> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Configuration

## Article: Configuration

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-exempt-groups-integration-service-plugin/configuration.md

## Article Content:

# Configuration

The Tax Exempt Groups service plugin is configuration-only — you declare the tax exempt groups your app provides, and Wix adds them to the site's available tax exempt groups when your app is installed. There are no methods to implement.

Follow these steps to add the service plugin:

1. Go to [Extensions](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/about-extensions.md) in your app's dashboard.

1. Click **+ Create Extension** in the top right.

1. Find **Tax Exempt Groups Provider** and click **+ Create**.

1. 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.

   | Name | Type | Description |
   | --- | --- | --- |
   | `deploymentUri` | string | Base URI of the service plugin implementation. Since no endpoint is called, it may be left blank. |
   | `taxExemptGroups` | array | The tax exempt groups your app provides. Up to 100 groups. Each entry is a tax exempt group object (see below). |

   Each object in `taxExemptGroups` has the following fields:

   | Name | Type | Description |
   | --- | --- | --- |
   | `exemptTaxGroupName` | string | Display name of the exempt group. Maximum 100 characters. |
   | `id` | string | Unique ID (GUID) for the exempt group. |
   | `exemptRegions` | object | Where the exemption applies. Contains `regionScope` and, for specific regions, a `regions` list. |

   The `exemptRegions` object has the following fields:

   | Name | Type | Description |
   | --- | --- | --- |
   | `regionScope` | string | `WORLDWIDE` to apply the exemption everywhere (leave `regions` empty), or `SPECIFIC_REGIONS` to apply it only to the listed `regions`. |
   | `regions` | array | The regions where the exemption applies, used when `regionScope` is `SPECIFIC_REGIONS`. Up to 200 regions. Each entry has a `countryCode` and optional `subdivisions`. |

   Each object in `regions` has the following fields:

   | Name | Type | Description |
   | --- | --- | --- |
   | `countryCode` | string | 2-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code, such as `US`. |
   | `subdivisions` | array | Optional [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) subdivision codes (without the country prefix), such as `NY` or `CA`. If empty, the exemption applies to the entire country. Up to 100 subdivisions. |

1. Click [**Test Your App**](https://dev.wix.com/docs/build-apps/launch-your-app/app-distribution/test-your-app/test-your-app-on-a-premium-site.md).

## Example configuration

```json
{
  "taxExemptGroups": [
    {
      "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
      "exemptTaxGroupName": "Reseller",
      "exemptRegions": {
        "regionScope": "SPECIFIC_REGIONS",
        "regions": [
          { "countryCode": "US", "subdivisions": ["NY", "CA"] }
        ]
      }
    },
    {
      "id": "6b1e8f34-2c7a-4b9d-8e5f-1a2b3c4d5e6f",
      "exemptTaxGroupName": "Non-profit",
      "exemptRegions": {
        "regionScope": "WORLDWIDE"
      }
    }
  ]
}
```