How eggz works with Xero
eggz syncs your accounting data from Xero so you can view invoices, bills, quotes, and customer information in one place alongside your uploaded receipts. The integration is primarily one-way (Xero to eggz), with the ability to push processed receipts back to Xero — and to publish draft invoices and quotes you create in eggz.Connect Xero
1
Open Integrations
Navigate to Settings > Integrations and find the Xero card.
2
Click Connect
Click Connect on the Xero card. Xero’s authorisation page opens.
3
Authorise access
Sign in to Xero (if not already) and grant eggz permission to access your data.
4
Select your organisation
If your Xero login has access to more than one organisation, eggz shows a selection screen after you authorise — pick the organisation you want to connect. Only one Xero organisation can be connected per eggz workspace, so choose carefully. (With a single organisation, eggz connects it automatically and skips this step.)
What syncs from Xero
eggz pulls the following data from your Xero account:
Payments and bank transactions keep your Collected and Outstanding views accurate — eggz knows not just what was invoiced, but what’s actually been paid and when.
Customers refresh automatically every 8 hours. Everything else refreshes by hand: on the Xero card, click Xero settings, then click Refresh next to Chart of accounts, Invoices, Bills, Quotes or Financial year under Synced data. Customers has a Refresh too, if you don’t want to wait. Payments and bank transactions have no Refresh.
Sync order
When you first connect, documents sync first, then payments. So invoices, bills, and quotes appear before the payments that settle them. If a payment ever lands before its document, eggz links the two automatically once the document arrives.eggz checks for deleted payments each time it syncs payments. That happens when you connect, so a payment deleted in Xero later stays in your eggz reports until then.
What eggz pushes to Xero
eggz can push processed receipts to Xero in two ways:Draft invoices and quotes you create in eggz can be published to Xero. Documents synced from Xero can’t be pushed back, and customer records created in eggz aren’t pushed to Xero on their own. When you publish, eggz creates the supplier or customer in Xero if Xero doesn’t already have a match. Deleting a draft invoice that’s in Xero deletes it in Xero too: see Voiding and deleting invoices.
Account mapping
After syncing your chart of accounts from Xero, you can map eggz expense categories to Xero account codes. This ensures receipts are posted to the correct account when published to Xero.1
Open Xero settings
Go to Settings > Integrations and click Xero settings on the Xero card.
2
Refresh your chart of accounts
Under Synced data, click Refresh next to Chart of accounts to pull your Xero account list.
3
Map categories
Under Account mappings, click Add Mapping, then choose a Category and its Xero Account.
Managing your connection
Connection status
The line under Xero on the card says how the connection stands:
eggz renews its access to Xero while the workspace is in use. A connection nobody has touched for 60 days reads as expired. If renewing fails, the card says the connection expired. Only admins see the Xero card, so only an admin can connect, reconnect or disconnect.
Disconnect Xero
1
Open the card's menu
In Settings > Integrations, press ⋯ at the top right of the Xero card.
2
Choose Disconnect Xero
A box asks Disconnect Xero? Click Disconnect Xero to go ahead, or Keep it connected to back out.
Switch to a different organisation
Because only one Xero organisation can be connected per workspace, to change which one is linked: disconnect the current organisation, then click Connect on the Xero card again and choose the other organisation on the selection screen.Limitations
- One Xero organisation per workspace: You cannot connect multiple Xero organisations to the same eggz workspace.
- One-way sync for most data: Bills in eggz are read-only copies synced from Xero — edit them in Xero. (Publishing a processed receipt can create a new bill in Xero — see What eggz pushes to Xero — but existing bills never sync back.) Contact details also sync one way from Xero; the CRM fields you manage on customers in eggz (owner, segment, annual value, and so on) live only in eggz and are never pushed to Xero. Invoices and quotes synced from Xero are one-way too. A draft you create in eggz can be published to Xero, and deleting a draft invoice that’s in Xero deletes it in Xero too.
- Mostly manual refresh: Customers refresh by themselves every 8 hours. For invoices, bills, quotes and your chart of accounts, click Refresh under Xero settings. Payments and bank transactions come in when you connect.
- No bank reconciliation: eggz displays financial data but does not perform bank reconciliation. Continue using Xero for reconciliation.
- Currency conversion: Analytics convert foreign currency at the daily reference rate for each document’s date, not a live rate. To use a different rate for one document, click Set exchange rate on it. Reverted to the daily rate confirms you went back.
- Invoices settled by credit notes, overpayments, or prepayments still show as Outstanding in eggz for now, even though Xero considers them settled. This is coming in a follow-up. Invoices settled by an ordinary payment are handled correctly today.