--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/content-change.md - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/content-change.md - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/content-change.md - href: en/step-by-step/content-change.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt # Changing categorical characteristics You can use the API to manage the content on product cards. — This includes transmitting characteristics specific to a specific product category. ## The products belong to a new category for the store {#edit-card} ```mermaid %%{ init: { 'theme': 'base', 'themeVariables': { 'primaryColor': '#FDF3E8', 'primaryTextColor': '#000000', 'primaryBorderColor': '#BA9C80', 'lineColor': '#BA9C80', 'secondaryColor': '#94E1C4', 'tertiaryColor': '#F84E57', 'noteBkgColor': '#FED58D' } } }%% sequenceDiagram participant Merchant as Your store participant Market as Yandex Market rect rgb(251, 243, 232) note right of Merchant: Getting card statuses and previously submitted product information Merchant ->>+ Market: POST v2/businesses/{businessId}/offer-cards Market ->> Market: Compiles
a list of products. Market -->>- Merchant: OK: list of products with card statuses and filling recommendations. end rect rgb(251, 243, 232) note right of Merchant: Getting product attributes required for their category Merchant ->> Market: Category identifier on the Market to which the product belongs
POST v2/category/{categoryId}/parameters Market -->>+ Merchant: OK: list of attributes for products in this category. Merchant ->>- Merchant: Matches their product attributes
with the Market's attributes. end rect rgb(251, 243, 232) note right of Merchant: Filling out cards Merchant ->>+ Market: Attribute values for each product
POST v2/businesses/{businessId}/offer-cards/update Market ->> Market: Analyzes the received content
and, if it's correct,
adds it to the cards. Market -->>- Merchant: OK end rect rgb(251, 243, 232) note right of Merchant: Checking results Merchant ->>+ Market: POST v2/businesses/{businessId}/offer-cards Market ->> Market: Checks the product list. Market -->>- Merchant: OK: list of products with statuses and filling recommendations. end ``` 1. Get the information that you previously provided for product cards, as well as card statuses and recommendations for filling them out using [POST v2/businesses/{businessId}/offer-cards](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getOfferCardsContentStatus.md). In response, you will receive the following: * Which categories the products belong to on the Market. The Market determines the product category automatically based on the data provided by you. * What is the status of the product cards? * Transmitted product characteristics. * Recommendations for filling out the cards. [How to use the recommendations](#recommendations) 2. For each [leaf category](*list-category) request a list of required characteristics using [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getCategoryContentParameters.md). For characteristics that have units of measurement, in the parameter `unit` They will return: * acceptable values (`units`); * default value (`defaultUnitId`). 3. Compare the characteristics expected by Yandex.Market with the characteristics available in the store's database. **Example.** For soup plates, the Market expects, among others, the "Color for filter" characteristic. In the store's database, the same characteristic is called "Color". You need to set up the integration so that: * the value of the "Color" characteristic was transmitted to the Market as the "Color for filter" characteristic; * Each value of the "Color" characteristic was assigned an acceptable value of the "Color for filter" characteristic. 4. Transmit the product characteristics using [POST v2/businesses/{businessId}/offer-cards/update](https://yandex.com/dev/market/partner-api/doc/en/reference/content/updateOfferContent.md). {% note warning "Always convey the full set of characteristics." %} Passing empty values will erase what was entered on the cards earlier. {% endnote %} If necessary, change the identifier of the unit of measurement of characteristics. — parameter `unitId` in `parameterValues`. If it is not passed, the default units of measurement will be used (`defaultUnitId`). Before forming `parameterValues`, check out the ["Transfer of characteristic values"](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/parameter-values.md) — it describes typical cases, limitations, and examples. ## The products belong to a well-known and customized category {#known-category} Follow the instructions for the new category, but skip the step of configuring the comparison of Market and store characteristics. ## How to check and update the comparison of characteristics on the Market and in the store {#check-and-update-comparison} The lists of characteristics required for products of various categories do not remain unchanged. Gadgets have additional functions, new materials are becoming fashionable. Sometimes the Market simply makes a more detailed list of characteristics on the product card. — to make it easier for customers to compare and choose. For each of the configured categories, check regularly whether the mapping needs to be updated. ```mermaid %%{ init: { 'theme': 'base', 'themeVariables': { 'primaryColor': '#FDF3E8', 'primaryTextColor': '#000000', 'primaryBorderColor': '#BA9C80', 'lineColor': '#BA9C80', 'secondaryColor': '#94E1C4', 'tertiaryColor': '#F84E57', 'noteBkgColor': '#FED58D' } } }%% sequenceDiagram participant Merchant as Your store participant Market as Yandex Market rect rgb(251, 243, 232) note right of Merchant: Category settings check Merchant ->> Market: Category ID on Market that was configured long ago
POST v2/category/{categoryId}/parameters Market -->>+ Merchant: OK: list of characteristics for products in this category. Merchant ->>- Merchant: Checks the mapping of product characteristics
with characteristics on Market. end ``` {% note tip "Also read the instructions" %} * [Adding and editing products](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/assortment-add-goods.md) * [Yandex.Market recommendations for cards](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/recommendations.md) * [Managing goods in the archive](https://yandex.com/dev/market/partner-api/doc/en/step-by-step/assortment-archive.md) {% endnote %} [*list-category]: A category that has no children.