Introduction
Once you’ve integrated Anrok & Xero, configured your Xero account, and checked out our best practices for invoicing in Xero, we understand you may encounter situations you haven't experienced before — which can bring about a few questions. Don't worry, many of these situations are completely normal your first time using the integration flow, so let's work through some of these commonly asked questions together.
Xero frequently asked questions:
Why is my invoice's tax amount showing as $0.00 in Xero?
1. See if you've saved the invoice yet.
For Anrok to calculate sales tax, the invoice must first be sent to Anrok. The invoice is sent to Anrok immediately after you click Save & close at the top of your Xero invoice. For this reason — before you save the invoice — the calculated tax amount will show as $0.00. The tax calculation will be displayed after you save and reloaded the invoice.
Once the invoice has been sent to Anrok, it will appear on your Transactions page — along with the customer and product/service information, the calculated tax amount, and the jurisdiction's return period.
2. Check if the accounting date is before the jurisdiction's tax collection start date.
If you've confirmed that the invoice has been saved and is present on your Transactions page, there is a chance that the accounting date listed is before your tax collection date. To check a jurisdictions tax collection start date:
- In the Anrok app
, go to Jurisdictions. Take me there!
- Select the Remitting tab, then select the jurisdiction.
- Under Jurisdiction details, review the Tax calculation state date.
3. Make sure you've selected the invoice's amounts to be Tax exclusive.
If the invoice is present on your Transaction page and is dated after the jurisdiction tax collection date, there is a possibility the amounts on the transaction have been marked as Tax inclusive instead of Tax exclusive. At this time, Anrok does not support tax inclusive pricing model, so all transactions are required to be tax exclusive. To mark a transaction as tax exclusive:
- In the Xero app
, go to the invoice you would like to edit.
- Under Amounts are, select Tax exclusive.
- When you are finished, click Save.
- Reload the invoice to view Anrok’s updated tax amount.
Why am I receiving an "Unknown product ID" error on my Unprocessed Transactions page?
Configure the Xero item into Anrok as a product ID.
This error occurs when Anrok receives a Xero item that does not have a corresponding Anrok product ID. For Anrok to calculate tax on an item in your invoice, you will need to configure the item as a product ID in Anrok. Doing so ensures that the correct tax rate and taxability are applied to the item — based on the configured product type and tax category. To configure a Xero item into Anrok as a product ID:
- In the Anrok app
- Under Integration sources, click the options menu button
next to Xero, then select Configure new products.
- Under New products detected, select a corresponding Product type and Tax category for each product detected. See What tax configuration should I select?
- If you'd like to assign a Product type and Tax category to multiple products at once, click the checkbox
next to each product, then select Batch assign.
- When you are finished, scroll down and click Add products.
Why am I receiving an "Internal" error on my Unprocessed Transactions page?
1. Make sure you've included an item on the invoice, not just a description.
- In the Xero app
- Under Item, click the empty box, then select an item to include on the invoice.
- When you are finished, click Save.
- Reload the invoice to view Anrok’s updated tax amount.
- In the Xero app
- Click New item, then under New item, add the following information:
- Code: add an item code to find and organize your items.
- Name: add an item name for internal use only.
- Next to Purchase, deselect the checkbox
.
- Under Sell, add the following information:
- Sale price: add the sale price of the item in your base currency.
- Sales account: select the default chart of accounts code for revenue received when selling the item.
- Tax rate: select Tax on Sales.
- When you are finished, click Save or Save & add another.
2. Make sure Tax on Sales has been selected as the tax rate.
For Anrok to read an invoice, all products and services included on the invoice must be marked as taxable. To mark all products and services as taxable:
- In the Xero app
- Under Tax Rate, select Tax on Sales (if not already selected).
- When you are finished, click Save.
- Reload the invoice to view Anrok’s updated tax amount.
If you are worried about a non-taxable product having getting taxed, you can always adjusts the product/service's product ID product type and category on the Product IDs page. If the customer is tax exempt, you can add the customer's tax exemption certificate on the Certificates page. If you are concerned the customer will be taxed in a jurisdiction you are not collecting sales tax, Anrok will determine every invoices taxability based on the customer's address and billing location.
How does Anrok process Xero's credit memos?
Anrok's Xero integration assesses taxability for your transactions by taking into account Credit Notes. The following is intended as a guide to help you understand the tax implications for applying them.
Credit Memos
Credit Notes in Xero are post-tax, meaning that the amount credited back to your customer is inclusive of tax. This means that if you issue, for example, a $50 credit on an invoice then that amount will be proportionally applied to include a refund of the relevant tax and the remaining amount towards the purchased items. Alternately, if you wanted to credit back 50% of a purchase, you'd need to credit half of the invoice total, inclusive of tax.
Please note that Xero uses Credit Notes for refunds and Anrok updates the original transaction when they are received (instead of creating a new transaction). For this reason, Credit notes/memos are a required way of recording credits/refunds.
We hope this guide was able to help you with your Anrok & Xero integration questions. As always, feel free to reach out to anrok@support.com if you have questions or if you'd like to troubleshoot with our team.