Saltar al contenido
XSIS
Hable con un ingeniero

Integraciones

Integración con terceros y API

API y servicios de terceros conectados, con los casos de fallo resueltos

Integraciones REST, SOAP, webhooks e iPaaS con proveedores de CRM, logística, servicios fiscales, KYC e identidad.

Visión general

La mayoría de las empresas depende de servicios que no opera: un CRM, transportistas, plataformas fiscales y de facturación electrónica, proveedores de identidad y KYC, marketplaces y herramientas SaaS. Cada uno tiene su propia API, sus propios límites y su propia forma de fallar. Conectados uno a uno, acaban siendo un conjunto de scripts que nadie comprende del todo.

Diseñamos y construimos integraciones sobre REST, SOAP, GraphQL y webhooks, de forma directa o a través de una plataforma de integración como MuleSoft, Boomi o Azure Logic Apps. También conectamos la identidad: inicio de sesión único con OpenID Connect o SAML, aprovisionamiento de usuarios con SCIM y acceso entre servicios con OAuth 2.0.

Cada llamada se diseña para el día en que falle la otra parte. Usamos solicitudes idempotentes para que un reintento nunca cree un duplicado, reintentos con espera progresiva para los fallos temporales y una cola de mensajes fallidos con alertas para el resto. Los contratos se documentan, las versiones se gestionan y su equipo puede ver qué se ha transmitido y qué no.

Qué entregamos

  1. Inventario de integraciones

    Cada servicio de terceros del que depende, qué datos fluyen hacia él y desde él, y quién es responsable de cada conexión.

  2. Contratos de API

    Definiciones OpenAPI o WSDL para cada interfaz, con reglas de campos, códigos de error, límites y ejemplos.

  3. Conectores

    El código o los flujos de la plataforma de integración que llaman a cada servicio y gestionan sus callbacks, construidos y probados.

  4. Identidad e inicio de sesión único

    Inicio de sesión a través de su proveedor de identidad con OpenID Connect o SAML, y aprovisionamiento de usuarios con SCIM cuando esté disponible.

  5. Reintentos, idempotencia y mensajes fallidos

    Reintentos seguros para fallos temporales, protección frente a duplicados en cada escritura y una cola para los mensajes que siguen fallando.

  6. Control de versiones y política de cambios

    Un esquema de versiones para las API que publica y un proceso para absorber los cambios en las API que consume.

  7. Secretos y accesos

    Credenciales y claves en un almacén de secretos, limitadas a cada integración y rotadas con la periodicidad que usted defina.

  8. Monitorización y alertas

    Trazas, tasas de error y latencia por socio, con alertas que indican qué socio ha fallado y cómo.

  9. Pruebas de contrato y de integración

    Pruebas automatizadas frente a cada contrato y al entorno de pruebas de cada socio, ejecutadas antes de cada versión.

Cómo trabajamos

  1. 01

    Hacer inventario

    Enumeramos los servicios de los que depende, los datos que necesita cada uno y los fallos que ve hoy.

  2. 02

    Diseñar los contratos

    Redactamos los contratos de API y elegimos llamadas directas, eventos o una plataforma de integración para cada flujo.

  3. 03

    Construir los conectores

    Construimos cada conector con su gestión de errores, protección frente a duplicados y registro desde el principio.

  4. 04

    Probar con cada socio

    Ejecutamos pruebas de contrato y escenarios de extremo a extremo en el entorno de pruebas de cada socio, incluidos los fallos.

  5. 05

    Publicar con seguridad

    Publicamos tras indicadores de funcionalidad (feature flags) o por etapas, y mantenemos disponible la ruta anterior hasta que la nueva demuestre su eficacia.

  6. 06

    Operar y adaptar

    Vigilamos las tasas de error y los mensajes fallidos, y adaptamos los conectores cuando los socios cambian sus API.

Cómo se conecta

Del ERP a terceros: una plataforma, muchos sociosLos eventos de negocio salen del ERP una sola vez y la plataforma de integración los entrega a cada socio en el formato que espera. Las respuestas de vuelta (callbacks) siguen la misma vía. Un mensaje que sigue fallando tras sus reintentos pasa a una cola de mensajes fallidos y genera una alerta con el contenido adjunto.ERPERPClientes, pedidos,facturasXSISPlataforma deintegracióniPaaS o servicios amedida, mapeo yreintentosTerceroCRMCuentas, contactos yoportunidadesTerceroLogística ytransportistasEnvíos y seguimientoTerceroFacturaciónelectrónica eimpuestosValidación fiscal ydeclaracionesTerceroProveedor de KYCe identidadVerificación y cribadoServicioCola de mensajesfallidos y alertasNo se pierde nadaPersonasEquipo de soporte1REST · ODatawebhook2REST/JSON3REST/JSON4webhook5SOAP/XML · REST6REST/JSON7webhook89

Del ERP a terceros: una plataforma, muchos socios

Los eventos de negocio salen del ERP una sola vez y la plataforma de integración los entrega a cada socio en el formato que espera. Las respuestas de vuelta (callbacks) siguen la misma vía. Un mensaje que sigue fallando tras sus reintentos pasa a una cola de mensajes fallidos y genera una alerta con el contenido adjunto.

  • Flujo principal
  • Asíncrono
  • Ruta de fallo

