Set Up Tax-Inclusive Pricing

Overview

By default, Foxy displays prices tax-exclusive: the price is shown before tax, and tax is added as a separate line. Tax-inclusive pricing instead displays the price with tax already included, while still showing the tax charged as a separate line item. This is the norm in the EU, UK, Australia, and other VAT/GST regions.

How it works

The price you pass to Foxy is always the pre-tax amount, whether or not tax-inclusive pricing is on. Tax-inclusive pricing changes how the price is displayed, not the value you send.

For example, an $83.33 product with a 20% tax is price=83.33 in both cases:

• Tax-exclusive: the item shows as $83.33, tax is $16.67, and the order total is $100.

• Tax-inclusive: the item shows as $100, tax is $16.67 (marked as inclusive), and the order total is still $100.

How to enable it

Tax-inclusive pricing is available to all Foxy stores. It is a display-level change set on the template set (inclusive or exclusive), so a store can run one template set inclusive and another exclusive. There is no toggle in the admin, so you enable it in one of two ways:

• Ask Foxy to enable it. Contact Foxy and say which template set should use inclusive pricing.

• Set it yourself via the API. Use the API Browser in the admin (or any hAPI client) to set the tax inclusivity option on the template set " to inclusive. The safe approach is to fetch the current configuration, change that one value, and save it back with a PATCH.

Notes

• Rounding. Because the displayed amount is derived from the price and rate, some combinations need a more precise price to round cleanly. For example, pass price=83.3333 instead of 83.33. Foxy handles that added precision.

• No tax for the customer's location. The inclusive amount is tied to the applicable rate. If a customer is in a location where no tax applies, they pay the price as passed.

• Coupons and discounts. Coupon and discount behavior has edge cases with tax-inclusive pricing (for example, how a coupon interacts with a taxable versus non-taxable configuration), so test your coupon and discount flows carefully before going live.