Reconciliación y SLA
Cómo validar órdenes contra archivos de billing y monitorear la salud de fuentes de datos en Relo.
Reconciliación y SLA
La reconciliación compara las órdenes que Relo rastreó (AppsFlyer, pixel, etc.) contra el archivo de billing que envía la marca. El objetivo es detectar diferencias antes de facturar o pagar comisiones.
La vista vive en /v2/c/:slug/reconciliation y tiene dos tabs:
- Ledger — revisión fila por fila y carga de billing files.
- SLA — salud agregada del cliente y frescura de fuentes.
Flujo de reconciliación
Cómo funciona el match
Relo cruza el archivo de billing contra eventos en ClickHouse. Cada fila queda con un status:
| Status | Significado | Acción típica |
|---|---|---|
| matched | Orden y monto coinciden. | Ninguna. |
| pending | Aún no se revisa automáticamente. | Esperar o forzar re-run. |
| orphan | Está en el billing pero no fue rastreada por Relo. | Revisar atribución o hueco de ingesta. |
| inflated | Relo reportó más de lo que la marca pagará. | Revisar duplicados o revenue mal parseado. |
| deflated | Relo reportó menos de lo que la marca pagará. | Revisar eventos faltantes o filtros. |
| missing | Está rastreada por Relo pero no aparece en el billing. | Puede ser orden cancelada/devuelta. |
Tab Ledger
KPIs superiores
| KPI | Qué indica |
|---|---|
| Awaiting check | Filas pendientes de auto-match. |
| Verified & matching | Filas que ya coinciden. |
| Mismatches found | Suma de orphan + inflated + deflated + missing. |
| Validation pass rate | % de filas auto-matched. |
Mismatches
Lista paginada de filas con problema. Puedes filtrar por status y buscar por order ID. Cada fila muestra:
- Order ID
- Partner atribuido
- Amount (del billing)
- Difference (delta)
- Status
- Date
- Reglas aplicadas (reclassify / filter)
Subir billing file
- Ve al tab Ledger → Upload billing file.
- Arrastra o selecciona el archivo (CSV/XLSX, máx 100MB).
- Selecciona el source type:
samsung_xlsxcsv_genericshopify_csv
- Haz clic en Upload to backbone.
- El backbone parsea, escribe
client_ledger_ordersy corre auto-match. - Vuelve al tab Mismatches para ver el resultado.
Reprocesar el mismo periodo
Re-subir el mismo archivo sobreescribe las filas existentes. Es seguro correrlo varias veces.
Tab SLA
El SLA dashboard responde la pregunta: ¿todo está bien con este cliente?
Niveles de SLA
| Nivel | Drift % | Significado |
|---|---|---|
| Green | < 1% | Ledger y tracking alineados. |
| Yellow | 1% – 5% | Hay drift, conviene revisar. |
| Red | ≥ 5% | Diferencia crítica, no facturar sin revisar. |
KPIs del SLA
| KPI | Descripción |
|---|---|
| Reconciled rows | Total de filas en la ventana. |
| Gross revenue | Revenue del ledger. |
| Total delta | Diferencia neta (positiva = over-reported, negativa = under-reported). |
| Drift % | Delta / gross revenue. |
Status breakdown
Cards con count, gross y delta por status: matched, deflated, inflated, orphan, missing, pending.
Open suspicious
Número de eventos marcados por el motor de fraude que aún no se revisan. Si es > 0, ve a Fraud Review.
Daily drift
Gráfico de barras que muestra día a día si Relo reportó más (rojo) o menos (verde) que el ledger.
Ledger sources
Tabla de fuentes de ledger configuradas para el cliente:
| Columna | Significado |
|---|---|
| Source | Nombre descriptivo. |
| Type | Tipo de fuente. |
| Status | Último resultado (success / error). |
| Last run | Última ejecución. |
| Age | Tiempo desde la última ejecución. |
| Last error | Mensaje de error si falló. |
Una fuente se marca Stale si tiene schedule_cron configurado pero no corre hace más de 24h.
Acciones comunes
| Tarea | Dónde |
|---|---|
| Subir billing file | Ledger → Upload billing file |
| Revisar filas con problema | Ledger → Mismatches |
| Ver salud general | SLA |
| Ver drift histórico | SLA → Daily drift |
| Revisar fuentes stale | SLA → Ledger sources |
| Investigar fraude | Fraud Review (/v2/c/:slug/fraud-review) |
Troubleshooting
| Problema | Causa probable | Solución |
|---|---|---|
Muchos orphan | Hueco en ingesta o atribución mal configurada | Revisa pulls de AppsFlyer / pixel events. |
Muchos inflated | Duplicados o revenue mal parseado | Revisa event_value y deduplicación. |
Muchos deflated | Eventos rastreados no llegan al ledger | Verifica que el archivo de billing incluya todas las órdenes. |
| Fuente stale | El cron no corrió o falló | Revisa logs del backbone y re-procesa. |
| Drift crítico | Cambio reciente en reglas o fuente | Revisa actividad reciente y re-corre reconciliación. |
Ver también
- Admin Fraud Quality — Revisión de eventos sospechosos.
- Admin Data — Fuentes de datos y pipelines.
- Admin Payments — Cierre mensual basado en datos validados.