Sincronización ERP–CRM: qué pasa cuando la API falla
Flujo con datos ficticios que muestra una sincronización correcta, un error de API y la recuperación del registro afectado.
Integraciones de API, ERP y CRM que aguantan cuando algo falla
Conectar dos sistemas el día bueno es fácil. Lo difícil es qué pasa cuando la API del proveedor devuelve un error, cuando cambia sin avisar o cuando el reintento duplica el registro. Eso es lo que diseñamos primero.
Señales de que la integración no está resuelta
Alguien copia datos a mano
Una persona exporta de un sistema y pega en otro. Funciona hasta que se equivoca o se va de vacaciones.
Los registros se duplican
El reintento crea un registro nuevo en vez de completar el anterior. El problema aparece semanas después, al cerrar el mes.
Nadie sabe si el flujo corrió
No hay registro de ejecuciones ni alerta de fallos: el error se descubre porque un cliente reclama.
El proveedor cambió la API
La integración dejó de funcionar y no está claro quién se hace cargo de actualizarla.
Alcance
Qué definimos antes de escribir código
Una integración se decide en estas siete preguntas. Si alguna no tiene respuesta, el flujo fallará más adelante.
Origen, destino y dirección
Qué sistema manda sobre cada dato y si la sincronización es en un sentido o en los dos. Sin esto no hay forma de resolver un conflicto.
Datos y correspondencias
Qué campos viajan, cómo se transforman y qué se hace con los que el destino no admite.
Autenticación y permisos
Credenciales, rotación, y con qué permisos mínimos opera la integración. Nunca con un usuario administrador de alguien.
Errores y reintentos
Qué se reintenta, cuántas veces y con qué espera. Y dónde queda lo que agota los intentos, para que no se pierda.
Control de duplicados
Una clave de idempotencia estable entre ambos sistemas. Es el punto que más integraciones rompe y el que menos se diseña.
Monitoreo y soporte
Registro de ejecuciones, alerta cuando falla y a quién le llega. Y qué pasa cuando el proveedor cambia la API.
Qué incluye y qué no
Qué incluye
- Mapa de datos entre los sistemas y decisión de sistema maestro por campo
- Implementación del flujo con reintentos, idempotencia y cola de revisión
- Registro de ejecuciones y alertas de fallo
- Pruebas con casos de error, no solo con el camino feliz
- Documentación del flujo y traspaso
Qué queda fuera
- Licencias de los sistemas conectados y de las plataformas de integración
- Limpieza de datos históricos inconsistentes, que se estima aparte
- Cambios en el sistema de origen o destino cuando no exponen lo necesario
- Mantenimiento continuo ante cambios de API si no hay contrato de soporte
Evidencia
La demo enseña el caso de error, no el feliz
Demo interna con datos ficticios: sincronización correcta, error de API y recuperación del registro afectado sin duplicarlo.
¿Quién se hace cargo cuando el proveedor cambia la API?
Depende de si hay contrato de soporte. Con soporte, nosotros: monitoreamos, detectamos la ruptura y aplicamos el cambio. Sin soporte, la entrega cierra con la documentación y el traspaso, y una actualización posterior se cotiza como trabajo nuevo. Lo dejamos escrito antes de empezar.
¿Sirve una plataforma tipo n8n o Make en lugar de código?
Muchas veces sí, y lo decimos. Una plataforma de automatización resuelve bien flujos de volumen moderado con conectores existentes. Conviene código propio cuando el volumen, las reglas de transformación o los requisitos de auditoría superan lo que la plataforma soporta. La tecnología se elige después del alcance, no antes.
¿Cuánto tarda una integración?
Una integración acotada entre dos sistemas con API documentada se mide en semanas. Lo que alarga los plazos casi nunca es el código: es conseguir credenciales, entender datos históricos inconsistentes y decidir qué sistema manda sobre cada campo.
Servicios relacionados
Desarrollo de software a medida para conectar tu operación
Sistemas y plataformas propias cuando ninguna herramienta del mercado resuelve tu proceso.
Aplicaciones web que hacen algo, no que solo se leen
Portales, aplicaciones internas y plataformas con roles, datos, seguridad y mantenimiento.
¿Qué sistemas necesitas conectar?
Cuéntanos el origen, el destino y qué debería pasar cuando algo falla. Revisamos el caso antes de proponer nada.