---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/updateOfferMappings.md
  - https://yandex.com/dev/market/partner-api/doc/ru/reference/business-offer-mappings/updateOfferMappings.md
  - https://yandex.com/dev/market/partner-api/doc/zh/reference/business-offer-mappings/updateOfferMappings.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

<!-- source: en/api/business-offer-mappings/updateOfferMappings.md -->
<div class="openapi">

# Adding products to the catalog and changing information about them

<!-- markdownlint-disable-file -->

{% list tabs %}

- Info

  
  <!-- source: en/_auto/method_scopes/updateOfferMappings.md -->
  **The method is available for [all models](https://yandex.com/dev/market/partner-api/doc/en/overview/business.md).**

  {% cut "**If you are using an API Key token, one of the accesses in the list is required to call the method**" %}

  * offers-and-cards-management — [Manage products and cards](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/offers-and-cards-management.md)
  * all-methods — Full account management

  {% endcut %}
  <!-- endsource: en/_auto/method_scopes/updateOfferMappings.md -->
  
  
  Adds products to the catalog and transmits:
  
  * their [leaf categories](*list-categories) on the Market and categorical characteristics;
  * main features;
  * prices of goods in the cabinet.
  
  It also combines products on the card, edits and deletes information about already added products, including prices in the cabinet and product categories.
  
  You can get a list of Market categories using a request. [POST v2/categories/tree](https://yandex.com/dev/market/partner-api/doc/en/reference/categories/getCategoriesTree.md), and product characteristics by category using [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getCategoryContentParameters.md).
  
  
  {% cut "Добавить новый товар" %}
  
  
  Transfer it with a new ID that has never been used in the folder before.
  
  Be sure to specify the parameters: `offerId`, `name`, `marketCategoryId`, `pictures`, `vendor`, `description`.
  
  Try to convey as much information as possible at once — The Market will need it to select a suitable card or create a new one.
  
  If you know which card on the Market corresponds to the product, you can immediately specify the ID of this card (SKU on the Market) in the field `marketSKU`.
  
  **For sellers of the Yandex Go Market:**
  
  When you add products to the catalog, specify the parameter values `name` and `description` in Russian. To display them in a different language on the showcase, make the request again. `POST v2/businesses/{businessId}/offer-mappings/update` where to specify:
  
    * language in the parameter `language`;
    * parameter values `name` and `description` in the specified language.
  
    You do not need to retransmit the remaining product characteristics.
  
  
  {% endcut %}
  
  
  
  {% cut "Изменить информацию о товаре" %}
  
  
  Send the new data by specifying in `offerId` SKU the product is in your system.
  
  Fields where nothing changes can be omitted.
  
  
  {% endcut %}
  
  
  
  {% cut "Удалить переданные ранее параметры товара" %}
  
  
  In `deleteParameters` specify the parameter values that you want to delete. You can pass multiple values at once.
  
  For parameters with the type `string` you can also pass an empty value.
  
  
  {% endcut %}
  
  
  Parameter `offerId` (SKU the product in your system) must be **unique** for all the products that you transfer.
  
  
  {% note warning "Правила использования SKU" %}
  
  
  * For each product SKU there must be one.
  
  * Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.
  
  SKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).
  
  
  {% endnote %}
  
  
  
  {% note info "Данные в каталоге обновляются не мгновенно" %}
  
  
  It takes up to a few minutes.
  
  
  {% endnote %}
  
  
  
  <!-- source: en/_auto/method_limits/updateOfferMappings.md -->
  |<div style="text-align: left;">**⚙️ Limit without subscription:** 5 000 offers per minute<br>**⭐️ [Limit with Medium subscription](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 10 000 offers per minute</div>|
  |-|
  <!-- endsource: en/_auto/method_limits/updateOfferMappings.md -->
  
  
  
  ## Request
  
  <div class="openapi__requests">
  
  <div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">
  
  <div class="openapi__request">
  
  POST {.openapi__method}
  ```text translate=no
  https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-mappings/update
  ```
  
  </div>
  
  </div>
  
  </div>
  
  ### Path parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _businessId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  Cabinet ID.
  
  
  
  
  To find out, use the request [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/en/reference/campaigns/getCampaigns.md).
  
  ℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)
  
  
  
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  ### Query parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _language_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  The language in which the values in the parameters are accepted and returned `name` and `description`.
  
  Default value: `RU`.
  
  Language:
  
  * `RU` — Russian.
  * `UZ` — uzbek.
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `RU`, `UZ`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "offerMappings": [
      {
        "offer": {
          "offerId": "example",
          "name": "Ударная дрель Makita HP1630, 710 Вт",
          "marketCategoryId": 0,
          "category": "example",
          "pictures": [
            null
          ],
          "videos": [
            null
          ],
          "manuals": [
            null
          ],
          "vendor": "LEVENHUK",
          "barcodes": [
            null
          ],
          "description": "example",
          "manufacturerCountries": [
            null
          ],
          "weightDimensions": {},
          "vendorCode": "VNDR-0005A",
          "tags": [
            null
          ],
          "shelfLife": {},
          "lifeTime": {},
          "guaranteePeriod": {},
          "customsCommodityCode": "8517610008",
          "commodityCodes": [
            null
          ],
          "certificates": [
            null
          ],
          "boxCount": 1,
          "condition": {},
          "type": "DEFAULT",
          "downloadable": true,
          "adult": true,
          "age": {},
          "params": [
            null
          ],
          "parameterValues": [
            null
          ],
          "basicPrice": {},
          "purchasePrice": {},
          "additionalExpenses": {},
          "firstVideoAsCover": true,
          "deleteParameters": [
            null
          ]
        },
        "mapping": {
          "marketSku": 1
        }
      }
    ],
    "onlyPartnerMediaContent": true
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _offerMappings_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  {% cut "**Type**: object[]" %}
  
  #|
  ||
  
  _offer_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    #|
    ||
  
    _offerId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Your SKU — the product ID in your system.
  
    Usage rules SKU:
  
    * For each product SKU there must be one.
  
    * Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.
  
    SKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).
  
  
    {% note warning %}
  
  
    Spaces at the beginning and end of the value are automatically deleted. For example, `"  SKU123  "` and `"SKU123"` they will be treated as identical values.
  
  
    {% endnote %}
  
  
    [What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)
  
  
    _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `255`
  
    _Pattern:_{.json-schema-reset .json-schema-assertion} `^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _adult_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: boolean
  
    The parameter includes the label 18+ for the product. Set it only for products that are related to satisfying sexual needs.
  
    {.table-cell}
    ||
    ||
  
    _age_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _ageUnit_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Age measurement units:
  
    * `YEAR` — year.
    * `MONTH` — month.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `YEAR`, `MONTH`
    {.table-cell}
    ||
    ||
  
    _value_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    Meaning.
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Age in the specified units of measurement.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "value": 0,
      "ageUnit": "YEAR"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _barcodes_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    Barcode.
  
    Specify it as a sequence of numbers. The codes will do EAN-13, EAN-8, UPC-A, UPC-E or Code 128. For books — ISBN.
  
    For products [certain categories and brands](https://yastatic.net/s3/doc-binary/src/support/market/ru/yandex-market-list-for-gtin.xlsx) The barcode must be a valid code. GTIN. Please note: internal barcodes starting with 2 or 02, and format codes Code 128 They are not GTIN.
  
    [What is it GTIN](*gtin)
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "46012300000000"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _boxCount_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    The number of cargo spaces.
  
    This parameter is used if the product consists of several boxes, packages, and so on. For example, the air conditioner takes up two seats — the external and internal units are in two boxes.
  
    For products that occupy one place, do not pass this parameter.
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `1`
    {.table-cell}
    ||
    ||
  
    _category_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
    {.table-cell}|
    **Type**: string
  
  
    {% note warning "Вместо него используйте `marketCategoryId`." %}
  
  
     
  
  
    {% endnote %}
  
  
    The product category in your store.
  
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _certificates_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    The numbers of the documents for the product: certificate, declaration of conformity, etc.
  
    You can only transfer the document numbers, the scans of which are uploaded in the merchant's office by [Instructions](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html).
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max items:_{.json-schema-reset .json-schema-assertion} `6`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "example"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _commodityCodes_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _code_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Product code.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _type_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Type of product code:
  
    * `CUSTOMS_COMMODITY_CODE` — the product code in the unified Commodity Nomenclature of Foreign Economic Activity (HS) — 10 or 14 digits without spaces.
    * `IKPU_CODE` — The identification code of products and services in Uzbekistan is 17 digits without spaces.
  
    Do not send multiple codes of the same type.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `CUSTOMS_COMMODITY_CODE`, `IKPU_CODE`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Product codes.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "code": "example",
        "type": "CUSTOMS_COMMODITY_CODE"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _condition_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _quality_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Product appearance:
  
    * `PERFECT` — ideal.
    * `EXCELLENT` — excellent.
    * `GOOD` — good.
    * `NOT_SPECIFIED` — not selected.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `PERFECT`, `EXCELLENT`, `GOOD`, `NOT_SPECIFIED`
    {.table-cell}
    ||
    ||
  
    _reason_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Product description. Describe the defects in detail, how noticeable they are and where to look for them.
  
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _type_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Markdown type:
  
    * `PREOWNED` —  used goods that used to belong to another person.
    * `SHOWCASESAMPLE` — showcase sample.
    * `REFURBISHED` — re-sale of the product.
    * `REDUCTION` — the product is defective.
    * `RENOVATED` — the restored product.
    * `NOT_SPECIFIED` — not selected.
  
    `REFURBISHED` — special significance for clothing, shoes, and accessories. It is used only for discounted products from this category. Other values for clothing, shoes, and accessories are not used.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `PREOWNED`, `SHOWCASESAMPLE`, `REFURBISHED`, `REDUCTION`, `RENOVATED`, `NOT_SPECIFIED`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The condition of the discounted product.
  
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "type": "PREOWNED",
      "quality": "PERFECT",
      "reason": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _customsCommodityCode_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
    {.table-cell}|
    **Type**: string
  
  
    {% note warning "Вместо него используйте `commodityCodes` с типом `CUSTOMS_COMMODITY_CODE`." %}
  
  
     
  
  
    {% endnote %}
  
  
    The product code in the unified Commodity Nomenclature of Foreign Economic Activity (HS) — 10 or 14 digits without spaces.
  
    Be sure to indicate if there is one.
  
  
    _Example:_{.json-schema-reset .json-schema-example} `8517610008`
    {.table-cell}
    ||
    ||
  
    _description_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Detailed product description: for example, its advantages and features.
  
    Do not provide installation and assembly instructions in the description. Do not use the words "discount", "sale", "cheap", "gift" (except gift categories), "free", "special offer", "special price", "novelty", "new", "analog", "order", "hit". Do not provide any contact information or links.
  
    You can use HTML tags to format the text:
  
    * \<h>, \<h1>, \<h2> and so on — for headlines;
    * \<br> and \<p> — for line breaks;
    * \<ol> — for a numbered list;
    * \<ul> — for a bulleted list.
    * \<li> — to create list items (must be inside \<ol> or \<ul>);
    * \<div> — It is supported, but it does not affect the text display.
  
    Optimal length — 400-600 characters.
  
    [Recommendations and rules](https://yandex.ru/support/marketplace/assortment/fields/description.html)
  
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `6000`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _downloadable_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: boolean
  
    A sign of a digital product. Specify `true` if the product is delivered by e-mail.
  
    [How to work with digital goods](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/digital.md)
  
    {.table-cell}
    ||
    ||
  
    _guaranteePeriod_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    Duration in the specified units.
    {.table-cell}
    ||
    ||
  
    _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Time measurement unit:
  
    * `HOUR` — hour.
    * `DAY` — day.
    * `WEEK` — a week.
    * `MONTH` — month.
    * `YEAR` — year.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
    {.table-cell}
    ||
    ||
  
    _comment_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Comment.
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    A time period with a comment. The requirements for the comment content depend on the context of the parameter usage and are specified in the description of the field that contains it.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _lifeTime_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    Duration in the specified units.
    {.table-cell}
    ||
    ||
  
    _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Time measurement unit:
  
    * `HOUR` — hour.
    * `DAY` — day.
    * `WEEK` — a week.
    * `MONTH` — month.
    * `YEAR` — year.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
    {.table-cell}
    ||
    ||
  
    _comment_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Comment.
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    A time period with a comment. The requirements for the comment content depend on the context of the parameter usage and are specified in the description of the field that contains it.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _manuals_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _url_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `2000`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _title_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    The name of the instruction that will be displayed on the product card.
  
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    A list of instructions for using the product.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max items:_{.json-schema-reset .json-schema-assertion} `6`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "url": "example",
        "title": "example"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _manufacturerCountries_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    The country where the product was produced.
  
    Write down the names of the countries as they are written in [the list](https://yastatic.net/s3/doc-binary/src/support/market/ru/countries.xlsx).
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "Россия"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _marketCategoryId_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    The ID of the category on the Market to which you attribute your product.
  
  
    {% note warning "Всегда указывайте, когда передаете `parameterValues`" %}
  
  
    If, when changing the characteristics, you pass `parameterValues` and don't specify `marketCategoryId`, the characteristics will be updated, but you will receive a warning in the response (parameter `warnings`).
  
    If you do not pass both of them, information from outdated parameters will be used. `params` and `category`, and `marketCategoryId` it will be detected automatically.
  
  
    {% endnote %}
  
  
    When changing the category, make sure that the product characteristics and their values in the parameter `parameterValues` you are submitting for a new category.
  
    You can get a list of Market categories using a request.  [POST v2/categories/tree](https://yandex.com/dev/market/partner-api/doc/en/reference/categories/getCategoriesTree.md).
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
    _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
    {.table-cell}
    ||
    ||
  
    _name_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Make up the name according to the scheme: type + brand or manufacturer + model + features, if any (for example, color, size or weight) and quantity in the package.
  
    Do not include emotional characteristics ("hit", "super", etc.) in the name of the terms of sale (for example, "discount", "free shipping", etc.). Don't write words in capital letters. — except for well-established brand names and models.
  
    Optimal length — 50-60 characters.
  
    [Recommendations and rules](https://yandex.ru/support/marketplace/assortment/fields/title.html)
  
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `256`
  
    _Example:_{.json-schema-reset .json-schema-example} `Ударная дрель Makita HP1630, 710 Вт`
    {.table-cell}
    ||
    ||
  
    _params_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _name_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The name of the characteristic.
  
    It must match the name of the feature on the Market. You can find it from the category's Excel template or through a query. [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getCategoryContentParameters.md).
  
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `200`
  
    _Example:_{.json-schema-reset .json-schema-example} `Wi-Fi`
    {.table-cell}
    ||
    ||
  
    _value_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Meaning.
  
  
    _Example:_{.json-schema-reset .json-schema-example} `есть`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
  
    {% note warning "При передаче характеристик используйте `parameterValues`." %}
  
  
     
  
  
    {% endnote %}
  
  
    Characteristics that only products of a specific category have. — for example, the diameter of the bicycle wheels or the material of the shoe sole.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "name": "Wi-Fi",
        "value": "есть"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _pictures_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    Links to product images. The image on the first link is considered the main one, the others are additional.
  
    **Link Requirements**
  
    * Specify the entire link, including the http or https protocol.
    * Russian letters in URL may.
    * You can use direct links to images and to Yandex.Disk. Links on Yandex.Disk must be copied using the function **Share**. Relative links and links to other cloud storage — They don't work.
  
    ✅ `https://example-shop.ru/images/sku12345.jpg`
  
    ✅ `https://yadi.sk/i/NaBoRsimVOLov`
  
    ❌ `/images/sku12345.jpg`
  
    ❌ `https://www.dropbox.com/s/818f/tovar.jpg`
  
    The links to the image must be permanent. You cannot use dynamic links that change from upload to upload.
  
    If you need to replace the image, upload the new image via a new link, and delete the link to the old one. If you simply replace the image using the old link, it will not update.
  
    [Image Requirements](https://yandex.ru/support/marketplace/assortment/fields/images.html)
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max items:_{.json-schema-reset .json-schema-assertion} `30`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "example"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _shelfLife_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    Duration in the specified units.
    {.table-cell}
    ||
    ||
  
    _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Time measurement unit:
  
    * `HOUR` — hour.
    * `DAY` — day.
    * `WEEK` — a week.
    * `MONTH` — month.
    * `YEAR` — year.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
    {.table-cell}
    ||
    ||
  
    _comment_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Comment.
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `500`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    A time period with a comment. The requirements for the comment content depend on the context of the parameter usage and are specified in the description of the field that contains it.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _tags_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    Product labels that the store uses. The tags are not visible to customers. You can group and filter different products in the catalog by tags. — for example, products of the same series, collection, or line.
  
    Maximum tag length — 20 characters. One product can have a maximum of 10 tags.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max items:_{.json-schema-reset .json-schema-assertion} `50`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "до 500 рублей"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _type_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Special type of product:
  
    * `DEFAULT` — products for which you previously provided a special type and want to remove it.
    * `MEDICINE` — medicines.
    * `BOOK` — paper and electronic books.
    * `AUDIOBOOK` — audiobooks.
    * `ARTIST_TITLE` — music and video production.
    * `ON_DEMAND` — custom-made products.
    * `ALCOHOL` — alcohol.
  
  
    {% note info "Если ваш товар — книга" %}
  
  
    Specify the year of publication in the product specifications. [More information about the parameter](https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/updateOfferMappings.md#offerparamdto)
  
  
    {% endnote %}
  
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `DEFAULT`, `MEDICINE`, `BOOK`, `AUDIOBOOK`, `ARTIST_TITLE`, `ON_DEMAND`, `ALCOHOL`
    {.table-cell}
    ||
    ||
  
    _vendor_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    The name of the brand or manufacturer. It should be written the way the brand itself writes it.
  
    _Example:_{.json-schema-reset .json-schema-example} `LEVENHUK`
    {.table-cell}
    ||
    ||
  
    _vendorCode_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    The article of the product from the manufacturer.
  
    _Example:_{.json-schema-reset .json-schema-example} `VNDR-0005A`
    {.table-cell}
    ||
    ||
  
    _videos_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    Links (URL) on the product video.
  
    **Link Requirements**
  
    * Specify the entire link, including the http or https protocol.
    * Russian letters in URL may.
    * You can use direct links to videos and to Yandex.Disk. Links on Yandex.Disk must be copied using the function **Share**. Relative links and links to other cloud storage — They don't work.
  
    ✅ `https://example-shop.ru/video/sku12345.avi`
  
    ✅ `https://yadi.sk/i/NaBoRsimVOLov`
  
    ❌ `/video/sku12345.avi`
  
    ❌ `https://www.dropbox.com/s/818f/super-tovar.avi`
  
    Links to videos must be permanent. You cannot use dynamic links that change from upload to upload.
  
    If you need to replace the video, upload the new video via a new link, and delete the link to the old one. If you simply replace the video using the old link, it will not update.
  
    [Video Requirements](https://yandex.ru/support/marketplace/assortment/fields/video.html)
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max items:_{.json-schema-reset .json-schema-assertion} `6`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "example"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _weightDimensions_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _height_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    Package height in cm.
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
    {.table-cell}
    ||
    ||
  
    _length_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    Package length in cm.
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
    {.table-cell}
    ||
    ||
  
    _weight_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    The weight of the product in kg, including packaging (gross).
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
    {.table-cell}
    ||
    ||
  
    _width_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    Package width in cm.
  
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The dimensions of the package and the weight of the product.
  
    If the product takes up several boxes, fold them compactly before measuring the dimensions.
  
    ![Multi-seat cargo measurement scheme](../../_images/reference/boxes-measure.png)
  
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "length": 65.55,
      "width": 50.7,
      "height": 20,
      "weight": 1.001
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    The main parameters of the product.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "offerId": "example",
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "marketCategoryId": 0,
      "category": "example",
      "pictures": [
        "example"
      ],
      "videos": [
        "example"
      ],
      "manuals": [
        {
          "url": "example",
          "title": "example"
        }
      ],
      "vendor": "LEVENHUK",
      "barcodes": [
        "46012300000000"
      ],
      "description": "example",
      "manufacturerCountries": [
        "Россия"
      ],
      "weightDimensions": {
        "length": 65.55,
        "width": 50.7,
        "height": 20,
        "weight": 1.001
      },
      "vendorCode": "VNDR-0005A",
      "tags": [
        "до 500 рублей"
      ],
      "shelfLife": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "lifeTime": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "guaranteePeriod": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "customsCommodityCode": "8517610008",
      "commodityCodes": [
        {
          "code": "example",
          "type": "CUSTOMS_COMMODITY_CODE"
        }
      ],
      "certificates": [
        "example"
      ],
      "boxCount": 1,
      "condition": {
        "type": "PREOWNED",
        "quality": "PERFECT",
        "reason": "example"
      },
      "type": "DEFAULT",
      "downloadable": true,
      "adult": true,
      "age": {
        "value": 0,
        "ageUnit": "YEAR"
      },
      "params": [
        {
          "name": "Wi-Fi",
          "value": "есть"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  - **Type**: object
  
    #|
    ||
  
    _additionalExpenses_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Currency codes:
  
    * `RUR` — the Russian ruble.
    * `UAH` — the Ukrainian hryvnia.
    * `BYR` — the Belarusian ruble.
    * `KZT` — Kazakhstani tenge.
    * `UZS` — Uzbek sum.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
    {.table-cell}
    ||
    ||
  
    _value_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    The price of the product.
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
    _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The price of the product.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "value": 0,
      "currencyId": "RUR"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _basicPrice_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      Currency codes:
  
      * `RUR` — the Russian ruble.
      * `UAH` — the Ukrainian hryvnia.
      * `BYR` — the Belarusian ruble.
      * `KZT` — Kazakhstani tenge.
      * `UZS` — Uzbek sum.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
      {.table-cell}
      ||
      ||
  
      _value_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: number
  
      The price of the product.
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
      _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The price of the product.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "value": 0,
        "currencyId": "RUR"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _discountBase_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: number
  
      The crossed-out price.
  
      The number must be an integer. You can specify a price with a discount from 5 to 99%.
  
      Pass this parameter every time the price is updated if you provide a discount on the product.
  
  
      _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
      _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "discountBase": 0
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    Price with discount indication.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "value": 0,
      "currencyId": "RUR",
      "discountBase": 0
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _deleteParameters_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string[] &#124; null
  
    The parameters that you previously passed to `UpdateOfferDTO`, and now you want to delete it.
  
    If you pass `adult`, `downloadable` and `firstVideoAsCover` They will not be deleted — their value will change to `false`.
  
    You can pass multiple values at once.
  
    Do not use together with the corresponding parameter in `UpdateOfferDTO`. This will result in an error. `400`.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      "ADDITIONAL_EXPENSES"
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _firstVideoAsCover_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
    {.table-cell}|
    **Type**: boolean
  
    Use the first video in the card as a video background.
  
    Pass it on `true` for the first video to be used as a video background, or `false` so that the video background is not displayed in the product profile.
  
    {.table-cell}
    ||
    ||
  
    _parameterValues_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _parameterId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    The identifier of the characteristic.
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `1`
    {.table-cell}
    ||
    ||
  
    _unitId_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    ID of the unit of measurement. If you did not pass the parameter `unitId`, the default unit of measurement is used.
    {.table-cell}
    ||
    ||
  
    _value_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: string
  
    Meaning.
  
    For type characteristics `ENUM` send:
    - Together with `valueId`, if you take the value from the directory;
    - without `valueId`, if the value is its own.
  
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _valueId_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    ID of the value.
  
    - Be sure to specify the identifier if you are transmitting a value from the list of acceptable values received from the Market.
    - Do not specify for your own values.
    - Only for type characteristics `ENUM`.
  
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    A list of characteristics with their values.
  
  
    {% note warning "Всегда передавайте вместе с `marketCategoryId`" %}
  
  
    If you don't pass it `marketCategoryId` when the characteristics change, they will be updated, but a warning will be received in the response (parameter `warnings`).
  
    If you do not pass both of them, information from outdated parameters will be used. `params` and `category`, and `marketCategoryId` it will be detected automatically.
  
  
    {% endnote %}
  
  
    When **changing** characteristics, transmit only those whose value needs to be updated. If in `marketCategoryId` you are changing the category, the values of the common characteristics for the old and new categories will remain, and you do not need to transfer them.
  
    Read more in ["Transfer of characteristic values"](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/parameter-values.md).
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max items:_{.json-schema-reset .json-schema-assertion} `300`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "parameterId": 1,
        "unitId": 0,
        "valueId": 0,
        "value": "example"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _purchasePrice_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Currency codes:
  
    * `RUR` — the Russian ruble.
    * `UAH` — the Ukrainian hryvnia.
    * `BYR` — the Belarusian ruble.
    * `KZT` — Kazakhstani tenge.
    * `UZS` — Uzbek sum.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
    {.table-cell}
    ||
    ||
  
    _value_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: number
  
    The price of the product.
  
    _Min value:_{.json-schema-reset .json-schema-assertion} `0`
  
    _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The price of the product.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "value": 0,
      "currencyId": "RUR"
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "parameterValues": [
        {
          "parameterId": 1,
          "unitId": 0,
          "valueId": 0,
          "value": "example"
        }
      ],
      "basicPrice": {
        "value": 0,
        "currencyId": "RUR",
        "discountBase": 0
      },
      "purchasePrice": {
        "value": 0,
        "currencyId": "RUR"
      },
      "additionalExpenses": {
        "value": 0,
        "currencyId": "RUR"
      },
      "firstVideoAsCover": true,
      "deleteParameters": [
        "ADDITIONAL_EXPENSES"
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  Product parameters.
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "offerId": "example",
    "name": "Ударная дрель Makita HP1630, 710 Вт",
    "marketCategoryId": 0,
    "category": "example",
    "pictures": [
      "example"
    ],
    "videos": [
      "example"
    ],
    "manuals": [
      {
        "url": "example",
        "title": "example"
      }
    ],
    "vendor": "LEVENHUK",
    "barcodes": [
      "46012300000000"
    ],
    "description": "example",
    "manufacturerCountries": [
      "Россия"
    ],
    "weightDimensions": {
      "length": 65.55,
      "width": 50.7,
      "height": 20,
      "weight": 1.001
    },
    "vendorCode": "VNDR-0005A",
    "tags": [
      "до 500 рублей"
    ],
    "shelfLife": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "lifeTime": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "guaranteePeriod": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "customsCommodityCode": "8517610008",
    "commodityCodes": [
      {
        "code": "example",
        "type": "CUSTOMS_COMMODITY_CODE"
      }
    ],
    "certificates": [
      "example"
    ],
    "boxCount": 1,
    "condition": {
      "type": "PREOWNED",
      "quality": "PERFECT",
      "reason": "example"
    },
    "type": "DEFAULT",
    "downloadable": true,
    "adult": true,
    "age": {
      "value": 0,
      "ageUnit": "YEAR"
    },
    "params": [
      {
        "name": "Wi-Fi",
        "value": "есть"
      }
    ],
    "parameterValues": [
      {
        "parameterId": 1,
        "unitId": 0,
        "valueId": 0,
        "value": "example"
      }
    ],
    "basicPrice": {
      "value": 0,
      "currencyId": "RUR",
      "discountBase": 0
    },
    "purchasePrice": {
      "value": 0,
      "currencyId": "RUR"
    },
    "additionalExpenses": {
      "value": 0,
      "currencyId": "RUR"
    },
    "firstVideoAsCover": true,
    "deleteParameters": [
      "ADDITIONAL_EXPENSES"
    ]
  }
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _mapping_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  {% cut "**Type**: object" %}
  
  #|
  ||
  
  _marketSku_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer
  
  The ID of the product card on the Market.
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  {% endcut %}
  
  A card on the Market that, from your point of view, fits the product. To determine the ID of the appropriate card, use the search in the cabinet (**Products** → **Catalog** → **Upload products**).
  
  Based on the verification results, the Market can link the product to a more suitable card.
  
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "marketSku": 1
  }
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  {% endcut %}
  
  A list of products that need to be added or updated.
  
  
  {% note warning "Скоро мы уменьшим максимальное количество товаров в запросе" %}
  
  
  Don't send more than 100 right now.
  
  
  {% endnote %}
  
  
   
  
  
  _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Max items:_{.json-schema-reset .json-schema-assertion} `500`
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    {
      "offer": {
        "offerId": "example",
        "name": "Ударная дрель Makita HP1630, 710 Вт",
        "marketCategoryId": 0,
        "category": "example",
        "pictures": [
          "example"
        ],
        "videos": [
          "example"
        ],
        "manuals": [
          {}
        ],
        "vendor": "LEVENHUK",
        "barcodes": [
          "46012300000000"
        ],
        "description": "example",
        "manufacturerCountries": [
          "Россия"
        ],
        "weightDimensions": {
          "length": 65.55,
          "width": 50.7,
          "height": 20,
          "weight": 1.001
        },
        "vendorCode": "VNDR-0005A",
        "tags": [
          "до 500 рублей"
        ],
        "shelfLife": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "lifeTime": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "guaranteePeriod": {
          "timePeriod": 0,
          "timeUnit": "HOUR",
          "comment": "example"
        },
        "customsCommodityCode": "8517610008",
        "commodityCodes": [
          {}
        ],
        "certificates": [
          "example"
        ],
        "boxCount": 1,
        "condition": {
          "type": "PREOWNED",
          "quality": "PERFECT",
          "reason": "example"
        },
        "type": "DEFAULT",
        "downloadable": true,
        "adult": true,
        "age": {
          "value": 0,
          "ageUnit": "YEAR"
        },
        "params": [
          {}
        ],
        "parameterValues": [
          {}
        ],
        "basicPrice": {},
        "purchasePrice": {
          "value": 0,
          "currencyId": "RUR"
        },
        "additionalExpenses": {
          "value": 0,
          "currencyId": "RUR"
        },
        "firstVideoAsCover": true,
        "deleteParameters": [
          "ADDITIONAL_EXPENSES"
        ]
      },
      "mapping": {
        "marketSku": 1
      }
    }
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _onlyPartnerMediaContent_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: boolean
  
  Whether only the product data you provided will be used.
  
  Default value: `false`. To delete the data that the Market added, pass the value `true`.
  
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  The request was executed correctly, and the data has been processed.
  
  
  {% note warning "Ответ `200` сам по себе не значит, что переданные значения корректны" %}
  
  
  Be sure to look at the details of the response.: `status`, as well as a list of errors (`results.errors`) and comments (`results.warnings`), if there are any.
  
  - If an error is returned for at least one product (`results.errors`), field `status` = `ERROR`. Changes to all transferred items will not be applied.
  - If there are no errors, but at least one product has a comment returned (`results.warnings`), field `status` = `OK`, and the changes will be applied.
  
  
  {% endnote %}
  
  
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "results": [
      {
        "offerId": "example",
        "errors": [
          {}
        ],
        "warnings": [
          {}
        ]
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _status_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The type of response.
    Possible values:
    * `OK` — There are no errors.
    * `ERROR` — an error occurred while processing the request.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The standard wrapper for server responses.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _results_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _offerId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Your SKU — the product ID in your system.
  
    Usage rules SKU:
  
    * For each product SKU there must be one.
  
    * Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.
  
    SKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).
  
  
    {% note warning %}
  
  
    Spaces at the beginning and end of the value are automatically deleted. For example, `"  SKU123  "` and `"SKU123"` they will be treated as identical values.
  
  
    {% endnote %}
  
  
    [What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)
  
  
    _Min length:_{.json-schema-reset .json-schema-assertion} `1`
  
    _Max length:_{.json-schema-reset .json-schema-assertion} `255`
  
    _Pattern:_{.json-schema-reset .json-schema-assertion} `^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _errors_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _message_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The text of the error or warning.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _type_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Types of errors and warnings:
  
    * `UNKNOWN_CATEGORY` — an unknown category is specified.
    * `INVALID_CATEGORY` — a non-leaf category is specified. Specify the one that has no child categories.
    * `EMPTY_MARKET_CATEGORY` — the Market category is not specified when transmitting the category characteristics.
    * `UNKNOWN_PARAMETER` — A characteristic has been transmitted that is not among the characteristics of the category.
    * `UNEXPECTED_BOOLEAN_VALUE` — something else is passed instead of the boolean value.
    * `NUMBER_FORMAT` — a string is passed that does not represent a number, instead of a number.
    * `INVALID_UNIT_ID` — the unit of measurement that is unacceptable for the characteristic has been passed.
    * `INVALID_GROUP_ID_LENGTH` — the allowed character value is exceeded in the name — 255.
    * `INVALID_GROUP_ID_CHARACTERS` — transferred [invalid characters](*ascii-code).
    * `INVALID_PICKER_URL` — a link to the thumbnail image was transmitted, which is not included in the transmitted links to the product image.
    * `LOCKED_DIMENSIONS` — The dimensions of the package have been transferred, which cannot be changed.
    * `INVALID_COMMODITY_CODE` — an incorrect product code was transmitted.
  
    You can check which category characteristics are available for a given category and get their settings using a request. [POST v2/category/{categoryId}/parameters](../content/getCategoryContentParameters).
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `EMPTY_MARKET_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`, `INVALID_PICKER_URL`, `LOCKED_DIMENSIONS`, `INVALID_COMMODITY_CODE`
    {.table-cell}
    ||
    ||
  
    _parameterId_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    ID of the characteristic that the error or warning is associated with.
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Mistakes.
  
    If there is an error for at least one product, the information in the catalog will not be updated for all transferred products.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "type": "UNKNOWN_CATEGORY",
        "parameterId": 0,
        "message": "example"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    ||
  
    _warnings_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object[]" %}
  
    #|
    ||
  
    _message_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The text of the error or warning.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    ||
  
    _type_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    Types of errors and warnings:
  
    * `UNKNOWN_CATEGORY` — an unknown category is specified.
    * `INVALID_CATEGORY` — a non-leaf category is specified. Specify the one that has no child categories.
    * `EMPTY_MARKET_CATEGORY` — the Market category is not specified when transmitting the category characteristics.
    * `UNKNOWN_PARAMETER` — A characteristic has been transmitted that is not among the characteristics of the category.
    * `UNEXPECTED_BOOLEAN_VALUE` — something else is passed instead of the boolean value.
    * `NUMBER_FORMAT` — a string is passed that does not represent a number, instead of a number.
    * `INVALID_UNIT_ID` — the unit of measurement that is unacceptable for the characteristic has been passed.
    * `INVALID_GROUP_ID_LENGTH` — the allowed character value is exceeded in the name — 255.
    * `INVALID_GROUP_ID_CHARACTERS` — transferred [invalid characters](*ascii-code).
    * `INVALID_PICKER_URL` — a link to the thumbnail image was transmitted, which is not included in the transmitted links to the product image.
    * `LOCKED_DIMENSIONS` — The dimensions of the package have been transferred, which cannot be changed.
    * `INVALID_COMMODITY_CODE` — an incorrect product code was transmitted.
  
    You can check which category characteristics are available for a given category and get their settings using a request. [POST v2/category/{categoryId}/parameters](../content/getCategoryContentParameters).
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `EMPTY_MARKET_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`, `INVALID_PICKER_URL`, `LOCKED_DIMENSIONS`, `INVALID_COMMODITY_CODE`
    {.table-cell}
    ||
    ||
  
    _parameterId_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    **Type**: integer
  
    ID of the characteristic that the error or warning is associated with.
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Warnings.
  
    The information in the catalog will be updated.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "type": "UNKNOWN_CATEGORY",
        "parameterId": 0,
        "message": "example"
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    Errors and warnings that appeared when processing the list of characteristics. Each item in the list corresponds to one product.
  
    If there are no errors or warnings, the field is not passed.
  
  
    _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    [
      {
        "offerId": "example",
        "errors": [
          {
            "type": "UNKNOWN_CATEGORY",
            "parameterId": 0,
            "message": "example"
          }
        ],
        "warnings": [
          {
            "type": "UNKNOWN_CATEGORY",
            "parameterId": 0,
            "message": "example"
          }
        ]
      }
    ]
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "results": [
        {
          "offerId": "example",
          "errors": [
            {
              "type": "UNKNOWN_CATEGORY",
              "parameterId": 0,
              "message": "example"
            }
          ],
          "warnings": [
            {
              "type": "UNKNOWN_CATEGORY",
              "parameterId": 0,
              "message": "example"
            }
          ]
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__400">
  
  ## 400 Bad Request
  
  ⚠️ Even if the problem is related to only one product in the request, none will be sent to the catalog.
  
  The request contains incorrect data. [Learn more about errors when working with products](../../concepts/error-codes#offers) and [about errors when working with prices](../../concepts/error-codes#prices)
  
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__401">
  
  ## 401 Unauthorized
  
  The authorization data is not specified in the request. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#401)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__403">
  
  ## 403 Forbidden
  
  The authorization data is incorrect or access to the resource is prohibited. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#403)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__404">
  
  ## 404 Not Found
  
  The requested resource was not found. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#404)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__420">
  
  ## 420 Method Failure
  
  The resource access limit has been exceeded. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#420)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__423">
  
  ## 423 Locked
  
  The specified method cannot be applied to the resource. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#423)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__500">
  
  ## 500 Internal Server Error
  
  Internal error of the Market. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#500)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
        

- Console

  ```openapi-sandbox translate=no
  pathParams:
    - description: "Cabinet ID.\n\n\n:::no-translate\n{% if audience == \"partner\" %}\n:::\n\n\nTo find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n\n\n:::no-translate\n{% endif %}\n:::\n\n"
      name: businessId
      in: path
      required: true
      schema:
        type: integer
        format: int64
        minimum: 1
  searchParams:
    - description: >
        The language in which the values in the parameters are accepted and
        returned `name` and `description`.
  
  
        Default value: `RU`.
      name: language
      in: query
      required: false
      schema:
        description: |
          Language:
  
          * `RU` — Russian.
          * `UZ` — uzbek.
        type: string
        enum:
          - RU
          - UZ
  headers: []
  body: |-
    {
      "offerMappings": [
        {
          "offer": {
            "offerId": "example",
            "name": "Ударная дрель Makita HP1630, 710 Вт",
            "marketCategoryId": 0,
            "category": "example",
            "pictures": [
              null
            ],
            "videos": [
              null
            ],
            "manuals": [
              null
            ],
            "vendor": "LEVENHUK",
            "barcodes": [
              null
            ],
            "description": "example",
            "manufacturerCountries": [
              null
            ],
            "weightDimensions": {},
            "vendorCode": "VNDR-0005A",
            "tags": [
              null
            ],
            "shelfLife": {},
            "lifeTime": {},
            "guaranteePeriod": {},
            "customsCommodityCode": "8517610008",
            "commodityCodes": [
              null
            ],
            "certificates": [
              null
            ],
            "boxCount": 1,
            "condition": {},
            "type": "DEFAULT",
            "downloadable": true,
            "adult": true,
            "age": {},
            "params": [
              null
            ],
            "parameterValues": [
              null
            ],
            "basicPrice": {},
            "purchasePrice": {},
            "additionalExpenses": {},
            "firstVideoAsCover": true,
            "deleteParameters": [
              null
            ]
          },
          "mapping": {
            "marketSku": 1
          }
        }
      ],
      "onlyPartnerMediaContent": true
    }
  schema:
    type: object
    required:
      - offerMappings
    properties:
      offerMappings:
        description: "A list of products that need to be added or updated.\n\n\n:::no-translate\n{% note warning \"Скоро мы уменьшим максимальное количество товаров в запросе\" %}\n:::\n\n\nDon't send more than 100 right now.\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n\_\n"
        type: array
        minItems: 1
        maxItems: 500
        items:
          description: Product information.
          type: object
          required:
            - offer
          properties:
            offer:
              description: Product parameters.
              type: object
              allOf:
                - description: The main parameters of the product.
                  type: object
                  required:
                    - offerId
                  properties:
                    offerId:
                      description: "Your SKU —\_the product ID in your system.\n\nUsage rules SKU:\n\n* For each product SKU there must be one.\n\n* Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.\n\nSKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n\n:::no-translate\n{% note warning %}\n:::\n\n\nSpaces at the beginning and end of the value are automatically deleted. For example, `\"  SKU123  \"` and `\"SKU123\"` they will be treated as identical values.\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n[What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
                      type: string
                      pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
                      x-transform: trim
                      minLength: 1
                      maxLength: 255
                    internalOfferId:
                      description: >-
                        The internal identifier of the product in the Market
                        systems. It is needed to create Shop and Food products
                        with different offerids.
                      type: string
                      minLength: 1
                      maxLength: 255
                      x-hidden: true
                    name:
                      description: >
                        Make up the name according to the scheme: type + brand or
                        manufacturer + model + features, if any (for example,
                        color, size or weight) and quantity in the package.
  
  
                        Do not include emotional characteristics ("hit", "super",
                        etc.) in the name of the terms of sale (for example,
                        "discount", "free shipping", etc.). Don't write words in
                        capital letters. — except for
                        well-established brand names and models.
  
  
                        Optimal length — 50-60 characters.
  
  
                        [Recommendations and
                        rules](https://yandex.ru/support/marketplace/assortment/fields/title.html)
                      example: Ударная дрель Makita HP1630, 710 Вт
                      type: string
                      maxLength: 256
                    marketCategoryId:
                      description: "The ID of the category on the Market to which you attribute your product.\n\n\n:::no-translate\n{% note warning \"Всегда указывайте, когда передаете `parameterValues`\" %}\n:::\n\n\nIf, when changing the characteristics, you pass `parameterValues` and don't specify `marketCategoryId`, the characteristics will be updated, but you will receive a warning in the response (parameter `warnings`).\n\nIf you do not pass both of them, information from outdated parameters will be used. `params` and `category`, and `marketCategoryId` it will be detected automatically.\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\nWhen changing the category, make sure that the product characteristics and their values in the parameter `parameterValues` you are submitting for a new category.\n\nYou can get a list of Market categories using a request.  [POST\_v2/categories/tree](../../reference/categories/getCategoriesTree.md).\n"
                      type: integer
                      format: int64
                      minimum: 0
                      exclusiveMinimum: true
                    category:
                      description: "\n:::no-translate\n{% note warning \"Вместо него используйте `marketCategoryId`.\" %}\n:::\n\n\n\_\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\nThe product category in your store.\n"
                      type: string
                      deprecated: true
                      x-deprecation-config:
                        shutdown-date: '2026-10-12'
                        replacement-field: marketCategoryId
                    pictures:
                      description: >
                        Links to product images. The image on the first link is
                        considered the main one, the others are additional.
  
  
                        **Link Requirements**
  
  
                        * Specify the entire link, including the http or https
                        protocol.
  
                        * Russian letters in URL may.
  
                        * You can use direct links to images and to Yandex.Disk.
                        Links on Yandex.Disk must be copied using the function
                        **Share**. Relative links and links to other cloud storage
                        — They don't work.
  
  
                        ✅
                        `https://example-shop.ru/images/sku12345.jpg`
  
  
                        ✅ `https://yadi.sk/i/NaBoRsimVOLov`
  
  
                        ❌ `/images/sku12345.jpg`
  
  
                        ❌
                        `https://www.dropbox.com/s/818f/tovar.jpg`
  
  
                        The links to the image must be permanent. You cannot use
                        dynamic links that change from upload to upload.
  
  
                        If you need to replace the image, upload the new image via
                        a new link, and delete the link to the old one. If you
                        simply replace the image using the old link, it will not
                        update.
  
  
                        [Image
                        Requirements](https://yandex.ru/support/marketplace/assortment/fields/images.html)
                      type: array
                      nullable: true
                      minItems: 1
                      maxItems: 30
                      uniqueItems: false
                      items:
                        type: string
                        minLength: 1
                        maxLength: 2000
                    videos:
                      description: >
                        Links (URL) on the product video.
  
  
                        **Link Requirements**
  
  
                        * Specify the entire link, including the http or https
                        protocol.
  
                        * Russian letters in URL may.
  
                        * You can use direct links to videos and to Yandex.Disk.
                        Links on Yandex.Disk must be copied using the function
                        **Share**. Relative links and links to other cloud storage
                        — They don't work.
  
  
                        ✅
                        `https://example-shop.ru/video/sku12345.avi`
  
  
                        ✅ `https://yadi.sk/i/NaBoRsimVOLov`
  
  
                        ❌ `/video/sku12345.avi`
  
  
                        ❌
                        `https://www.dropbox.com/s/818f/super-tovar.avi`
  
  
                        Links to videos must be permanent. You cannot use dynamic
                        links that change from upload to upload.
  
  
                        If you need to replace the video, upload the new video via
                        a new link, and delete the link to the old one. If you
                        simply replace the video using the old link, it will not
                        update.
  
  
                        [Video
                        Requirements](https://yandex.ru/support/marketplace/assortment/fields/video.html)
                      type: array
                      nullable: true
                      minItems: 1
                      maxItems: 6
                      uniqueItems: false
                      items:
                        type: string
                        minLength: 1
                        maxLength: 2000
                    manuals:
                      description: |
                        A list of instructions for using the product.
                      type: array
                      nullable: true
                      minItems: 1
                      maxItems: 6
                      items:
                        type: object
                        required:
                          - url
                        description: |
                          Instructions for using the product.
                        properties:
                          url:
                            type: string
                            minLength: 1
                            maxLength: 2000
                          title:
                            description: >
                              The name of the instruction that will be displayed
                              on the product card.
                            type: string
                            maxLength: 500
                    vendor:
                      description: >-
                        The name of the brand or manufacturer. It should be
                        written the way the brand itself writes it.
                      example: LEVENHUK
                      type: string
                    barcodes:
                      description: >
                        Barcode.
  
  
                        Specify it as a sequence of numbers. The codes will do
                        EAN-13, EAN-8, UPC-A, UPC-E or
                        Code 128. For books —
                        ISBN.
  
  
                        For products [certain categories and
                        brands](https://yastatic.net/s3/doc-binary/src/support/market/ru/yandex-market-list-for-gtin.xlsx)
                        The barcode must be a valid code. GTIN.
                        Please note: internal barcodes starting with 2 or 02, and
                        format codes Code 128 They are not
                        GTIN.
  
  
                        [What is it GTIN](*gtin)
                      type: array
                      nullable: true
                      minItems: 1
                      uniqueItems: true
                      items:
                        type: string
                        example: '46012300000000'
                    description:
                      description: >
                        Detailed product description: for example, its advantages
                        and features.
  
  
                        Do not provide installation and assembly instructions in
                        the description. Do not use the words "discount", "sale",
                        "cheap", "gift" (except gift categories), "free", "special
                        offer", "special price", "novelty", "new", "analog",
                        "order", "hit". Do not provide any contact information or
                        links.
  
  
                        You can use HTML tags to format the text:
  
  
                        * \<h>, \<h1>, \<h2> and so on — for
                        headlines;
  
                        * \<br> and \<p> — for line breaks;
  
                        * \<ol> — for a numbered list;
  
                        * \<ul> — for a bulleted list.
  
                        * \<li> — to create list items (must be
                        inside \<ol> or \<ul>);
  
                        * \<div> — It is supported, but it does not
                        affect the text display.
  
  
                        Optimal length — 400-600 characters.
  
  
                        [Recommendations and
                        rules](https://yandex.ru/support/marketplace/assortment/fields/description.html)
                      type: string
                      maxLength: 6000
                    manufacturerCountries:
                      description: >
                        The country where the product was produced.
  
  
                        Write down the names of the countries as they are written
                        in [the
                        list](https://yastatic.net/s3/doc-binary/src/support/market/ru/countries.xlsx).
                      type: array
                      nullable: true
                      minItems: 1
                      uniqueItems: true
                      items:
                        type: string
                        example: Россия
                    weightDimensions:
                      description: >
                        The dimensions of the package and the weight of the
                        product.
  
  
                        If the product takes up several boxes, fold them compactly
                        before measuring the dimensions.
  
  
                        ![Multi-seat cargo measurement
                        scheme](../../_images/reference/boxes-measure.png)
                      type: object
                      required:
                        - length
                        - width
                        - height
                        - weight
                      properties:
                        length:
                          description: |
                            Package length in cm.
                          example: 65.55
                          type: number
                          minimum: 0
                        width:
                          description: |
                            Package width in cm.
                          example: 50.7
                          type: number
                          minimum: 0
                        height:
                          description: |
                            Package height in cm.
                          example: 20
                          type: number
                          minimum: 0
                        weight:
                          description: >
                            The weight of the product in kg, including packaging
                            (gross).
                          example: 1.001
                          type: number
                          minimum: 0
                    vendorCode:
                      description: The article of the product from the manufacturer.
                      example: VNDR-0005A
                      type: string
                    tags:
                      description: >
                        Product labels that the store uses. The tags are not
                        visible to customers. You can group and filter different
                        products in the catalog by tags. — for
                        example, products of the same series, collection, or line.
  
  
                        Maximum tag length — 20 characters. One
                        product can have a maximum of 10 tags.
                      type: array
                      nullable: true
                      minItems: 1
                      maxItems: 50
                      uniqueItems: true
                      items:
                        type: string
                        example: до 500 рублей
                    shelfLife:
                      description: >-
                        A time period with a comment. The requirements for the
                        comment content depend on the context of the parameter
                        usage and are specified in the description of the field
                        that contains it.
                      type: object
                      required:
                        - timePeriod
                        - timeUnit
                      properties:
                        timePeriod:
                          description: Duration in the specified units.
                          type: integer
                        timeUnit:
                          description: |
                            Time measurement unit:
  
                            * `HOUR` — hour.
                            * `DAY` — day.
                            * `WEEK` — a week.
                            * `MONTH` — month.
                            * `YEAR` — year.
                          type: string
                          enum:
                            - HOUR
                            - DAY
                            - WEEK
                            - MONTH
                            - YEAR
                        comment:
                          description: Comment.
                          type: string
                          maxLength: 500
                    lifeTime:
                      description: >-
                        A time period with a comment. The requirements for the
                        comment content depend on the context of the parameter
                        usage and are specified in the description of the field
                        that contains it.
                      type: object
                      required:
                        - timePeriod
                        - timeUnit
                      properties:
                        timePeriod:
                          description: Duration in the specified units.
                          type: integer
                        timeUnit:
                          description: |
                            Time measurement unit:
  
                            * `HOUR` — hour.
                            * `DAY` — day.
                            * `WEEK` — a week.
                            * `MONTH` — month.
                            * `YEAR` — year.
                          type: string
                          enum:
                            - HOUR
                            - DAY
                            - WEEK
                            - MONTH
                            - YEAR
                        comment:
                          description: Comment.
                          type: string
                          maxLength: 500
                    guaranteePeriod:
                      description: >-
                        A time period with a comment. The requirements for the
                        comment content depend on the context of the parameter
                        usage and are specified in the description of the field
                        that contains it.
                      type: object
                      required:
                        - timePeriod
                        - timeUnit
                      properties:
                        timePeriod:
                          description: Duration in the specified units.
                          type: integer
                        timeUnit:
                          description: |
                            Time measurement unit:
  
                            * `HOUR` — hour.
                            * `DAY` — day.
                            * `WEEK` — a week.
                            * `MONTH` — month.
                            * `YEAR` — year.
                          type: string
                          enum:
                            - HOUR
                            - DAY
                            - WEEK
                            - MONTH
                            - YEAR
                        comment:
                          description: Comment.
                          type: string
                          maxLength: 500
                    customsCommodityCode:
                      description: "\n:::no-translate\n{% note warning \"Вместо него используйте `commodityCodes` с типом `CUSTOMS_COMMODITY_CODE`.\" %}\n:::\n\n\n\_\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\nThe product code in the unified Commodity Nomenclature of Foreign Economic Activity (HS) — 10 or 14 digits without spaces.\n\nBe sure to indicate if there is one.\n"
                      deprecated: true
                      x-deprecation-config:
                        shutdown-date: '2026-10-12'
                        replacement-field: commodityCodes
                      example: '8517610008'
                      type: string
                    commodityCodes:
                      description: |
                        Product codes.
                      type: array
                      nullable: true
                      minItems: 1
                      items:
                        description: Product code.
                        type: object
                        required:
                          - code
                          - type
                        properties:
                          code:
                            description: Product code.
                            type: string
                          type:
                            description: >
                              Type of product code:
  
  
                              * `CUSTOMS_COMMODITY_CODE`
                              — the product code in the unified
                              Commodity Nomenclature of Foreign Economic Activity
                              (HS) — 10 or 14 digits without
                              spaces.
  
                              * `IKPU_CODE` — The
                              identification code of products and services in
                              Uzbekistan is 17 digits without spaces.
  
  
                              Do not send multiple codes of the same type.
                            type: string
                            enum:
                              - CUSTOMS_COMMODITY_CODE
                              - IKPU_CODE
                    certificates:
                      description: >
                        The numbers of the documents for the product: certificate,
                        declaration of conformity, etc.
  
  
                        You can only transfer the document numbers, the scans of
                        which are uploaded in the merchant's office by
                        [Instructions](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html).
                      type: array
                      nullable: true
                      minItems: 1
                      maxItems: 6
                      uniqueItems: true
                      items:
                        type: string
                    boxCount:
                      description: >
                        The number of cargo spaces.
  
  
                        This parameter is used if the product consists of several
                        boxes, packages, and so on. For example, the air
                        conditioner takes up two seats — the
                        external and internal units are in two boxes.
  
  
                        For products that occupy one place, do not pass this
                        parameter.
                      type: integer
                      format: int32
                      minimum: 1
                    condition:
                      description: |
                        The condition of the discounted product.
                      type: object
                      properties:
                        type:
                          description: >
                            Markdown type:
  
  
                            * `PREOWNED` —  used
                            goods that used to belong to another person.
  
                            * `SHOWCASESAMPLE` —
                            showcase sample.
  
                            * `REFURBISHED` —
                            re-sale of the product.
  
                            * `REDUCTION` — the
                            product is defective.
  
                            * `RENOVATED` — the
                            restored product.
  
                            * `NOT_SPECIFIED` — not
                            selected.
  
  
                            `REFURBISHED` — special
                            significance for clothing, shoes, and accessories. It
                            is used only for discounted products from this
                            category. Other values for clothing, shoes, and
                            accessories are not used.
                          type: string
                          enum:
                            - PREOWNED
                            - SHOWCASESAMPLE
                            - REFURBISHED
                            - REDUCTION
                            - RENOVATED
                            - NOT_SPECIFIED
                        quality:
                          description: >
                            Product appearance:
  
  
                            * `PERFECT` — ideal.
  
                            * `EXCELLENT` —
                            excellent.
  
                            * `GOOD` — good.
  
                            * `NOT_SPECIFIED` — not
                            selected.
                          type: string
                          enum:
                            - PERFECT
                            - EXCELLENT
                            - GOOD
                            - NOT_SPECIFIED
                        reason:
                          description: >
                            Product description. Describe the defects in detail,
                            how noticeable they are and where to look for them.
                          type: string
                    type:
                      description: "Special type of product:\n\n* `DEFAULT` — products for which you previously provided a special type and want to remove it.\n* `MEDICINE` — medicines.\n* `BOOK` — paper and electronic books.\n* `AUDIOBOOK` — audiobooks.\n* `ARTIST_TITLE` — music and video production.\n* `ON_DEMAND` — custom-made products.\n* `ALCOHOL` — alcohol.\n\n\n:::no-translate\n{% note info \"Если ваш товар —\_книга\" %}\n:::\n\n\nSpecify the year of publication in the product specifications. [More information about the parameter](../../reference/business-offer-mappings/updateOfferMappings.md#offerparamdto)\n\n\n:::no-translate\n{% endnote %}\n:::\n\n"
                      type: string
                      enum:
                        - DEFAULT
                        - MEDICINE
                        - BOOK
                        - AUDIOBOOK
                        - ARTIST_TITLE
                        - ON_DEMAND
                        - ALCOHOL
                    downloadable:
                      description: >
                        A sign of a digital product. Specify `true`
                        if the product is delivered by e-mail.
  
  
                        [How to work with digital
                        goods](../../step-by-step/digital.md)
                      type: boolean
                    adult:
                      description: >
                        The parameter includes the label 18+ for the product. Set
                        it only for products that are related to satisfying sexual
                        needs.
                      type: boolean
                    age:
                      description: Age in the specified units of measurement.
                      type: object
                      required:
                        - value
                        - ageUnit
                      properties:
                        value:
                          description: |
                            Meaning.
                          type: number
                          minimum: 0
                        ageUnit:
                          description: |
                            Age measurement units:
  
                            * `YEAR` — year.
                            * `MONTH` — month.
                          type: string
                          enum:
                            - YEAR
                            - MONTH
                    params:
                      description: "\n:::no-translate\n{% note warning \"При передаче характеристик используйте `parameterValues`.\" %}\n:::\n\n\n\_\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\nCharacteristics that only products of a specific category have. — for example, the diameter of the bicycle wheels or the material of the shoe sole.\n"
                      type: array
                      nullable: true
                      minItems: 1
                      deprecated: true
                      x-deprecation-config:
                        shutdown-date: '2026-10-12'
                        replacement-field: parameterValues
                      items:
                        description: >+
                          Product parameters.
  
  
                          If the product has several values of the same parameter,
                          send them with the same `name`, but
                          different `value`.
  
  
  
  
                          {% cut "Пример" %}
  
  
  
  
                          ```json translate=no
  
                          "params": [
                            {
                              "name": "Цвет для фильтра",
                              "value": "Зеленый"
                            },
                            {
                              "name": "Цвет для фильтра",
                              "value": "Желтый"
                            }
                          ]
  
                          ```
  
  
  
  
                          {% endcut %}
  
  
                        type: object
                        required:
                          - name
                          - value
                        properties:
                          name:
                            description: "The name of the characteristic.\n\nIt must match the name of the feature on the Market. You can find it from the category's Excel template or through a query. [POST\_v2/category/{categoryId}/parameters](../content/getCategoryContentParameters.md).\n"
                            example: Wi-Fi
                            type: string
                            maxLength: 200
                          value:
                            description: |
                              Meaning.
                            example: есть
                            type: string
                - properties:
                    parameterValues:
                      description: >
                        A list of characteristics with their values.
  
  
  
  
                        {% note warning "Всегда передавайте вместе с
                        `marketCategoryId`" %}
  
  
  
  
                        If you don't pass it `marketCategoryId`
                        when the characteristics change, they will be updated, but
                        a warning will be received in the response (parameter
                        `warnings`).
  
  
                        If you do not pass both of them, information from outdated
                        parameters will be used. `params` and
                        `category`, and
                        `marketCategoryId` it will be detected
                        automatically.
  
  
  
  
                        {% endnote %}
  
  
  
  
                        When **changing** characteristics, transmit only those
                        whose value needs to be updated. If in
                        `marketCategoryId` you are changing the
                        category, the values of the common characteristics for the
                        old and new categories will remain, and you do not need to
                        transfer them.
  
  
                        Read more in ["Transfer of characteristic
                        values"](../../step-by-step/parameter-values.md).
                      type: array
                      nullable: true
                      minItems: 1
                      maxItems: 300
                      items:
                        description: |
                          The value of the characteristic.
                        type: object
                        required:
                          - parameterId
                        properties:
                          parameterId:
                            description: The identifier of the characteristic.
                            type: integer
                            format: int64
                            minimum: 1
                          unitId:
                            description: >-
                              ID of the unit of measurement. If you did not pass
                              the parameter `unitId`, the default
                              unit of measurement is used.
                            type: integer
                            format: int64
                          valueId:
                            description: >
                              ID of the value.
  
  
                              - Be sure to specify the identifier if you are
                              transmitting a value from the list of acceptable
                              values received from the Market.
  
                              - Do not specify for your own values.
  
                              - Only for type characteristics
                              `ENUM`.
                            type: integer
                            format: int64
                          value:
                            description: >
                              Meaning.
  
  
                              For type characteristics `ENUM` send:
  
                              - Together with `valueId`, if you
                              take the value from the directory;
  
                              - without `valueId`, if the value is
                              its own.
                            type: string
                    basicPrice:
                      description: Price with discount indication.
                      type: object
                      allOf:
                        - description: The price of the product.
                          type: object
                          required:
                            - value
                            - currencyId
                          properties:
                            value:
                              description: The price of the product.
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            currencyId:
                              type: string
                              description: >
                                Currency codes:
  
  
                                * `RUR` — the
                                Russian ruble.
  
                                * `UAH` — the
                                Ukrainian hryvnia.
  
                                * `BYR` — the
                                Belarusian ruble.
  
                                * `KZT` —
                                Kazakhstani tenge.
  
                                * `UZS` — Uzbek sum.
                              enum:
                                - RUR
                                - USD
                                - EUR
                                - UAH
                                - AUD
                                - GBP
                                - BYR
                                - BYN
                                - DKK
                                - ISK
                                - KZT
                                - CAD
                                - CNY
                                - NOK
                                - XDR
                                - SGD
                                - TRY
                                - SEK
                                - CHF
                                - JPY
                                - AZN
                                - ALL
                                - DZD
                                - AOA
                                - ARS
                                - AMD
                                - AFN
                                - BHD
                                - BGN
                                - BOB
                                - BWP
                                - BND
                                - BRL
                                - BIF
                                - HUF
                                - VEF
                                - KPW
                                - VND
                                - GMD
                                - GHS
                                - GNF
                                - HKD
                                - GEL
                                - AED
                                - EGP
                                - ZMK
                                - ILS
                                - INR
                                - IDR
                                - JOD
                                - IQD
                                - IRR
                                - YER
                                - QAR
                                - KES
                                - KGS
                                - COP
                                - CDF
                                - CRC
                                - KWD
                                - CUP
                                - LAK
                                - LVL
                                - SLL
                                - LBP
                                - LYD
                                - SZL
                                - LTL
                                - MUR
                                - MRO
                                - MKD
                                - MWK
                                - MGA
                                - MYR
                                - MAD
                                - MXN
                                - MZN
                                - MDL
                                - MNT
                                - NPR
                                - NGN
                                - NIO
                                - NZD
                                - OMR
                                - PKR
                                - PYG
                                - PEN
                                - PLN
                                - KHR
                                - SAR
                                - RON
                                - SCR
                                - SYP
                                - SKK
                                - SOS
                                - SDG
                                - SRD
                                - TJS
                                - THB
                                - TWD
                                - BDT
                                - TZS
                                - TND
                                - TMM
                                - UGX
                                - UZS
                                - UYU
                                - PHP
                                - DJF
                                - XAF
                                - XOF
                                - HRK
                                - CZK
                                - CLP
                                - LKR
                                - EEK
                                - ETB
                                - RSD
                                - ZAR
                                - KRW
                                - NAD
                                - TL
                                - UE
                        - properties:
                            discountBase:
                              description: >
                                The crossed-out price.
  
  
                                The number must be an integer. You can specify a
                                price with a discount from 5 to 99%.
  
  
                                Pass this parameter every time the price is
                                updated if you provide a discount on the product.
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                    purchasePrice:
                      description: The price of the product.
                      type: object
                      required:
                        - value
                        - currencyId
                      properties:
                        value:
                          description: The price of the product.
                          type: number
                          minimum: 0
                          exclusiveMinimum: true
                        currencyId:
                          type: string
                          description: >
                            Currency codes:
  
  
                            * `RUR` — the Russian
                            ruble.
  
                            * `UAH` — the Ukrainian
                            hryvnia.
  
                            * `BYR` — the Belarusian
                            ruble.
  
                            * `KZT` — Kazakhstani
                            tenge.
  
                            * `UZS` — Uzbek sum.
                          enum:
                            - RUR
                            - USD
                            - EUR
                            - UAH
                            - AUD
                            - GBP
                            - BYR
                            - BYN
                            - DKK
                            - ISK
                            - KZT
                            - CAD
                            - CNY
                            - NOK
                            - XDR
                            - SGD
                            - TRY
                            - SEK
                            - CHF
                            - JPY
                            - AZN
                            - ALL
                            - DZD
                            - AOA
                            - ARS
                            - AMD
                            - AFN
                            - BHD
                            - BGN
                            - BOB
                            - BWP
                            - BND
                            - BRL
                            - BIF
                            - HUF
                            - VEF
                            - KPW
                            - VND
                            - GMD
                            - GHS
                            - GNF
                            - HKD
                            - GEL
                            - AED
                            - EGP
                            - ZMK
                            - ILS
                            - INR
                            - IDR
                            - JOD
                            - IQD
                            - IRR
                            - YER
                            - QAR
                            - KES
                            - KGS
                            - COP
                            - CDF
                            - CRC
                            - KWD
                            - CUP
                            - LAK
                            - LVL
                            - SLL
                            - LBP
                            - LYD
                            - SZL
                            - LTL
                            - MUR
                            - MRO
                            - MKD
                            - MWK
                            - MGA
                            - MYR
                            - MAD
                            - MXN
                            - MZN
                            - MDL
                            - MNT
                            - NPR
                            - NGN
                            - NIO
                            - NZD
                            - OMR
                            - PKR
                            - PYG
                            - PEN
                            - PLN
                            - KHR
                            - SAR
                            - RON
                            - SCR
                            - SYP
                            - SKK
                            - SOS
                            - SDG
                            - SRD
                            - TJS
                            - THB
                            - TWD
                            - BDT
                            - TZS
                            - TND
                            - TMM
                            - UGX
                            - UZS
                            - UYU
                            - PHP
                            - DJF
                            - XAF
                            - XOF
                            - HRK
                            - CZK
                            - CLP
                            - LKR
                            - EEK
                            - ETB
                            - RSD
                            - ZAR
                            - KRW
                            - NAD
                            - TL
                            - UE
                    additionalExpenses:
                      description: The price of the product.
                      type: object
                      required:
                        - value
                        - currencyId
                      properties:
                        value:
                          description: The price of the product.
                          type: number
                          minimum: 0
                          exclusiveMinimum: true
                        currencyId:
                          type: string
                          description: >
                            Currency codes:
  
  
                            * `RUR` — the Russian
                            ruble.
  
                            * `UAH` — the Ukrainian
                            hryvnia.
  
                            * `BYR` — the Belarusian
                            ruble.
  
                            * `KZT` — Kazakhstani
                            tenge.
  
                            * `UZS` — Uzbek sum.
                          enum:
                            - RUR
                            - USD
                            - EUR
                            - UAH
                            - AUD
                            - GBP
                            - BYR
                            - BYN
                            - DKK
                            - ISK
                            - KZT
                            - CAD
                            - CNY
                            - NOK
                            - XDR
                            - SGD
                            - TRY
                            - SEK
                            - CHF
                            - JPY
                            - AZN
                            - ALL
                            - DZD
                            - AOA
                            - ARS
                            - AMD
                            - AFN
                            - BHD
                            - BGN
                            - BOB
                            - BWP
                            - BND
                            - BRL
                            - BIF
                            - HUF
                            - VEF
                            - KPW
                            - VND
                            - GMD
                            - GHS
                            - GNF
                            - HKD
                            - GEL
                            - AED
                            - EGP
                            - ZMK
                            - ILS
                            - INR
                            - IDR
                            - JOD
                            - IQD
                            - IRR
                            - YER
                            - QAR
                            - KES
                            - KGS
                            - COP
                            - CDF
                            - CRC
                            - KWD
                            - CUP
                            - LAK
                            - LVL
                            - SLL
                            - LBP
                            - LYD
                            - SZL
                            - LTL
                            - MUR
                            - MRO
                            - MKD
                            - MWK
                            - MGA
                            - MYR
                            - MAD
                            - MXN
                            - MZN
                            - MDL
                            - MNT
                            - NPR
                            - NGN
                            - NIO
                            - NZD
                            - OMR
                            - PKR
                            - PYG
                            - PEN
                            - PLN
                            - KHR
                            - SAR
                            - RON
                            - SCR
                            - SYP
                            - SKK
                            - SOS
                            - SDG
                            - SRD
                            - TJS
                            - THB
                            - TWD
                            - BDT
                            - TZS
                            - TND
                            - TMM
                            - UGX
                            - UZS
                            - UYU
                            - PHP
                            - DJF
                            - XAF
                            - XOF
                            - HRK
                            - CZK
                            - CLP
                            - LKR
                            - EEK
                            - ETB
                            - RSD
                            - ZAR
                            - KRW
                            - NAD
                            - TL
                            - UE
                    firstVideoAsCover:
                      deprecated: true
                      x-deprecation-config:
                        shutdown-date: '2026-10-12'
                      description: >
                        Use the first video in the card as a video background.
  
  
                        Pass it on `true` for the first video to be
                        used as a video background, or `false` so
                        that the video background is not displayed in the product
                        profile.
                      type: boolean
                    deleteParameters:
                      description: "The parameters that you previously passed to `UpdateOfferDTO`, and now you want to delete it.\n\nIf you pass `adult`, `downloadable` and `firstVideoAsCover` They will not be deleted —\_their value will change to `false`.\n\nYou can pass multiple values at once.\n\nDo not use together with the corresponding parameter in `UpdateOfferDTO`. This will result in an error. `400`.\n"
                      type: array
                      nullable: true
                      minItems: 1
                      uniqueItems: true
                      items:
                        description: >
                          The values of the parameters you want to delete and the
                          corresponding parameters in
                          `UpdateOfferDTO` in which you passed
                          these values earlier:
  
  
                          * `ADDITIONAL_EXPENSES` —
                          additional product costs (parameter
                          `additionalExpenses`).
  
                          * `ADULT` — mark 18+
                          (parameter `adult`)
  
                          * `AGE` — age limit for
                          children (parameter `age`).
  
                          * `BARCODES` — barcode
                          (parameter `barcodes`).
  
                          * `BOX_COUNT` — number of
                          cargo spaces (parameter `boxCount`).
  
                          * `CERTIFICATES` — product
                          document numbers (parameter
                          `certificates`).
  
                          * `COMMODITY_CODES` —
                          product codes (parameter
                          `commodityCodes`).
  
                          * `CONDITION` — the
                          condition of the discounted product (parameter
                          `condition`).
  
                          * `CUSTOMS_COMMODITY_CODE`
                          — the product code in the HS code
                          (parameter `customsCommodityCode`).
  
                          * `DESCRIPTION` — Product
                          description (parameter `description`).
  
                          * `DOWNLOADABLE` — digital
                          product attribute (parameter
                          `downloadable`).
  
                          * `GUARANTEE_PERIOD` —
                          Warranty period (parameter
                          `guaranteePeriod`).
  
                          * `LIFE_TIME` — Service
                          life (parameter `lifeTime`).
  
                          * `MANUALS` — list of
                          instructions for using the product (parameter
                          `manuals`).
  
                          * `MANUFACTURER_COUNTRIES`
                          — country of manufacture (parameter
                          `manufacturerCountries`).
  
                          * `PARAMETERS` — product
                          characteristics (parameters `params`,
                          `parameterValues`).
  
                          * `PICTURES` — links to
                          product images (parameter `pictures`).
  
                          * `PURCHASE_PRICE` — cost
                          price (parameter `purchasePrice`).
  
                          * `SHELF_LIFE` —
                          expiration date (parameter `shelfLife`).
  
                          * `TAGS` — product labels
                          that the store uses (parameter `tags`).
  
                          * `TYPE` — a special type
                          of product (parameter `type`).
  
                          * `VENDOR_CODE` — the name
                          of the brand or manufacturer (parameter
                          `vendorCode`).
  
                          * `VIDEOS` — links to the
                          product video (parameter `videos`).
                        type: string
                        enum:
                          - ADDITIONAL_EXPENSES
                          - ADULT
                          - AGE
                          - BARCODES
                          - BOX_COUNT
                          - CERTIFICATES
                          - COMMODITY_CODES
                          - CONDITION
                          - CUSTOMS_COMMODITY_CODE
                          - DESCRIPTION
                          - DOWNLOADABLE
                          - GUARANTEE_PERIOD
                          - LIFE_TIME
                          - MANUALS
                          - MANUFACTURER_COUNTRIES
                          - PARAMETERS
                          - PICTURES
                          - PURCHASE_PRICE
                          - SHELF_LIFE
                          - TAGS
                          - TYPE
                          - VENDOR_CODE
                          - VIDEOS
            mapping:
              description: >
                A card on the Market that, from your point of view, fits the
                product. To determine the ID of the appropriate card, use the
                search in the cabinet (**Products** → **Catalog** → **Upload
                products**).
  
  
                Based on the verification results, the Market can link the product
                to a more suitable card.
              type: object
              properties:
                marketSku:
                  description: The ID of the product card on the Market.
                  type: integer
                  format: int64
                  minimum: 1
      onlyPartnerMediaContent:
        description: >
          Whether only the product data you provided will be used.
  
  
          Default value: `false`. To delete the data that the
          Market added, pass the value `true`.
        type: boolean
  bodyType: application/json
  method: post
  security:
    - type: apiKey
      name: 'Api-Key'
      in: header
    - type: oauth2
      x-inline: true
      flows:
        implicit:
          authorizationUrl: https://oauth.yandex.ru/authorize
          scopes:
            market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
  path: v2/businesses/{businessId}/offer-mappings/update
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.
<!-- endsource: en/api/business-offer-mappings/updateOfferMappings.md -->

[*gtin]:
<b>What is GTIN?</b><br>GTIN — This is a unique number assigned to a product in a single international database. [GS1](https://ru.wikipedia.org/wiki/GS1). This number generates an EAN, UPC, or ISBN barcode.<br><br><b>How to make sure that the product is in the database</b><br>You can check the code on [verification page](https://gepir.gs1.org/index.php/search-by-gtin) on the GS1 association's website. If the product is not found, request the GTIN code from your supplier.<br><br><b>How to get a GTIN for your products</b><br>To receive GTIN codes, the manufacturer needs to join the GS1 association and register the products.

[*ascii-code]:
ASCII characters 0 through 31 (except 9) and 127 are prohibited. [from the table](https://www.ascii-code.com/compact).

[*list-categories]:
Categories that have no children.