Xero – Getting connected

Quotient integrates seamlessly with Xero. You can lookup your Xero Contacts and Xero inventory items when creating Quotes. These are real-time lookups, meaning they work seamlessly alongside Quotient’s own powerful Contacts and Template Items.

Best of all, once a Quote has been accepted, an invoice can be created automatically in Xero.


How to setup the Xero integration

  1. Go to Setting > Integrations
  2. Hit the Xero logo.
  3. Hit 'Connect'.
  4. Login to your Xero account, select which organization you’d like Quotient to access and hit ‘Authorise’. You’ll be re-directed back to Quotient.
  5. Now you'll need to enable some services, read on...


Xero invoices

A draft invoice can be created in Xero from an accepted Quote:

  • automatically when the Quote is accepted; or
  • automatically when the Quote is archived; or
  • manually using the 'Send to Xero' button.

How to enable Xero invoices:

  1. Under 'Create invoices' hit ‘Enable’.
  2. Confirm when accepted Quotes are sent to Xero, what's included on the invoices and the invoice due date, hit 'Save'.
  3. Match your Xero account codes and tax rates to those which are in Quotient using the appropriate drop-downs, hit ‘Save’.

Displayed on the invoice is the Quote Title, customer order/reference number, a permanent link back to your Quote for easy future reference and all accepted Price Items, including Unit Price, Quantity and Heading. There's also the option to include the Long Description text on the invoice.

For an Item Code to appear on the draft invoice the Item Code must also be present in Xero AND lookups for Xero inventory items must be enabled in Quotient.

You can set the invoice due date to be a specified number of days following the Quote acceptance date, or leave this empty and let the default due date in Xero or on the Xero contact determine the invoice due date. 

Contacts are sent to Xero when an invoice is created. If a Contact already exists in Xero, Quotient will NOT replace or update the Contact or relevant Contact information. Contacts are matched by Contact name. 

Note: Make sure the currencies you quote in are also enabled in your Xero account.

Purchase Orders

Creating a purchase order (from an accepted Quotient Quote) is really easy within Xero:

  1. In Xero, go your 'Draft' invoice tab.
  2. Check the checkbox next to the draft invoice for which you'd like to generate a purchase order from.
  3. Hit 'Copy to...', select 'Purchase Order' and follow the steps.


Xero contacts – include in lookup results

When adding contacts to Quotes you can include your Xero Contacts in lookup results. Xero Contacts are indicated with a logo  in results.

Once you select a Xero Contact it will be saved (copied) into Quotient Contacts. Note that only a person's name, email and company name are saved.

How to enable Xero contact lookups

  1. Under 'Lookup Contacts' hit ‘Enable’.
  2. Your Xero Contacts will now appear in the lookup results.

Required fields

Xero Contacts must have these fields populated to be included in the lookup results:

  • First Name
  • Email

This Xero Contact would be included in the results:


Xero inventory items – include in lookup results

When adding Price Items to quotes you can include Xero inventory items in lookup results. Xero items are indicated with a logo  in results.

How to enable Xero inventory item lookups:

  1. Under 'Lookup inventory items' hit ‘Enable’.
  2. Your Xero inventory items will now appear in the lookup results.

Quotient does not create or update Xero inventory items.

Field matches (for lookups):

From Xero

To Quotient

Item Code

Item Code

Description (also called Sales Description)

Product or Service Heading

Not used in Xero

Long Description

Re-cache your lookup data

If your lookup results data isn't appearing in Quotient exactly the same as your inventory items data in Xero, then you may need to "re-cache your lookup data". To do this, under 'Lookup inventory items' hit the ‘Disable’ button, confirm, then follow the steps to re-enable. A fresh cache of your Xero data will be created for the lookups.

Why would I need to do this? You'd only need to do this if you've deleted inventory items in Xero then recreated them (manually or with a CSV upload) and used an Item Code(s) that existed previously.


Start a Quotient quote from inside Xero

You can start a new Quotient Quote directly from a Xero contact by setting up a handy time-saving link, which will appear on your Xero contact. By doing this it can save you time by jumping you straight into a new Quotient Quote with relevant contacts details populated.

To set up the link in Xero:

  1. Sign in to Xero
  2. Go to Settings > General Settings > Custom Contact Links
  3. Click 'Add A Custom Link' and enter the following values, then hit ‘Save’ when done:
  4. Name: New Quotient Quote
  5. Link Definition: https://go.quotientapp.com/new-001/quote?email={!EMAILADDRESS}


Find out more about Xero.

Was this article helpful?
3 out of 4 found this helpful
Have more questions? Contact Support
Powered by Zendesk