Download the PHP package andreani/sdk-php without Composer
On this page you can find all versions of the php package andreani/sdk-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package sdk-php
SDK de PHP para integración con servicios Andreani [deprecado]
Este servicio se encuentra DEPRECADO, sin mantenimiento. Para integraciones consultar nuestra documentación en https://developers.andreani.com/documentacion
- Instalación
- Uso
- Llamadas Propias
Instalación:
Para las instrucciones de instalación se presume que su aplicación utiliza Composer, si en su proyecto no tiene incorporada esta herramienta (primero considere utilizarla, ¡es muy útil!) deberá descargar el repositorio completo y definir manualmente los namespaces (o hacer los includes
según corresponda).
Agregue la siguiente línea dentro de la sección require
de su composer.json
Corra el comando composer update
y una vez finalizado el proceso debería ver el directorio "andreani" dentro de sus vendors.
Uso:
Las llamadas a los servicios de Andreani están modeladas en objetos que implementan la interfaz WebserviceRequest. Este SDK trae incorporadas probablemente todas las llamadas que vaya a necesitar (más abajo se explica como desarrollar llamadas propias e incorporarlas al circuito).
Por otro lado, la clase principal que gestiona la comunicación es la clase Andreani. Para instanciarla se debe pasar como parámetros obligatorios el username
y el password
. Opcionalmente se le puede pasar un entorno (test
para que apunte al entorno de pruebas de Andreani, por defecto prod
para producción).
Los pasos a seguir serían los siguientes:
- Instanciar un objeto del tipo WebserviceRequest.
- Setear los datos para la llamada
- Instanciar la clase Andreani.
- Llamar al método
call
pasándole el Request como parámetro
Ejemplo para realizar una cotización de prueba:
Como se muestra en el ejemplo, toda llamada devuelve un objeto del tipo Response, capaz de responder si la llamada fue o no exitosa (con el método isValid
) y que con el método getMessage
retorna literalmente la respuesta del webservice.
Llamadas propias
Si necesita desarrollar sus propias llamadas a los webservices (por ejemplo, por si tiene en los sistemas de Andreani un webservice hecho a medida) puede hacerlo y aún utilizar el sdk.
Los pasos serían los siguientes:
- Desarrollar una clase que implemente la interfaz
Andreani\Resources\WebserviceRequest
. Esta interfaz lo obligará a implementar el métodogetWebserviceRequest
que deberá retornar un índice que la identifique. - Generar un archivo del tipo
json
para la configuración. Este archivo contiene la configuración de cada webservice (identificado por el índice del paso anterior). - Adapter del request a los parámetros del webservice, es decir, una clase cuya responsabilidad es generar (a partir de un WebserviceRequest) los parámetros necesarios para la consulta. La clase a utilizar también se define en el archivo de configuración.
Ejemplo de una llamada propia: