Tax Treatments
Clearvo selects a tax treatment for each transaction using a priority-ordered decision tree. The treatment determines the EN16931 tax code and effective rate applied to line items.
| Treatment | taxCode | Rate | When applied |
|---|---|---|---|
| STANDARD | S |
Country standard or reduced rate | Default B2C treatment. The buyer is in the seller's country, or the seller is registered in the buyer's country and no other rule takes priority. Correct rate band (STANDARD, REDUCED, etc.) is selected per product category. |
| IOSS | S |
Destination country rate | Non-EU seller with an IOSS number, selling physical goods to an EU B2C customer, where the total goods value is ≤€150. VAT is collected at the destination country's rate and declared via IOSS. |
| REVERSE_CHARGE | AE (non-EU→EU B2B) or K (EU→EU B2B cross-border) |
0% | B2B transaction where the buyer has a verified VAT ID and the transaction crosses an EU border. Tax liability shifts to the buyer. No VAT is charged on the invoice. |
| ZERO_RATED | Z |
0% | Product falls into a zero-rated category in the destination jurisdiction (e.g. children's clothing in the UK, basic foodstuffs in many EU countries). |
| EXEMPT | E |
0% | An exemption certificate has been registered for this customer's tax ID in the relevant jurisdiction and product category. See Exemptions. |
| OUT_OF_SCOPE | O |
0% | The transaction falls outside the scope of indirect tax (e.g. financial services, insurance, inter-group transactions where both parties are in the same VAT group). |
| SELLER_NOT_REGISTERED | O |
0% | The seller's tax obligation record for the buyer's jurisdiction has registrationStatus: "NOT_REGISTERED". No tax is charged. The obligation status surfaces in the dashboard as MONITORING or ACTION_REQUIRED. |
| UNSUPPORTED_JURISDICTION | O |
0% | The destination (or seller) is a well-formed country we do not calculate tax for. The response is a 200 with totalTax: 0, an unsupportedJurisdiction: { country, party } field and a country_not_supported warning. Not an error — but 0 tax here means "not covered", not "no tax due". See Supported jurisdictions. |
| RATE_UNAVAILABLE | O |
0% | The destination is a supported country or region (not the US) but we hold no tax rate for it on the calculation date. The response is a 200 with totalTax: 0, degraded: true, degradedReason: "RATE_NOT_FOUND", a rate_not_found warning and, on each affected line, outcome.reasonCode: "rate_not_found". It is not a real zero-rated or standard sale: do not rely on the amount, check the region you sent and contact support if the place should be covered. A credit note of such a sale keeps this treatment. |
| EXPORT | G |
0% | EU seller, non-EU buyer — goods or services exported outside the EU VAT area. Zero-rated as an export. |
rate on each response line maps directly to the taxRate field accepted by the Clearvo e-invoicing /v1/send endpoint (as a percentage — 0.19 becomes 19). No category lookup is required: /v1/send has no line taxCode input; it resolves the EN16931 category itself from the rate plus your clientTaxCode or taxTreatment.Jurisdiction Resolution
Clearvo determines which tax authority's rules apply to a transaction using a rule-based resolution chain. The resolved jurisdiction, resolution method, and any conflicting signals are all returned in the response.
For tangible goods, the shipping destination controls the jurisdiction. If a shippingAddress.country is provided, it takes priority over all other signals.
For B2B transactions, Clearvo extracts the country prefix from the customer's taxId (e.g. DE from DE987654321) and uses it as the primary signal. If the VAT ID prefix is absent or unverifiable, the billing address country is used.
Consulting, legal, accounting, insurance, and other general professional services sold to a consumer are sourced to where the seller is established, not the customer's location — the opposite of the digital-services rule below (EU VAT Directive Art. 45 — general B2C services; contrast with Art. 58's customer-location rule for electronically supplied services). A German consultancy invoicing a French consumer charges German VAT, not French VAT, and reports jurisdiction.resolutionMethod: "SELLER_ADDRESS" on that line. Clearvo applies this seller-country sourcing globally — for any seller/buyer country pair classified as a general service — not only within the EU; see the sourcing matrix below for the exact scope of every rule.
Digital/electronically-supplied services are sourced to the customer's location for both B2B and B2C (EU VAT Directive Art. 58/44). When either the buyer or the seller is in the EU, sellers of B2C digital services must collect two non-contradictory pieces of evidence of the customer's location — the evidentiary procedure set out in Reg 282/2011 Art. 24f. Clearvo evaluates up to three signals: billing address country, IP geolocation country, and card BIN country. The majority wins. If all three agree, resolutionPrecision is EXACT; if only two agree, it is COUNTRY. Disagreements are listed in jurisdiction.conflicts. Outside that EU-linked scope, the same customer-location outcome is reached via a simpler billing → IP → seller-country cascade, with no formal evidence-conflict procedure.
Some territories use the country code of their parent state but are outside the EU VAT area. Clearvo detects these automatically from the postal code:
- Canary Islands (ES 35xxx–38xxx) — outside EU VAT
- Ceuta & Melilla (ES 51xxx, 52xxx) — outside EU VAT
- Åland Islands (FI 22xxx) — outside EU VAT
- Madeira (PT 90xxx–93xxx) — inside EU VAT
For a general B2C service (step 3 above), this detection runs on the seller's own postal code rather than the customer's, since that line is sourced to the seller's country.
For US transactions, Clearvo looks up the applicable sales tax rate using one of three precision tiers, depending on which address fields are supplied and your account's usAddressPrecision setting:
- ROOFTOP — a street address (
line1) is present and your account setting isusAddressPrecision: "rooftop"(the default). Clearvo resolves the address to a zip+4 code and looks up the exact rate for that delivery-point range. "Rooftop" is the industry-standard term for address-level precision in US sales tax — the underlying rate table is keyed on zip+4 ranges, which cover approximately 10–20 delivery points. - ZIP — only a postal code is available, or your account setting is
usAddressPrecision: "zip"(which skips street-address resolution even whenline1is present). Clearvo uses the zip5 code directly. - STATE — only a state code (
region) is available with no postal code. Clearvo applies the state-level rate. Note that USregionis always required — if it is missing, the API returns a 422 error.
The tier used is returned in jurisdiction.addressPrecision on every US response. You can switch your account between ROOFTOP and ZIP precision under Settings → Tax Calculations.
When the resolution chain cannot determine the jurisdiction from available signals, Clearvo falls back to the seller's country and marks the result as degraded: true with a degradedReason of "jurisdiction_unresolved".
Sourcing matrix
Every line item is classified into one of three place-of-supply regimes (placeOfSupplyRule in the response — see Product Classification) before jurisdiction and tax code are resolved. The tables below are the complete, current sourcing behaviour per regime, including which rules are EU-specific versus applied by Clearvo for any seller/buyer country. A category classified UNSUPPORTED (e.g. real estate, restaurant/catering, passenger transport, event admission) never reaches sourcing at all — the calculation is rejected with a 422 category_not_supported error.
GOODS — tangible products, destination-of-goods sourcing.
| Customer | Seller → buyer | Sourced to | Tax code | Legal basis & geographic scope |
|---|---|---|---|---|
| B2C | any | Customer's shipping (or billing) address | Standard/reduced rate at destination | Applied globally. |
| B2B | same country | Domestic — seller's country | S (standard rate) | Applied globally. |
| B2B | EU seller → EU buyer (cross-border) | Buyer's country (self-accounted) | K — intra-Community supply, Art. 138 | EU-only. K is reserved for goods. |
| B2B | EU seller → non-EU buyer | Export, zero-rated | G | EU-only (requires an EU seller). |
| B2B | non-EU seller → EU buyer | Buyer's country (self-accounted) | AE — reverse charge, Art. 44/196 | Applied globally for any non-EU seller shipping into the EU. |
| B2B | non-EU seller → non-EU buyer | Buyer's country (self-accounted) | AE — reverse charge | Applied globally (Clearvo default outside the EU); no ZA/AE/SA local-tax carve-out for goods — see below. |
DIGITAL_SERVICE — electronically supplied (TBE) services: SaaS, streaming, downloads, online courses, etc. Customer-location sourcing for both B2B and B2C.
| Customer | Seller → buyer | Sourced to | Tax code | Legal basis & geographic scope |
|---|---|---|---|---|
| B2C | buyer or seller in the EU | Customer location, 2-of-3 evidence (billing/IP/BIN) | Standard/reduced rate at destination | EU-only evidence procedure (Reg 282/2011 Art. 24f); the underlying customer-location rule (Art. 58) is applied by Clearvo for any transaction. |
| B2C | neither in the EU | Customer location via billing → IP → seller cascade | Standard/reduced rate at destination | Applied globally — same customer-location outcome, without the formal EU evidence-conflict procedure. |
| B2B | same country | Domestic — seller's country | S | Applied globally. |
| B2B | EU seller → EU buyer (cross-border) | Buyer's country (self-accounted) | AE — reverse charge, Art. 44/196 | EU-only. Services use AE. |
| B2B | EU seller → non-EU buyer | Export, zero-rated | G | EU-only (requires an EU seller). |
| B2B | non-EU seller → EU buyer | Buyer's country (self-accounted) | AE — reverse charge, Art. 44/196 | Applied globally for any non-EU seller. |
| B2B | non-EU seller → non-EU buyer, destination ZA, AE, or SA | Buyer's country — seller charges local VAT/GST | Destination standard rate | Carve-out limited to South Africa, UAE, and Saudi Arabia. These jurisdictions require a registered non-resident supplier of digital services to charge local VAT/GST even B2B. Digital services only — the same three destinations apply ordinary reverse charge for GOODS or GENERAL_SERVICE. |
| B2B | non-EU seller → non-EU buyer, any other destination | Buyer's country (self-accounted) | AE — reverse charge | Applied globally (Clearvo default). |
GENERAL_SERVICE — non-digital services: consulting, legal, accounting, financial services, insurance, healthcare. B2B sourcing matches DIGITAL_SERVICE; B2C sourcing does not.
| Customer | Seller → buyer | Sourced to | Tax code | Legal basis & geographic scope |
|---|---|---|---|---|
| B2C | any | Seller's own country — resolutionMethod: "SELLER_ADDRESS" | Seller-country standard/reduced rate | Citation is EU VAT Directive Art. 45. Clearvo applies this rule globally — for any seller/buyer country pair, not only where the seller or buyer is in the EU. |
| B2B | same country | Domestic — seller's country | S | Applied globally. |
| B2B | EU seller → EU buyer (cross-border) | Buyer's country (self-accounted) | AE — reverse charge, Art. 44/196 | EU-only. Services use AE. |
| B2B | EU seller → non-EU buyer | Export, zero-rated | G | EU-only (requires an EU seller). |
| B2B | non-EU seller → EU buyer | Buyer's country (self-accounted) | AE — reverse charge, Art. 44/196 | Applied globally for any non-EU seller. |
| B2B | non-EU seller → non-EU buyer | Buyer's country (self-accounted) | AE — reverse charge | Applied globally. The ZA/AE/SA local-tax carve-out above is scoped to DIGITAL_SERVICE only and never applies to general services. |
B2G (government) customers are treated identically to B2B throughout the tables above.
Product Classification
Clearvo classifies each line item into a product category to determine the correct VAT rate band — for example, whether a digital product is taxed at the standard rate or a reduced "cultural goods" rate. No HS codes are required.
Classification pipeline
/v1/tax/calculate never makes a live AI call — every line resolves through a deterministic, low-latency cascade so a large cart is never slowed down by an unrecognised product name. AI-assisted classification is available separately, for building your product catalogue in advance — see Product Catalogue below.
taxCategory)
If you pass a taxCategory slug on a line item, that category is used with confidence 1.0 and status: "APPROVED". Use this for a one-off line, or when you maintain your own classification and want deterministic results without relying on Clearvo's catalogue at all.
classificationCodes)
Most catalogues already carry a product code from somewhere else: a Stripe product tax code, a Shopify product category, or a customs commodity code. Send those codes with the line and Clearvo looks each one up in its classification code map, which links an outside code to the right tax category. This is the recommended path for catalogues that already use one of these systems, and it takes precedence over everything below.
Send up to 5 codes as { "system", "code" } pairs. The systems are:
stripe— a Stripe product tax code such astxcd_10103000. The code must match exactly.shopify— a Shopify product taxonomy category id such asaa-1-13. If your specific category has no entry of its own, Clearvo uses its nearest mapped parent category (aa-1-13-5falls back toaa-1-13, thenaa-1).hs— a customs commodity code. Clearvo uses the longest mapped prefix of the code you send.
Other lowercase system names are accepted, but a system Clearvo does not know is skipped. Codes are tried in the order you list them and the first one that maps wins. A code is skipped, and the next one tried, when it has no entry in the map, when the map marks it as ambiguous (one outside category covers products that are taxed differently), or when the map records that no Clearvo category fits it. If no code maps, the line carries on to the steps below: product code, product name, then your account default. A skipped code never changes the result silently.
When a code decides the line, the response sets classificationSource to "CODE_MAP" and adds classificationSystem and classificationMatchedCode. The matched code is the entry that actually decided, which may be a parent of the one you sent, so you can see exactly why the line was classified as it was.
Clearvo checks whether a prior classification exists for this exact productCode in your catalogue. If found, it's used immediately with fromCache: true. Catalogue entries are per-account and persist across calls — see Product Catalogue for how entries get there.
If no productCode was supplied (or it didn't match), Clearvo looks for an exact, case-insensitive match on productName against your catalogue. Only an unambiguous match is used — if two catalogue entries share the same name, it's treated as no match rather than guessed, and the line falls through to the default below.
If nothing above matched, the line resolves to your account's configured default category (defaultTaxCategorySlug), or the standard physical-goods category if you haven't set one. status: "NEEDS_REVIEW" signals this line wasn't recognised — add it to your catalogue (see below) so future calls resolve it directly.
Common category slugs
A representative sample — call GET /v1/tax/categories for the complete live list.
| Slug | Typical rate band | Examples |
|---|---|---|
saas_business | STANDARD | SaaS subscriptions (B2B use) |
saas_personal | STANDARD | SaaS subscriptions (consumer / personal use) |
api_data_services | STANDARD | API access, data feeds, webhooks |
streaming_video | STANDARD | Video streaming subscriptions |
ebooks | REDUCED (most EU countries) | Digital books, audiobooks, online newspapers |
books_physical | REDUCED (most EU countries) | Printed books, newspapers, maps |
online_courses | EXEMPT (many jurisdictions) | E-learning, training subscriptions |
food_basic | REDUCED or ZERO | Groceries, basic unprocessed foods |
food_restaurant | REDUCED or STANDARD | Prepared meals, catering |
medical_devices | EXEMPT or REDUCED | Medical equipment, hearing aids, spectacles |
pharmaceuticals | REDUCED or ZERO | Prescription drugs, licensed medications |
clothing_children | REDUCED or ZERO | Children's apparel (zero-rated in UK and IE) |
financial_services | EXEMPT | Banking fees, insurance premiums, credit services |
professional_services | STANDARD | Consulting, legal, accounting, advisory |
physical_goods_general | STANDARD | Catch-all for physical goods with no specific slug |
digital_general | STANDARD | Catch-all for digital goods with no specific slug |
nontaxable | ZERO / EXEMPT | Items not subject to indirect tax in any jurisdiction |
productCode on every line. This gives you a reviewed, deterministic result instead of falling through to your account default — reserve an inline taxCategory override for one-off lines or products you don't want in the catalogue at all.