Skip to main content
All CollectionsIntegrations
Getting started and configuring the VGM to Xero Integration
Getting started and configuring the VGM to Xero Integration
L
Written by Luke Mavin
Updated over 9 months ago


Configuring the Company Portal Xero integration involves several steps, focusing on both company-wide settings and branch-specific settings. Below is a detailed guide to help you get started:

Company Configuration

  1. Click the Cog icon in the top-right corner of the main Company Portal screen to open the Company Configuration window.

  2. In the Company Configuration window, set the “Ignore Documents Before” date to ensure that the import process ignores any documents from before this date that have not been imported into Xero.

Branch Configuration

  1. Click on Integrations > Xero > Sales/Purchases in the top-left of the main Company Portal screen to begin the integration process.

  2. From the drop-down menu on the left, select the branch you want to configure. If required, connect to your Xero account by following the prompts.

  3. Configure Branch Settings:

    • Only export posted documents:

      • Enable this setting to ensure only posted documents are sent to Xero. Unposted documents will be ignored.

    • Exclude documents with no line items:

      • Enable this setting to ensure only documents with line items are sent to Xero. Documents without line items will be ignored.

    • Use Branch Document Number Suffixes:

      • This setting should be turned on for multi-branch setups to format all document numbers with a suffix (e.g., 686 (My Tyre Centre 446)). It is optional for single-branch systems.

    • Invoice Due Offset (days):

      • Set this value to determine the “Payment Due” date for invoices imported into Xero. Xero will use this date to alert users about late payments.

    • Default Payment Bank Account:

      • Select the default bank account for payments imported into Xero. This can be overridden on a case-by-case basis for different payment types.

    • Xero Contact Match Behaviour:

      • Match unlinked customers to existing Xero contacts:

        • The integration process will try to match unlinked customers to existing Xero contacts. If no match is found, a new contact will be created.

      • Create new Xero contacts for unlinked customers:

        • The integration process will create a new Xero contact for all unlinked customers being imported into Xero.

      • Use default Xero contact for all customers:

        • All documents will be imported using a single Xero contact. Select the “Default Xero Contact” from the provided dropdown box.

Did this answer your question?