Tratar un resultado de integración incierto como desconocido, no como fallido
Un timeout no dice nada sobre si el receptor confirmó la operación. Modelar ‘desconocido’ como estado propio, resolverlo por clave de petición y solo entonces reintentar o darlo por fallido.
Elaborado de forma independiente. No contiene detalles de implementación, nombres internos ni cifras de ningún empleador o cliente.
01Contexto
Un CRM envía peticiones de creación de clientes y de pedidos a un ERP a través de una capa de integración. Con carga, algunas llamadas agotan el tiempo de espera cuando el ERP ya ha confirmado la operación. La integración las marca como fallidas; los usuarios o los reintentos automáticos las reenvían, y aparecen clientes legales y pedidos duplicados. Otros timeouts sí son fallos reales, y para quien llama ambos casos son idénticos.
02Factores de decisión
- F01
Deshacer un cliente legal duplicado es caro
- F02
Los usuarios necesitan un estado honesto mientras el resultado es incierto
- F03
Se puede consultar al receptor por una clave de petición externa
- F04
Los fallos transitorios siguen necesitando reintentos
03Opciones consideradas
| Opción | Encaja cuando | Coste / contrapartida | Veredicto |
|---|---|---|---|
| Tratar el timeout como fallo y reintentar | Receptores idempotentes por diseño | Un duplicado cada vez que el receptor ya había confirmado | Descartada |
| Timeouts más largos y una comprobación manual antes de reintentar | Volúmenes bajos, en los que un operador puede revisar cada timeout | Los usuarios esperan más para la misma incertidumbre; las comprobaciones manuales no escalan ni dejan estado | Descartada |
| Un estado Desconocido, resuelto por clave de petición | Receptores que no son idempotentes, o no del todo | Requiere una clave de petición consultable, un proceso de resolución y un responsable | Elegida |
Cada opción es la adecuada con ciertas premisas. El veredicto se refiere al contexto descrito arriba.
04Decisión
Cada petición saliente lleva una clave de idempotencia ligada a la petición de negocio y un ID de correlación. Un timeout o una respuesta perdida pasa la petición a Desconocido, no a Fallido. Antes de cualquier reintento, la capa de integración busca la petición en el receptor por su clave: si aparece, se confirma; si no, se reintenta con la misma clave; si sigue sin resolverse agotado el presupuesto de reintentos, se escala a un responsable con nombre. Los usuarios ven “confirmando el resultado”, nunca una invitación a pulsar el botón otra vez.
05Consecuencias
Lo que esta elección cambia en el resto del sistema.
- Estado de negocio
Desconocido pasa a ser un estado de negocio monitorizado, con antigüedad y responsable.
- Idempotencia
Los reintentos son seguros: la misma clave no puede crear dos veces.
- Conciliación
La conciliación cierra los Desconocidos que el proceso de resolución no puede cerrar.
- Contrato de integración
El receptor debe permitir la consulta por clave de petición externa, o la capa de integración mantiene un registro de lo enviado.
06Cuándo revisarla
La decisión se sostiene mientras se mantenga su contexto. Hay que cuestionarla cuando:
El receptor garantiza la creación idempotente por clave.
La operación pasa a ser de solo lectura o idempotente por naturaleza.
07Dónde se aplica esta decisión
La decisión explica por qué se eligió este camino; cada caso muestra cómo forma parte de una arquitectura más amplia.
08Decisiones relacionadas
Decisiones de las que depende o a las que condiciona.
- ADR / 001Crear el cliente en el ERP de forma asíncronaProteger el flujo comercial de la latencia del ERP, con el estado pendiente y la recuperación explícitos.
- ADR / 008Mantener la conciliación como control permanente, no como proceso de excepciónLas garantías de entrega fallan en silencio. Una comparación programada entre las poblaciones esperada y real, con un responsable para cada tipo de diferencia, forma parte de la arquitectura; no es una limpieza.
- ADR / 003Usar código en las fronteras de orquestaciónMantener declarativas las reglas locales y transparentes; llevar la orquestación con estado y entre sistemas detrás de fronteras de servicio probadas.