Beacon

ERP sync patterns

View as Markdown

ERP sync patterns

Integration strategies between Beacon and ERP with controlled eventual consistency.

explanation • updated 2026-03-15

Problem to solve

Synchronize billing events and financial state between Beacon and ERP without duplication or context loss.

  • Beacon as source-of-truth for operational events.
  • ERP as source-of-truth for consolidated accounting.
  • Event-driven integration with scheduled reconciliation.

Integration data model

FieldOriginPurpose
eventIdBeacon webhook/eventDuplicate detection
organizationIdBeaconMulti-tenant isolation
externalReferenceERPBidirectional reconciliation
statusBothDivergence handling

Reliability strategy

  1. 11) Idempotent ingestion

    Use a technical key per event to prevent double writes in ERP.
  2. 22) Retry with backoff

    Retry transient failures with limits and telemetry.
  3. 33) Daily reconciliation

    Compare totals and statuses per period to close divergences.
  4. 44) Exception queue

    Route non-automatable cases for manual triage.