> ## Documentation Index
> Fetch the complete documentation index at: https://zenskar.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/docs/20260301/product-modules/settings/glossary.md#business-entity) does not have another third-party [tax engine](/docs/20260301/product-modules/settings/glossary.md#tax-engine) connected.
* Your role has the permissions in the following table.

| Action | Permission | Group |
| - | - | - |
| Enter the API key | None | |
| Select the Zenskar business entity | **Can Read Integration Config** | **INTEGRATION\_CONFIG** |
| Select the Zenskar business entity | **Can Create Integration Config** | **INTEGRATION\_CONFIG** |
| Set the [served countries](/docs/20260301/product-modules/settings/glossary.md#served-country) and the [Anrok tax codes](/docs/20260301/product-modules/settings/glossary.md#anrok-tax-code) | **Can Update Organisation Config** | **ORGANISATION\_CONFIG** |

> [!WARNING]
>
> If your Anrok account is not registered in a jurisdiction, Anrok returns no tax for that jurisdiction. Neither Anrok nor Zenskar shows an error. Before you select Anrok as the tax engine of a served country, register the jurisdictions in Anrok where you collect tax.

1. Go to **More** > **Integrations**.
2. Click the **Anrok** card. To find the card, you can filter by **Sales Tax**.

   ![The Anrok card on the Integrations page, with the Sales Tax filter](https://assets.zenskar.com/20260301/sales-tax-anrok-integrations-card.png)
3. Click **NEW CONNECTION**.

   ![The Anrok page with NEW CONNECTION](https://assets.zenskar.com/20260301/sales-tax-anrok-connector-overview.png)

   **NEW CONNECTION** is unavailable while an [Anrok connection](/docs/20260301/product-modules/settings/glossary.md#anrok-connection) has no Zenskar business entity. In that case, click **Select Business Entity** on that connection. Then continue from step 6.

   ![An Anrok connection without a business entity, with Select Business Entity](https://assets.zenskar.com/20260301/sales-tax-anrok-connection-pending-configuration.png)
4. In **API Key**, enter your Anrok API key.

   ![The Anrok connection form with the API Key field](https://assets.zenskar.com/20260301/sales-tax-anrok-connect-form.png)
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.

   ![The Connect step of the Anrok Setup page](https://assets.zenskar.com/20260301/sales-tax-anrok-setup-connect-step.png)
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](/docs/20260301/product-modules/settings/tax-configuration/how-to-guides.md#manage-served-countries).

   ![The Countries Serving step of the Anrok Setup page](https://assets.zenskar.com/20260301/sales-tax-anrok-setup-countries-step.png)

   ![The Add Country panel with Tax Engine set to Anrok](https://assets.zenskar.com/20260301/sales-tax-anrok-add-country-tax-engine.png)
9. Click **Continue**.
10. On the **Tax Categories** step, set the **Anrok Tax Code** of each Zenskar [tax category](/docs/20260301/product-modules/settings/glossary.md#tax-category) that your Zenskar products use. See [Map a Zenskar tax category to an Anrok tax code](#map-a-zenskar-tax-category-to-an-anrok-tax-code).

    ![The Tax Categories step of the Anrok Setup page, with the Anrok tax code list open](https://assets.zenskar.com/20260301/sales-tax-anrok-setup-tax-categories-step.png)
11. Click **Finish Setup**.

    The **Connections** tab of the Anrok page opens.

Zenskar creates the [Anrok products](/docs/20260301/product-modules/settings/glossary.md#anrok-product) of your existing Zenskar products.

> [!NOTE]
>
> Zenskar ignores the Anrok products that you created directly in Anrok. Zenskar creates its own Anrok products. Zenskar does not match the two.

***

## 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.

| Action | Permission | Group |
| - | - | - |
| Open the **Anrok Setup** page | **Can Read Integration Config** | **INTEGRATION\_CONFIG** |
| Change the served countries and the Anrok tax codes | **Can Update Organisation Config** | **ORGANISATION\_CONFIG** |

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](/docs/20260301/product-modules/settings/tax-configuration/how-to-guides.md#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](#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](#connect-anrok).
* Your role has the permissions in the following table.

| Action | Permission | Group |
| - | - | - |
| Map a Zenskar tax category to an Anrok tax code | **Can Update Organisation Config** | **ORGANISATION\_CONFIG** |

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.

   ![The Anrok Tax Code field in the tax-category panel](https://assets.zenskar.com/20260301/sales-tax-anrok-add-tax-category.png)
4. Click **Save Changes**.

   ![The Anrok Tax Code column of the tax-category list](https://assets.zenskar.com/20260301/sales-tax-anrok-tax-categories-list.png)

> [!NOTE]
>
> You can also map the code in the **Anrok Tax Code** column of the tax-category list. Click **Map Anrok code** or the current code. Then select the Anrok tax code. Zenskar saves the selection right away.

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](/docs/20260301/product-modules/settings/glossary.md#anrok-customer) exists, and you have its customer ID from Anrok.
* Your role has the permissions in the following table.

| Action | Permission | Group |
| - | - | - |
| Link a Zenskar customer to an Anrok customer | **Can Read Customer** | **CUSTOMER** |
| Link a Zenskar customer to an Anrok customer | **Can Update Customer** | **CUSTOMER** |
| Link a Zenskar customer to an Anrok customer | **Can Update Customer Integration** | **CUSTOMER\_INTEGRATION** |

> [!CAUTION]
>
> After you link a Zenskar customer, you cannot remove the link. You can only change it to another Anrok customer.

1. Go to **Customers**, and open the Zenskar customer.
2. Click the **Integrations** tab.

   ![The Integrations tab of a Zenskar customer, with Add Anrok ID under Linked Integration Objects](https://assets.zenskar.com/20260301/sales-tax-anrok-customer-integrations-tab.png)
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.

   ![The Add Anrok ID dialog](https://assets.zenskar.com/20260301/sales-tax-anrok-add-anrok-id-dialog.png)
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](/docs/20260301/third-party-integrations/tax-automation/anrok/concepts.md#anrok-customers-who-anrok-taxes).

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.

| Action | Permission | Group |
| - | - | - |
| Open the Zenskar invoice | **Can Read Invoice** | **INVOICE** |
| View the **Logs** tab | None | |

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](/docs/20260301/product-modules/settings/glossary.md#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**.

   ![The Integrations tab of an approved invoice](https://assets.zenskar.com/20260301/sales-tax-anrok-invoice-integrations-tab.png)
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.

   ![The matching Anrok transaction in the Transactions list of Anrok](https://assets.zenskar.com/20260301/sales-tax-anrok-console-transactions.png)

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**.

![The Logs tab of the Anrok page](https://assets.zenskar.com/20260301/sales-tax-anrok-connector-logs.png)

***

## Disconnect Anrok

### Prerequisites

* Your role has the permissions in the following table.

| Action | Permission | Group |
| - | - | - |
| Disconnect Anrok | None | |

> [!WARNING]
>
> Disconnecting Anrok does not change the tax engine of any served country. Generating Zenskar invoices fails for served countries that still use Anrok. Before you disconnect, change the tax engine of those served countries. See [Change the tax engine for a served country](/docs/20260301/product-modules/settings/tax-configuration/how-to-guides.md#change-the-tax-engine-for-a-served-country).

> [!CAUTION]
>
> Disconnecting Anrok removes every link between Zenskar and the Anrok account. Zenskar customers lose their links to Anrok customers. Zenskar invoices lose their links to Anrok transactions. You cannot undo this. After you connect Anrok again, link each Zenskar customer again. See [Link a Zenskar customer to an Anrok customer](#link-a-zenskar-customer-to-an-anrok-customer).

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.