## Problema a resolver

Sincronizar eventos de facturación y estado financiero entre Beacon y ERP sin duplicaciones ni pérdida de contexto.

## Patrón recomendado

- Beacon como source-of-truth de eventos operacionales.
- ERP como source-of-truth contable consolidado.
- Integración orientada a eventos con conciliación periódica.

## Modelo de datos de integración

| Campo | Origen | Objetivo |
| --- | --- | --- |
| `eventId` | Beacon webhook/event | Detección de duplicados |
| `organizationId` | Beacon | Aislamiento multi-tenant |
| `externalReference` | ERP | Conciliación bidireccional |
| `status` | Ambos | Gestión de divergencias |

## Estrategia de robustez

<Steps>
  <Step title="1) Ingesta idempotente">Usa clave técnica por evento para evitar escrituras dobles en ERP.</Step>
  <Step title="2) Retry con backoff">Reintenta fallos transitorios con límites y telemetría.</Step>
  <Step title="3) Conciliación diaria">Compara totales y estados por período para cerrar divergencias.</Step>
  <Step title="4) Cola de excepciones">Envía casos no automatizables a triage manual.</Step>
</Steps>

<Tip title="Escalabilidad">Cuando el volumen sube, separa colas por dominio (billing, reembolsos, fiscal) para reducir blast radius.</Tip>