---
title: "TaxScheme"
slug: "api/basket/types/taxscheme"
sidebar:
  order: 300
---

<a id="ref-5fcb6bfe07fb"></a>
<a id="ref-ce3ded04e4e3"></a>
<a id="ref-4234e28c11e9"></a>

## Synopsis

```text
struct TaxScheme {
    string identifier;
    string country;
    string region;
    string variantName;
    string currency;
    TaxType[]       taxTypes;
    OrderedTax[]    orderedTaxes;
    TaxGroup[]      taxGroups; // zero or more elements
}
```

See also: [`TaxType`](/pCon/configuratorOnline/specs/api/basket/types/taxscheme#ref-e65d9adc553e), [`OrderedTax`](/pCon/configuratorOnline/specs/api/basket/types/orderedtax#ref-02605b1b6535)

**Detailed information about tax scheme. Result of operation `getTaxScheme` (§[getTaxScheme](/pCon/configuratorOnline/specs/api/basket/operations/gettaxscheme#ref-b4bc6dea8982)).**

<a id="ref-e65d9adc553e"></a><a id="ref-4eec53203b7f"></a><a id="ref-2a470d3dae4c"></a>`TaxType`

## Synopsis

```text
struct TaxType {
    string identifier;
    string rateUnit;
    string abbreviation;
    string name;
    TaxCategory[]   taxCategories;
    boolean hasEnumerableCategories; // required attribute
}
```

See also: [`TaxCategory`](/pCon/configuratorOnline/specs/api/basket/types/taxcategory#ref-e48dd9952039)

**The value of attribute `rateUnit` of complex type `taxType` is either `%` in case of relative taxes, or \<cy\>/\<uom\>, where `<cy>` is a currency code and `<uom>` is an UNECE unit of measure. With the current implementation of pricing procedures, both weight and volume units are meaningful.**

**taxGroups**

The possibly empty list of [TaxGroup](/pCon/configuratorOnline/specs/api/basket/types/taxgroup) definitions in this scheme.

**TaxType.hasEnumerableCategories**

True if all categories of the tax type can be listed. For categories defined directly in the tax configuration, taxCategories contains all available categories. For categories imported from CSV, hasEnumerableCategories is false: the global configuration returns an empty or absent taxCategories list, while a basket scheme returns a possibly empty list of categories used now or at some point in the past.

**Tax date**

A basket tax scheme takes its tax date from the current date in the session time zone when it is first accessed. The date selects the validity period of imported tax categories and cannot be set explicitly. Saving and loading OBK/BSK preserves it. [resetTaxScheme](/pCon/configuratorOnline/specs/api/basket/operations/resettaxscheme) or [resetTaxConfiguration](/pCon/configuratorOnline/specs/api/basket/operations/resettaxconfiguration) discards the corresponding basket schemes; their next access creates new copies with the current date.
