How-to guides

​

Connect Anrok

​

Prerequisites

• You have an Anrok API key. You create API keys in Anrok, under Settings > Manage API keys.
• The Zenskar business entity does not have another third-party tax engine connected.
• Your role has the permissions in the following table.

1. Go to More > Integrations.
2. Click the Anrok card. To find the card, you can filter by Sales Tax.
3. Click NEW CONNECTION. NEW CONNECTION is unavailable while an Anrok connection has no Zenskar business entity. In that case, click Select Business Entity on that connection. Then continue from step 6.
4. In API Key, enter your Anrok API key.
5. Click Connect. If Anrok accepts the API key, the Anrok Setup page opens at the Connect step. If Anrok rejects the API key, Zenskar shows an error.
6. In Select Zenskar Entity, select the Zenskar business entity.
7. Click Save & Continue. Zenskar rejects a Zenskar business entity that already has another third-party tax engine connected.
8. On the Countries Serving step, add or edit the served countries of the Zenskar business entity. For each served country that Anrok should tax, select Anrok in Tax Engine. See Manage served countries.
9. Click Continue.
10. On the Tax Categories step, set the Anrok Tax Code of each Zenskar tax category that your Zenskar products use. See Map a Zenskar tax category to an Anrok tax code.
11. Click Finish Setup. The Connections tab of the Anrok page opens.

Zenskar creates the Anrok products of your existing Zenskar products.

---

​

Edit an Anrok connection

Editing an Anrok connection changes the served countries of its Zenskar business entity. It also changes the Anrok tax codes of the Zenskar tax categories. The Zenskar business entity of a connection cannot change.

​

Prerequisites

• The Anrok connection has a Zenskar business entity.
• Your role has the permissions in the following table.

1. Go to More > Integrations.
2. Click the Anrok card.
3. Click the Connections tab. Each connection on the tab shows its Account ID, Connected Entity, Connected On, Last Updated On, and Status. The status is Configured after the connection has a Zenskar business entity. Before that, it is Pending Configuration.
4. On the connection, click Edit. The Anrok Setup page opens at the Connect step. Select Zenskar Entity shows the Zenskar business entity of the connection. You cannot change it.
5. Click Continue. To go to a step directly, you can also click the step at the top of the page.
6. On the Countries Serving step, add or edit the served countries. See Manage served countries.
7. Click Continue.
8. On the Tax Categories step, change the Anrok Tax Code of the Zenskar tax categories. See Map a Zenskar tax category to an Anrok tax code.
9. Click Finish Setup.

Changes on these steps take effect as you make them. Finish Setup only returns to the Connections tab.

---

​

Map a Zenskar tax category to an Anrok tax code

​

Prerequisites

• Anrok is connected. The Anrok Tax Code field and column appear only after you connect Anrok.
• Your role has the permissions in the following table.

1. Go to Settings > Tax Configuration.
2. On the Tax Categories tab, in the actions menu of the Zenskar tax category, click Edit. The Edit Tax Category panel opens.
3. In Anrok Tax Code, search for the Anrok tax code by its name or ID. Then select it.
4. Click Save Changes.

To remove the Anrok tax code of a Zenskar tax category, click × next to the code. You can do this in the panel or in the column. Zenskar creates Anrok products for the Zenskar products of the Zenskar tax category.

---

​

Link a Zenskar customer to an Anrok customer

​

Prerequisites

• Anrok is connected to the Zenskar customer’s business entity. The Add Anrok ID button appears only then.
• The Anrok customer exists, and you have its customer ID from Anrok.
• Your role has the permissions in the following table.

1. Go to Customers, and open the Zenskar customer.
2. Click the Integrations tab.
3. Under Linked Integration Objects, click Add Anrok ID. The Add Anrok ID dialog opens.
4. In Anrok customer ID, enter the exact customer ID from Anrok. Search by name is not supported.
5. Click Look up. If Anrok has the Anrok customer, Zenskar shows its name and email. Zenskar shows an error in two cases: Anrok has no Anrok customer with this ID, or the Anrok customer is already linked to another Zenskar customer. In both cases, Save stays unavailable.
6. Click Save.

From the next tax calculation, Zenskar identifies the Zenskar customer to Anrok by the ID of the Anrok customer. See Anrok customers. To change the link, on the Anrok ID card, in the actions menu, click Edit. The Edit Anrok ID dialog opens. Then repeat steps 4 to 6. Save is available only for an ID that differs from the current one.

---

​

Check the Anrok transaction of a Zenskar invoice

​

Prerequisites

• The Zenskar invoice is approved, partially paid, paid, or void. The Integrations tab appears only on these invoices.
• Your role has the permissions in the following table.

1. Go to Invoices, and open the Zenskar invoice.
2. Click the Integrations tab. Under Linked Integration Objects, the Anrok ID card shows the ID of the Anrok transaction. To copy the ID, click the copy icon next to it. Under Integration Logs, each row is one sync event between Zenskar and Anrok for the Zenskar invoice. The row shows the event, its status, and its timestamp. To show only failed events, click Failed.
3. In Anrok, open Transactions, and search for the ID that you copied. The Anrok transaction shows the Anrok customer, the jurisdiction, and the sales, tax, and invoice amounts. If the integration worked, the amounts match the Zenskar invoice.

To check the sync events of all Zenskar invoices, go to More > Integrations, click the Anrok card, and then click the Logs tab. The tab has the same columns and filters as Integration Logs.

---

​

Disconnect Anrok

​

Prerequisites

• Your role has the permissions in the following table.

1. Go to More > Integrations.
2. Click the Anrok card.
3. Click the Connections tab.
4. On the connection, click Disconnect. The Delete Connector ID dialog opens.
5. Click Delete.

Zenskar removes the Anrok connection. The Anrok transactions stay in Anrok. Draft Zenskar invoices that Anrok priced are held at approval after the disconnect. To apply the new tax engine, regenerate them.