Esta guía ordena el diagnóstico de integraciones que fallan antes de decidir si conviene reparar o reconstruir.
Síntomas habituales
- Clientes duplicados o estados incoherentes.
- Errores que solo se conocen cuando un usuario los detecta.
- Procesos nocturnos sin logs comprensibles.
- Datos parciales tras una caída de red o API.
- Dependencia de una persona para relanzar importaciones.
Orden de diagnóstico
- Identificar sistemas, endpoints, scripts y responsables.
- Revisar logs, credenciales, límites y frecuencia.
- Comprobar reglas de deduplicación y campos obligatorios.
- Separar errores funcionales de errores técnicos.
- Definir reintentos, alertas y criterios de recuperación.
Arquitectura de referencia
EventoCola o controlTransformaciónSistema destinoAuditoría, reintentos y alerta
No todas las integraciones necesitan una cola formal, pero sí necesitan saber qué ocurrió, qué se reintentó y qué quedó pendiente.
Cuándo rescatar y cuándo rehacer
Se puede rescatar si hay lógica válida y el problema es monitorización, datos o robustez. Conviene rehacer si no existe documentación, las reglas ya no responden al negocio o el coste de mantener parches supera al de rediseñar.