Sample Flow

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

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

Many jurisdictions run back-to-school sales tax holidays before 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. Each tax group is charged per tax region, so if the group is treated differently by region, set a rate for it in each region with a manual tax mapping.
2. Assign the group to the relevant products by setting each product's taxGroupId in the Wix Stores catalog. Use the Stores Catalog V3 Products API (for example, Bulk Update Products By Filter), which returns a jobId. taxGroupId exists only in catalog V3: check the catalog version first, and for a catalog V1 store, route the merchant to the dashboard or the V3 migration path instead.

When a tax group is no longer needed, for example once the seasonal status ends, delete it. Any product that still references the deleted taxGroupId falls back to the default tax group for its catalog.