Skip to content

INTEGRATIONS

Accounting Integrations

Connect Beeswax to external accounting software.

Overview

Accounting Integrations allow you to connect Beeswax to external accounting software so your invoices, expenses, contacts, and chart of accounts stay synchronised across both platforms.

Key features:

  • Xero integration — Connect your Xero organisation to automatically sync finalised invoices and expenses.
  • OAuth2 authentication — Secure connection using industry-standard OAuth2 (no passwords stored).
  • Automatic sync — Finalised invoices and expenses are periodically pushed to your connected accounting platform.
  • Payment webhooks — Payments recorded in Xero are automatically reflected in Beeswax.
  • Account mapping — Map your Beeswax transaction accounts to their Xero equivalents for accurate categorisation.
  • Contact sync — Company/contact information is sent to Xero when invoices or expenses are synced.
  • Stripe online invoice payments — Connect your own Stripe account so clients can pay invoices online by card, straight from the invoice email.

Note: Accounting integrations are included with every paid plan and during the trial.


Connecting to Xero

To connect your Xero account:

  1. Navigate to user menu > Connected Apps.
  2. Click Connect to Xero.
  3. A Xero login window will open — sign in and authorise Beeswax to access your organisation.
  4. Once authorised, the window closes and your connection status updates automatically.

What Happens on Connection

  • Beeswax stores an OAuth2 access token and refresh token (valid for 60 days).
  • Tokens are automatically refreshed before they expire.
  • The name of the connected Xero organisation is displayed on the integration settings page.

Requirements

  • You must have an active Xero account and organisation.
  • Only Owners and Super Admins can connect or disconnect integrations.
  • Your account must be on a paid plan (or an active trial).

How Syncing Works

Once connected, Beeswax periodically syncs your financial data to Xero.

What Gets Synced

  • Invoices — Finalised invoices are pushed to Xero as Accounts Receivable (ACCREC) invoices.
  • Expenses — Finalised expenses are pushed to Xero as Accounts Payable (ACCPAY) bills.
  • Contacts — Company details are created or updated in Xero when their invoices or expenses sync.
  • Transaction accounts — Beeswax accounts are mapped to Xero accounts for correct categorisation.

Sync Behaviour

  • Only entries modified since the last successful sync are processed (incremental sync).
  • Draft entries are never synced — only finalised, sent, or approved entries.
  • By default, only outstanding (unpaid) entries are synced. Enable the Sync Paid toggle on the Xero card (user menu > Connected Apps) to also include paid and partially paid invoices and expenses.
  • Entries are processed in batches to ensure reliability.
  • The sync timestamp updates after each successful batch.
  • Original modification timestamps are preserved to prevent sync loops.

Duplicate Prevention

The system uses two methods to prevent duplicate entries in Xero:

  1. Resource ID check — Looks for an existing mapping between the Beeswax entry and a Xero invoice.
  2. URL-based check — Searches Xero for invoices that reference the Beeswax entry ID.

If a valid, non-voided invoice is found in Xero, the entry is skipped.


Payment Webhooks

When a payment is recorded against an invoice or expense in Xero, Beeswax automatically receives a webhook notification and creates a corresponding payment record.

How It Works

  1. Xero sends a webhook event to Beeswax when an invoice is updated or a payment is created.
  2. Beeswax validates the webhook signature using HMAC-SHA256.
  3. The system finds the corresponding Beeswax entry via the Xero invoice mapping.
  4. A payment is created in Beeswax with the correct amount, date, and bank account.

Payment Matching

  • The system attempts to map the Xero bank account to a Beeswax bank account.
  • If no bank account mapping exists, the payment is skipped and Owners, Super Admins, and Accountants are notified. Beeswax no longer falls back to a default bank account for Xero payments.
  • Duplicate payments are prevented by checking the Xero payment ID first, then the amount and date when needed.
  • Foreign-currency payments use the exchange rate supplied on the Xero payment when available.
  • If the Xero payment amount exceeds the remaining balance in Beeswax, a notification is sent.

Account Mapping

For accurate financial categorisation, you should map your Beeswax transaction accounts to their Xero equivalents.

