Sign in

Xero Sync - Best Practices

This document provides best practices when syncing between and Xero.

Best Practices

Contacts vs. Vendors/Customers

  • Vendors and Customers will connect to the same contacts in Xero, as long as the names match, and they have transactions in
  • If Contacts in Xero do not have transactions, assign them to one of the groups that we create: Sync to Vendors or Sync to Customers. If the Contact exists as both a Customer and a Vendor, add them to both groups.
  • If the names of Contacts in Xero do not match the Vendors/Customers in, then the Contact will be created as a new Vendor/Customer in, and the Vendor/Customer in will be created as a new Contact in Xero. 
  • Newly-created Contacts in Xero won't sync to until a transaction is created for them. When a transactions is created, Xero will categorize them and then sync them into as either a Vendor or a Customer.
  • Newly-created Vendors/Customers in will sync over to Xero in either the Sync to Vendors group, or Sync to Customers group. If a Vendor and Customer in have the same name, then they will sync as one Contact in Xero, but will be a part of both Groups.
  • In order to sync to, the contact address in Xero must be specifically in the "Postal Address" section. Also, the contact phone must be in the dash format (xxx-xx-xxxx) and not be in the "Mobile Phone" field in order to sync to

Archive vs. Delete

  • never truly deletes information. If you choose to Delete a record in, it becomes inactive, the same record in Xero will be Archived. You can un-delete a record that has been deleted at any time in
  • Xero has the option to delete, which will truly delete records in Xero. If a record is deleted in Xero, the matching object in is unchanged. Because the record was removed in Xero, there is no update triggered for the sync to carry over.
  • Undeleting an inactive vendor/customer in will not restore the arhcived contact in Xero
    • Restore the contact in Xero and the sync will undelete the the vendor/customer in

Tracking Categories

  • In order for tracking categories to sync, in Xero they must be named Location and Department
  • When initially creating locations and departments, those will sync from Xero to and/or to Xero. Updates/deletions made to these items, however, will not sync from Xero to, and must be done in manually.


  • makes one or two lump-sum withdrawals (depending on when you schedule your payments) for the total amount of bills paid on a given day. This withdrawal(s) are located in your Money Out Clearing account in Xero. When reconciling your bank account, you will need to reconcile once for all bills paid on a given day.

Chart of Accounts

  • When creating a bank account or charge account in Xero, a corresponding chart of account is auto created. The chart of account will sync to


  • Items will sync two way between and Xero.  When entering in Sales Tax, these will only sync one way from Xero to 


  • Only unpaid bills sync from Xero into, so you should always initiate payments in On the Pay page you can pay via (check or ACH), or record payment made offline. The sync will send to Xero the related payment or check to be printed in Xero.
  • $0 bills will sync from to Xero as Paid
  • You can choose to have only Approved bills sync to Xero. Learn more here
  • If using approvals in Xero, once a bill is approved in Xero it can not be deleted, it can only be voided. Voiding an approved bill in Xero will not sync to The bill will need to be manually deleted in

Vendor Credits

  • Only unapplied vendor credits sync from Xero, so you should apply vendor credits in
    • When you make a payment with a vendor credit, we will sync it to Xero, where it gets automatically applied.
  • You can choose to have only Approved vendor credits sync to Xero. Learn more here

Credit Memos

  • Credit Memos don't sync to/from Xero. They need to be manually applied in both and Xero.

Bill/Invoice numbering

  • When creating invoices/bills, each needs a unique invoice number to avoid the sync number-matching to an incorrect invoice/bill.  

AR Invoice Payments

  • AR payments in will only sync to Xero if applied to an invoice; overpayments/unapplied payments will not sync to Xero.