External Tax Providers

An external tax provider replaces Alguna’s rule table with a tax engine that determines the correct rate across country, state, county, and city jurisdictions from two inputs: each line’s tax code and the customer’s address. The engine keeps rates and nexus rules current. Use one when you sell into many jurisdictions, need per-product taxability, or want registrations and filings handled by a specialist. The engine is chosen per legal entity; Alguna Tax remains available for other entities. See the Tax overview.

Supported engines

Engine	Notes
Anrok	Sales tax and VAT/GST determination for SaaS and digital goods, with finalized invoices recorded for filing. Alguna provisions one Anrok product per canonical tax code, so no manual product mapping is needed. See Anrok.
Stripe Tax	Automatic tax calculation through your Stripe account. See Stripe Tax.

How it works

With a provider connected, Alguna does not apply your own rules. For every invoice line — and every line in a POST /tax/calculations request — it sends the line’s tax code and the customer’s address to the engine, which returns the tax amount, rate, type, and reason. The result lands on the line as tax_rate, tax_amount, tax_type, and tax_reason, exactly as with Alguna Tax. You assign a canonical tax code to each product, or pass one per line through the API. You never deal with an engine’s native codes: Alguna translates the canonical code into whatever the configured provider expects, so switching engines does not require re-coding your catalogue.

Assigning tax codes

On products

Set tax_code when creating or updating a product. It applies to every invoice line for that product. See Create a product.

curl -X PATCH https://api.alguna.io/products/prod_abc123 \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{ "tax_code": "txcd_business_saas_storage" }'

import os

import requests

response = requests.patch(
    "https://api.alguna.io/products/prod_abc123",
    headers={
        "Authorization": f"Bearer {os.environ['ALGUNA_API_KEY']}",
        "Alguna-Version": "2026-04-01",
        "Content-Type": "application/json",
    },
    json={"tax_code": "txcd_business_saas_storage"},
    timeout=10,
)
response.raise_for_status()
print(response.json()["tax_code"])

await alguna.products.update("prod_abc123", { tax_code: "txcd_business_saas_storage" });

Per line in a tax calculation

POST /tax/calculations takes tax_code on each line item, for baskets that are priced outside the catalogue. A line without one resolves to txcd_business_saas. See the Tax overview.

Tax codes

Alguna owns a provider-neutral taxonomy. Each code is a txcd_… identifier that captures both the product category and the audience:

Audience is part of the code. Most categories come as a txcd_business_* / txcd_consumer_* pair. Pick the one matching who you sell to, since taxability can differ.
Default. txcd_business_saas. A product or line with no code resolves here.
Exempt. txcd_exempt marks a line as not subject to tax.

You only ever supply the canonical txcd_… code. Alguna maps it to the provider’s native code.

Tax code reference

The taxonomy is exhaustive. Every canonical code Alguna recognises is listed below.

