Caso de arquitectura / 001 · Arquitectura de sistemas

Diseñar el ciclo de vida del cliente entre CRM y ERP.

Una arquitectura basada en premisas para una empresa B2B global ficticia: de la intención comercial a un cliente legalmente válido y operativamente recuperable.

Escenario ficticio

Elaborado de forma independiente. No contiene detalles de implementación, nombres internos ni cifras de ningún empleador o cliente.

01El resultado

La integración no es la arquitectura.

Una empresa B2B global quiere que el CRM «cree clientes en el ERP». La frase esconde tres identidades distintas, dos fronteras de aprobación y un estado de fallo que puede interrumpir los ingresos.

Resultado buscado

Convertir una intención comercial aprobada en un cliente legal al que se le pueda vender, sin duplicar la identidad ni hacer depender a los usuarios de la disponibilidad del ERP.

Decisión clave

Usar un comando asíncrono e idempotente, con estados explícitos de pendiente y de intervención en el CRM.

Principio rector

El ERP controla el alta legal. El CRM posee el ciclo de vida comercial. La capa de integración posee el estado de entrega, no la verdad de negocio.

La cara de proceso de este ciclo de vidaCaso 002 — Diseñar un modelo operativo global de lead a cliente

02Premisas y restricciones

Explicitar qué debe ser cierto antes de elegir.

La recomendación solo es válida para este conjunto de premisas. Si cambian las premisas, la respuesta debe poder cambiar.

  1. 01
    Operación global

    Varias filiales comparten cuentas comerciales, pero operan a través de registros de cliente legal distintos.

  2. 02
    Control financiero

    La validación del ERP es obligatoria antes de un pedido; puede rechazar datos fiscales, de crédito o de sociedad.

  3. 03
    Disponibilidad variable

    El ERP tiene paradas de mantenimiento planificadas y tiempos de respuesta no deterministas entre regiones.

  4. 04
    Responsabilidad humana

    Un aprobador comercial confirma que todo está listo; operaciones es responsable de las excepciones de integración sin resolver.

Supuesto a cuestionar
«El cliente es del ERP.»

El ERP posee la identidad legal y transaccional del cliente. El CRM puede seguir poseyendo la identidad del prospecto, el contexto de la relación y el estado comercial. La autoridad es una matriz, no un trofeo que se entrega a un sistema.

03La segunda capa

Lo que «crear cliente» deja sin decir.

  1. P01

    ¿Qué existe antes del ID del ERP?

  2. P02

    ¿Pueden dos filiales compartir una parte pero no un número de cliente?

  3. P03

    ¿Un timeout significa fallo o un resultado desconocido?

  4. P04

    ¿Quién puede editar los datos fiscales tras el alta?

  5. P05

    ¿Qué bloquea el primer pedido mientras el estado está pendiente?

  6. P06

    ¿Cómo reenvía soporte sin crear un duplicado?

  7. P07

    ¿Qué ve el comercial cuando el ERP no está disponible?

  8. P08

    ¿Qué evento hace que la analítica cuente un cliente activo?

04Identidad y fronteras

Una empresa. Tres identidades útiles.

Identidad comercial

Cuenta

Relación, pipeline e intención. Se crea pronto; autoridad del CRM.

Identidad legal

Parte

Organización registrada e identidad fiscal. Se valida antes de operar.

Identidad transaccional

Cliente

Contexto de sociedad, área de ventas y pago. Autoridad del ERP.

Vista de referencia / alta de clientes
Alta de clientes: el usuario comercial aprueba en el CRM; el CRM envía un comando a la capa de integración, que crea el cliente en el ERP; el resultado y el estado vuelven; los eventos llegan a la plataforma de datos.ApruebaComandoAltaResultadoEstadoEventoPERSONAUsuario comercialCOMERCIALCRMPLATAFORMACapa de integraciónFINANZASERPDATOSPlataforma de datos

Pasa el cursor o el foco por un sistema para ver qué posee, qué no y en qué flujos participa.

Llamada síncronaComando o evento gestionadoResponsable indicado en cada nodo

05Arquitecturas candidatas

Tres diseños pueden funcionar. Solo uno encaja con estas premisas.

Comparación de arquitecturas candidatas. Selecciona una opción para ver sus consecuencias.
Dimensión de decisión
Espera del usuarioBloqueado por el ERPLa aprobación terminaLa aprobación termina
Recuperación ante fallosEl usuario reintentaReenvío gestionadoSiguiente batch
ConsistenciaInmediataEventual y visibleDiferida
Carga operativaBaja al principioResponsable explícito de la colaIntensiva en conciliación
Encaja mejor conDependencia estable y rápidaOperación global variablePoca urgencia, volumen
Si eligesComando asíncrono
Encaja cuando

