Here are some common errors you may see with our Xero integration. Find the error message below that matches what you’re seeing, then follow the instructions to fix it.
Archived contact
The contact with the specified contact details has been archived. The contact must be un-archived before creating new invoices or credit notes. |
What went wrong?
To raise invoices, each customer in Upstock needs to be matched with a contact in Xero. In this case the contact in Xero has been archived.
How to fix
You can either restore the archived contact in Xero, or choose a new contact to match with in Upstock.
To restore the archived contact in Xero:
In Xero, got to Contacts
Select the Archived tab.
Click on the contact to open their details, then click Restore.
To choose a new contact to match with in Upstock:
In Upstock, go to Customers
Select the customer
Go to the Profile tab
Under the Xero contact section click Edit
Search and select a different contact or add a new contact
Helpful articles
Restoring archived contacts in Xero
Item code not valid
Item code ‘CRBAGEL12’ is not validThe UnitAmount field is mandatory and cannot be derived from the Quantity and LineAmount fields. The LineAmount field is mandatory and cannot be derived from the Quantity and UnitAmount fields. |
What went wrong?
The product mentioned in the error message does not exist in Xero. Either the product has been deleted, or the product code has been updated. Product codes need to match across the two systems to automatically create invoices.
How to fix
Check the product is in Xero and if so, update the code.
In Xero go to Business › Products and services
Select the product
Select Edit item
Update the Code field to match what you have in Upstock
Select Save
If you can’t find the product, it may have been deleted. You’ll need to add a new product with the same code. Remember to set the sales account.
Helpful articles
No items available to sell
CRBAGEL12: Cinnamon Raisin Bagel 12 Pack - No items available to sell. |
What went wrong?
The product is a tracked inventory item in Xero. The stock on hand is less than what’s required for the order.
How to fix
To fix, you’ll need to increase the stock you have on hand.
In Xero go to Business › Products and services
Select the product
Click New adjustment.
In the Adjustment type field, select Increase quantity
Helpful articles
Increasing stock on hand in Xero
Item code changed
The TaxType field is mandatory |
What went wrong?
The product code has been updated in Xero, but not in Upstock.
How to fix
Import the product changes into Upstock.
In Upstock, go to Products › Import products
Select the product that has the updated code
Click Next then Import
Helpful articles
Xero plan limit reached
You have reached the limit of invoices you can approve. |
What went wrong?
The Xero plan you are on has a limited amount of invoices that can be approved.
How to fix
Upgrade your Xero plan.
Helpful links
Customer needs matching
InvalidProviderContact |
What went wrong?
The customer in Upstock needs to be matched with a contact in Xero. This is needed to automatically raise invoices.
How to fix
In Upstock, go to Customers
Select the customer
Go to the Profile tab
Under the Xero contact section click Edit
Search and select a different contact or add a new contact