Integrations
Accounting Sync
Xero
24min
invoiced integrates with the xero accounting system out of the box to supercharge the billing capabilities of xero this document describes how to set up the integration and how it works in detail overview the xero integration ships with the following capabilities bi directional sync with xero new data from xero is synced once per hour transactions generated on invoiced post to xero in real time initial data sync data flow invoiced sync to invoiced sync to xero xero customer ← → contact contact ← contact person invoice ← → invoice credit note ← → credit note payment ← → batch payment foreign currency payment ← → payment convenience fee → invoice setup in order to begin syncing with xero first go to apps → xero click on connect to xero you will be redirected to xero you will need to sign in to xero, if you are not already signed in next you will be prompted to authorize invoiced access to your xero organization click on authorize you will be redirected back to invoiced xero is now connected! now you can configure the accounting sync in order to tell invoiced how to map the data into your general ledger change the account mapping and other settings click save sync convenience fees from invoiced to xero when the write setting is enabled for convenience fees, the integration will create a convenience fee invoice in xero the convenience fee is applied to this invoice, so it does not create a credit in the accounting system when this setting is enabled, you will be prompted to configure account mapping for the convenience fee invoice line item usage once the xero integration is enabled it will sync data automatically per the data flows that you have enabled writing data from invoiced to xero will sync instantly reading data from xero to invoiced, such as when a new invoice is available, will sync once per hour you can see when the last sync happened on the accounting sync page if you wish to run a one off sync you can click the sync now button initial data sync the initial data sync feature allows you to sync data from your accounting system that was created before the integration was installed you can run the initial data sync after you first install the integration to pick up previous transactions the initial data sync is optional and is only performed if initiated by you the initial data sync can be started by going to the accounting sync page and clicking the initial data sync button then you can select the type of data you want to sync and the date range for any transactions that will be synced you can only select a date range of at most 1 year however, you can run multiple initial data syncs if you want to get transactions from a greater time period syncing more than 1,000 records at a time might not complete if you need to sync a large volume of data, see importing data for instructions on how to import data through a spreadsheet and here's a pro tip if you're fetching invoices or credit notes from the past, don't forget to grab the payments, too this way, you'll ensure your financial history is complete, with every balance perfectly in place once the initial data sync is complete and you are satisfied with the results, we do not recommend using it again the ongoing sync of the integration will keep your data up to date automatically handling errors on the accounting sync page you will see a reconciliation errors table which contains any sync errors that the integration encountered each error listed belongs to individual record that could not be synced the error message is listed next to each failed record when a record fails to sync it will not be re attempted unless there is a new operation (i e updating the record) that triggers a new sync you can retry syncing any failed record by clicking the retry button or you can ignore the error by clicking the ignore button errors will not go away until they are successful or ignored field mapping we support setting several optional fields on xero that do not have a standard invoiced field this can be useful if you are first creating invoices on invoiced and posting to xero these additional field mappings work when a record on invoiced has a custom field with a specific id that corresponds to a specific field on xero this gives you granular control of the data sent to xero object type xero field description invoice xero lineamounttypes amount type (eg exclusive or inclusive) line item xero accountcode account code line item xero itemcode item code line item xero taxtype tax rate line item xero trackingname1 tracking category 1 name line item xero trackingoption1 tracking category 1 value line item xero trackingname2 tracking category 2 name line item xero trackingoption2 tracking category 2 value tax rate mapping if you are posting invoices from invoiced to xero then you have different options for how taxes are synced to xero create sales tax line item (recommended) the invoice will have no tax amounts and a line item will be created for sales tax pointed to the sales tax liability account you choose inherit account tax rate the invoice will have tax exclusive amount and the sales account default tax rate will be selected match tax rate by name the invoice will be created in tax exclusive mode the tax rate selected on xero will be matched based on the name of the tax rate on invoiced if no match is found then an error is generated deposit account mapping you can map the bank accounts in which payments are deposited into in settings > accounting sync > configure > mapping you can create rules to choose the deposit account for each payment method and currency combination the deposit account can be any account that is enabled for payments the deposit account in xero must have an associated code, or invoiced will not be able to map payments to it you can view and add an account code in your chart of accounts in xero edge cases here we have documented all of the limitations, nuances, and edge cases to be aware of when using the xero integration general xero has a hard limit of 5,000 api operations per day if you run into this rate limit then you will have to retry your sync operation later when the rate limit has been reset xero also has a hard limit of 60 api operations per minute if you run into this rate limit then the sync will pause for a minute and retry the request as a result you might find that operations to xero are temporarily delayed the integration can use fewer api calls by making sure that you have only enabled the data flows that you need and disable the remaining data flows invoices late fees will only sync to xero if the invoice is originally created in invoiced late fees applied in invoiced will not sync to xero if you create invoices in xero xero supports 2 and 4 digit precision on the invoice line item quantity if you create invoices in invoiced with 3 digit precision, you will see a rounding error you can change your unit cost precision to 2 or 4 digits in invoiced in settings > accounts receivable customers it is not possible to reactivate a contact on xero that was marked inactive on invoiced if a customer is marked as inactive on invoiced and then later reactivated then you must separately restore it on xero credit notes when a credit note is reapplied on invoiced, the new application cannot be synced to xero you must also modify the credit note application on xero payments when a foreign currency payment from invoiced is posted to xero with multiple line items, it will post as multiple payments on xero because xero batch payments do not support multi currency faqs how long will my xero organization be connected for? your xero organization will be connected until you click disconnect if you ever find your account prematurely disconnected then you can reconnect any time in apps → xero how do i disconnect my xero organization? go to apps → xero and click delete app which xero organization is connected? you will find the organization name below the xero settings how are payments recorded on xero handled? payments applied to invoices on xero will be synced to invoiced instantly you must have auto sync enabled for 2 way payment sync to work what accounts does invoiced create in my chart of accounts? you can see the accounts we create here how are taxes carried over? the integration adds all the taxes on the invoice from invoiced and adds a tax line item to the corresponding xero invoice you can disable this behavior with the add tax line item setting what should i do when i changed my xero organization? if you have changed your xero organization then you will need to reconnect your xero account by clicking on reconnect in the xero integration settings are items synced from invoiced to xero? currently items from invoiced are not imported into xero which invoices from invoiced are synced to xero? all non draft invoices created after the installation of the integration will be synced the associated customers and payments will also be synced if an invoice originated from xero and was modified on invoiced then it will not be synced, although any payments received will still be synced what happens if the invoice does not have a due date? since xero requires a due date on all invoices, if an invoice is missing a due date the due date will be set to the invoice date on xero are the taxes on the synced invoices exclusive or inclusive? taxes synced to xero are exclusive by default are tracking categories supported? yes, line item tracking categories can be synced to and from xero troubleshooting below we have documented commonly encountered errors and recommended resolutions if you are still unable to get your books synced then please contact invoiced support for further assistance unauthorized unauthorized invalid authorization credentials if you see this error message then our access token to your xero account has expired you need to go to settings → xero in order to reconnect xero organisation is not subscribed to currency organisation is not subscribed to currency xxx invoiced supports 150+ currencies out of the box with no extra configuration needed if you are seeing this error message then you need to tell xero about each currency you operate with in settings → general settings → currencies