Tax: the parts, in plain words

28 parts and 13 phrases. Apps in this area include Stripe Tax, Avalara, TaxJar, Quaderno, Shopify Tax.

Compliancetax.complianceShowWhere the store must collect tax, who is exempt, and how tax is reported.

Registrations and thresholdstax.compliance.registrationShowWhere the store must collect tax.

How to extend

ProviderOne per storetax providerRegistrations are kept in the tax engine that calculates and files the tax.

Part	Litestore today	How to extend
Registration list`tax.compliance.registration.registration_list`A registration list holds the states or countries where the store is registered to collect tax, with each registration number.	Plugin	Provider · one
Threshold tracking`tax.compliance.registration.threshold_tracking`Threshold tracking adds up sales per state or country and flags when they pass the amount that requires registering there.	Plugin	Provider · one
EU One-Stop Shop`tax.compliance.registration.eu_oss`The EU One-Stop Shop is one registration in a home country that covers VAT on sales to consumers in every EU country.	Plugin	Provider · one
EU Import One-Stop Shop`tax.compliance.registration.eu_ioss`The EU Import One-Stop Shop collects VAT at checkout on low-value parcels shipped into the EU from outside it.	Plugin	Provider · one
Marketplace collection`tax.compliance.registration.marketplace_collection`Marketplace collection puts the duty to collect tax on a marketplace for sales its sellers make through it.	Plugin	Provider · one

Exemptionstax.compliance.exemptionShowBuyers and sales that are not taxed.

How to extend

ProviderOne per storetax providerExemptions are checked by the tax engine that calculates the tax.
SlotMany side by sidecheckout.slot.delivery.below_methodsAn exemption plugin renders a VAT number field at checkout.

Part	Litestore today	How to extend
VAT number check`tax.compliance.exemption.vat_number`A VAT number check validates a business buyer's VAT number against the official register.	Plugin	Provider · oneSlot · many
Reverse charge`tax.compliance.exemption.reverse_charge`Reverse charge removes VAT from a cross-border business sale and notes on the invoice that the buyer accounts for it.	Plugin	Provider · oneSlot · many
Exemption certificate`tax.compliance.exemption.certificate`An exemption certificate is a document a tax-exempt buyer provides, stored with its expiry date.	Plugin	Provider · oneSlot · many
Tax-exempt customer`tax.compliance.exemption.exempt_customer`A tax-exempt customer is an account whose orders are charged no tax.	Plugin	Provider · oneSlot · many

Invoices and filingtax.compliance.reportingShowThe documents and returns that report tax.

How to extend

ProviderOne per storetax providerFiling is done by the tax engine or a filing service that holds the transactions.

Part	Litestore today	How to extend
Invoice`tax.compliance.reporting.invoice`An invoice is a printable document for an order that lists the lines, the tax and the seller's details.	Core`app/print/orders/[id]/invoice/page.tsx`	Provider · one
Seller tax ID`tax.compliance.reporting.seller_tax_id`A seller tax ID is the store's VAT or tax number, stored once and printed on invoices.	Core`modules/settings/schema.ts`	Provider · one
Credit note`tax.compliance.reporting.credit_note`A credit note is a document that reverses all or part of an invoice after a refund.	Plugin	Provider · one
Tax report`tax.compliance.reporting.tax_report`A tax report sums tax collected per jurisdiction and period for a return.	Plugin	Provider · one
Filing and remittance`tax.compliance.reporting.filing`Filing and remittance submits the tax return to each authority and pays the tax owed.	Plugin	Provider · one

Calculating taxtax.calculationShowHow the tax on an order is worked out at checkout.

How to extend

ProviderOne per storetax providerOne tax engine calculates tax for a store; Litestore ships a flat rate and Stripe Tax, and another engine plugs into the same seam.