Canonical code	Description
`txcd_business_saas` (default)	SaaS - General (business)
`txcd_consumer_saas`	SaaS - General (consumer)
`txcd_business_saas_security`	SaaS - Security (business)
`txcd_consumer_saas_security`	SaaS - Security (consumer)
`txcd_business_saas_storage`	SaaS - Storage (business)
`txcd_consumer_saas_storage`	SaaS - Storage (consumer)
`txcd_software_onprem`	SaaS - On-prem
`txcd_business_paas`	PaaS - General (business)
`txcd_consumer_paas`	PaaS - General (consumer)
`txcd_business_iaas`	IaaS - General (business)
`txcd_consumer_iaas`	IaaS - General (consumer)
`txcd_business_web_hosting`	Web hosting (business)
`txcd_consumer_web_hosting`	Web hosting (consumer)
`txcd_business_domain_names`	Domain name sales (business)
`txcd_consumer_domain_names`	Domain name sales (consumer)
`txcd_business_software_download`	Downloaded software (business)
`txcd_consumer_software_download`	Downloaded software (consumer)
`txcd_business_software_maintenance_optional`	Software maintenance automated - optional (business)
`txcd_consumer_software_maintenance_optional`	Software maintenance automated - optional (consumer)
`txcd_business_people_services_mandatory`	People services - mandatory (business)
`txcd_consumer_people_services_mandatory`	People services - mandatory (consumer)
`txcd_business_people_services_optional`	People services - optional (business)
`txcd_consumer_people_services_optional`	People services - optional (consumer)
`txcd_business_digital_subscription`	Digital goods (subscription) - General (business)
`txcd_consumer_digital_subscription`	Digital goods (subscription) - General (consumer)
`txcd_business_gaming_subscription`	Gaming - subscription (business)
`txcd_consumer_gaming_subscription`	Gaming - subscription (consumer)
`txcd_business_video_subscription`	Video - subscription (business)
`txcd_consumer_video_subscription`	Video - subscription (consumer)
`txcd_business_photography_subscription`	Photography - subscription (business)
`txcd_consumer_photography_subscription`	Photography - subscription (consumer)
`txcd_business_music_subscription`	Music - subscription (business)
`txcd_consumer_music_subscription`	Music - subscription (consumer)
`txcd_business_ebook_subscription`	E-books - subscription (business)
`txcd_consumer_ebook_subscription`	E-books - subscription (consumer)
`txcd_business_in_app_subscription`	Digital tokens/in-app - subscription (business)
`txcd_consumer_in_app_subscription`	Digital tokens/in-app - subscription (consumer)
`txcd_business_dataset_subscription`	Data sets - subscription (business)
`txcd_consumer_dataset_subscription`	Data sets - subscription (consumer)
`txcd_business_digital_permanent`	Digital goods (permanent) - General (business)
`txcd_consumer_digital_permanent`	Digital goods (permanent) - General (consumer)
`txcd_business_gaming_permanent`	Gaming - permanent (business)
`txcd_consumer_gaming_permanent`	Gaming - permanent (consumer)
`txcd_business_video_permanent`	Video - permanent (business)
`txcd_consumer_video_permanent`	Video - permanent (consumer)
`txcd_business_photography_permanent`	Photography - permanent (business)
`txcd_consumer_photography_permanent`	Photography - permanent (consumer)
`txcd_business_music_permanent`	Music - permanent (business)
`txcd_consumer_music_permanent`	Music - permanent (consumer)
`txcd_business_nft`	NFTs (business)
`txcd_consumer_nft`	NFTs (consumer)
`txcd_business_ebook_permanent`	E-books - permanent (business)
`txcd_consumer_ebook_permanent`	E-books - permanent (consumer)
`txcd_business_in_app_permanent`	Digital tokens/in-app - permanent (business)
`txcd_consumer_in_app_permanent`	Digital tokens/in-app - permanent (consumer)
`txcd_business_dataset_permanent`	Data sets - permanent (business)
`txcd_consumer_dataset_permanent`	Data sets - permanent (consumer)
`txcd_business_digital_advertising`	Digital advertising (business)
`txcd_consumer_digital_advertising`	Digital advertising (consumer)
`txcd_exempt`	Exempt

Customer-side inputs

The engine also uses what is on the customer record: the billing address and tax_country, and the tax_id (for reverse charge and validation). A per-customer tax_rate and tax_reason, when set, override what the engine returns. See Customer Tax Settings. On POST /tax/calculations the same inputs are passed inline as customer.address and customer.tax_ids.

Next steps

Tax overview

Calculate tax through the API and issue invoices from the result.

Anrok

Connect Anrok to a legal entity.

Stripe Tax

Connect Stripe Tax to a legal entity.

Overview

Guides

Getting Started

Customers

Pricing & Packaging

Quotes (CPQ)

Subscriptions

Entitlements

Invoices

Credits & Wallets

Usage Metering

Approval Workflows

Automations

Collections

Tax Management

Hosted Pages

Revenue & Accounting

Multi-Currency

Data & Exports

AI

External Tax Providers

Supported engines

How it works

Assigning tax codes

On products

Per line in a tax calculation

Tax codes

Tax code reference

Customer-side inputs

Next steps

Tax overview

Anrok

Stripe Tax

​Supported engines

​How it works

​Assigning tax codes

​On products

​Per line in a tax calculation

​Tax codes

​Tax code reference

​Customer-side inputs

​Next steps

Tax overview

Anrok

Stripe Tax

Supported engines

How it works

Assigning tax codes

On products

Per line in a tax calculation

Tax codes

Tax code reference

Customer-side inputs

Next steps