Mapa de sistemas
Documenta para cada aplicación:
- función;
- datos;
- propietarios;
- usuarios;
- autenticación;
- interfaces;
- límites;
- criticidad.
Fuente de verdad
Define dónde se crea y modifica cada entidad. Por ejemplo:
- oportunidad: CRM;
- factura: ERP;
- documento: almacenamiento;
- identidad: directorio.
Eventos
En lugar de sincronizar todo continuamente, identifica eventos:
- cliente aprobado;
- pedido confirmado;
- factura emitida;
- correo recibido;
- documento firmado.
Patrones
API síncrona
Necesita respuesta inmediata. Útil para consultar disponibilidad o crear un registro durante una acción.
Webhook
El sistema notifica un cambio. Reduce consultas y latencia.
Cola
Desacopla procesos y permite reintentos. Adecuada para volumen y tareas no inmediatas.
Lote
Sincroniza periódicamente. Útil cuando no se necesita tiempo real.
Transformación y validación
Los sistemas pueden representar fechas, monedas y estados de forma diferente. La capa de integración normaliza y rechaza datos inválidos.
Idempotencia
Un reintento no debe crear duplicados. Cada operación necesita identificador y reglas.
Errores
Distingue:
- temporal;
- validación;
- autenticación;
- límite;
- conflicto;
- negocio.
Cada uno requiere tratamiento.
Correo
El correo puede iniciar procesos, pero debe convertirse en datos y estado. Hay que relacionar mensajes con clientes, expedientes y tareas.
Observabilidad
Registra volumen, latencia, fallos, reintentos y operaciones pendientes. Una integración silenciosa puede perder datos durante semanas.
Ejemplo
Cuando una oportunidad se gana:
- CRM emite evento.
- Se valida cliente.
- ERP crea ficha.
- Se crea proyecto.
- Se genera carpeta.
- Se envía acceso.
- CRM recibe estado.
Si ERP falla, el evento se reintenta y queda visible.
Preguntas frecuentes
¿Todo debe sincronizarse en tiempo real?
No. El tiempo real añade complejidad; debe reservarse para necesidades reales.
¿Dónde debe vivir la lógica?
Las reglas transversales suelen gestionarse en una capa de integración o aplicación de proceso.
¿Cómo se evitan duplicados?
Con identificadores estables, idempotencia, búsqueda previa y restricciones.