Sign in →

ERP Sync

Automatically sync invoices to QuickBooks, Xero, NetSuite, or any custom webhook endpoint with full audit trail.

Updated 2026-06-15Suggest edits

ERP Sync

ERP Sync automatically pushes finalized Aforo invoices to your accounting system. Aforo supports four connectors out of the box and a custom webhook adapter for any other system.

Supported Connectors

ERPAuthInvoice Format
QuickBooks OnlineOAuth 2.0QBO Invoice API
XeroOAuth 2.0 + PKCEXero Invoice API
NetSuiteToken-Based Auth (TBA)NetSuite REST API
Custom WebhookHMAC-SHA256 signedYour format

Connecting an ERP

  1. Go to Pricing Studio → Invoices → ERP Sync
  2. Click + Connect ERP
  3. Select your ERP provider
  4. Complete the OAuth flow (or enter credentials for NetSuite)
  5. Aforo runs a test sync to verify the connection

Only one ERP can be connected at a time by default. Enable Multi-ERP mode in Settings → Billing → Advanced if you need simultaneous sync to multiple systems (e.g. QuickBooks for US entity + Xero for UK entity).

Sync Behavior

  • Automatic — Every invoice is synced within 60 seconds of finalization
  • Retry — Failed syncs are retried 3 times with exponential backoff
  • Idempotent — Re-syncing a previously synced invoice updates the existing record, not a duplicate

Sync Log

The sync log records every sync attempt with:

  • Timestamp
  • Invoice ID
  • Status (SUCCESS / FAILED)
  • Provider response code
  • Error details (for failures)

Filter the sync log by date range, status, or invoice ID.

Manual Sync

Trigger a manual sync for a specific invoice if automatic sync failed:

Custom Webhook Adapter

Send invoices to any HTTP endpoint in your format. Configure:

  • Endpoint URL — your receiving webhook URL
  • Signing secret — Aforo sends an X-Aforo-Signature header (HMAC-SHA256)
  • Payload template — transform the Aforo invoice to your format (JSON path mapping)

Your endpoint must return 2xx to mark the sync successful. Any other response triggers retry.

Disconnecting an ERP

Disconnecting stops automatic sync immediately. Previously synced invoices remain in your ERP. You can reconnect or switch to a different provider at any time.

Disconnecting an ERP does not delete synced data from the ERP system. It only stops future syncs.