Adding and editing products

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

• their 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 categories/tree.

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

3. Send information about products (names, descriptions, photos, and so on), prices, categories on the Market, and characteristics using a request POST businesses/{businessId}/offer-mappings/update.

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

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

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

6. Set the conditions for product placement using a query POST campaigns/{campaignId}/offers/update. The terms of the placement are the minimum order quantity, sales quota and VAT. If you use the DBS model, the same query sets the delivery parameters.

7. Make sure that the products have appeared in the showcase by using a request POST 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 categories/tree.

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

   • Their IDs — offerId.
   • IDs of new 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 businesses/{businessId}/offer-mappings/update retransmit:

• Their IDs — offerId.
• Category IDs — 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.

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

Product characteristics by category can be obtained using a request. POST 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 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 category/{categoryId}/parameters. The characteristics that are 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. Pass the categorical characteristics for them as a parameter. parameterValues in the method POST businesses/{businessId}/offer-mappings/update or POST 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. In some category, there are three characteristics — the 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.

For more information on how to work with product options, see Help.