Xero integration

Step 1: Connect to Xero

To interact with Xero, Tradevine needs to be authorised by Xero.

First you will need your login details for Xero, so you will need a Xero account, if you don't have one already. Then you can log into Tradevine and set up an authorised connection. The Xero Integration screen can be found under the Settings cog icon.

On Step 1 use the Connect to Xero button to authorise and connect Tradevine to Xero.

Authorise Tradevine

The first time you authorise you will need to select the Authorise Tradevine button.

If you are not already logged into Xero, then you will be prompted to log into Xero. Then you will be requested to Deny or Allow Tradevine access. Select the Allow button and wait for the screen to fall back to Tradevine.

Once you are connected you can continue with setting up Xero.

You will only have to re-authorise once each year. You can re-authorise at anytime and the authorisation will be good for another year.

To re-authorise expand the Authorisation section and select the Re-authorise button. The process should be the same as when you first authorised.


Step 2: Map Accounts

Note You might like to get your accountant to assist with setting up the account mappings. The expected Xero account types for the account mappings are indicated in the square brackets below.


Sales [Revenue Account]
All product sales are coded against this account.
Shipping (Sales) [Revenue Account]
Account to where shipping sales are coded against, this could be the same account as the Sales account, but can be different for information and reporting purposes.


Shipping (Expense) [Expense Account]
Any shipping expenses incurred are coded to this account.
Trade Me Pay Now Fees [Expense Account]
Optional. Account to where TM Pay Now Fees will be coded against, Tradevine adds this line to an Invoice when Pay Now is used as a payment method, so that when Pay Now payments are transferred into your account, the payment will reconcile with the invoice in Xero. This account is not mandatory to map as not all Trade Me sellers will be using the Pay Now feature. If we detect that you are a Trade Me Top Seller then we will use the 1.65% rate instead of the default 1.95% rate.


Stock on Hand [Current Asset]
Value of stock that has been purchased but not sold.
Cost of Goods Sold [Direct Cost]
Inventory costs of the stock a business has sold.
Obsolete Stock [Expense]
Account to where obsolete stock will be written off.
Stock Breakage [Expense]
Account to where any stock breakages will be written off.
Inventory Variances [Expense]
Account to use for any inventory adjustments.


Cash [Bank Account]
Optional. Account where all cash sales will be coded against.
Tracking Categories
Optional. Hook this in if you have configured Tracking in Xero. Useful for tracking sales from multiple sales channels.

Here is an example of the accounts set up with Xero. Please note that all inventory adjustments for breakage, obsolete stock and inventory variances are going to a single account, but if you wanted to track these separately, you would code these to three separate accounts.


Many of the account mappings are mandatory and if these are not mapped, then your sales orders, goods receipts and inventory journals will not be created in Xero. When the mandatory accounts have not been mapped you will see an on-screen message similar to this:

The Trade Me Pay Now Fees and the Cash account mappings are not mandatory.

We disable the integration if any of the mappings are missing because it can cause issues in Xero.


Step 3: Importing Xero contacts into Tradevine

You can import all your Xero contacts into Tradevine with a click of a button. This can be run at any time and will only import contacts that don't already exist in Tradevine.

NB We will only import contacts which have had payable or receivable invoices raised against them (i.e. Xero customer/suppliers).

During the import, we will only create new records in Tradevine. We will not update imported Xero contact records in Tradevine, that are updated in Xero after the initial import.


Manually turn Xero off

You can suspend Xero temporarily or permanently at any time by selecting the Turn Off Xero Integration button. You will then be presented with a warning dialogue, which will outline the potential hazards of doing this.

You can turn Xero back on at any time by then selecting the Turn On Xero Integration button.


Re-authorise Xero

You can re-authorise Xero at any time. Simply access step 1. Occasionally the Xero authorisation may unexpectedly drop off. This will be highlighted on your Dashboard screen. The link from the Dashboard screen should take you directly to a screen where you can easily re-authorise. Alternatively, any Xero related screen should automatically link you through to the re-authorisation screen when the authorisation drops off.