↪️Integrating Ascora with Xero

6 min read

Integrating Xero with Ascora ensures seamless financial data synchronization between both systems, reducing manual data entry and maintaining accurate customer, invoice, and payment records. This integration streamlines workflows by automatically transferring financial transactions, minimizing errors, and keeping your accounts up to date.

Before setting up the integration, it's essential to configure Xero’s chart of accounts to ensure proper tracking of payments. Once connected, invoices generated in Ascora will sync directly to Xero, and payments recorded in either system will be reflected in both, ensuring financial consistency.

By correctly setting up account codes and default payment methods, you can optimize financial reporting, simplify reconciliation, and enhance overall efficiency. This guide provides step-by-step instructions to ensure a smooth integration process.

📽 Watch the video guide ⤵


Ascora runs two-way, full integration which means data will flow from Ascora into your accounting package as well as from your accounting package back into Ascora to ensure your Customers, Invoices and Payments are always synchronised.  To connect Ascora to your Xero Accounting Package:

1.  Due to the structure of the Xero chart of accounts, you first need to add an account code to your bank account record in Xero so that Ascora can push and pull payment information correctly.

C – Type the account code 1-1110 into the Code textbox the click the Save button.

Xero is now configured and is ready to connect with Ascora.

2.  From the Administration Icon in the Top Menu, choose the Accounts Integration option.

3.  Select Xero from the dropdown list.  A summary will display on the screen to explain the integration further.

4.  Click the Connect to Accounting Package button to commence the integration.  You will be re-directed to Xero to authorise Ascora to access your accounting data.

5.  Enter your Xero log-in details and click the Log in button.  Xero will ask you to allow Ascora access to your Xero Account.

6.  Click the Allow access button to allow Ascora to integrate with Xero.  You will be redirected back to Ascora to finish the integration.

7.  Once you have successfully connected Ascora with Xero, a list of account code options will display.  These tell Ascora which account codes in Xero to send different information to.  Work through the list and select the applicable account codes from the dropdown lists.  When you are ready, click the Save Accounting Settings button.

Customer Invoicing:

  • Invoice Reference Field: This value will appear in the Reference field on the top of your Invoice in Xero.
  • Default Labour Income Account: Sets the Income Code to be used when pushing Labour lines to your Accounting Package.
  • Default Supplies Income Account: Sets the Income Code to be used when pushing Supplies lines to your Accounting Package.

Payments:

  • Account for Payments: Represents the Bank Account into which any Payments would be deposited. This must match the Bank Account you would reconcile in your Accounting Package.
  • Account or Credit Card Payments: Sets Bank Account in which Credit Card Settlements will appear. Generally this should be a Clearing Account to make reconciliation far easier from your bank feeds.
  • Payment MEthod from Accounts: Any Payments pulled back from your Accounting Package will be assigned this Payment Method. e.g. EFT or Paid in Xero

Bills & Expenses:

  • Default Supplier Invoice Account: This Expense Account will be used as default if you haven't set a specific code on the Supplier when creating a Supplier Invoice.
  • Default Expense Account:This Expense Account will be used as default if you haven't set a specific code on the Supplier when creating an Expense.
  • Push Supplier Invoices as Awaiting Approval: Tick this if you want the Supplier Invoice to be sent to Xero as "Awaiting Approval" rather than "Awaiting Payment".

General Settings:

  • Default Rounding Account: This account will be used when creating a line due to Rounding Differences between Ascora and your Accounting Package.
  • Retention Income Account:  This income account will be used when adding a Retention Line to an Invoice or Progress Claim. It will also be used when creating the Completion and Final Retention Invoices.
  • Credit Note Account:  This income account will be used when creating a Credit Note for a Customer.
  • Bad Debt Account: This income account will be used when creating an adjustment when an Invoice in Ascora is written off as a Bad Debt.
  • Default Inventory Account: This Inventory Account will be used when creating a Product/Service in your Accounting Package and the Inventory Account has not been set
  • Team Tracking Category: If you're using Tracking Categories in Xero, you can select which of your Tracking Categories you want associated with Teams in Ascora.
  • Accounting Start Date: Only transactions that occur after this date will be pushed to your Accounting Package. Relax Account Selection Restrictions: Ascora will not filter the available Account Codes in the dropdowns so you will be able to select any type of Account - expenses, assets, equity or current liability - on any of the Ascora screens.

8.  Ascora is now integrated with Xero and will ask if you wish to import customer information.  Click Yes, import all my customers to import customer information from Xero immediately.  Alternatively, click Not right now to import data at a later time using the Import Icon in the Top Menu.

Configure Specific Account Codes for Different Job Types

When you create a Job Type in Ascora, you can choose to assign unique Labour and Materials Income Account Codes to it.  For example, you can set a Domestic Job Type to push income to Domestic Labour and Domestic Materials income accounts in Xero.

ℹ️
Note that you do not need to configure specific Account Codes for different Job Types - any Job Type that does not have a specific Labour and/or Materials Income Account Code assigned to it will use the default Labour and Materials Income Account Codes configured in the main Accounts Integration settings.

1.  From the Administration Icon in the Top Menu, choose the Jobs option.

2.  Under the General Tab, and then the Job Type section, click the +Add New button to create a new Job Type, or click the Edit button to edit an existing Job Type.

3.  The Job Type details pop-up window will display.  Select the required Labour and Materials Income Account Codes from the dropdown lists then click the Save button.

Configure Specific Account Codes for Individual Supplies

You can configure Ascora to push income generated from a specific Supply Item into a specific Income Account Code in Xero.  This would typically be used when, for example, you charge out a rate for the use of a particular piece of equipment and have the equipment listed as a Supply in Ascora.  By specifying a unique Income Account Code, you can track income specifically generated by that piece of equipment.

1.  From the Inventory Icon in the Top Menu, choose the Supplies option.

2.  Locate the Supply in the Supplies List for which you wish to apply a specific Income Account Code and click on the Part Number

3.  The Edit Supply pop-up window will display.  Click on Details and scroll down to select the applicable Income Account Code from the dropdown list then click the Save button.

Configure Account Codes for Credit Card Surcharges

Ascora allows you to (optionally) apply surcharges to credit card payments.  You can apply different surcharge amounts to different card types if required and you can also define the Account Code in Xero for Ascora to push Surcharge Income into.

1.  From the Administration Icon in the Top Menu, choose the Payments & Tax option.

2.  Under the Payment Methods section, click the +Add button to add a new Payment Method or click the Edit button to edit an existing payment method.

3.  The Payment Method pop-up window will display.  Select the applicable Surcharge Income Account Code from the dropdown list then click the Save button.


Did this answer your question?