How to Map Accounts

  1. Navigate to the Chart of Accounts page.
  2. Click the Xero mapping icon next to any account.
  3. Select the corresponding Xero account from the dropdown.
  4. The mapping is saved immediately.

Bank accounts can also be mapped from their bank account detail page. This mapping is required for Xero payment webhooks because Beeswax must know which local bank account received or paid the money.

Mapping Rules

  • Asset accounts map to Xero BANK, CURRENT, EQUITY, FIXED, INVENTORY, NONCURRENT, and PREPAYMENT types.
  • Expense accounts map to Xero DEPRECIATN, DIRECTCOSTS, EXPENSE, and OVERHEADS types.
  • Income accounts map to Xero OTHERINCOME, REVENUE, and SALES types.
  • Loan (liability) accounts map to Xero CURRLIAB, LIABILITY, and TERMLIAB types.

Unmapped Accounts

If an invoice or expense uses a Beeswax account that has no Xero mapping, the system falls back to a default account and sends an email notification so you can correct the mapping.


Sync History

You can view the history of synced entries from user menu > Connected Apps.

The sync history table shows:

  • Document number — The Beeswax invoice or expense number.
  • Type — Invoice or Expense.
  • Title — The document title.
  • Sync status — Whether the entry was successfully synced.
  • Xero ID — The corresponding Xero invoice ID.
  • Date created — When the sync occurred.
  • Total amount — The document total.

The list supports infinite scroll for large sync histories.


Error Handling & Notifications

The integration sends email notifications for scenarios that require your attention:

  • Missing account mapping — A transaction account was not mapped to Xero; the default account was used instead.
  • Unmapped Xero bank account — A payment webhook referenced a Xero bank account that is not mapped to a Beeswax bank account. The payment is skipped until the bank account is mapped.
  • Payment mismatch — A payment received from Xero exceeds the remaining balance on the Beeswax entry.
  • Manual intervention required — A paid or locked invoice in Xero cannot be updated automatically.
  • API errors — Authentication failures or Xero API errors requiring reconnection.
  • Voided invoice replacement — An expense with a voided Xero invoice was automatically replaced with a new one.

Manual Intervention

Some scenarios require manual action:

  • Paid invoices — Cannot be updated in Xero once marked as paid. These are flagged for manual review.
  • Voided sales invoices (ACCREC) — Due to Xero's unique invoice number requirement, voided sales invoices cannot be automatically replaced.
  • Voided expense bills (ACCPAY) — These are automatically replaced with a new Xero invoice.

Disconnecting

To disconnect your Xero integration:

  1. Navigate to user menu > Connected Apps.
  2. Click Disconnect.
  3. The OAuth2 tokens are cleared and syncing stops immediately.

Existing sync history and account mappings are preserved for reference. Reconnecting later will resume syncing from where it left off.


QuickBooks Online

Beeswax also connects to QuickBooks Online (Australian, UK and US companies). An account connects to one accounting system at a time — Xero or QuickBooks — so disconnect one before connecting the other.

Connecting

  1. Open the user menu → Connected Apps and click Connect on the QuickBooks card (account owner only).
  2. Sign in to Intuit in the popup and choose the company.
  3. The connection starts in setup mode: nothing is sent until you go live.

Linking accounts and tax codes

Before going live, open Accounts & tax codes from the QuickBooks card. Link each Beeswax account to the matching QuickBooks account (only accounts of a compatible type are offered) and each tax to the company's QuickBooks tax code. Unlinked taxes with exactly one QuickBooks code at the same rate are pre-filled for you to check. Nothing is guessed at sync time: an invoice or bill that uses an unlinked account or tax is held and listed under Waiting for you on the card until you link it and mark it resolved.

Sales tax in a US QuickBooks company

