ADR / 007

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.

Patrón de referencia

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

  1. F01

    Deshacer un cliente legal duplicado es caro

  2. F02

    Los usuarios necesitan un estado honesto mientras el resultado es incierto

  3. F03

    Se puede consultar al receptor por una clave de petición externa

  4. F04

    Los fallos transitorios siguen necesitando reintentos

03Opciones consideradas

Opciones consideradas: cuándo sería cada una la elección adecuada, qué cuesta y el veredicto con estas premisas
OpciónEncaja cuandoCoste / contrapartidaVeredicto
Tratar el timeout como fallo y reintentarReceptores idempotentes por diseñoUn duplicado cada vez que el receptor ya había confirmadoDescartada
Timeouts más largos y una comprobación manual antes de reintentarVolúmenes bajos, en los que un operador puede revisar cada timeoutLos usuarios esperan más para la misma incertidumbre; las comprobaciones manuales no escalan ni dejan estadoDescartada
Un estado Desconocido, resuelto por clave de peticiónReceptores que no son idempotentes, o no del todoRequiere una clave de petición consultable, un proceso de resolución y un responsableElegida

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.

  1. Estado de negocio

    Desconocido pasa a ser un estado de negocio monitorizado, con antigüedad y responsable.

  2. Idempotencia

    Los reintentos son seguros: la misma clave no puede crear dos veces.

  3. Conciliación

    La conciliación cierra los Desconocidos que el proceso de resolución no puede cerrar.

  4. 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:

01

El receptor garantiza la creación idempotente por clave.

02

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.

  1. Caso de sistemas / 01Diseñar el ciclo de vida del cliente entre CRM y ERPUna arquitectura basada en premisas: de la intención comercial a un cliente legalmente válido y operativamente recuperable.Arquitectura de Sistemas y CRMDatos e IntegracionesArquitectura de ProcesosCaso de arquitectura · 18 min

Decisiones de las que depende o a las que condiciona.

  1. 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.Patrón propuestoIntegración · ERP · Resiliencia
  2. 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.Patrón propuestoIntegración · Datos · Gobierno
  3. 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.Patrón propuestoAutomatización · Gobierno · Integración