Esta conversación ocurre en toda empresa que usa más de un sistema operativo. Finanzas presenta una cifra, operaciones otra, y la reunión dedica cuarenta minutos a decidir cuál está mal antes de que alguien haga la mejor pregunta: ¿qué está contando exactamente cada sistema?
En nuestra experiencia, la respuesta suele ser que cuentan cosas distintas, y correctamente.
Causa uno: el límite se define de forma distinta
¿Qué es una entrega completada?
- Para la plataforma de rastreo, puede ser: el vehículo entró en la geocerca del cliente y permaneció ahí más de tres minutos.
- Para la app del conductor, puede ser: el conductor presionó «Entregado» y capturó una firma.
- Para el sistema de facturación, puede ser: se recibió un comprobante de entrega y se relacionó con una línea del pedido.
Un vehículo que llegó, esperó y se fue sin descargar porque el andén del cliente estaba lleno cumple la primera definición y ninguna de las otras. Eso no es un error de datos. Son tres equipos respondiendo tres preguntas distintas con la misma palabra.
La solución no es técnica. Acuerden una definición por indicador, escríbanla y hagan que cada informe indique qué definición usa. La mayoría de estas discusiones desaparecen en cuanto las definiciones están alineadas.
Causa dos: zonas horarias y el corte del día
Las plataformas de rastreo suelen guardar las horas en UTC porque los dispositivos reportan desde donde estén. Los sistemas contables suelen trabajar en la hora local del negocio, porque eso es lo que significa un día comercial. Una entrega completada a las 02:30 hora local puede caer, legítimamente, en días distintos en los dos sistemas.
En un informe de cierre de mes, esto solo afecta los días límite, y por eso es difícil de detectar: la diferencia es pequeña, se mueve y nunca se repite cuando uno la busca.
Una trampa relacionada que conviene conocer
La configuración regional puede reescribir los números, no solo los formatos. Una aplicación en árabe mostrará una fecha como ٢٠٢٦-٠٨-٢١, lo cual es correcto para el lector e ilegible para un servidor que espera una fecha ISO. Si ese texto llega a una API, la solicitud falla en silencio y devuelve vacío en lugar de dar error, lo que aparece como informes que regresan misteriosamente vacíos para algunos usuarios y no para otros.
Causa tres: una sincronización falló y nadie se enteró
Esta es la que realmente cuesta dinero.
Las integraciones suelen construirse para el camino feliz. El sistema A envía al sistema B, el B acepta y todos contentos. Luego el B entra en mantenimiento once minutos, cuarenta y tres registros no se envían y la integración (sin reintentos, sin cola y sin alertas) pasa al siguiente lote.
Nada parece roto. Ambos sistemas están funcionando. La diferencia se descubre semanas después, en una conciliación, cuando ya nadie puede reconstruir qué registros se perdieron ni reproducir las condiciones.
Lo que realmente necesita una integración resistente
- Reintentos con espera progresiva. Las fallas temporales son el caso común, y un reintento unos segundos después suele funcionar.
- Idempotencia. Si un reintento pasa dos veces, el sistema receptor debe reconocerlo como el mismo registro en lugar de crear un duplicado; si no, un problema de registros perdidos se convierte en uno de doble facturación.
- Una cola de mensajes fallidos. Los registros que no pueden procesarse tras los reintentos van a un lugar visible, no a un archivo de log que nadie lee.
- Alertas sobre la cola, no sobre el error. Alguien debe enterarse de que hay cuarenta y tres registros atorados, en el momento en que se atoran.
- La conciliación como función. Un proceso programado que compara el número de registros entre sistemas y reporta desvíos es poco vistoso y atrapa todo lo que las otras cuatro dejan pasar.
Nada de esto es difícil. Es simplemente la parte del trabajo de integración que se recorta cuando el proyecto se define como «conectar estos dos sistemas» en lugar de «mantener de acuerdo estos dos sistemas».
Cómo hacer la investigación
La próxima vez que las cifras no coincidan, resista el impulso de buscar la equivocada. En su lugar:
- Pida a ambos sistemas los registros de detalle, no los totales. Los totales esconden todo.
- Compare conjuntos, no conteos. Lo que busca son los registros concretos que están en uno y faltan en el otro.
- Mire primero la hora de esos registros. Si se agrupan en los cortes de día, apunta a las zonas horarias; si se agrupan en una ventana estrecha, apunta a una sincronización fallida.
- Si están dispersos sin patrón, tiene una diferencia de definición. Revise cómo decide cada sistema que un registro está completo.
Esta secuencia resuelve la mayoría de estos casos en una tarde, y suele terminar con una definición escrita y no con código modificado.
Puntos clave
- Dos sistemas en desacuerdo suelen ser dos respuestas correctas a dos preguntas distintas.
- Acuerden una definición escrita por indicador y hagan que cada informe diga cuál usa.
- Las diferencias de zona horaria solo aparecen en los cortes de día, y por eso cuesta reproducirlas.
- Las sincronizaciones fallidas son la causa costosa: construya reintentos, idempotencia, cola de fallidos y alertas, o se enterará en la conciliación.
- Investigue comparando conjuntos de registros, no totales: los totales esconden el patrón que revela la causa.
Referencias técnicas
- Stripe API: Idempotent requests
One concrete API design for safely retrying requests; behaviour varies by provider.
¿Preguntas o una corrección? Contacte con el equipo de 2M. Los ejemplos explican un método; los resultados dependen de su operación y configuración.
