Skip to main content

​
Overview

​
Provider-specific behaviors

  • The transaction in Anrok includes the amount per line item and the specified tax code used for computation. Line item-level minimums or discounts are synced as separate (negative) line items.

​
Geographic coverage

US sales tax + global VAT/GST across 100+ countries.

​
Setup

​
Prerequisites

  1. Read the Anrok Getting Started Guide.
  2. Anrok account: ensure you have an Anrok account, and ideally an Anrok sandbox you can connect to your Orb test mode account. You can get a free Anrok sandbox by contacting the Anrok team.
  3. Physical nexus: ensure you’re correctly recording physical nexus, via the Jurisdictions tab and the “Manage Physical Nexus” button.
  4. Products in Anrok: create products in Anrok that associate a tax configuration to each product you sell in Orb. You’ll need these product IDs when configuring the integration in Orb.
  5. Customer exemptions in Anrok: upload valid exemption certificates for customers, using the Orb customer ID so Anrok applies them correctly when calculating tax.

​
Connecting your account

  1. Navigate to Settings > Taxes in the Orb dashboard.
  2. Select “Connect to Anrok.”
  3. Create an Anrok API key.
    1. In your Anrok account, go to Settings > Developers > Manage API Keys > New key.
  4. In Orb, enter your Anrok API key and API key secret. The sellerId is expected as part of the key, in the format /. Invalid credentials will error at this stage.

​
Setting up tax codes

Anrok tax code configuration Because different jurisdictions may tax items at different rates, register the type of product in your Anrok instance under the Product IDs section. Create a unique Anrok product for each type of product you sell — one Anrok product can map to multiple external product IDs of the same type. Orb tax code configuration Orb supports tax code configuration per Item. Items represent a sellable product or service in Orb and ensure invoice line items map correctly to your tax/accounting services. To configure, navigate to Settings > Items > Item name > edit, and fill in the External item ID with the ID of the corresponding Anrok product.

​
Sample request and response payload

The example below is illustrative of the shape Orb sends to and receives from Anrok today, based on Orb’s tax provider processors and test fixtures. Exact field names and structure can change as Anrok versions its API — confirm against current behavior before relying on it for integration work.

​
Request (Orb → Anrok)

{
  "customerId": "<orb_customer_id>",
  "customerName": "<customer_name>",
  "currencyCode": "USD",
  "customerAddress": {
    "line1": "345 California Floor 6",
    "city": "San Francisco",
    "country": "US",
    "postalCode": "94104",
    "region": "CA"
  },
  "accountingDate": "2022-09-01",
  "lineItems": [
    {
      "amount": 5000,
      "productExternalId": "custom-tax-code-price-id",
      "id": "bjur5ox8eqwHXgNa"
    }
  ]
}

​
Response (Anrok → Orb)

{
  "taxAmountToCollect": 825,
  "lineItems": [
    {
      "id": "line_item_1",
      "taxAmountToCollect": 825,
      "preTaxAmount": 10000,
      "jurises": [
        {
          "name": "US State",
          "notTaxedReason": null,
          "taxes": [
            {
              "taxName": "State Tax",
              "taxRate": 0.0825
            }
          ]
        }
      ]
    }
  ]
}

​
Reporting tax for filing

Once an invoice is issued or finalized (not when it’s paid), Orb makes a second call to Anrok to report the transaction for filing: POST /v1/seller/transactions/createOrUpdate. The reporting payload has the same shape as the calculation payload, with one addition — an id field set to the Orb invoice ID. 
{
  "id": "<invoice_id>",
  "customerId": "<orb_customer_id>",
  "customerName": "<customer_name>",
  "currencyCode": "USD",
  "customerAddress": {
    "line1": "345 California Floor 6",
    "city": "San Francisco",
    "country": "US",
    "postalCode": "94104",
    "region": "CA"
  },
  "accountingDate": "2022-09-01",
  "lineItems": [
    {
      "amount": 5000,
      "productExternalId": "custom-tax-code-price-id",
      "id": "bjur5ox8eqwHXgNa"
    }
  ]
}