Crear el cliente en el ERP de forma asíncrona
Proteger el flujo comercial de la latencia del ERP, con el estado pendiente y la recuperación explícitos.
Elaborado de forma independiente. No contiene detalles de implementación, nombres internos ni cifras de ningún empleador o cliente.
01Contexto
Una organización B2B global debe validar financieramente cada cliente nuevo en el ERP antes del primer pedido. Un día normal el ERP responde en segundos; en el cierre de mes, en las ventanas de mantenimiento o con latencia regional tarda minutos, o no responde. Si la aprobación comercial en el CRM espera esa respuesta, el vendedor se queda bloqueado o vuelve a pulsar; si no espera, alguien tiene que responder de lo que ocurre mientras el ERP no ha contestado.
02Factores de decisión
- F01
Un timeout nunca debe generar un segundo cliente legal
- F02
El vendedor necesita un estado sobre el que actuar mientras decide el ERP
- F03
El ERP sigue siendo el único que emite el número legal de cliente
- F04
Cada petición atascada necesita responsable, motivo y un reprocesamiento seguro
03Opciones consideradas
| Opción | Encaja cuando | Coste / contrapartida | Veredicto |
|---|---|---|---|
| Llamada síncrona a la API al aprobar | El ERP responde en segundos con alta disponibilidad y el volumen es bajo | La aprobación hereda las caídas y la latencia del ERP; tras un timeout, el usuario no sabe si volver a pulsar | Descartada |
| Comando asíncrono gestionado | La latencia del ERP varía y los resultados deben poder recuperarse sin el usuario | Pendiente pasa a ser un estado real: el CRM debe mostrarlo, alguien debe responder de él y los pedidos deben esperarlo | Elegida |
| Creación programada por lotes | Altas masivas en las que nadie hace pedidos el mismo día | Horas de retraso invisible; los rechazos llegan desligados de la aprobación que los originó | Descartada |
Cada opción es la adecuada con ciertas premisas. El veredicto se refiere al contexto descrito arriba.
04Decisión
Tras la aprobación comercial, el CRM congela los datos aprobados y publica un único comando de creación idempotente, con la petición de negocio como clave. La capa de integración lo valida, lo envía al ERP, persiste la correlación y el estado de entrega, y devuelve al CRM el resultado: creado, rechazado con motivo o desconocido. La entrada de pedidos solo se abre cuando el CRM tiene el número de cliente del ERP.
05Consecuencias
Lo que esta elección cambia en el resto del sistema.
- Estado de negocio
El CRM muestra Pendiente, Creado, Rechazado y Requiere intervención como estados de negocio, no como entradas de un log técnico.
- Idempotencia
La clave de la petición acompaña a cada reintento, así que un reprocesamiento nunca puede crear un segundo cliente.
- Recuperación
Un timeout se resuelve consultando la petición en el ERP antes de cualquier reintento (ADR 007); los usuarios nunca vuelven a pulsar Crear.
- Responsabilidad
Operaciones de plataforma responde de las peticiones envejecidas o atascadas; datos maestros, de los rechazos que puede corregir.
- Observabilidad
Las peticiones se vigilan por antigüedad y resultado en términos de negocio, no solo como llamadas fallidas.
- Entrada de pedidos
Los pedidos dependen del número de cliente del ERP, así que ninguno puede referirse a un cliente que quizá no exista.
06Cuándo revisarla
La decisión se sostiene mientras se mantenga su contexto. Hay que cuestionarla cuando:
El ERP ofrece un endpoint de creación idempotente que responde dentro de la propia aprobación, también en el cierre de mes.
La aprobación y la creación legal pasan a ser una sola decisión de un solo responsable, y el estado pendiente deja de significar algo.
La entrada de pedidos pasa al ERP, y el CRM ya no necesita saber cuándo existe el cliente.
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.
- 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.
- Caso de sistemas / 02Diseñar los límites entre sistemas detrás de una plataforma comercial globalDecidir qué plataforma posee cada capacidad comercial, y qué fronteras se mantienen aunque la experiencia parezca una sola aplicación.
- Caso de sistemas / 03Diseñar la identidad de cliente y de datos maestros entre CRM y ERPSeparar la identidad comercial, la legal y la transaccional —con un único emisor, una cardinalidad explícita y fusiones gobernadas— y asignar la autoridad a conceptos y atributos, no a registros completos.
08Decisiones relacionadas
Decisiones de las que depende o a las que condiciona.
- ADR / 007Tratar un resultado de integración incierto como desconocido, no como fallidoUn 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.
- ADR / 004Separar la aprobación comercial de la validación financieraDos decisiones con distintos responsables, evidencias y SLA no deben compartir un único paso de aprobación, aunque un mismo formulario recoja los datos de ambas.
- 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 / 005Separar la identidad comercial de la identidad legal del clienteUna cuenta es una relación comercial; una entidad legal es una organización registrada; un cliente del ERP es esa entidad en una de nuestras sociedades. Modelar tres identidades vinculadas, no un registro que signifique todo a la vez.