Latencia variable entre regiones y un proceso que puede continuar mientras se completa el alta legal.

Consecuencias
  • El CRM debe mostrar Pendiente, Creado y Requiere intervención como estados reales.
  • Soporte es responsable de una cola de reenvío con códigos de motivo.
  • La entrada de pedidos queda bloqueada hasta tener el número canónico del ERP.

La opción asíncrona no es «más moderna» por sí misma. Encaja porque la aprobación de negocio debe seguir siendo ágil mientras el alta legal es recuperable y observable de forma independiente.

06Diseño recomendado

Confirmar la intención. Conciliar el resultado.

  1. 01Aprobación comercial
  2. 02Comando de alta
  3. 03Validación en el ERP
  4. 04Evento de resultado
  5. 05Listo para pedir
  1. Congelar los datos del alta.

    Al aprobar, el CRM crea una instantánea inmutable de la petición y una clave de idempotencia acotada a la entidad jurídica.

  2. Aceptar; no fingir que ha terminado.

    La frontera de integración confirma la recepción duradera. El CRM pasa a Creation pending: nada de falsos éxitos.

  3. Resolver los resultados inciertos.

    Antes de reintentar tras un timeout, consultar el ERP por la clave externa de la petición. Un éxito tardío nunca debe convertirse en un duplicado.

  4. Publicar un resultado legible para el negocio.

    El éxito lleva los identificadores canónicos. El rechazo lleva códigos de motivo estables y un responsable de la reparación, no una traza de error.

07Semántica de fallos

Diseñar la ruta de recuperación antes que la ruta feliz.

EscenarioRespuesta del sistemaExperiencia de la persona
Rechazo en la validaciónRegistrar el motivo final; no reintentarCorregir los datos gobernados y reenviar
Timeout / resultado desconocidoConciliar por clave de petición antes de reenviarSigue pendiente; se muestra la última comprobación
Transporte no disponibleEsperar, reintentar y, si no, cola de mensajes fallidosNo hay que repetir ninguna acción
Candidato a duplicadoPausar para una revisión determinista de coincidenciasOperaciones acepta o rechaza la coincidencia
Fallo en la respuesta al CRMReenviar el resultado de forma idempotenteEl ID del ERP aparece tras la recuperación
Innegociable

Nunca pedir a un usuario que resuelva el resultado incierto de un sistema distribuido pulsando otra vez «Crear».

08Modelo operativo

El modelo de soporte forma parte del diseño.

Operaciones comerciales

Responsable de que el proceso esté listo, de la política de aprobación y de la comunicación con los comerciales.

Datos maestros / Finanzas

Responsable de las reglas de validación legal, la resolución de duplicados y los atributos transaccionales.

Operaciones de plataforma

Responsable de la salud del transporte, los controles de reenvío, la correlación y la telemetría de nivel de servicio.

Observar el estado del negocio, no solo la infraestructura.

  • Peticiones pendientes más allá de la latencia regional esperada
  • Tasa de rechazo por motivo de negocio estable
  • Resultados desconocidos a la espera de conciliación
  • Antigüedad de las intervenciones manuales y equipo responsable
  • Candidatos a duplicado y tiempo de resolución

09Cuándo decidiría distinto

La arquitectura debe moverse cuando se mueve el contexto.

Elegir síncrono

Si el ERP ofrece un alta determinista, idempotente y de alta disponibilidad, y los usuarios no pueden avanzar de forma útil sin su resultado inmediato.

Elegir batch

Si el alta no tiene urgencia operativa en el mismo día, los volúmenes son altos y el negocio ya trabaja en ventanas controladas de datos maestros.

Mover la autoridad

Si un servicio corporativo de datos maestros pasa a ser el emisor gobernado de la identidad de la parte para el CRM y el ERP.

Principio transferibleNo modelar la disponibilidad de un sistema como verdad de negocio. Modelar por separado la intención, el avance y el resultado.
Registro de decisión · ADR 001Crear el cliente en el ERP de forma asíncronaRegistro de decisión · ADR 005Separar la identidad comercial de la identidad legal del clienteArquitectura de Sistemas y CRM · uno de seis casosVariación regional controlada, oportunidades con varias modalidades comerciales, identidad del cliente, acceso y visibilidadDatos e Integraciones · cinco casos relacionadosGranularidad e inteligencia comercial, writeback de KPI, conciliación de la segmentación, evolución multidivisa