Skip to main content

How to Connect Buildern with Xero

Buildern integrates with Xero to help you manage accounting workflows between systems. In this article, you'll learn how to connect Buildern with Xero, configure integration settings, and sync data between the two platforms.


📋 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:

  1. Navigate to Settings > Accounting Integrations.

  2. Locate the Xero integration.

  3. 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:

  1. Enable the Use Tracking Category as Project checkbox.

  2. 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.

💡 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.


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.

ℹ️ 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!

Did this answer your question?