📋 Requirements
Before you begin, make sure:
You have access to Buildern.
You have a Xero account.
You have administrator permissions in both Buildern and Xero.
You are logged in to both platforms.
Connect Buildern to Xero
To connect your Buildern account to Xero:
Navigate to Settings > Accounting Integrations.
Locate the Xero integration.
Click Connect.
4. Select the Xero organization you want to connect.
5. Click Allow Access to grant Buildern permission to access your Xero account.
You will be redirected back to Buildern to begin configuring the integration.
Configure Project Syncing
Buildern can sync projects with Xero Tracking Categories.
To enable project syncing:
Enable the Use Tracking Category as Project checkbox.
Select the Xero Tracking Category you want to use from the dropdown menu.
Once enabled, a Projects checkbox will appear at the top of the page.
When enabled, all newly created Buildern projects will automatically create corresponding Tracking Category Options in Xero.
👉 Learn more about How to Sync Projects with Xero in Buildern
💡 Tip - Project syncing helps ensure bills, invoices, and expenses can be associated with the correct project in Xero.
Configure Automatic Bill and Invoice Syncing
Buildern can automatically send Bills and Client Invoices to Xero when they are created.
Enable:
Bills
Client Invoices
When these options are enabled newly created bills and invoices will display a Send to Xero checkbox.
👉 Learn more about How to Sync Bills and Expenses with Xero
Configure Two-Way Bill Syncing
Buildern can also import bills and expenses created directly in Xero.
Enable: Bring Bills from Xero
Bills and expenses created in Xero will automatically appear in Buildern.
You can also enable: Import Bills from Synced Projects
This option limits imports to bills associated with projects that are already synced between Buildern and Xero.
Configure Contact Syncing
Enable Bring Contacts from Xero to automatically import contacts from Xero into Buildern.
When enabled:
New Xero contacts will automatically appear in Buildern.
Imported contacts are created as Sub/Vendor profiles.
👉 Learn more about How to Sync Sub/Vendors with Xero
Configure Cost Code Syncing
Buildern allows Cost Codes to sync with either:
Option 1: Xero Products and Services - Cost Codes will be created and synced with Xero Products and Services.
Option 2: Xero Chart of Accounts - Cost Codes will be created and synced with Xero General Ledger Accounts.
Buildern uses a one-to-one relationship when syncing Cost Codes.
This means:
One Buildern Cost Code can only be linked to one Xero Product, Service, or Account.
One Xero Product, Service, or Account can only be be linked to one Buildern Cost Code.
👉 Learn more about How to Sync Cost Codes with Xero in Buildern
ℹ️ Note - Once a Xero Product, Service, or Account has been linked to a Cost Code, it cannot be selected for another Cost Code.
Configure Default Accounts
Next, select the default Xero accounts Buildern should use for different transaction types.
Default Account for Bills - Select the expense account that should be assigned to bill line items when syncing bills to Xero.
Default Account for Client Invoices - Select the income account that should be assigned to invoice line items when syncing client invoices to Xero.
Default Account for Bill Payment Records - Select the account that should be used when bill payment records are created in Xero. This is typically a bank account or another account type supported by Xero for recording outgoing payments.
Default Account for Client Invoice Payment Records - Select the account that should be used when client invoice payment records are created in Xero. This is typically a bank account or another account type supported by Xero for recording incoming payments.
Default Account for Retainage - Select the account that will be used to track retainage amounts. Retainage represents a portion of a payment that is withheld until specific project milestones or contractual obligations have been completed.
💡 Tip - If you recently added or modified accounts in Xero, click the Refresh icon to load the latest Chart of Accounts before making your selections.
Configure Bill Reference Syncing
Buildern bills contain a unique Bill ID and a Reference field
Choose which values Buildern should send to Xero:
Bill ID only
Reference only
Both Bill ID and Reference
After completing the configuration, click Save and Continue.
Complete Initial Data Sync
After saving your integration settings, Buildern will guide you through a series of sync windows. Depending on your configuration, you may see sync windows for:
Taxes
Sub/Vendors
Clients
Projects
Cost Codes
Users (Xero Australia only)
ℹ️ Note - The Taxes sync window only appears if Taxes are enabled in your Buildern company settings.
Understanding the Sync Windows
Most sync windows contain two tabs:
Xero to Buildern
Buildern to Xero
These tabs allow you to decide how records should be matched between the two platforms.
For each row, you can choose one of three options:
Not Matched -The record will not be connected to any record in the other platform.
Create New - Buildern will create a new record in the opposite platform.
Select Existing - Choose an existing record to establish a connection between the two systems.
Once matched, the selected record becomes unavailable for additional matches to prevent duplicate mappings.
Next Steps
Once the integration setup is complete, your selected data will automatically sync between Buildern and Xero based on the configuration you have chosen.
You can return to Settings > Accounting Integrations at any time to modify sync settings, update mappings, or reconnect your Xero account.
With this feature in place, managing your workflow becomes even easier.
Happy building!
