Padrões de sync ERP
Estratégias de integração entre Beacon e ERP com consistência eventual controlada.
explanation • updated 2026-03-15
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
11) Ingestão idempotente
Usa chave técnica por evento para evitar escrita dupla no ERP.22) Retry com backoff
Reenvia falhas transitórias com limite e telemetria.33) Reconciliação diária
Compara totais e estados por período para fechar divergências.44) Fila de exceções
Encaminha casos sem mapeamento automático para triagem manual.