VAT Groups
VAT groups define the tax rates applied to products and product lines. Each VAT group has a percentage and can be linked to a country.
Use the Datastore_VatGroup endpoint to query available VAT groups.
Endpoints
List VAT Groups
GET
/v1/odata/Datastore_VatGroupSingle VAT Group
GET
/v1/odata/Datastore_VatGroup({id})Fields
Datastore Fields (inherited)
| Field | Type | Description |
|---|---|---|
Name | String | Display name (e.g., "NL - 21%") |
Code | String | Unique code identifier |
LocalizedName | String | Localized display name |
IsDefault | Boolean | Whether this is the default VAT group |
VAT Group Fields
| Field | Type | Description |
|---|---|---|
Percentage | Double | VAT percentage (e.g., 21.0) |
Relationships
| Relationship | Target Entity | Cardinality | Description |
|---|---|---|---|
| Country | Datastore_Country | N:1 | Country this VAT group applies to |
| Product | Product | 1:N | Products using this VAT group |
| ProductLine | ProductLine | 1:N | Product lines using this VAT group |
Expanding Relationships
GET
/v1/odata/Datastore_VatGroup({id})?$expand=CountryNavigating Relationships
GET
/v1/odata/Datastore_VatGroup({id})/CountryFiltering Examples
GET
/v1/odata/Datastore_VatGroup?$filter=Name eq '{Name}'&$top={top}GET
/v1/odata/Datastore_VatGroup?$filter=Percentage eq {Percentage}&$top={top}GET
/v1/odata/Datastore_VatGroup?$filter=Percentage eq {Percentage}&$top={top}GET
/v1/odata/Datastore_VatGroup?$filter=IsDefault eq {IsDefault}&$top={top}GET
/v1/odata/Datastore_VatGroup?$filter=contains(Name, '{Name}')&$top={top}Custom Query
Build your own OData query against Datastore_VatGroup. Open Run and edit the whole request inline — swap the entity set, change the $filter, or add $expand, $select, $orderby, $top, $skip. Type $ for suggestions; use ↺ Reset to restore this example.
GET
/v1/odata/Datastore_VatGroup?$top=10