About the Tax Groups API

The Tax Groups API allows you to create and manage tax groups to categorize products based on distinct tax treatments. Use the Tax Groups API together with the Tax Regions API and the Tax Calculation API to customize the application of tax for a business.

Use case

• Create a new tax group for back-to-school items

Terminology

• Tax group: A group of products that share the same tax treatment. Assign tax groups manually to products with Update Product.
• Default tax group: A predefined tax group provided by an app, for example Wix Stores, and is the default tax group automatically assigned to products imported from that app's catalog.

Setup

To use the TaxGroups API, install the @wix/billing package.

Install the package

Follow the installation instructions for your development environment.

Import the package

To import the package in your code:

import { taxGroups } from "@wix/billing";

Sample Flow

This article presents a possible use case and a corresponding sample flow that you can support. This can be a helpful jumping off point as you plan your implementation.

Create a new tax group for back-to-school items

Many jurisdictions implement back-to-school sales tax holidays before the start of the school year. During these periods certain school supplies, clothing and electronics are exempt from sales tax.

Create a tax group to categorize these items:

1. Call Create Tax Group to create and name a new tax group. Save the id that is returned. Note that each tax group is calculated based on the tax region, if the tax group is treated differently based on the region then a unique group should be created for each region.
2. Call Update Product to update the taxGroupId field for the relevant products in your catalog.

When a tax group is no longer needed, such as when the seasonal status no longer applies, delete the group. The default tax group for that catalog will apply to any products that have the deleted taxGroupId.