Caso de datos / 03 · Writeback, frescura y activación

Devolver señales analíticas al CRM operativo

Un caso ficticio de arquitectura: copiar o consultar, granularidad del writeback, datos desactualizados, recálculos, bajas y quién responde de un writeback fallido.

Escenario ficticio

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

01El resultado

Un conjunto reducido de señales gobernadas y de solo lectura por cuenta —valor, segmento, fecha de referencia, versión y enlace a la definición— escritas de forma idempotente y conciliadas a diario con lo publicado.

La realidad

El rendimiento se calcula fuera del CRM, pero los comerciales actúan dentro, así que las cifras que ven están desactualizadas, se pueden editar o nadie las explica.

Pregunta de arquitectura

¿Debe el CRM guardar una copia de la métrica, y quién responde de ella cuando llega?

Decisión clave

Devolver al CRM señales gobernadas a nivel de cuenta, en lugar de consultar en directo o copiar todo el detalle de los KPI.

ContextoEl rendimiento de cada cuenta y la cobertura de pipeline se calculan a diario en la plataforma de datos. Los comerciales trabajan en el CRM y deberían actuar allí: abrir un plan de recuperación cuando una cuenta se queda atrás, generar pipeline cuando la cobertura es baja. El primer intento copió todo el detalle de los KPI en campos del CRM que los comerciales podían sobrescribir, sin fecha y sin enlace a la definición.

Sistemas y actoresPlataforma de datosCapa de integraciónCRM

02La realidad · situación actual

Qué hacen hoy los datos.

  • Los comerciales sobrescriben los valores derivados con los que no están de acuerdo
  • Nadie sabe si un valor es de hoy o del mes pasado
  • Un recálculo deja valores antiguos en cuentas que ya no son elegibles
  • Un writeback que falla en parte pasa desapercibido durante semanas
  • La automatización crea una nueva tarea de recuperación en cada ejecución nocturna

03Flujo objetivo

De dónde vienen los datos, adónde van… y cómo.

Cada traspaso se nombra con su modo. El modo sigue la tolerancia del negocio a la espera, a la inconsistencia y a la pérdida.

  • 01 · ERP · CRM · PlanificaciónFuentes

    Pedidos, facturas, pipeline y objetivos.

    Alimenta por Batch
  1. 02 · Plataforma de datosPlataforma de datos

    Histórico conformado por cuenta × mes.

    Traspasa por Batch
  2. 03 · Plataforma de datosKPI derivado

    Rendimiento frente a objetivo, cobertura: una definición cada uno.

    Traspasa por Batch
  3. 04 · Plataforma de datosSegmento

    En objetivo, Por debajo, En riesgo, Sin venta.

    Traspasa por API
  4. 05 · Integración → CRMWriteback al CRM

    Upsert por cuenta + versión de la métrica; campos de solo lectura.

    Traspasa por Evento
  5. 06 · Automatización del CRMAcción

    Una tarea de recuperación por cada entrada en En riesgo.

04Contratos

Qué significa una fila o un mensaje.

Significado, granularidad, clave, frescura y responsable, por escrito antes de mapear nada.

Contrato

Señal de rendimiento de la cuenta

El valor publicado de una métrica para una cuenta y un periodo.

Granularidad
Cuenta × métrica × periodo
Clave
Clave analítica de cliente + métrica + periodo + versión
Frescura
Diaria; desactualizada a las 48 horas
Responsable
Operaciones de ventas (definición) · equipo de datos (cálculo)
Contrato

Disparador de activación

Una cuenta ha entrado en un segmento que requiere una acción.

Granularidad
Cuenta × entrada en segmento
Clave
Cuenta + segmento + periodo de entrada
Frescura
En la hora siguiente al writeback
Responsable
Operaciones comerciales

05Dimensión clave · Writeback, frescura y activación

Un contrato de writeback, no una copia

Lo que llega al CRM es pequeño, de solo lectura y se describe a sí mismo. Su ciclo de vida es explícito, así que un valor desactualizado o sustituido se ve como tal.

  1. CalculadoDerivado en la plataforma de datos
  2. PublicadoLiberado como versión vigente
  3. EscritoUpsert en el CRM por clave
  4. RecibidoReleído y cotejado
  5. SustituidoReemplazado por una versión más reciente
  6. CaducadoHa superado su compromiso de frescura
