## Problema a resolver

Sincronizar eventos de faturação e estado financeiro entre Beacon e ERP sem duplicações nem perda de contexto.

## Padrão recomendado

- Beacon como source-of-truth de eventos operacionais.
- ERP como source-of-truth contabilístico consolidado.
- Integração orientada a eventos, com reconciliação periódica.

## Modelo de dados de integração

| Campo | Origem | Objetivo |
| --- | --- | --- |
| `eventId` | Beacon webhook/event | Deteção de duplicados |
| `organizationId` | Beacon | Isolamento multi-tenant |
| `externalReference` | ERP | Reconciliação bidirecional |
| `status` | Ambos | Gestão de divergências |

## Estratégia de robustez

<Steps>
  <Step title="1) Ingestão idempotente">Usa chave técnica por evento para evitar escrita dupla no ERP.</Step>
  <Step title="2) Retry com backoff">Reenvia falhas transitórias com limite e telemetria.</Step>
  <Step title="3) Reconciliação diária">Compara totais e estados por período para fechar divergências.</Step>
  <Step title="4) Fila de exceções">Encaminha casos sem mapeamento automático para triagem manual.</Step>
</Steps>

<Tip title="Escalabilidade">Quando o volume aumenta, separa filas por domínio (billing, reembolsos, fiscal) para reduzir blast radius.</Tip>