QuickBooks handles tax differently for US companies, so Beeswax sends it differently:

  • Invoices. Each line is sent as taxable or not taxable, according to whether Beeswax charged tax on it, and the invoice carries one QuickBooks sales tax rate. Under Accounts & tax codes, link each Beeswax tax that charges sales tax on invoices to the QuickBooks sales tax rate it stands for. Taxes at 0% and taxes used only on expenses need no link, and if your business does not charge sales tax in Beeswax there is nothing to link at all.
  • The amount of sales tax. QuickBooks normally works out sales tax itself, from its own rates and the customer's address. Beeswax sends the sales tax it charged and asks QuickBooks to use that figure, so the invoice in QuickBooks is for the same total your customer received. Beeswax then checks the total QuickBooks reports back. If the two differ, the invoice is listed under Waiting for you with both totals, so a difference is never left unnoticed.
  • One rate per invoice. An invoice whose lines charge two taxes that are linked to different QuickBooks rates is held, because a US QuickBooks invoice takes a single rate. Link both taxes to the same rate, or put the lines on separate invoices.
  • Bills. A bill in a US QuickBooks company has no tax of its own. Each line is sent with any sales tax included in its amount, so the bill total matches the expense in Beeswax. In QuickBooks the sales tax you paid therefore forms part of the expense, while Beeswax shows it separately.
  • Sales tax must be set up in QuickBooks. If the company has no sales tax rates (Taxes › Sales tax in QuickBooks), invoices that charge sales tax are held until it is set up and the tax is linked. Invoices without sales tax are sent as usual.

Canadian QuickBooks companies cannot be connected: Beeswax has no Canadian region yet.

What is sent

Beeswax QuickBooks
Finalised invoice Invoice (lines post through a service item per linked income account)
Finalised expense Bill
Voided invoice Voided invoice
Voided expense The bill is deleted (QuickBooks cannot void a bill)

Documents are sent every five minutes while the sync is live, oldest change first. Drafts never leave Beeswax.

Payments recorded in QuickBooks

When a customer payment or bill payment is recorded in QuickBooks against a document Beeswax sent, Beeswax records the payment against that invoice or bill within a few minutes (and checks nightly for anything missed). A payment received into Undeposited Funds is recorded against whichever Beeswax account you linked Undeposited Funds to, and moves onto the bank account when the deposit is made in QuickBooks. A payment for more than is owed, or into a QuickBooks account that is not linked, is not recorded; the account owner and accountants are emailed instead.

Reconnecting

QuickBooks' permission for Beeswax expires after 100 days without use, and in any case after a fixed period Intuit sets. The card warns two weeks ahead, and shows QuickBooks needs reconnecting (with an email to owners and accountants) if Intuit refuses the connection. Disconnect and connect again to continue.


Stripe — Online Invoice Payments

The same Connect page also hosts the Stripe card for Online Invoice Payments. Connecting your own Stripe account lets clients pay invoices online by card from a Review and pay button in the invoice email, with payments recorded against the invoice automatically.

  1. On the Stripe card, click Connect and sign in to (or create) your Stripe account.
  2. Choose the bank account online payments should be recorded to.
  3. Turn on the Online Payment switch on the invoices you want to carry a payment link (or set a default per client).

Use Disconnect on the Stripe card to stop taking online payments — existing payment links stop working immediately, and reconnecting restores them.

See the Online Invoice Payments help article for full details, including per-client defaults, what your client sees, and how payments are recorded.


Permissions by Role

Action Owner Super Admin Manager Accountant Basic Client
Connect to Xero Yes Yes No No No No
Disconnect from Xero Yes Yes No No No No
Connect or disconnect QuickBooks Yes No No No No No
Link QuickBooks accounts and tax codes Yes No No No No No
View sync history Yes Yes Yes Yes No No
Map transaction accounts Yes Yes No Yes No No

Basic Plus follows Basic for the actions in this table; its extra access is to account-wide tasks and read-only projects. See Roles.

Key Notes

  • Only Owners and Super Admins can connect or disconnect accounting integrations.
  • Accountants can view sync history and map transaction accounts but cannot manage the connection itself.
  • Managers can view sync history but cannot connect, disconnect, or map accounts.
  • Basic users, Contractors, and Clients cannot access accounting integration features.
  • Accounting integrations are included with every paid plan and during the trial.
  • The Stripe card for Online Invoice Payments sits on the same page and follows the same page access; like connected apps, it is available on paid plans.
← All resources Still have a question? ↗
Browse Topics