---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/parameter-values.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/parameter-values.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/parameter-values.md
  - href: ru/step-by-step/parameter-values.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/ru/llms.txt

# Передача значений характеристики

Во всех сценариях ориентируйтесь на данные из ответа метода получения характеристик [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/ru/reference/content/getCategoryContentParameters.md):
- `values[].id` — идентификаторы для передачи в `valueId`;
- `multivalue` — можно ли передать несколько значений;
- `allowCustomValues` — можно ли передавать собственные значения (`value` без `valueId`);
- `unit.defaultUnitId`, `unit.units[]` — единицы измерения и их идентификаторы (`unitId`);
- `constraints` — ограничения на значения (границы чисел, максимальная длина текста).

Передача значений выполняется в параметре `parameterValues` в двух методах (правила одинаковые):
- [POST v2/businesses/{businessId}/offer-mappings/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/business-offer-mappings/updateOfferMappings.md)
- [POST v2/businesses/{businessId}/offer-cards/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/content/updateOfferContent.md)

## Характеристика со списком допустимых значений (тип `ENUM`), нужно указать одно значение
- Когда применять: характеристика типа `ENUM`, в ответе метода характеристик поле `multivalue = false`.
- Что передавать: один объект с `parameterId` и `valueId` (идентификатор берите из `values[].id`). Поле `value` можно не указывать.
- Ограничение: если `allowCustomValues = false`, передача только `value` без `valueId` приведет к ошибке валидации.

{% cut "Пример — одно значение из списка" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "valueId": 999999, "value": "10" }
  ]
}
```

{% endcut %}

## Характеристика допускает собственные значения, нужно указать одно собственное значение
- Когда применять: характеристика типа `ENUM`, в ответе метода характеристик поле `allowCustomValues = true`, `multivalue = false`.
- Что передавать: один объект с `parameterId` и строкой в `value`. Поле `valueId` не указывайте.

{% cut "Пример — одно собственное значение" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "Собственное значение" }
  ]
}
```

{% endcut %}

## Характеристика допускает несколько значений
- Когда применять: в ответе метода характеристик поле `multivalue = true`.
- Что передавать: несколько объектов с одинаковым `parameterId` — по одному на каждое значение.
  - Если значение из перечня Маркета — укажите `valueId`.
  - Если разрешены собственные значения (`allowCustomValues = true`) — укажите `value` без `valueId`.

{% cut "Пример — несколько собственных значений" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "Собственное значение 1" },
    { "parameterId": 111111, "value": "Собственное значение 2" }
  ]
}
```

{% endcut %}

## Характеристика с единицами измерения
- Когда применять: для характеристики в ответе указаны единицы (`unit.defaultUnitId`, `unit.units[]`).
- Что передавать: при необходимости указывайте `unitId` в каждом объекте значения; если `unitId` не указан, используется единица по умолчанию.

{% cut "Пример — значение с единицей измерения" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "10", "unitId": 3 }
  ]
}
```

{% endcut %}

## Удаление ранее переданного значения
- Что передавать: объект с тем же `parameterId` и пустым `value` (`""`). Это удалит значение характеристики.

{% cut "Пример — удаление значения характеристики" %}

```json translate=no
{
  "parameterValues": [
    { "parameterId": 111111, "value": "" }
  ]
}
```

{% endcut %}