Part	Litestore today	How to extend
Flat tax rate`tax.calculation.flat_rate`A flat tax rate applies one percentage to every order's taxable amount.	Core`modules/checkout/tax/provider.ts`	Provider · one
Rate by address`tax.calculation.address_lookup`Rate by address sends the shipping address to a tax engine, which returns the combined rate for that location.	Core`modules/checkout/tax/provider.ts`	Provider · one
Fallback rate`tax.calculation.engine_fallback`A fallback rate charges the flat rate when the tax engine fails or the address is missing, so an order is never taxed at zero by mistake.	Core`modules/checkout/tax/provider.ts`	Provider · one
Product tax code`tax.calculation.product_tax_code`A product tax code marks a product's tax category, such as clothing or food, so each line gets the rate for its category.	Plugin	Provider · one
Shipping taxability`tax.calculation.shipping_taxability`Shipping taxability sets whether the shipping charge is taxed, by the rule of the buyer's location.	Plugin	Provider · one
Tax shown before payment`tax.calculation.checkout_estimate`A tax line in the checkout summary shows the tax before payment, calculated by the same engine as the charge.	Core`modules/checkout/checkout-estimates.ts`	Provider · one

Tax in pricestax.pricingShowWhether shown prices contain tax, and how tax is rounded.

How to extend

Core onlyInclusive or exclusive pricing and rounding stay in core because every money path must use the same rule.

Part	Litestore today	How to extend
Tax-inclusive prices`tax.pricing.inclusive`Tax-inclusive prices already contain the tax, so the shelf price is the price paid.	Core`modules/markets/channel.ts`	Core only
Tax-exclusive prices`tax.pricing.exclusive`Tax-exclusive prices leave the tax out, and the tax is added as a line at checkout.	Core`modules/markets/channel.ts`	Core only
Tax rounding`tax.pricing.rounding`Tax rounding is the one rule that turns a calculated tax into cents the same way on every path.	Core`modules/markets/channel.ts`	Core only
Origin country`tax.pricing.origin_country`An origin country records where the store ships from, which some tax rules use.	Core`modules/markets/channel.ts`	Core only

Tax on orders and refundstax.recordShowHow the tax charged is stored and reversed.

How to extend

EventMany side by sideevent.order.paid event.order.refundedA tax reporting plugin subscribes to paid and refunded orders to record each transaction with its engine.

Part	Litestore today	How to extend
Tax on the order`tax.record.order_tax`Tax on the order stores the tax charged and whether it was inclusive or exclusive, as part of the order totals.	Core`modules/orders/payments/order-amounts.ts`	Event · many
Tax on refunds`tax.record.refund_tax`Tax on refunds pays back each refunded item's share of the tax charged.	Core`modules/orders/refunds/calculate-item-refund.ts`	Event · many
Transaction recording`tax.record.engine_commit`Transaction recording sends each paid order to the tax engine so it counts toward the store's tax returns.	Plugin	Event · many
Refund recording`tax.record.engine_reversal`Refund recording sends each refund to the tax engine so the reported tax goes down by the refunded amount.	Plugin	Event · many

Phrase	Made of
tax-inclusive pricing	tax.pricing.inclusive
VAT-inclusive prices	tax.pricing.inclusive
nexus	tax.compliance.registration.threshold_tracking tax.compliance.registration.registration_list
economic nexus	tax.compliance.registration.threshold_tracking
VAT OSS	tax.compliance.registration.eu_oss
IOSS	tax.compliance.registration.eu_ioss
marketplace facilitator	tax.compliance.registration.marketplace_collection
real-time tax calculation	tax.calculation.address_lookup
product tax codes	tax.calculation.product_tax_code
VAT validation	tax.compliance.exemption.vat_number
B2B reverse charge	tax.compliance.exemption.vat_number tax.compliance.exemption.reverse_charge
exemption certificate management	tax.compliance.exemption.certificate tax.compliance.exemption.exempt_customer
tax filing	tax.compliance.reporting.filing

Tax