The Xero integration matches your Socket clients to Xero contacts and posts your invoices to Xero with the account codes you choose. This guide covers connecting, account codes, what syncs in each direction, and what to check when an invoice doesn't arrive.
Connecting to Xero
Socket doesn't bring Xero records directly into Socket (unless Xero is acting as the primary CRM for the practice). It matches Socket clients to Xero contacts behind the scenes, and warns you on the Billing Plan if any Socket clients are unmatched to a Xero contact.
To get started, go to Practice Settings > Integrations and select Connect with Xero.
Selecting your Xero company
Choose your practice's Xero company and allow access. This syncs your Xero general ledger account codes and contacts with Socket. Once connected, you see the Connected to Xero green tick.
If your Xero login can see more than one organisation, Socket asks which one this practice is for before it connects. Pick the organisation and select Connect. The Xero card then reads "Connected to" followed by that organisation's name. If you cancel the picker, the practice stays disconnected, so connect again and choose. A login with a single organisation connects as before. To switch a practice to a different organisation, disconnect and connect again, choosing the new one.
Setting default account codes
Select the default account code for recurring and one-off sales. Invoices then post to Xero with those codes.
Choose a different Account Code for one-off pieces of work if necessary. This keeps your regular revenue separate from ad-hoc projects in Xero.
The account code can also be changed within the pricing section for each service. If left unchanged, it uses the default set above.
Go to Services & Pricing and select the three dots on the right hand side of your Active Pricing Menu, then Billing & Engagement Letter Settings:
A note on VAT codes: when Socket posts invoices directly to Xero, it doesn't apply or control VAT codes. VAT is determined by the account codes you have configured in Xero. If invoices are posting to Xero with an incorrect VAT code, check the settings on the relevant account code in Xero. Invoices raised through Adfin are different, as they carry your practice's VAT rate.
Consolidating invoice lines
This setting lives in Billing Settings. You can choose whether to consolidate your services into one line item, or allow each service to have its own line.
See Configuring your Xero billing settings for the full set of billing settings.
Xero Tracking Category 1 on proposals
When you build a proposal for a Xero client that doesn't have a Tracking Category 1 value yet, the first step of the proposal shows an optional Tracking Category One field. The value you pick is saved to the client's invoice settings.
Categories for individual services go in your second tracking category. See Using Xero Tracking Categories.
To use this, set your Xero Tracking Categories up in Xero first. Socket pulls them through once connected.
What syncs in each direction
The direction data flows between Socket and Xero:
Socket | Direction | Xero |
Clients | Both ways | Contacts |
Account Codes | Xero to Socket | Account Codes |
Invoice Templates | Xero to Socket | Branding Themes |
Tracking Categories | Xero to Socket | Tracking Categories |
Invoices | Socket to Xero | Invoices |
The sync runs once a day, which is overnight for UK users.
Lost connection notifications
If Socket's connection to Xero stops working, Socket refreshes it and tries again once on its own. If that refresh fails, Socket disconnects Xero, your owners and admins get a Xero Connection Lost email, and the practice gets a notice in the bell. That way you can reconnect before your next billing run, so invoices don't fail to push through or route to the wrong integration.
An owner or admin reconnects from Practice Settings > Integrations by selecting Connect with Xero and logging in with your Xero credentials. Once reconnected the green tick reappears and invoices push through as normal.
If you use Adfin for invoicing and your Xero connection is lost, Socket pauses Adfin invoicing until Xero is reconnected. This prevents invoices from routing incorrectly. You receive an email notification in this situation.
Troubleshooting
Invoice not pushing to Xero
If an invoice isn't appearing in Xero and everything else looks correct, check the following:
Confirm Xero is still connected with a green tick in Practice Settings > Integrations. If not, reconnect.
Check you are not in Safe Mode. Integrations are read-only while Safe Mode is active.
Confirm the proposal start date has been set and is correct.
Check whether the Xero contact linked to that client has been archived. Go to the client record in Socket, open the Xero tab, and check which contact it is linked to. If the linked contact is archived in Xero the invoice fails. Re-link the client to the correct active contact to resolve this.
If a client has multiple contacts in Xero with similar names, Socket may be linked to the wrong one. Search by name may not surface the archived contact, so scroll through the full contact list in Xero to find and unarchive or re-link the correct record.
Re-posting a failed invoice
When an invoice fails to post to Xero (for example because the linked Xero contact was archived), it's recorded on the client's Invoicing > Invoices tab with a Failed chip. Hover over the chip to see the reason.
Once you've fixed the cause, select Retry and confirm, and Socket posts the invoice to Xero again.
If invoices still aren't pushing after working through the above, get in touch with the team via the chat icon in the bottom-right corner of Socket and we'll help you get it sorted.




