Cómo integrar dos sistemas a través de API

El pedido llega simple: “necesito conectar el sistema A con el sistema B”. En la reunión siguiente aparecen un formato distinto del documento, el horario en que B no responde, un registro duplicado y la duda de si el lote de ayer entró o no.

El problema

Cada sistema se hizo para su propio proceso. El puente necesita traducir el dato, respetar el límite, confirmar la recepción y sobrevivir al pico. Sin eso, la integración se vuelve una hoja de cálculo en el medio o un cron que “a veces funciona”.

Cómo funciona una integración que aguanta producción

• Contrato claro para campos, autenticación e idempotencia.
• Tiempos de espera y reintentos con límites definidos.
• Colas cuando el sistema de destino es más lento que el de origen.
• Registros suficientes para rastrear cada identificador.
• Reprocesamiento controlado de los datos que fallaron.

¿API o webhook?

Con una API, un sistema consulta o envía información cuando la necesita; con un webhook, el otro sistema notifica que ocurrió un evento. Ambos requieren tratamiento de tiempos de espera, firmas, orden de eventos y notificaciones duplicadas. La elección depende de qué sistema origina el evento y de los requisitos de la operación.

Por qué las integraciones fallan en producción

En la prueba, cinco mensajes. En producción, una ráfaga. La base de datos se traba en la consulta que era “rápida”. El HTTP agota el tiempo. Quien envió vuelve a intentar y crea un duplicado. Quien recibió procesa dos veces. Sin cola, sin idempotencia y sin observabilidad, el síntoma se vuelve “la API está inestable” — cuando el diseño es el que no preveía carga.

Experiencia práctica

En proyectos de rastreo y recolección continua, los dispositivos siguen enviando datos independientemente de la carga de la base de datos. Los formatos reales pueden diferir de la documentación y cada modelo puede comportarse de manera distinta. Los tiempos de espera, la ingestión, la persistencia y las consultas deben monitorearse y dimensionarse como componentes separados.

Errores comunes

• Integrar por la base de datos directa porque “es más rápido”.
• Asumir que el socio documentó el protocolo completo.
• Ignorar huso horario, encoding y un campo opcional que un día llega lleno.
• No tener un dueño de la integración después del go-live.

Cuándo utilizar una API nueva en un sistema existente

Cuando el legado necesita hablar con un canal, IA, mobile u otro ERP sin reescribir el núcleo de una vez. La API es la costura. El sistema antiguo continúa; el mundo nuevo no necesita entrar por la puerta de atrás de la base de datos.