Overview
Once you’ve integrated Anrok & NetSuite with SuiteTax and configured your NetSuite account, 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.
Why am I receiving an "Unknown product ID" error on my Unprocessed Transactions page?This error occurs when Anrok receives a NetSuite product 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 is applied to the item — based on the configured product type and tax category. To configure a NetSuite product into Anrok as a product ID:
|
How does Anrok process NetSuite's discounts, credit memos, & voids?Discounts All NetSuite discounts must be applied before the invoice is finalized; any price adjustments made after that point are considered credit memos (see below). Discounts applied in NetSuite are pre-tax and are applied proportionally across the line items on an invoice. Pre-tax means that tax will be calculated based on the discounted value of the line item rather than the full value. Note: the implications of this may be significant in cases where you have multiple line items for different product types on the same invoice (e.g. a SaaS product with an additional services fee), especially if the discount is thought of as discounting or refunding a particular cost that has higher taxability than the other item(s). If you want a discount to apply to a specific subset of line items, we recommend using negative line items associated with those products in order for tax to be assessed based on the distinct product categories of those line items. Credit Memos When issuing credit memos in NetSuite, we recommend that you specify the line item(s) being credited, so we can take into account any differences in the taxability of line items on the invoice. You should not credit any tax amount that was added by Anrok; we will do this automatically via our NetSuite integration. Tax credits will be reflected in Anrok and filed accordingly on your returns. When creating a credit memo in NetSuite, credit memos behave similarly to invoices on NetSuite. Tax can be calculated by pressing "Preview Tax" or when saving or updating the credit memo. Anrok records credit memos as negative value transactions. Voids If an invoice is in dispute or considered uncollectible and you don't want to owe taxes on it, you need to void the invoice in NetSuite. If the invoice is voided in the same tax filing period in which it was created, the tax will be adjusted within that same period. If the void occurs after tax has already been reported and remitted, you will see a credit in the next filing period for the amount previously paid. Please note that when you void or delete a transaction in NetSuite, the associated transaction in Anrok is voided for both delete and void events. |
Why is my invoice's tax amount showing as $0.00 in NetSuite?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 at the bottom of your NetSuite invoice. For this reason, before you save the invoice, the calculated tax amount will be shown 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 you are note remitting in the jurisdiction or that the accounting date listed is before your tax collection date. To check a remitting jurisdictions tax collection start date:
3. Make sure "United States" is selected as the transaction's nexus.NetSuite uses the Subsidiary address (not the customer address) to determine nexus. Since you are invoicing your customers (whether domestic or international) from a US subsidiary, the "United States" nexus must be selected on international invoices. For this reason, Anrok requires the "United States" nexus to be selected (regardless of the customer's location) for the transaction to be to sent to Anrok. To check and update a transactions nexus:
|
Tax Calculation Plugin errors
Here is the list of error types and their meanings — which you can use to determine the best course of action for resolving an error:
| Error type | Meaning |
|
The tax registrations setup for the subsidiary associated with the transaction is incomplete. |
You'll see this error if we were unable to find a product ID on one or more of the line items for the transaction. The presence of product IDs is critical for Anrok to be able to determine the taxability of your transactions, so you'll want to ensure that these are always present on your invoices. To fix this, you'll need to add the product ID(s) to this transaction within your billing system. If the invoice is no longer editable, contact us for support in reflecting the transaction in Anrok. |
|
Invalid tax calculation output: tax summary lines array must contain exactly one entry for every tax code used in tax details. |
You'll see this error if one or more of the products on the invoice haven't been configured in Anrok. We need product IDs to be set up in Anrok so we can determine the taxability of your transactions in the relevant jurisdiction and collect tax when relevant. To fix this, you can configure new products from the Product IDs page within Anrok or by using the "Configure new products" option from your Transaction Sources page. If you have processes in place that make it difficult to configure all new products in Anrok in a timely manner, feel free to contact us to discuss whether a default configuration might make sense for your account. |
|
Could not determine the appropriate Nexus to be used with Tax Type |
You'll see this error if we were unable to find an address on the transaction we received from your billing system. Without an address, Anrok is unable to determine which jurisdiction and tax codes to apply to a transaction. To fix this, simply set the address for this transaction or customer record within your billing system. Note that when multiple addresses are present on an invoice, Anrok has a hierarchy we use for each integration to determine which address to prioritize, and addresses with insufficient information may be considered missing. If there's a specific address that you want to be used, we'd recommend either updating both the shipping and billing addresses or removing the other address entirely. |
|
You have entered an Invalid Field Value |
You'll see this error if we found an address on the transaction but no country was specified. To fix this, simply set the address country on the address within your billing system. Note that when multiple addresses are present on an invoice, Anrok has a hierarchy we use for each integration to determine which address to prioritize. If there's a specific address that you want to be used, we'd recommend either updating both the shipping and billing addresses or removing the other address entirely. |
|
Error calculating sales tax: "Calculating sales tax: {\"type\":\"productExternalIdUnknown\",\"value\":\" |
This error occurs when Anrok receives a NetSuite product that does not have a corresponding Anrok product ID. To configure a NetSuite product into Anrok as a product ID:
|