ADR / 001

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.

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

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

  1. F01

    Un timeout nunca debe generar un segundo cliente legal

  2. F02

    El vendedor necesita un estado sobre el que actuar mientras decide el ERP

  3. F03

    El ERP sigue siendo el único que emite el número legal de cliente

  4. F04

    Cada petición atascada necesita responsable, motivo y un reprocesamiento seguro

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
Llamada síncrona a la API al aprobarEl ERP responde en segundos con alta disponibilidad y el volumen es bajoLa aprobación hereda las caídas y la latencia del ERP; tras un timeout, el usuario no sabe si volver a pulsarDescartada
Comando asíncrono gestionadoLa latencia del ERP varía y los resultados deben poder recuperarse sin el usuarioPendiente pasa a ser un estado real: el CRM debe mostrarlo, alguien debe responder de él y los pedidos deben esperarloElegida
Creación programada por lotesAltas masivas en las que nadie hace pedidos el mismo díaHoras 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.

  1. 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.

  2. Idempotencia

    La clave de la petición acompaña a cada reintento, así que un reprocesamiento nunca puede crear un segundo cliente.

  3. 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.

  4. Responsabilidad

    Operaciones de plataforma responde de las peticiones envejecidas o atascadas; datos maestros, de los rechazos que puede corregir.

  5. Observabilidad

    Las peticiones se vigilan por antigüedad y resultado en términos de negocio, no solo como llamadas fallidas.

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

01

El ERP ofrece un endpoint de creación idempotente que responde dentro de la propia aprobación, también en el cierre de mes.

02

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.

03

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.

  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
  2. 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.Arquitectura de Sistemas y CRMDatos e IntegracionesModelo Operativo DigitalCaso de arquitectura · 10 min
  3. 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.Arquitectura de Sistemas y CRMDatos e IntegracionesArquitectura de ProcesosCaso de arquitectura · 9 min

Decisiones de las que depende o a las que condiciona.

  1. 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.Patrón propuestoIntegración · Resiliencia · ERP
  2. 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.Patrón propuestoProcesos · Gobierno · ERP
  3. 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
  4. 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.Patrón propuestoIdentidad · CRM · ERP