El flujo, paso a paso

  1. De ERP a Plataforma de integración: Eventos de negocio, mediante REST · OData · webhook (flujo principal).
  2. De Plataforma de integración a CRM: Clientes y pedidos, mediante REST/JSON (flujo principal).
  3. De Plataforma de integración a Logística y transportistas: Envíos reservados, mediante REST/JSON (flujo principal).
  4. De Logística y transportistas a Plataforma de integración: Eventos de seguimiento, mediante webhook (asíncrono).
  5. De Plataforma de integración a Facturación electrónica e impuestos: Facturas para validación fiscal, mediante SOAP/XML · REST (flujo principal).
  6. De Plataforma de integración a Proveedor de KYC e identidad: Verificaciones de identidad, mediante REST/JSON (flujo principal).
  7. De Proveedor de KYC e identidad a Plataforma de integración: Resultados de verificación, mediante webhook (asíncrono).
  8. De Plataforma de integración a Cola de mensajes fallidos y alertas: Fallido tras los reintentos, a la cola de mensajes fallidos (ruta de fallo).
  9. De Cola de mensajes fallidos y alertas a Equipo de soporte: Alerta con el contenido y el error (ruta de fallo).

Tecnologías

Datos y analítica
  • Apache Kafka
Pruebas
  • Postman
Integración
  • REST
  • SOAP
  • GraphQL
  • Webhooks
  • OpenAPI
  • MuleSoft
  • Boomi
  • Azure Logic Apps
  • Apache Camel
  • RabbitMQ
Identidad y acceso
  • OAuth 2.0
  • OpenID Connect
  • SAML 2.0
  • SCIM
  • Keycloak
  • Microsoft Entra ID
Estándares sanitarios
  • HL7 v2
  • HL7 FHIR

Formas de trabajar con nosotros

Preguntas y respuestas

¿Debemos usar una plataforma de integración o código a medida?

Depende de cuántas conexiones tenga y de quién las vaya a operar. Una plataforma de integración como MuleSoft, Boomi o Azure Logic Apps le ofrece conectores listos, mapeo y monitorización en un solo lugar, con un costo de licencia. Los servicios a medida le dan control total y no requieren licencia, pero usted mantiene más código. Comparamos ambas opciones para su caso y construimos sobre la plataforma que ya tenga.

Enlace a esta pregunta
¿Qué ocurre cuando la API de un socio no está disponible?

Las solicitudes que fallan por motivos temporales se reintentan con esperas crecientes. Cada escritura lleva una clave de idempotencia, de modo que un reintento nunca crea un segundo pedido o una segunda factura. Si un mensaje sigue fallando, pasa a una cola de mensajes fallidos con su contenido y el error, se envía una alerta a su equipo y puede reprocesarse cuando el socio se recupere.

Enlace a esta pregunta
¿Cómo gestionan los cambios de versión de las API?

Las API que usted publica las versionamos, mantenemos las versiones antiguas en funcionamiento durante un periodo acordado e informamos a los consumidores de los cambios. En las API que usted consume, seguimos los avisos de obsolescencia de cada socio, probamos las nuevas versiones en su entorno sandbox y migramos antes de que se desactive la versión antigua. Las pruebas de contrato detectan un cambio no anunciado antes de que llegue a producción.

Enlace a esta pregunta
¿Pueden conectar nuestro proveedor de identidad?

Sí. Añadimos inicio de sesión único con OpenID Connect o SAML 2.0 a través de proveedores como Microsoft Entra ID o Keycloak, y aprovisionamos usuarios automáticamente con SCIM cuando la aplicación lo admite. Los servicios se comunican entre sí con tokens OAuth 2.0 limitados a lo que cada uno necesita. Su proveedor de identidad sigue siendo el único lugar donde se conceden y retiran los accesos.

Enlace a esta pregunta
¿Cómo gestionan los límites de uso de las API?

Leemos los límites publicados por cada socio y diseñamos en función de ellos: agrupamos solicitudes cuando la API lo permite, almacenamos en caché los datos que rara vez cambian, distribuimos las tareas programadas y reducimos el ritmo cuando el socio indica que un límite está cerca. La monitorización muestra lo cerca de su límite que funciona cada flujo, para que el crecimiento no se convierta en fallos.

Enlace a esta pregunta
¿Cuánto se tarda en integrar un servicio de terceros?

Depende de la calidad de la API y la documentación del socio, de si dispone de un entorno de pruebas utilizable, de la rapidez con que se emiten las cuentas y las claves y de la complejidad de su mapeo de datos. Los pasos de aprobación del socio pueden marcar el ritmo. Tras el inventario le entregamos un plan por socio y empezamos por la conexión que elimina más trabajo manual.

Enlace a esta pregunta
¿De qué depende el costo?

Del número de socios y flujos, la calidad de sus API, el mapeo y las reglas de negocio, las necesidades de volumen y horarios y de las posibles licencias de la plataforma de integración. El trabajo de identidad y la certificación con un socio añaden esfuerzo. Estimamos por conexión tras el inventario, para que pueda elegir el orden y ver el costo de cada una.

Enlace a esta pregunta
¿Quién es propietario del código y del trabajo que producen?

La propiedad intelectual del trabajo que desarrollamos para usted es suya desde el primer commit, sin ningún trámite de cesión al final. Esto incluye el código a medida, la documentación y los demás entregables creados para usted. Lo que aportamos y ya existía antes, como herramientas o bibliotecas internas, sigue siendo nuestro, y usted recibe una licencia para usarlo en sus sistemas. Los componentes de código abierto mantienen sus propias licencias, y se los enumeramos.

Enlace a esta pregunta

Cuéntenos qué necesita desarrollar o conectar.

Describa los sistemas, los plazos y las restricciones. Los ingenieros adecuados se encargan a partir de ahí.

  • Nuestro equipo le llamará en un plazo de 24 horas, en la franja horaria que usted prefiera
  • Nuestro equipo está disponible 24/7