ADR / 008

Mantener la conciliación como control permanente, no como proceso de excepción

Las 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 de referencia

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

01Contexto

La creación de clientes, el estado de los pedidos y los segmentos de rendimiento circulan entre un CRM, un ERP y una plataforma de datos. Cada flujo tiene reintentos y alertas y, aun así, los usuarios descubren las diferencias meses después: clientes todavía pendientes en el CRM que ya existen en el ERP, segmentos que nunca se retiraron, una sociedad que falta en una carga de facturas.

02Factores de decisión

  1. F01

    Cualquier mecanismo de entrega puede perder, duplicar o desordenar

  2. F02

    Las diferencias que descubren los usuarios destruyen la confianza en los datos

  3. F03

    La corrección necesita un responsable, no un buzón compartido

  4. F04

    Las repeticiones y correcciones deben ser seguras

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
Comprobaciones puntuales cuando alguien se quejaFlujos de bajo volumen y poco riesgoLa divergencia se acumula sin que nadie la veaDescartada
Confiar en las garantías de entrega y las alertasFlujos con semántica exactly-once de extremo a extremoLas alertas ven llamadas fallidas, no registros que nunca llegaronDescartada
Conciliación programada con diferencias clasificadasCualquier flujo cuya divergencia tenga coste para el negocioRequiere claves de comparación, una tolerancia, una cadencia y responsablesElegida

Cada opción es la adecuada con ciertas premisas. El veredicto se refiere al contexto descrito arriba.

04Decisión

Para cada flujo cuya divergencia tenga coste para el negocio, definir un contrato de conciliación: la población esperada, la clave de comparación, los atributos comparados, la tolerancia, la cadencia y, para cada clase de diferencia (coincidencia, diferencia, ausente, inesperado), un responsable y una acción correctora. Ejecutarla de forma programada, publicar el resultado como medida del estado del negocio y hacer idempotente cada corrección para que repetirla nunca empeore las cosas.

05Consecuencias

Lo que esta elección cambia en el resto del sistema.

  1. Observabilidad

    La divergencia silenciosa se hace visible en un solo ciclo.

  2. Responsabilidad

    Cada clase de diferencia tiene responsable y acción; nada acaba en un buzón compartido.

  3. Medición

    Los resultados de la conciliación se miden como cualquier otro KPI del proceso.

  4. Diseño de la integración

    El diseño de la integración debe aportar claves de comparación estables desde el principio.

06Cuándo revisarla

La decisión se sostiene mientras se mantenga su contexto. Hay que cuestionarla cuando:

01

Un flujo pasa a ejecutarse dentro de un único sistema transaccional.

02

La divergencia en el flujo no tiene coste para el negocio.

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 datos / 03Llevar las señales analíticas de vuelta al CRM para la operaciónUn contrato de activación para señales analíticas: un conjunto reducido de valores y segmentos gobernados y de solo lectura a nivel de cuenta, con fecha de referencia, versión, procedencia y una salida explícita; publicado como el estado esperado completo, aplicado de forma idempotente y reconciliado con lo que el CRM tiene realmente.Datos e IntegracionesRevenue OperationsAutomatizaciónCaso de arquitectura · 11 min
  2. Caso de automatización / 02Diseñar una automatización de ciclo cerrado desde la señal hasta la acción y la salidaLa automatización como mantenimiento de un estado esperado aguas abajo: entrada, actualización, salida y reentrada diseñadas por transición; el trabajo gestionado por el sistema, separado del que pertenece a las personas; repeticiones que convergen en lugar de sumar, y la conciliación como bucle de control que solo repara lo que es seguro reparar.AutomatizaciónRevenue OperationsDatos e IntegracionesCaso de arquitectura · 11 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 / 010Automatizar las salidas, no solo las entradasToda automatización que crea trabajo cuando un registro entra en un estado debe definir también qué ocurre cuando sale de él; si no, el estado posterior queda obsoleto.Patrón propuestoAutomatización · RevOps · Datos
  3. 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
  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