Campos del contrato de writeback
CampoSignificadoRegla
ValorLa métrica publicada para esta cuenta y este periodoSolo lectura en el CRM; nunca se recalcula allí
SegmentoEn objetivo, Por debajo, En riesgo o Sin ventaExactamente uno por cuenta elegible
Fecha de referenciaPeriodo y momento del cálculoSe muestra junto al valor; desactualizado a las 48 horas
VersiónVersión de la métrica y de la regla que lo produjoUn recálculo publica una versión nueva; el CRM conserva la última
ElegibilidadSi la cuenta está en la poblaciónAl salir se escribe «no elegible», nunca un vacío silencioso
Enlace a la definiciónLinaje para el comercialAbre la definición, el responsable y las fuentes

Copiar la señal, consultar el detalle: los comerciales actúan sobre el valor en el CRM y siguen el enlace cuando necesitan las transacciones que hay detrás.

06Autoridad del dato

Quién puede crear, cambiar, leer o derivar cada concepto.

Resaltar
Autoridad sobre los datos por concepto de negocio: qué sistema puede crear, modificar, leer o derivar cada concepto
Concepto de negocioPlataforma de datosCapa de integraciónCRM
Rendimiento frente a objetivoSe deriva en la plataforma de datos; es de solo lectura en el CRM. Una discrepancia va al responsable de la definición, no al campo.DerivarSin autoridadLeer
Segmento de rendimientoDerivado de la métrica y publicado con la versión de su regla.DerivarSin autoridadLeer
Fecha de referencia y versiónSe sellan en el cálculo y viajan con cada valor.CrearLeerLeer
Estado de entrega del writebackResponde de él la capa que escribe; se concilia con lo publicado.LeerCrearModificarSin autoridad
Tarea de recuperaciónLa automatización del CRM la crea una vez por entrada en el segmento; la trabaja el comercial.Sin autoridadSin autoridadCrearModificar
Comentario del comercial sobre la señalEl contexto del comercial, junto al valor, nunca en su lugar.LeerSin autoridadCrearModificar

Aquí ningún sistema posee un registro completo. La autoridad reside en cada concepto y, a veces, cambia de manos cuando avanza el ciclo de vida.

07Fallo y recuperación

Diseñar el camino del fallo antes que el camino feliz.

  • El writeback se completa solo en partePublicado frente a escrito, por claveReenviar las claves que faltan; el upsert lo hace seguroOperaciones de integración
  • Los valores superan su compromiso de frescuraFecha de referencia de más de 48 horasMostrar «desactualizado» en el CRM y suspender las nuevas tareasEquipo de la plataforma de datos
  • Se recalcula la métricaNueva versión publicadaSobrescribir por versión; las tareas ya creadas no se duplicanOperaciones de ventas
  • Una cuenta sale de la poblaciónEstá en el CRM, no en la nueva publicaciónEscribir «no elegible» y cerrar los disparadores abiertosEquipo de la plataforma de datos

08Arquitecturas candidatas

Opciones creíbles, evaluadas frente a estas premisas.

Según el contexto

Consultar en directo desde el CRM

Usuarios que solo miran la cifra

Coste: No puede alimentar vistas de lista, asignaciones ni automatización; depende de que el servicio analítico esté disponible
Descartada

Copiar todo el detalle de los KPI en el CRM

Conjuntos de métricas pequeños y estables

Coste: Volumen, datos desactualizados y valores que nadie sabe explicar
Elegida

Devolver señales gobernadas a nivel de cuenta

Métricas que deben cambiar lo que hace un comercial

Coste: Requiere un contrato de writeback, reglas de frescura y conciliación

09La segunda capa

Preguntas que cambian el diseño.

Copiar o consultar

  1. ¿Debe copiarse la métrica o consultarse en directo?
  2. ¿Cuál es la granularidad del writeback?
  3. ¿Qué necesita el comercial junto a la cifra?

Frescura y cambios

  1. ¿Cómo se identifican los datos desactualizados?
  2. ¿Qué pasa cuando se recalcula la métrica de origen?
  3. ¿Cómo se trata un cero, o un «ya no es elegible»?

Responsabilidad

  1. ¿Quién responde de un writeback fallido?
  2. ¿Puede el CRM modificar el valor analítico?
  3. ¿Cómo se muestra el linaje al comercial?

10Decisiones y entregables

Qué produce el trabajo.

  1. 01Contrato de writeback
  2. 02Modelo de responsabilidad
  3. 03Regla de frescura y caducidad
  4. 04Conciliación entre publicado y escrito
  5. 05Regla de activación
  6. 06Enlace de linaje