The Tax Exempt Groups API lets you create and manage reusable groups of tax exemption rules for a site. A tax exempt group represents a category of customers that pay reduced or zero tax, such as resellers, non-profit organizations, or customers with a valid VAT ID.
Instead of configuring an exemption for each customer individually, you associate customers with a tax exempt group through their contact tax details. When a customer that belongs to a group checks out, tax calculation resolves the group and applies its exemption, reporting the reduced tax as an exempt amount in the tax breakdown.
With the Tax Exempt Groups API, you can:
- Create, retrieve, update, and delete tax exempt groups, individually or in bulk.
- Query tax exempt groups by ID or name.
- Retrieve the site's default tax exempt groups, including the global full-exemption group.
- Organize tax exempt groups with tags.
Wix provides a predefined global full-exemption group that's available on every site and requires no setup. Associate a customer with it and the customer pays no tax. To apply reduced (partial) or category-specific rates instead, create your own tax exempt group and define its override rates per tax group and tax region on the associated manual tax mappings. Either way, exemptions are applied by the Wix manual tax calculator, and you make a customer exempt by associating them with a group through the Contact Tax Details API.
It's important to note the following points before starting to code:
- Wix provides a predefined global full-exemption group that requires no setup. Associate a customer with it to fully exempt the customer from tax.
- To apply reduced (partial) or category-specific rates, create your own tax exempt group and define its override rates on the relevant manual tax mappings. Creating a group alone doesn't set any rate.
- To exempt a customer, associate the customer with a group through the Contact Tax Details API. A contact can belong to one tax exempt group.
- Default tax exempt groups, including the global full-exemption group, are returned only by List Default Tax Exempt Groups, not by Query Tax Exempt Groups.
- A resolved exemption is applied by the Wix manual tax calculator, even when the region is otherwise served by a third-party tax calculator.
- Tax exempt group: A reusable, named set of tax exemption rules that can be applied to many customers.
- Global full-exemption group: A predefined tax exempt group, available on every site with no setup, whose members pay no tax.
- Override rate: A reduced or zero tax rate that applies to a group's members for a given tax group and region. Override rates are managed through the Manual Tax Mapping API.
- Exempt amount: The portion of tax reduced by an exemption, reported in the tax breakdown during tax calculation.