Important: When developing websites or building apps with Blocks, use Velo service plugins.
The Tax Groups service plugin allows you to create and manage default tax groups to categorize products from your app's catalog based on distinct tax treatments. The tax groups you add with this API, by default, will apply to your app's products. Alternatively, you can create and manage tax groups with the Tax Groups API, and manually add tax groups to individual products with Update Product.
With the Tax Groups service plugin integrated into your app, Wix will retrieve the tax group you provide whenever it calls a catalog of products from your app.
The integration is done via an app created in your Wix Studio workspace with the Tax Groups service plugin.
Learn more about implementing a service plugin with Wix.
To enable Wix to communicate with your app:
Go to Extensions in your app's dashboard.
Click + Create Extension in the top right.
Find Tax Groups Provider and click + Create.
Use the JSON editor to create the extension's configuration file. Configure the parameters by referencing the table below or the Documentation section to the right of the editor. For each parameter, add the parameter name and value in the JSON editor.
Name | Type | Description |
---|---|---|
deploymentUri | string | Base URI of the service plugin implementation. Since no endpoint is calling this path, it may be left blank. |
defaultTaxGroup | string | Name of the default tax group for this app. All products retrieved from this app will be categorized, by default, with this group name. The id for this tax group is the app's ID. |
additionalTaxGroups | object | Additional tax groups to be added to a site's tax settings when the app is installed. Each additionalTaxGroup must include an id and a name . |
componentName | string | A unique name for this component. This is an internal name that will only appear in the app dashboard. |
Click Test Your App.
id
and name
fields.