Adding and editing products

Using a request POST v2/businesses/{businessId}/offer-mappings/update you can add products to the catalog and transfer:

• their leaf categories on the Market and categorical characteristics;
• main features;
• prices of goods in the cabinet.

You can also combine products on the card, edit and delete information about already added products, including prices in the cabinet and product categories.

To find out the source and time of the information update:

1. In the seller's account on the Market, go to the page Products → Catalog.

2. Click on the product you are interested in.

3. In the upper-right corner, click and enable the option Data source.

   Information about the data transfer will appear under the corresponding characteristics.

Add new products to the catalog

To add products to the catalog and place them in the store, you need to make several consecutive requests to the Market:

1. Get a list of Market categories by making a request POST v2/categories/tree.

2. For each leaf category request a list of required characteristics using POST v2/category/{categoryId}/parameters.

   For characteristics that have units of measurement, in the parameter unit They will return:

   • acceptable values (units);
   • default value (defaultUnitId).

3. Call the method POST v2/businesses/{businessId}/offer-mappings/update, where:

   • Provide information about the products (names, descriptions, photos, etc.), prices, leaf categories on the Market and characteristics.
   • 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).

   For sellers of the Yandex Go Market: also read instructions.

4. For products that do not have manufacturer's barcodes, generate the Market barcodes. — method POST v1/businesses/{businessId}/offer-mappings/barcodes/generate.

5. If necessary, look at the cost of the Market services for specific products. To do this, pass their parameters in the request. POST v2/tariffs/calculate.

6. Get a list of models from Yandex. Market for which you can sell each of the added products using a query. POST v2/businesses/{businessId}/offer-mappings. What is a work model and what models are there?

7. Set the conditions for product placement using a query POST v2/campaigns/{campaignId}/offers/update. Terms of placement — this is the minimum order quantity, sales quantum and VAT. If you work according to the model DBS, the same request sets the delivery parameters.

8. Make sure that the products have appeared in the showcase by using a request POST v2/campaigns/{campaignId}/offers. You will find detailed explanations of the product statuses. in the Help of the Market for sellers.

Change product categories

1. Get a list of Market categories using a request POST v2/categories/tree.

2. To change the categories of products that you have already added to the catalog, in the request POST v2/businesses/{businessId}/offer-mappings/update send:

   • Their IDs — offerId.
   • IDs of new leaf categories — marketCategoryId.
   • Product characteristics and their meanings for new categories — parameterValues. The values of the common characteristics for the old and new categories will remain, and you do not need to transfer them.

Change product characteristics

To change the characteristics of products that you have already added to the catalog, in the request POST v2/businesses/{businessId}/offer-mappings/update retransmit:

• Their IDs — offerId.
• IDs of leaf categories — marketCategoryId. If you don't send it, you will receive a warning in the response (parameter warnings).
• New characteristics and their meanings — parameterValues. If you don't pass it parameterValues and marketCategoryId, information from outdated parameters will be used params and category, and marketCategoryId it will be detected automatically.

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).

You don't need to pass parameters where nothing changes.

Product characteristics by category can be obtained using a request. POST v2/category/{categoryId}/parameters.

You can also change the categorical characteristics using Instructions.

Delete product characteristics

To delete previously transmitted product characteristics, use a request POST v2/businesses/{businessId}/offer-mappings/update — 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.

Combine products on a card

To combine product options on one card:

1. Make a request POST v2/category/{categoryId}/parameters. The characteristics that are the features of the product variant may depend on the cabinet. To find them out, pass the parameter businessId.

   If the category supports combining options:

   • Among the characteristics will be the following:

     Parameter	Meaning
     id	200
     name	Name of the group of options

   • The characteristics will be returned with the value true in the field distinctive.

2. Add each option to the catalog individually.

3. Give them categorical characteristics. — parameter parameterValues in the method POST v2/businesses/{businessId}/offer-mappings/update or POST v2/businesses/{businessId}/offer-cards/update.

   Follow the following rules:

   • The name of the group of options should be the same for all products that need to be displayed as options on a single card.

   • The name of a group of variants can be a sequence of any characters up to 255 characters long.

   • Each option should be different from all the others in distinctive- characteristics.

   • All other characteristics must have the same values.

     Example. There are three characteristics in a certain category — features of the options (distinctive: true): the color for the filter, size and availability of Wi-Fi. And more features material and series, which are not features of the variants.

     ✅ Right

     ❌ Wrong

     	The color for the filter	Size	There is Wi-Fi	Material	Series
     Option 1	Red	XL	Yes	Tree	"Jupiter"
     Option 2	Red	XL	—	Tree	"Jupiter"
     Option 3	Green	S	Yes	Tree	"Jupiter"

     Each option has its own set distinctive- characteristics, and the rest match.

     	The color for the filter	Size	There is Wi-Fi	Material	Series
     Option 1	Red	XL	Yes	Tree	"Jupiter"
     Option 2	Red	XL	Yes	Tree	"Jupiter"
     Option 3	Green	S	Yes	Tree	"Jupiter"

     Option 1 and option 2 have the same features.

     ---

     	The color for the filter	Size	There is Wi-Fi	Material	Series
     Option 1	Red	XL	Yes	Tree	"Jupiter"
     Option 2	Red	XL	—	Tree	"Jupiter"
     Option 3	Green	S	Yes	Steel	"Mars"

     Option 3 has different characteristics that are not specific to the option.

Products that are grouped together will have the same identifier. groupId.

For more information on how to work with product options, see Yandex.Market Help for sellers.