Prices and Tax

Prices can be defined with or without tax, and appear with or without tax in different contexts.

Overview

Prices in the system can be defined including or excluding tax.
However, tax handling depends on several contexts:

How prices are stored – whether the price value includes tax.
How prices are used – whether tax should be applied or removed when calculating totals (for example, in the cart).
How prices are displayed – whether the user interface should show prices including or excluding tax.

These behaviors are controlled by a few key settings.

Key Settings

Setting	Level	Description
`price.IsTaxExcluded`	Price	Indicates whether the stored price is excluding tax (`true`) or including tax (`false`).
`market.IsTaxExcluded`	Market	Defines whether tax should be excluded in the cart (for example, in a B2B market). This does not act as a default for `price.IsTaxExcluded`.
`price.TaxRate`	Price	The specific tax rate for this price.
`market.DefaultTaxRate`	Market	The default tax rate to use when a price does not define its own `TaxRate`.

Tax on Prices

Price values are represented by the UnitPrice property on the Price object.

If price.IsTaxExcluded = false, UnitPrice includes tax.
If price.IsTaxExcluded = true, UnitPrice excludes tax.
If price.TaxRate is not defined, the system falls back to:
1. market.DefaultTaxRate, or
2. the global default tax rate (0 if not configured).

Unit price includes tax	Unit prices excludes tax

Example:

UnitPrice = 100
TaxRate = 25%
If IsTaxExcluded = false → Base = 80, Tax = 20
If IsTaxExcluded = true → Base = 100, Tax = added when used

Tax in Cart

When prices are shown in a cart or order context, the tax behavior is determined by the Market settings.

Setting	Description
`market.IsTaxExcluded`	Determines whether tax should be excluded from the cart total (used for B2B contexts).
`market.ShowOrderLinesExcludingTax`	Controls whether order lines should be displayed without tax.

If market.IsTaxExcluded = true, the tax rate used in the cart will be set to 0.
This means that, regardless of whether the original price included or excluded tax, the cart total will not include tax.

Examples

Case	Price: UnitPrice = 10, TaxRate = 25	Market	Result
1	Price includes tax	Market includes tax	Cart price = 10, Tax = 2
2	Price excludes tax	Market includes tax	Cart price = 12.5, Tax = 2.5
3	Price includes tax	Market excludes tax	Cart price = 8, Tax = 0
4	Price excludes tax	Market excludes tax	Cart price = 10, Tax = 0

Working with B2B Prices

In a Business-to-Business (B2B) context:

The tax is usually excluded in the cart.
This is controlled by the market.IsTaxExcluded property.
The actual price definitions can still include or exclude tax (price.IsTaxExcluded).

This corresponds to Case 3 and Case 4 in the examples above.

Override “Show Tax” Setting

The setting market.ShowOrderLinesExcludingTax determines whether order lines should be shown without tax. The tax display preference can also be overridden per user profile, rather than for the entire tenant.
If a price is shown without tax, the label ex. mva (excluding VAT) will appear next to the price.

This can be set in the tax settings section in the profile view:

When a tax setting is set in the profile view, an icon will appear on the top of the page: