Skip to main content
Anrok is one of the external tax providers Alguna can use to calculate sales tax, VAT and GST: with it connected, Alguna asks Anrok to determine tax for every invoice line, checkout, and POST /tax/calculations request from the customer’s address and the line’s tax code, and records finalized invoices and credit notes in Anrok so they flow into your filings. Use it when Anrok is your system of record for registrations and returns. The alternatives are rules you maintain yourself (Alguna Tax) or Stripe Tax; how tax fits into invoicing is in Tax overview. This integration requires an Anrok seller account.

​
Set up Anrok

Production: https://app.alguna.io/settings/connections/integrations
Sandbox: https://app.sandbox.alguna.io/settings/connections/integrations
1

Create an API key in Anrok

In Anrok, create an API key for the seller account you want Alguna to use. The key needs access to products and transactions: Alguna creates products in your account and records transactions against them. Use a sandbox seller account for the Alguna sandbox and your production seller account for production, since products and transactions live per seller account.
2

Connect Anrok

Log into the correct environment and go to Settings → Connections → Integrations. Click Connect on Anrok and paste the API key. Alguna stores the key encrypted and validates it against Anrok before saving. If you run more than one Anrok seller account, give each connection a seller name so you can tell them apart.
3

Enable Anrok as your tax provider

In Settings → Workflows → Billing → Tax, choose the legal entity and set its tax provider to your Anrok connection. The engine is chosen per legal entity, so other entities can keep using Alguna Tax or Stripe Tax.
4

Choose calculation only, or calculation and reporting

On the same screen, leave the engine mode on its default to have Alguna record finalized invoices and credit notes in Anrok for filing. Switch to Calculation only if you file from another source and only want Anrok’s rates on your documents.
5

Check your registrations in Anrok

Anrok only collects tax where your seller account has a registration. A calculation for a jurisdiction you are not registered in returns zero tax with the reason not_collecting. Add registrations in Anrok, not in Alguna.

​
How products map to Anrok

You never map products by hand. Alguna assigns each line a canonical txcd_… tax code, either from the product or per line on POST /tax/calculations, and creates a matching product in your Anrok account: A line without a tax code uses txcd_business_saas. The full code list is in External Tax Providers. Each product is created with the product tax category Alguna considers the default for that code. To change how a code is taxed, open the product in Anrok and change its product tax category there. Alguna never overwrites a category you have set, and re-running provisioning leaves existing products untouched. Products you create in Anrok yourself are not used by Alguna, so tune the alguna: and alguna-product: products rather than creating new ones.
If a calculation is rejected with productExternalIdUnknown, the products for your seller account have not been provisioned yet. Contact support@alguna.io with your organization name and we will complete provisioning. Nothing needs to change in Anrok.

​
Features Included

  • Tax is determined on every invoice line, on checkout, and on every POST /tax/calculations request, using the customer’s address, tax IDs, and the line’s tax code. Reverse charge and exemptions are decided by Anrok from the customer’s tax IDs and any exemption certificates in your seller account.
  • Calculations do not enter your Anrok filings. Only finalized documents are recorded.
  • In calculation and reporting mode, issued invoices are recorded in Anrok as transactions, updated when their amounts change, and voided when the invoice is voided. Applied credit notes reduce the recorded invoice, and voided credit notes reverse that reduction. Imported invoices are never recorded.
  • Every recorded transaction is listed under Tax transactions in the dashboard, with the amount Anrok recorded next to the amount printed on the document.
  • Calculations can be read back and run ad hoc through the Tax endpoints.