Técnica↗ Guía práctica

Integraciones que no duplican el trabajo

Identificadores, reintentos y registros: tres decisiones para diseñar una conexión entre herramientas.

Elige la fuente de referencia

Antes de conectar dos herramientas, decide qué sistema es la referencia para cada dato. Documenta campos, identificadores y qué hacer ante cambios simultáneos. Evita que dos copias compitan sin una regla clara.

Diseña los reintentos

Una petición puede haberse ejecutado aunque no recibas la respuesta. Para operaciones que crean registros, utiliza una clave estable y un mecanismo de deduplicación cuando el sistema lo permita. Distingue los errores temporales de los que necesitan una corrección manual.

Deja rastro sin exponer datos

Registra el estado, la hora y un identificador de correlación. Evita incluir credenciales o el contenido completo de documentos en los logs. El registro debe ayudar a localizar una incidencia y retomar el trabajo.

Comprueba antes de ampliar

Prueba duplicados, campos vacíos, límites de uso e interrupciones. Define cómo reconciliar los registros de ambos sistemas y quién recibe los avisos. Una integración también necesita una forma de detectar que no funciona.

Cada proceso necesita su propia revisión. Esta guía es un punto de partida, no una promesa de resultados.