--- title: How to Sync Client Invoices with Xero description: Buildern allows you to sync client invoices with Xero. In this article, you'll learn how invoice information is synchronized, how to create and sync invoices, and understand which updates flow between Buildern and Xero. --- [Skip to content](https://help.buildern.com/en/articles/15519237-how-to-sync-client-invoices-with-xero#main-content) ![logo\_icon\_text](https://help.buildern.com/hubfs/Buildern%20logo.svg) - [My Account](https://app.buildern.com/signin) Open main navigation Close main navigation - [My Account](https://app.buildern.com/signin) - [Get Started Free](https://app.buildern.com/signup) [Get Started Free](https://app.buildern.com/signup) Welcome to Buildern Help Center! - There are no suggestions because the search field is empty. 1. [Buildern Help Center](https://help.buildern.com/en/articles?hsLang=en-gb) 2. [Client Invoices](https://help.buildern.com/en/articles/client-invoices?hsLang=en-gb) # How to Sync Client Invoices with Xero ### How to Sync Client Invoices with Xero Buildern allows you to sync client invoices with Xero. In this article, you'll learn how invoice information is synchronized, how to create and sync invoices, and understand which updates flow between Buildern and Xero. July 31, 2026 ### **📋 Requirements** Before you begin, make sure: - Your Buildern account is connected to Xero. - You have permission to create and manage invoices. - A project and client exist in Buildern. - Required Cost Codes, Clients, Projects, and Tax Rates have been synced with Xero. ### **Invoice Field Mapping** The following fields are synchronized between Buildern and Xero: | **Buildern** | **Xero** | | --- | --- | | Client Invoice | Invoice | | Project Client | Contact (To) | | Project | Tracking Category Option | | Date | Issue Date | | Due Date | Due Date | | Invoice ID | Reference | | Attachments (first 10 files only) | Related Files | | Amounts Are | Amounts Are | | Invoice Line Name | Description | | Cost Code | Item or Account (based on integration settings) | | Claim | Price | | Account | Account | | Tax | Tax Rate | | Invoice Payment | Payment | | Retainage | Invoice Line with Negative Amount | ### **Understanding Cost Codes on Invoice Lines** Invoice lines in Buildern do not always contain Cost Codes. Cost Codes are assigned only in the following scenarios: **Schedule of Values Invoices -** When The project invoice type is Schedule of Values, and the Estimate Grouping option is set to Show by Cost Codes. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/39a9418c-3865-4489-beaa-f6832be50389.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549253/c4a4ef7e54e7544b9a96fa33a71b/39a9418c-3865-4489-beaa-f6832be50389?expires=1792671300&signature=ac192040ae9b9bb9edd737e72154109d0e5bab95237414c7f5d9917b6480cae1&req=diQvFsx6lINaWvMW1HO4zW3ohbiA%2BYAIWsBztbQ8d0McSbtFCGnKegQfwlYP%0A0M9yTI7kjjubNlf0leI%3D%0A)[![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/ea153f2f-13b8-4e15-8a7b-e7479454e13c.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549252/4ed4fd42d4fb6531c07d18cd6ee0/ea153f2f-13b8-4e15-8a7b-e7479454e13c?expires=1792671300&signature=f365cfb4f963b09a4849549b681823b32367ac55f0b8baeb4a14d750b94a3b0a&req=diQvFsx6lINaW%2FMW1HO4zfrWntSW71d%2FmYkQyuFIp4N3Vifbrb8bUyJpQq3Z%0AZ23whqyWfW4dyjtGQjE%3D%0A) **Cost Plus Invoices -** When timesheet records are included on the invoice. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/ea10985b-b00f-4c78-a83c-f8e5289061f6.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549249/f4318e7dd93d705575ed48142b9d/ea10985b-b00f-4c78-a83c-f8e5289061f6?expires=1792671300&signature=6c5957ef5f3105ada4ac829bb055567151d63089a1bc407c04e3a40dbaec6cff&req=diQvFsx6lINbUPMW1HO4zXzt2Vkl4oPptaeM%2FuqTVVmnmRUEMsBASskXJZKc%0AfxhqamJ3A%2F2nZQtjCds%3D%0A)[![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/b10c25b7-c1c5-4f85-8ace-93daf56f4123.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549248/c25c8fcb4ab66c0d2da634edfd39/b10c25b7-c1c5-4f85-8ace-93daf56f4123?expires=1792671300&signature=c1b5173270c12d54b18f6520a333888466fc35841ba5cba5180dbc6d77bb8636&req=diQvFsx6lINbUfMW1HO4zavu7tufPbRbyiAw4R0XJcxzc4%2F%2BYSX7XsoaLEwU%0A%2B%2FezTfPv%2FXLd%2Fzq5SUc%3D%0A) **Custom Invoice Lines -** When a custom line item is manually added to the invoice. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/d1ec945c-e530-4f2d-b261-ce695bdd4118.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549251/fb774499c2a8a07bb20d8dc1578e/d1ec945c-e530-4f2d-b261-ce695bdd4118?expires=1792671300&signature=35e25e1732405c8b8a10d934ca18e2871d094488af06070eeeaa75111fd3fd0d&req=diQvFsx6lINaWPMW1HO4zT7wlIj1ONAW%2Ff1K0hIR8EMJQf636Fhca5Gm7od%2F%0AY6qbqZB7CSdFB67s7bE%3D%0A) Outside of these scenarios, invoice lines do not contain Cost Code information. An Account can be selected manually, or Buildern can automatically assign a default Account based on the Accounting Integration settings. When synced to Xero, no Item information is sent. ### **Cost Code Sync Behavior** When Cost Codes are synced with Xero, the behavior of invoice line items depends on the selected synchronization method. - If Cost Codes are synced with **Xero Accounts**, the **Account** field on invoice lines is automatically populated based on the selected Cost Code and cannot be edited manually. When the invoice is synced to Xero, the Item field remains blank, and only the Account field is populated. - If Cost Codes are synced with **Xero Products & Services**, the **Account** field can be selected manually on invoice lines. When the invoice is synced to Xero, the corresponding Product/Service is populated in the Item field, while the selected account is populated in the Account field. ### **Enable Automatic Invoice Synchronization** Client invoices can be automatically synced to Xero when they are created. To enable automatic synchronization: 1. Navigate to Settings → Accounting Integration. 2. Under Project Default Settings, locate Client Invoices. 3. Enable the checkbox. Once enabled, all newly created invoices will automatically sync to Xero. For existing invoices, open the invoice, enable **Send to Xero**, and save the record. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/a463ab8a-2cb5-4ac0-a653-b3578bbd295e.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549258/1dd77e539e05da6a1969469a35f1/a463ab8a-2cb5-4ac0-a653-b3578bbd295e?expires=1792671300&signature=fc9bbb7ddd0bbed6cff94e037b1e8a8893ab7e7a801acede579ef7ff698d5618&req=diQvFsx6lINaUfMW1HO4zUcYx%2BhTwO3AIkipgelJGAUKqIVPyLjdDRXHbKlu%0AEOIwaxP0ejH7JxnrnfQ%3D%0A) ### **Verify Invoice Synchronization** When an invoice is successfully synced: 1. Navigate to the project's Invoices page. 2. Locate the invoice in the list. 3. Review the Sync column. A Xero icon indicates that the invoice has been synchronized successfully. Clicking the icon opens the corresponding invoice directly in Xero. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/eeca3871-d738-4196-b431-86276fdf6031.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549261/dee866e87694644ac692d0027a6f/eeca3871-d738-4196-b431-86276fdf6031?expires=1792671300&signature=67c538bf97674a0a66caf6cb6cd9b55046487e6254b79c6cf66ea72034040bf5&req=diQvFsx6lINZWPMW1HO4za80oLqIX7ot0dFYKk9XMq598DL4vKxNE8RT4NjI%0AsWUnXduq3F67n%2FFVmnk%3D%0A) ### **Resolve Synchronization Errors** In some cases, synchronization may fail because information referenced on the invoice has not yet been synchronized with Xero. Common causes include: - New Cost Codes - New Projects - New Tax Rates - New Clients When this occurs, Buildern displays an error message identifying the missing information and may provide an option to resolve the issue automatically. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/e53a8b8e-380d-4798-8ba7-9ab0d0ba3f2d.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549257/c356a527477180ca1ace1a303e06/e53a8b8e-380d-4798-8ba7-9ab0d0ba3f2d?expires=1792671300&signature=a21713dcb5b9148215cf838f028d0d760811a954c0f2b9a4b1bf307d2bd32c7b&req=diQvFsx6lINaXvMW1HO4zVw2qlAmJED0IjIF7Y1mfVU9WnJfC5rFxJ6R5%2Br0%0A37HUIBW6ycGPHHNtTGk%3D%0A) To resolve the issue: 1. Ensure the missing records have been synchronized with Xero. 2. Verify: - Cost Codes exist as Products & Services or Accounts. - Projects exist as Tracking Category Options. - Clients exist as Contacts. 3. Save the changes. 4. Retry the synchronization. Once the required records exist in Xero, the invoice can be synchronized successfully. ### **Find Synced Invoices in Xero** To verify that an invoice has been synchronized: 1. Open Xero. 2. Navigate to **Sales → Invoices**. 3. Locate the invoice. The invoice created in Buildern should now be available in Xero. [![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/77d59e0f-24d2-4652-8151-fb3159359e17.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549259/2f711d42852050486f7b44b24b53/77d59e0f-24d2-4652-8151-fb3159359e17?expires=1792671300&signature=c0414cfd5fd2a17f8c40c9122ce883456981d79c7406836ecf981d62b0e64f17&req=diQvFsx6lINaUPMW1HO4zRlyNvitOFwkoRwqp7r8jdMqsGzihmI8%2FYeuUKik%0A2dRjIYCpVS6p38TWUfE%3D%0A)[![](https://help.buildern.com/hubfs/Knowledge%20Base%20Import/b2bead43-e3e3-401b-ab81-ac490acb7eaa.png)](https://downloads.intercomcdn.com/i/o/suco1tn6/2480549260/3cd25a7c7a8fe24b463a027ff268/b2bead43-e3e3-401b-ab81-ac490acb7eaa?expires=1792671300&signature=c17165ae4c4980f83c94a98062848ab2165caded7b33ca22581d89cbdf47cf33&req=diQvFsx6lINZWfMW1HO4zSVwHu1EX3o0ilZvr4NGKAUNpLhf%2F6ahJKRsADpO%0ABX6REVxVi6fDDC7O3go%3D%0A) ### **Transaction Updates** - #### Updates Synced from Buildern to Xero When an invoice is synchronized with Xero, most changes made in Buildern are automatically reflected in Xero. This includes updates to the client (provided the invoice has not been paid in Xero), invoice ID, invoice date, due date, invoice status, tax calculation method, invoice line accounts, cost codes on custom lines, invoice line amounts, descriptions, tax values, and quantities. - #### **Updates Synced from Xero to Buildern** Certain changes made directly in Xero are also synchronized back to Buildern. These include invoice date updates, due date updates, invoice status changes, payment creation and deletion, and invoice deletion. If an invoice is deleted in Xero, the synchronization link between the invoice records in Buildern and Xero is removed. You're all set to start using this feature and improve your project management process. Happy Building! - [Getting started](https://help.buildern.com/en/articles/getting-started?hsLang=en-gb) - [Projects](https://help.buildern.com/en/articles/projects?hsLang=en-gb#main-content) - [Getting Started with Projects](https://help.buildern.com/en/articles/projects?hsLang=en-gb#getting-started-with-projects) - [Projects Explained](https://help.buildern.com/en/articles/projects?hsLang=en-gb#projects-explained) - [Dashboards](https://help.buildern.com/en/articles/dashboards?hsLang=en-gb) - [Takeoff](https://help.buildern.com/en/articles/takeoff?hsLang=en-gb) - [Estimates](https://help.buildern.com/en/articles/estimates?hsLang=en-gb#main-content) - [Creating and Editing an Estimate](https://help.buildern.com/en/articles/estimates?hsLang=en-gb#creating-and-editing-an-estimate) - [Estimate Measurements](https://help.buildern.com/en/articles/estimates?hsLang=en-gb#estimate-measurements) - [Getting Started with Estimates](https://help.buildern.com/en/articles/estimates?hsLang=en-gb#getting-started-with-estimates) - [Importing Estimates](https://help.buildern.com/en/articles/estimates?hsLang=en-gb#importing-estimates) - [Cost Codes](https://help.buildern.com/en/articles/cost-codes?hsLang=en-gb#main-content) - [Getting Started with Cost Codes](https://help.buildern.com/en/articles/cost-codes?hsLang=en-gb#getting-started-with-cost-codes) - [Importing Cost codes](https://help.buildern.com/en/articles/cost-codes?hsLang=en-gb#importing-cost-codes) - [Proposals](https://help.buildern.com/en/articles/proposals?hsLang=en-gb) - [Schedule](https://help.buildern.com/en/articles/schedule?hsLang=en-gb#main-content) - [Schedule Board Explained](https://help.buildern.com/en/articles/schedule?hsLang=en-gb#schedule-board-explained) - [Importing Schedule](https://help.buildern.com/en/articles/schedule?hsLang=en-gb#importing-schedule) - [Getting Started Schedule](https://help.buildern.com/en/articles/schedule?hsLang=en-gb#getting-started-schedule) - [Bid Requests / Request for Quote](https://help.buildern.com/en/articles/bid-requests-request-for-quote?hsLang=en-gb) - [Selections and Allowances](https://help.buildern.com/en/articles/selections-and-allowances?hsLang=en-gb) - [Purchase Orders](https://help.buildern.com/en/articles/purchase-orders?hsLang=en-gb) - [Bills](https://help.buildern.com/en/articles/bills?hsLang=en-gb) - [Budget Tab](https://help.buildern.com/en/articles/budget-tab?hsLang=en-gb) - [Change Orders / Variations](https://help.buildern.com/en/articles/change-orders-variations?hsLang=en-gb) - [Quickbooks Online Integration](https://help.buildern.com/en/articles/quickbooks-online-integration?hsLang=en-gb) - [Xero Integration](https://help.buildern.com/en/articles/xero-integration?hsLang=en-gb) - [Client Invoices](https://help.buildern.com/en/articles/client-invoices?hsLang=en-gb#main-content) - [Client Invoices Explained](https://help.buildern.com/en/articles/client-invoices?hsLang=en-gb#client-invoices-explained) - [Getting Started with Invoices](https://help.buildern.com/en/articles/client-invoices?hsLang=en-gb#getting-started-with-invoices) - [To-Dos](https://help.buildern.com/en/articles/to-dos?hsLang=en-gb) - [Daily Logs / Site diary](https://help.buildern.com/en/articles/daily-logs-site-diary?hsLang=en-gb) - [Timesheets](https://help.buildern.com/en/articles/timesheets?hsLang=en-gb) - [Files](https://help.buildern.com/en/articles/files?hsLang=en-gb) - [Users, Roles, Permissions](https://help.buildern.com/en/articles/users-roles-permissions?hsLang=en-gb) - [Clients](https://help.buildern.com/en/articles/clients?hsLang=en-gb) - [Subcontractors & Vendors](https://help.buildern.com/en/articles/subcontractors-vendors?hsLang=en-gb) - [Templates](https://help.buildern.com/en/articles/templates?hsLang=en-gb) - [Settings and Configurations](https://help.buildern.com/en/articles/settings-and-configurations?hsLang=en-gb) - [Buildern AI](https://help.buildern.com/en/articles/buildern-ai?hsLang=en-gb) - [My Account](https://app.buildern.com/signin) [![logo\_icon\_text](https://help.buildern.com/hubfs/Buildern%20logo.svg "logo_icon_text")](https://buildern.com/) Copyright © 2026, Buildern Inc.