Product Management (products)

Returns the list of all products parent categories

Returns the list of all available subjects, subjects parent categories and their IDs

Returns list of the subject characteristics by its ID

Provides values of color characteristic.

Provides values of gender characteristic.

Provides value of characteristic country of origin.

Provide values of season characteristic

Method provides list of HS codes by category name and filter by HS code.

Returns a list of values for the VAT rate characteristic

The method allows to get separately free and paid vendor limits for creating product cards.
To calculate the number of cards that can be created, use the formula: (freeLimits + paidLimits) - Number of cards created.
All cards that can be obtained using the Nomenclature list and List of nomenclatures that are in the trash methods are considered created.

Creates products card. You can specify product description and characteristics in product card.
How to create a card:

1. Get parent categories list
2. Get the category and get all subcategories
3. Choose the subcategory and get all available characteristics. For Color, Gender, Country of origin, Season, VAT rate, HS code characteristics use values from category.
4. Send the request. If the response is Success (200) but the card was not created, check errors using list of failed nomenclature with errors.

The dimensions of the goods can only be specified in centimeters.
With one request you can create maximum 100 cards (imtID) and 30 nomenclatures (nmID) in each card. Maximum request size is 10 Mb.
Creating a card is asynchronous, after sending the request is put in a queue for processing.

Edits products cards. If you need some product data, get it using nomenclatures list.

The dimensions of the goods can only be specified in centimeters.

You can not edit or delete barcodes but you can add new ones. You have not to send photos, video and tags and can not edit them.

If this method response is Success (200) but product card was not updated, check errors using list of failed nomenclature with errors.

With one request you can edit maximum 3000 nomenclatures (nmID). Maximum request size is 10 Mb

Adds new nomenclature to the product card. The dimensions of the goods can only be specified in centimeters. Adding nomenclature is asynchronous, after sending the request is put in a queue for processing. If the adding request passed but the nomenclature was not created, check errors using list of failed nomenclature with errors. Maximum request size is 10 Mb

Merges nomenclatures (nmID) in same product card (imtID) or separate them.
To merge nomenclatures, the request with a list of nomenclatures has to be sent with the targetIMT parameter specified in the body of the request. In this case, all nomenclatures will be merged under the imtID specified in the targetIMT.
To separate the nomenclature from the product card, it is necessary to pass this nomenclature without the targetIMT parameter in the request body.
This creates a new imtID for the transferred nomenclature.
If several nomenclatures are passed in the separating request, they will all be automatically merged under one new imtID.
To assign a unique imtID to each nomenclature, it is necessary to send one nomenclature per query. Maximum request size is 10 Mb

Generates array of unique barcodes to create size of nomenclature in product card

Adds one media file for the product (nomenclature).

Requirements to images:

• maximum images for each product (nomenclature) — 30,
• minimal resolution – 700 × 900 pixels,
• maximum size — 32 МB,
• minimal quality — 65%,
• formats — JPG, PNG, BMP, GIF (static), WebP.

Requirements video:

• maximum video for each product (nomenclature)
• maximum size — 50 MB
• formats — MOV, MP4

Edits product (nomenclature) media files.

• maximum images for each product (nomenclature) — 30,
• minimal resolution – 700 × 900 pixels,
• maximum size — 32 MB,
• minimal quality — 65%,
• formats — JPG, PNG, BMP, GIF (static), WebP.

Requirements video:

• maximum video for each product (nomenclature),
• maximum size — 50 MB,
• formats — MOV, MP4.

If one or several images do not meet the requirements, no images will be uploaded even if you have the success response (200)

Returns the list of created nomenclatures.

To get more than 100 nomenclatures, you need to use pagination:

1. Make first request (all listed params are required):

           {
             "settings": {                      
               "cursor": {
                 "limit": 100
               },
               "filter": {
                 "withPhoto": -1
               }
             }
           }

2. From last part of response list, copy 2 strings from `cursor` field response:
   • "updatedAt": "***"
   • "nmID": ***
3. Paste the copied strings to the request cursor, repeat the request.
4. Repeat 2 and 3, until total will be less than limit in response. This will mean you got all cards.

Returns the list of nomenclatures and the list of errors encountered during product card creation

Transfers the nomenclature to trash. In doing so, the product card would not be deleted.

Returns the nomenclature from trash

Returns list of nomenclatures in trash.

To get full list of nomenclatures, if their number exceed 100, user need to use pagination.

1. Make the first request:
   

           {
             "settings": {                      
               "cursor": {
                 "limit": 100
               }
             }
           }

2. From last part of response list copy 2 strings from cursor field response:
   • "trashedAt": "***"
   • "nmID": ***
3. Paste copied strings in cursor request parameter, repeat the method request.
4. Repeat 2 and 3, until total will be less than limit in response. This will mean you got all cards.

Returns seller's tags list

Creates a tag. It is possible to create 15 tags. The maximum length of a tag is 15 characters

Changes tag data: name and color

Deletes the tag

The method allows to add tags to the product card and remove tags from the product card.
When removing a tag from a product card, the tag itself is not removed.
It is possible to add 15 tags to a product card.

Sets prices and discounts

Sets different prices for different sizes.

Only for products from categories where size price setting is available. For these products editableSizePrice: true in Get product sizes response.

Sets WB Club subscription discounts

Returns the processed upload data

Returns products in processed upload including product errors