Introduction
Transactions that are listed in your Unprocessed Transactions dashboard are ones that Anrok was unable to ingest and/or update when processing the request from your external billing system. This typically means that we weren't able to add tax for those transactions and haven't included them on your tax returns. In some cases, you may also see transactions listed that are in Anrok but showing an outdated version because the later update was unsuccessful.
We designed this dashboard to provide greater visibility into processing errors between Anrok and the billing systems we integrate with so that sellers can directly troubleshoot and resolve any issues that arise in real-time. We hope that this tool becomes a way to monitor and quickly resolve any compliance gaps or data quality issues.
Monitor unprocessed transactions
When a new transaction has appeared in your Unprocessed Transaction dashboard, you will see a red dot in the sidebar next to Unprocessed transactions.
We recommend checking the Unprocessed Transactions dashboard whenever you do a large billing run (e.g. if you invoice your customers monthly) and/or on an ongoing basis to monitor and manage any taxation issues. For most sellers, we'd suggest using the dashboard like an inbox and actioning each transaction listed, using the bulk retry/archive features as needed.
Note
Not all transactions shown in the dashboard have immediate tax implications, but ingesting them into Anrok will ensure that we're able to track your nexus and exposure accurately and keep you compliant.
Try monitoring your unprocessed transactions in the demo above ☝️
-
In the Anrok app
, go to Unprocessed transactions. Take me there!
- Under the Unprocessed tab, review the unprocessed transaction(s).
- Scroll to the right to view the Error type and Error value, then determine the best method for resolving that type of error. See Types of errors.
- If you have a large number of unprocessed transactions, click Export all to view them in a CSV file.
- Under Transaction ID, you can click the transaction link to make edits to the transaction directly in your billing system.
Retry unprocessed transactions
Successfully retrying a transaction from the dashboard means that the underlying error has been resolved and that Anrok was able to ingest the transaction and add it to an open tax return, if relevant. If the transaction is taxable, we'll also attempt to add/update tax, though this may not be possible depending on whether the invoice in your billing system is still editable.
Any taxable transactions that are successfully retried will be added to your open tax return for that jurisdiction regardless of whether tax was able to be collected on the invoice. You can choose to exclude those transactions by editing your return(s) prior to filing if you prefer not to pay the tax due out-of-pocket. See Exclude transactions for your returns.
Try retrying your unprocessed transactions in the demo above ☝️
-
In the Anrok app
- Under the Unprocessed tab, review the unprocessed transaction(s).
- After you've resolved a transaction's underlying error, click Retry to reprocess the transaction.
-
If you'd like to reprocess multiple transactions at once, click the checkbox
next to each transaction, then select Retry selected.
- If you'd like to reprocess all of your transactions at one, click the checkbox
- Review the number of transactions that were reprocessed successfully.
Archive unprocessed transactions
Archiving a transaction will not block Anrok from attempting to re-process it, but will remove it permanently from your active errors list. We recommend archiving transactions that you don't have the ability or motivation to resolve, such as historical addresses that are missing if the volume of those errors is insignificant.
Note
Anrok will auto-archive any "Address country unsupported" errors since those are expected for international sales.
Try archiving your unprocessed transactions in the demo above ☝️
-
In the Anrok app
- Under the Unprocessed tab, review your unprocessed transaction(s).
- If the transaction is insignificant and you do not have the motivation to resolve it, click Archive.
-
If you'd like to archive multiple transactions at once, click the checkbox
- If you'd like to archive all of your transactions at one, click the checkbox
- Click the Archived tab to view all of your archived unprocessed transactions.
Types of 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 |
|
Missing product ID |
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. |
|
Unknown product ID |
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. |
|
Missing address |
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. |
|
Missing address country |
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. |
|
Unsupported address country |
You'll see this error if we found a partial address on the transaction we received from your billing system, but were unable to resolve this partial address into an actual location. Anrok is usually able to determine a good enough location to look up tax codes from a partial address, but sometimes this isn't possible. To fix this, make sure the address on the transaction is correct within your billing system, and fill in more details if possible. 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. |
|
Malformed address |
You'll see this error if we found a partial address on the transaction we received from your billing system, but were unable to resolve this partial address into an actual location. Anrok is usually able to determine a good enough location to look up tax codes from a partial address, but sometimes this isn't possible. To fix this, make sure the address on the transaction is correct within your billing system, and fill in more details if possible. 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. |
|
Missing line items |
You'll see this error if the transaction we received from your billing system didn't contain any line items. Without line items, Anrok isn't aware of what products are included and what the resulting taxability should be. To fix this, you'll need add line items to the transaction within your billing system. You may also need to change your billing processes to ensure all future transactions contain line items and product IDs. If the invoice is no longer editable, contact us for support in reflecting the transaction in Anrok. |
|
Currency not supported |
You'll see this error if the transaction we received from your billing system was in a currency not supported by Anrok. To fix this, make sure the currency on the transaction is correct within your billing system. If it is, you can archive the transaction, and Anrok will no longer show you errors stemming from attempts to process it. |
|
Transaction already filed |
You'll see this error if a previously filed transaction was updated in your billing system and is unable to be modified in Anrok. Please contact us for support in understanding and resolving these errors. |
|
Internal error |
You'll see this error if some other kind of error occurred when trying to process the transaction. Generally we'd recommend retrying these transactions to check whether the initial error has already been resolved. If this error persists, please contact us for support in understanding and resolving these errors. |
|
Invoice too far in future |
You'll see this error if the transaction is too far in the future to accurately calculate tax. Anrok accepts dates up to 31 days in the future. To resolve this error, adjust the date of the transaction or retry the request closer to the transaction date. |
Note
Due to variations in how our customers use Product IDs and set up their integrations, having a lot of errors in your Unprocessed Transactions dashboard may or may not be a cause for concern. If you're concerned about your error volume or unclear on how to resolve them, feel free to contact us to review your errors.