New France e-invoicing mandate goes live September 2026 — our implementation is ready. See all mandates →
Tax Calculations

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.

TreatmenttaxCodeRateWhen 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.
ℹ
The 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.
Tax Calculations

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.

1
Physical goods — shipping address wins

For tangible goods, the shipping destination controls the jurisdiction. If a shippingAddress.country is provided, it takes priority over all other signals.

2
B2B — VAT ID prefix then billing address

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.

3
General (non-digital) B2C services — the seller's own country

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.

4
B2C digital services — 2-of-3 rule (EU)

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.

5
Special postal territories

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.

6
US address precision tiers

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 is usAddressPrecision: "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 when line1 is 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 US region is 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.

CustomerSeller → buyerSourced toTax codeLegal basis & geographic scope
B2CanyCustomer's shipping (or billing) addressStandard/reduced rate at destinationApplied globally.
B2Bsame countryDomestic — seller's countryS (standard rate)Applied globally.
B2BEU seller → EU buyer (cross-border)Buyer's country (self-accounted)K — intra-Community supply, Art. 138EU-only. K is reserved for goods.
B2BEU seller → non-EU buyerExport, zero-ratedGEU-only (requires an EU seller).
B2Bnon-EU seller → EU buyerBuyer's country (self-accounted)AE — reverse charge, Art. 44/196Applied globally for any non-EU seller shipping into the EU.
B2Bnon-EU seller → non-EU buyerBuyer's country (self-accounted)AE — reverse chargeApplied 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.

CustomerSeller → buyerSourced toTax codeLegal basis & geographic scope
B2Cbuyer or seller in the EUCustomer location, 2-of-3 evidence (billing/IP/BIN)Standard/reduced rate at destinationEU-only evidence procedure (Reg 282/2011 Art. 24f); the underlying customer-location rule (Art. 58) is applied by Clearvo for any transaction.
B2Cneither in the EUCustomer location via billing → IP → seller cascadeStandard/reduced rate at destinationApplied globally — same customer-location outcome, without the formal EU evidence-conflict procedure.
B2Bsame countryDomestic — seller's countrySApplied globally.
B2BEU seller → EU buyer (cross-border)Buyer's country (self-accounted)AE — reverse charge, Art. 44/196EU-only. Services use AE.
B2BEU seller → non-EU buyerExport, zero-ratedGEU-only (requires an EU seller).
B2Bnon-EU seller → EU buyerBuyer's country (self-accounted)AE — reverse charge, Art. 44/196Applied globally for any non-EU seller.
B2Bnon-EU seller → non-EU buyer, destination ZA, AE, or SABuyer's country — seller charges local VAT/GSTDestination standard rateCarve-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.
B2Bnon-EU seller → non-EU buyer, any other destinationBuyer's country (self-accounted)AE — reverse chargeApplied globally (Clearvo default).

GENERAL_SERVICE — non-digital services: consulting, legal, accounting, financial services, insurance, healthcare. B2B sourcing matches DIGITAL_SERVICE; B2C sourcing does not.

CustomerSeller → buyerSourced toTax codeLegal basis & geographic scope
B2CanySeller's own country — resolutionMethod: "SELLER_ADDRESS"Seller-country standard/reduced rateCitation 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.
B2Bsame countryDomestic — seller's countrySApplied globally.
B2BEU seller → EU buyer (cross-border)Buyer's country (self-accounted)AE — reverse charge, Art. 44/196EU-only. Services use AE.
B2BEU seller → non-EU buyerExport, zero-ratedGEU-only (requires an EU seller).
B2Bnon-EU seller → EU buyerBuyer's country (self-accounted)AE — reverse charge, Art. 44/196Applied globally for any non-EU seller.
B2Bnon-EU seller → non-EU buyerBuyer's country (self-accounted)AE — reverse chargeApplied 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.

Tax Calculations

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.

1
Explicit override (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.

2
Classification code map (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 as txcd_10103000. The code must match exactly.
  • shopify — a Shopify product taxonomy category id such as aa-1-13. If your specific category has no entry of its own, Clearvo uses its nearest mapped parent category (aa-1-13-5 falls back to aa-1-13, then aa-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.

3
Product code lookup

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.

4
Product name lookup

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.

5
Account default

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.

SlugTypical rate bandExamples
saas_businessSTANDARDSaaS subscriptions (B2B use)
saas_personalSTANDARDSaaS subscriptions (consumer / personal use)
api_data_servicesSTANDARDAPI access, data feeds, webhooks
streaming_videoSTANDARDVideo streaming subscriptions
ebooksREDUCED (most EU countries)Digital books, audiobooks, online newspapers
books_physicalREDUCED (most EU countries)Printed books, newspapers, maps
online_coursesEXEMPT (many jurisdictions)E-learning, training subscriptions
food_basicREDUCED or ZEROGroceries, basic unprocessed foods
food_restaurantREDUCED or STANDARDPrepared meals, catering
medical_devicesEXEMPT or REDUCEDMedical equipment, hearing aids, spectacles
pharmaceuticalsREDUCED or ZEROPrescription drugs, licensed medications
clothing_childrenREDUCED or ZEROChildren's apparel (zero-rated in UK and IE)
financial_servicesEXEMPTBanking fees, insurance premiums, credit services
professional_servicesSTANDARDConsulting, legal, accounting, advisory
physical_goods_generalSTANDARDCatch-all for physical goods with no specific slug
digital_generalSTANDARDCatch-all for digital goods with no specific slug
nontaxableZERO / EXEMPTItems not subject to indirect tax in any jurisdiction
✓
For production use, we recommend pre-classifying your product catalogue via the Product Catalogue endpoints and sending 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.