Page tree
Skip to end of metadata
Go to start of metadata

CartonCloud can be integrated with Xero quickly and easily, allowing you to further automate your invoicing.

How it works:

In addition, all of the above steps can be automated so they happen completely automatically every invoicing cycle, meaning you don't need to do anything at all!

How to setup the CartonCloud / Xero Integration:

Connecting to Xero can be broken into 3 main parts:

  1. Connecting CartonCloud to your Xero Organisation
  2. Linking each customer in CartonCloud with the appropriate contact in Xero
  3. Pushing Invoices to Xero
  4. (optional) - Go Completely Automated

1. Connecting CartonCloud to your Xero Organisation

Firstly, go to your "Organisation Settings" page - you can get here by simply typing "Organisation" up in the top "search for anything" box:

Once there, go to the "Invoice" tab and click "Connect to Xero"

Xero will now ask you to provide authorization to CartonCloud so it can access your Xero account, click "Authorise".

Once that has been done, you'll be redirected back to CartonCloud and you'll be able to see the Xero Connection is now active

To configure which "Account" from your General Ledger to use for each type of payment, click on "Modify Settings".

Fields which can be modified:

NameThe name of the Accounting Connection, this is shown in several places throughout the app. If you create multiple accounting connections (ie: you are pushing invoices for different clients into different Xero accounts), then it's important to name them different from one another. ie: "Company A", "Company B"Xero Partner App
Start Date for Invoice/Bills

By default, if an invoice covers the week period: "2016-11-21" to "2016-11-27", then the Invoice uploaded to Xero will have an Invoice Date of "2016-11-28".

This field sets the number of days which should be added to the Invoice Ending Date, when uploaded to Xero . For example, if you wanted the invoice to have the same date as the last day of the invoice then you would enter the value 0, which would add 0 days to the End Date, making the Date "2016-11-27"


Start Date for Invoice / BillsDate of Invoice in Xero


1 (the day after the Invoice finished)
Chart of Accounts

CartonCloud uses various types of Income and Expense which can be mapped to specific accounts within Xero . Generally you'll link these to your income accounts which relate to that particular type of charging.

We suggest creating a unique account for each different revenue type as this allows you to report more accurately on where your revenue is coming from.
For example, in your Xero chart of accounts you should have an account for "Storage Income", which is used only for recording revenue from Storage of items in your warehouse.

All Expenses however (coming from Bills), are always linked to a single Expense Account. 

The Chart of Accounts can also be overwritten for specific Customers / Suppliers within the Edit Customers / Edit Suppliers pages.


Once you have linked up each of your accounts click "Save".

The chart of accounts is reloaded from Xero each time this page is reloaded, so if you make changes in your Chart of Accounts in Xero and want to show that on CartonCloud, just refresh the page on CartonCloud.

2. Linking each customer in CartonCloud with the appropriate contact in Xero

You now need to link each of your customers in CartonCloud with your contacts in Xero. This needs to be performed so that CartonCloud knows which Contact in Xero the invoice should be loaded against.

Firstly, go to the Customers page in CartonCloud (Contacts-->Customers).

Then click the More Dropdown and select "Bulk Link Customers to {the name of your Xero Connection}":

Note: The next page may take a while to load as it first downloads a list of all your Xero contacts and attempts to automatically match as many as possible.

You can now see a list of all your CartonCloud customers, and link them with the appropriate account in Xero

Firstly, search for each contact using the Search Box. If nothing is found, then use the button to Create a new Contact in Xero.

Once you're done linking each of your customers to your Xero Contacts, simply click "Save" at the bottom of the page.
If you ever need to change an individual customers link to Xero, simply go to the Edit page for the customer and use the "Invoice", "Accounting Connector" tab:

3. Pushing Invoices to Xero

If you have Existing Invoices in CartonCloud that you want to push to Xero (invoices that were created prior to linking the customer to Xero) , you first need to notify them that they can be pushed to Xero.

Select any invoices you want to link with Xero

Then scroll down and click "Link Accounting Connector".

Once this has been done, the Invoice will appear with a faded Xero logo. This means the Invoice is setup to be sent to Xero, but has not yet been sent

Now, go into the Invoice and you'll have the option to Upload to Xero. Click the Upload to Xero Button

Once the invoice has been uploaded, several more options become available:

Note that Every time the invoice is Uploaded to Xero a new Invoice is created - you cannot alter an existing invoice by re-uploading.

You can email the invoice to the customer as well, just click Email Invoice to Customer

If the customers email address is not auto-populating in the email field, then you can add this into the customers email settings. See section  4.3 in 'Go Completely Automated' below.

4. Go Completely Automated:

If you want to totally automate your invoicing, so that everything (charges, invoice generation, push to Xero and emailing of invoices) is automated, you'll be happy to know you can.
Provided the Invoice does not have any charge errors (requiring manual intervention), complete automation is possible, and recommended - once you've testing everything is working correctly of course!

You should only move to complete automation once you're happy that your rates are correct, that you have everything connected correctly between CartonCloud and Xero.

4.1. Xero Invoice Status to Approved
Complete automation requires "Approved" invoices to be sent to Xero, so make sure your Xero Invoice Status is set to "Approved".
Once you've done this - more options will be available in the Details tab.

4.2. Turn on automatic Invoicing
Next, from the Invoice / Details page, ensure you have 'Automatically Upload Invoices to Xero' and 'Automatically Email Invoice ...' enabled.

4.3. Ensure you have your customers email address setup to receive 'Invoice Notifications'

For the email to be sent automatically, you need to have at lease one email address setup to receive Invoice Notifications.
If you don't, simply add a new email and enable Invoice Notifications for that email address.

You're all done! Now just keep an eye on any Invoices that have Charge Errors!