En los últimos años, la venta de seguros en línea ha experimentado un crecimiento significativo en todo el mundo. La conveniencia, la accesibilidad y la capacidad de comparar múltiples opciones en línea han llevado a un aumento en las ventas de seguros a través de canales digitales.

Si bien el porcentaje exacto puede variar según el país y el tipo de seguro, se estima que la venta online de seguros representa una parte cada vez mayor del mercado total de seguros. Se estima que las ventas en línea representan más del 20% del total de las ventas de seguros, por lo que abrirse a este mercado hoy en día es una obligación más que una opción.

Nuestra experiencia

En el caso de uno de nuestros clientes del sector de los seguros, las ventas y gestiones se realizan totalmente online. Por ello, acudieron a nosotros para el desarrollo de su plataforma, la cual ofrece la posibilidad de contratar seguros, así como la posibilidad de acceder al área privada de cliente para gestionar sus pólizas y renovaciones, dar de alta nuevos siniestros o hacerles seguimiento, y descargar documentación.

Conexión con plataformas de terceros

Nuestro cliente y muchas aseguradoras comercializan seguros como Correduría de Seguros, y es otra aseguradora la que proporciona y suscribe la póliza, por lo que surge la necesidad de una sincronización y gestión automática con estos. Dicha sincronización se hace a través de la plataforma intermedia EBroker.

EBroker

EBroker es un ERP (sistema de gestión empresarial) altamente especializado en la actividad de distribución de seguros (en particular, corredores, brokers y unidades de gerencia de riesgos) que bajo un entorno de usuario 100% web contempla las operaciones de negocio habituales en esta tipología de empresas como gestión financiera, gestión de contratos de seguro, tramitación de siniestros, operaciones con recibos de prima, relaciones con clientes (CRM), gestión documental trasversal, mensajería integrada, procesos en workflows, recursos de movilidad (APPs), business intelligence (BI) a través de KPIs, cuadros de mando y segmentación de clientes inteligente, entre otros.

Conexión con API SOAP

Para comunicar la APP con Ebroker hacemos uso de la API SOAP que proporciona distintos métodos para realizar las mismas acciones que se realizan desde el backoffice. En nuestro caso, sincronizamos distintos módulos como pólizas, recibos, siniestros o clientes.

Como desarrolladores de software estamos habituados a conexiones con APIs de tipo REST con respuesta en formato json, por lo que este tipo de integraciones requiere de un tratamiento especial. Explicaremos a grandes rasgos como hacer esta conexión haciendo uso del lenguaje de programación PHP:

Obtención de datos

Para consumir una API SOAP mediante PHP, puedes seguir los siguientes pasos:

  1. Habilita el soporte de SOAP en tu instalación de PHP asegurándote de que la extensión SOAP esté habilitada. Puedes verificar esto revisando el archivo php.ini y asegurándote de que la línea extension=soap no esté comentada (sin el punto y coma al principio).

  2. Crea un cliente SOAP en PHP utilizando la clase SoapClient. Esta clase proporciona métodos y funciones para interactuar con la API SOAP. Puedes instanciarla de la siguiente manera:

$wsdl = 'URL_DEL_WSDL';
$client = new SoapClient($wsdl, array('trace' => 1));

Asegúrate de reemplazar URL_DEL_WSDL con la URL real del archivo WSDL de la API SOAP que deseas consumir.

  1. Llama a los métodos de la API SOAP utilizando el cliente SOAP que has creado. Puedes invocar los métodos de la API como si fueran métodos de la clase SoapClient. Por ejemplo:
$response = $client->MethodName($param1, $param2);

Reemplaza MethodName con el nombre real del método que deseas llamar y proporciona los parámetros requeridos.

  1. Maneja la respuesta de la API SOAP. La respuesta de la API puede ser un objeto o un valor primitivo, dependiendo de la estructura de la API. Puedes acceder a los datos devueltos por la API utilizando la variable $response que has utilizado en el paso anterior.

Además, puedes utilizar métodos adicionales del cliente SOAP, como __getLastRequest() y __getLastResponse(), para obtener la última solicitud enviada y la última respuesta recibida para fines de depuración.

Añadir contenido

Para realizar peticiones tipo POST a una API SOAP, debes seguir un enfoque ligeramente diferente al mencionado anteriormente. A diferencia de las llamadas a métodos en una API SOAP, donde los parámetros se pasan directamente como argumentos en la llamada, en una petición POST necesitarás construir y enviar un mensaje SOAP personalizado con el contenido deseado.

Aquí hay un ejemplo de cómo puedes enviar una petición tipo POST a una API SOAP utilizando PHP:

  1. Construye los parámetros y crea un cliente SOAP como se mencionó anteriormente:
$params = array(
    'Param1' => 'valor1',
    'Param2' => 'valor2'
);

$wsdl = 'URL_DEL_WSDL';
$client = new SoapClient($wsdl, $params);
  1. Construye el cuerpo de la petición SOAP utilizando un array asociativo. Por ejemplo:

$body = [
            'var_1' => $var_1,
            'obj_1' => [
                'prop_1' => $prop_1,
                'prop_2' => $prop_2,
                'prop_3' => $prop_3,
                'prop_4' => $prop_4,
                'prop_5' => $prop_5,
                'prop_6' => $prop_6,
            ]

        ];

Asegúrate de ajustar los nombres de los elementos y los valores según los requisitos de la API SOAP que estés utilizando.

  1. Realiza la llamada POST utilizando el método que desees de la API SOAP. Por ejemplo:

$response = $client->crearUsuario($body);
  1. Maneja la respuesta de la API SOAP como se mencionó anteriormente.

Conclusiones

El consumo de APIs SOAP puede resultar algo más compleja, pero probablemente esté aquí porque necesita que hagamos todo el trabajo por usted cumpliendo con los estándares de programación más avanzados, por lo que le invitamos a contactar con nosotros y estudiaremos su caso para darle el presupuesto que más se ajuste a sus necesidades.