Si alguien en su organización copia cada semana datos de un programa a otro, usted ya conoce el problema. La pregunta ya no es «¿hay que integrar sus programas?», sino «¿cómo hacerlo sin crear una nueva fragilidad?». Este artículo explica los mecanismos (API, webhooks, archivos), las decisiones de fondo (sentido de la sincronización, fuente de verdad) y los requisitos que marcan la diferencia entre una integración que perdura y una que se rompe en el primer incidente.
Los síntomas de introducir los mismos datos dos veces
La introducción duplicada de datos rara vez se identifica por su nombre. Se manifiesta más bien en fenómenos muy concretos:
- una misma ficha de cliente existe en dos versiones ligeramente distintas según la herramienta consultada;
- un informe «oficial» se rehace a mano porque nadie confía en las cifras automáticas;
- una tarea de reintroducción de datos se repite a finales de cada mes, con una persona designada que conoce «los trucos»;
- un error al teclear, detectado tardíamente, obliga a hacer correcciones en varios lugares;
- la llegada de un nuevo empleado lo ralentiza todo, porque el procedimiento vive en la cabeza de alguien.
Estos síntomas tienen un origen común: varios sistemas poseen la misma información sin que exista un vínculo controlado entre ellos. Por lo tanto, el objetivo de una integración no es «hacer que los programas se comuniquen», sino decidir quién posee qué y hacer fiable la transferencia.
Tres maneras de integrar sus programas
Las API
Una API (interfaz de programación) permite que un programa consulte o modifique otro según reglas publicadas. En el mundo web, se trata con mayor frecuencia de una API HTTP. La OpenAPI Initiative describe la especificación OpenAPI como «un formato de descripción neutral» de las API remotas basadas en HTTP: recoge las interacciones permitidas, los parámetros, los valores de retorno y los formatos de datos. Según la iniciativa, una descripción de este tipo facilita la generación de documentación coherente con la API, la generación de código base y la creación de servidores simulados para probar desde temprano, incluso antes de que el código del proveedor esté escrito.
Para una organización, la lección es práctica: antes de elegir un enfoque, verifique si los programas involucrados publican una descripción de API actualizada. Es un buen indicador de la facilidad (y del costo) de la integración.
Los webhooks
Un webhook invierte la lógica: en lugar de consultar con regularidad al otro sistema, usted le indica una dirección y él le avisa cuando ocurre un evento. La documentación de Stripe, un proveedor de pagos que utiliza ampliamente este mecanismo, ilustra bien las precauciones que hay que prever. Su guía pide, entre otras cosas, verificar la firma de cada solicitud, responder rápidamente con un código de éxito (2xx) antes de cualquier procesamiento complejo y procesar los eventos de forma asíncrona, mediante una cola, para resistir los picos de volumen. También precisa que el orden de entrega no está garantizado y que un mismo evento puede llegar más de una vez.
Estos principios valen mucho más allá de ese proveedor: todo receptor de webhooks debe concebirse para los duplicados, el desorden y la verificación de autenticidad.
Los archivos intercambiados
Algunos sistemas, a menudo más antiguos, no ofrecen ni API ni webhooks, pero saben exportar o importar archivos (CSV, XML, etc.). Una integración por archivos puede ser perfectamente razonable para volúmenes modestos o intercambios periódicos, siempre que se traten los mismos temas que con una API: formato documentado, validación en la recepción, control de duplicados, registro de los procesamientos. El riesgo principal es la dependencia de una persona que «deja el archivo en el lugar correcto».
Sincronización unidireccional o bidireccional
Es la decisión de diseño más estructurante.
Unidireccional: un sistema envía, el otro recibe. Es más sencilla de entender, probar y depurar. Conviene a los casos en que una información nace claramente en un solo lugar, por ejemplo un pedido registrado en una herramienta y utilizado después para la facturación.
Bidireccional: ambos sistemas pueden modificar la misma información y deben sincronizarse en los dos sentidos. A veces es necesario, pero plantea preguntas difíciles: ¿qué hacer si la misma ficha se modifica en ambos lados antes de la próxima sincronización? ¿Qué modificación prevalece? ¿Con qué criterio se decide?
Una regla prudente consiste en partir de lo unidireccional y pasar a lo bidireccional solo si una necesidad de negocio clara lo exige, campo por campo y no para todo el objeto.
Designar una fuente de verdad
Para cada dato compartido (cliente, producto, empleado, factura) y, si es necesario, para cada campo, designe una fuente de verdad: el sistema autorizado para crear o corregir ese dato. Los demás sistemas reciben una copia, según reglas de sincronización documentadas. En concreto:
- elabore la lista de los datos compartidos;
- asigne a cada uno un sistema propietario;
- documente las reglas de correspondencia (por ejemplo, qué identificador vincula a un cliente de la herramienta A con su equivalente en la herramienta B);
- prohíba, en los sistemas secundarios, la modificación de los campos gestionados en otro lugar, o hágala visible como una excepción.
Sin esta decisión, ninguna tecnología evitará nuevas discrepancias en los datos.
Gestionar los errores y los reintentos
Una integración terminará por fallar: red caída, servicio no disponible, dato inválido, cambio de formato. El criterio de calidad no es la ausencia de errores, sino el comportamiento cuando ocurren.
Hacer las operaciones repetibles
El glosario de MDN define un método HTTP idempotente como aquel cuyo efecto buscado en el servidor es el mismo tanto si la solicitud se envía una vez como varias. Los métodos GET, HEAD, OPTIONS, PUT y DELETE son idempotentes; POST y PATCH no tienen garantizada la idempotencia. MDN extrae la consecuencia: un cliente puede reintentar sin temor una solicitud idempotente cuando ignora si llegó al servidor. A la inversa, repetir un POST puede crear un duplicado (el ejemplo de MDN es la adición de una línea con cada envío).
Para una integración, esto significa diseñar los intercambios de modo que una repetición no duplique nada: identificadores únicos, actualización por reemplazo en lugar de creación a ciegas y, del lado de los webhooks, conservación de los identificadores de los eventos ya procesados, como recomienda Stripe.
Respetar los límites del proveedor
Cuando un servicio considera que usted envía demasiadas solicitudes, puede responder 429 («Too Many Requests»), un mecanismo llamado limitación de la frecuencia de solicitudes. Puede añadir un encabezado Retry-After que indica el tiempo de espera, en segundos o en forma de fecha. MDN precisa que el soporte de este encabezado varía según los clientes y los servidores. Cuando está presente y es válido, respete el plazo indicado; si falta o no se puede utilizar, prevea un tiempo de espera progresivo por defecto.
Prever la cola de los casos fallidos
Una buena integración no se limita a reintentar indefinidamente. Limita el número de intentos, aparta los casos que siguen fallando y alerta a una persona designada con suficiente contexto para corregirlos. También permite reprocesar un lote una vez corregido el problema de fondo.
Proteger los accesos
Conectar dos programas es abrir una puerta entre ellos. OWASP, organismo reconocido en seguridad de aplicaciones, mantiene una lista de los diez principales riesgos propios de las API (edición 2023). Varios afectan directamente a las integraciones:
- Autorización a nivel de objeto: un punto de acceso que recibe un identificador puede permitir el acceso a datos que no deberían ser accesibles.
- Autenticación deficiente: una gestión frágil de las conexiones o de los tokens permite suplantar una identidad.
- Autorización a nivel de propiedad y de función: verificaciones ausentes en ciertos campos o funciones exponen o modifican datos sin permiso.
- Consumo de recursos sin restricciones: sin límites de uso, una API puede sobrecargarse o generar costos elevados cuando se apoya en servicios de pago.
- Consumo inseguro de API: se confía demasiado en los datos de una API de terceros, a la que los atacantes pueden apuntar para llegar a su sistema.
Este último punto suele olvidarse: los datos recibidos de un socio deben validarse como cualquier otra entrada.
En la práctica, conserve como mínimo lo siguiente:
- una cuenta de servicio dedicada a la integración, con los derechos estrictamente necesarios (principio de mínimo privilegio);
- secretos (claves, tokens) almacenados fuera del código y renovables;
- conexiones cifradas (HTTPS/TLS) entre los sistemas: MDN advierte que la autenticación Basic, que codifica el nombre de usuario y la contraseña de forma reversible, sería «completamente insegura» sin una conexión segura (HTTPS/TLS);
- la verificación de la autenticidad de las llamadas entrantes, por ejemplo la firma de los webhooks.
Registrar para comprender, sin exponer
Cuando un cliente pregunta «¿por qué este pedido nunca llegó?», solo un registro permite responder. La guía de registro de OWASP recomienda consignar los eventos de seguridad (fallos de autenticación o de autorización, fallos de validación), los errores de la aplicación, los cambios de configuración y el acceso a datos sensibles o su exportación.
La misma guía pide no escribir en texto claro en los registros las contraseñas, los tokens de acceso, las claves, las cadenas de conexión ni los datos personales sensibles: deben eliminarse, enmascararse o aplicarles un hash. También recomienda controlar quién puede leer los registros, detectar cualquier alteración y utilizar formatos estructurados en lugar de texto libre. En términos simples: un registro útil para la operación no debe convertirse en una segunda fuga de datos.
Probar antes, durante y después de la puesta en marcha
Una integración se prueba en varios planos:
- Casos nominales: un dato válido circula correctamente de un sistema a otro.
- Casos límite: campos vacíos, caracteres con acento, volúmenes muy grandes, duplicados.
- Fallos simulados: servicio no disponible, respuesta lenta, 429, reenvío de un mismo evento, eventos en desorden.
- Conciliación: comparación periódica de los dos sistemas para detectar cualquier discrepancia silenciosa.
- Entorno de pruebas: si el proveedor ofrece uno, utilícelo antes de involucrar datos reales.
La descripción OpenAPI, cuando existe, ayuda a construir estas pruebas: la OpenAPI Initiative destaca que permite simular la API para probar desde temprano.
Prever el mantenimiento
Una integración nunca está «terminada». Los proveedores hacen evolucionar sus API, las claves caducan, los volúmenes cambian y los procesos de negocio también. Prevea desde el principio:
- una persona responsable de la integración, con un suplente;
- una documentación actualizada de los flujos, de las correspondencias de campos y de los procedimientos de recuperación;
- un seguimiento de los avisos de cambio de los proveedores;
- un inventario de las integraciones existentes (OWASP, por cierto, clasifica la gestión deficiente del inventario de API entre los diez riesgos);
- alertas ante fallos repetidos.
Preguntas frecuentes
¿Hay que pasar siempre por una API? No. Una API suele ser preferible cuando existe, pero un intercambio de archivos bien estructurado puede bastar para necesidades sencillas o programas más antiguos.
¿Por dónde empezar? Por un inventario de los casos actuales de introducción duplicada de datos: quién vuelve a introducir qué datos, con qué frecuencia y qué errores se han detectado. Este ejercicio indica dónde la integración aporta más y en qué orden actuar.
¿Cómo evitar los duplicados en un intercambio automático? Mediante identificadores únicos, operaciones diseñadas para repetirse sin efectos secundarios y, del lado de los webhooks, conservando los identificadores de los eventos ya procesados.
Conclusión
Integrar sus programas es ante todo un ejercicio de claridad: decidir quién posee cada dato, en qué sentido circula, cómo se reacciona cuando un intercambio falla, quién tiene acceso a él y cómo se conserva su rastro. La tecnología (API, webhooks, archivos) viene después. Si ya ha identificado dónde se introducen los mismos datos dos veces, ha hecho lo más difícil: describir el problema.
Los servicios especializados de KTMA SOLUTIONS
¿Tiene una situación concreta en mente? Hablar de mi proyecto.
Fuentes
- OWASP — Los 10 principales riesgos de seguridad de las API (API Security Top 10 ; edición 2023) (consultado el )
- OpenAPI Initiative — Introducción a la especificación OpenAPI (Introduction to the OpenAPI Specification) (consultado el )
- MDN Web Docs — Idempotente (glosario) (Idempotent (glossaire)) (consultado el )
- MDN Web Docs — 429 Demasiadas solicitudes (429 Too Many Requests) (consultado el )
- MDN Web Docs — Encabezado HTTP Retry-After (Retry-After) (consultado el )
- MDN Web Docs — Autenticación HTTP (HTTP authentication) (consultado el )
- Stripe — Recibir eventos de Stripe en su endpoint de webhook (Receive Stripe events in your webhook endpoint) (consultado el )
- OWASP — Hoja de referencia sobre registro de eventos (Logging Cheat Sheet) (consultado el )

