Skip to main content

​
External Tax Providers

Instead of maintaining rules yourself, you can connect a specialized tax engine. The engine determines the correct rate across country, state, county, and city jurisdictions from each line’s tax code and the customer’s location, and keeps rates and nexus rules current for you.

​
Supported Engines

​
How It Works

With an external provider connected, Alguna does not apply your tax rules. Instead, for every invoice line it sends the line’s tax code and the customer’s address to the engine, which returns the tax amount and the per-jurisdiction breakdown. You assign a canonical tax code to each product (or pass one per line via the API). You never deal with an engine’s raw codes directly. Alguna translates the canonical code into whichever provider you have configured, so switching engines requires no re-coding of your catalogue.

​
Tax Codes

Alguna owns a provider-neutral tax-code 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 is the default. A line with no tax 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 configured provider’s native code for you.

​
Tax Code Reference

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