Adding products to the catalog and changing information about them

offerId

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.

What is SKU and how to assign it

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

adult

Type: boolean

The parameter includes the label 18+ for the product. Set it only for products that are related to satisfying sexual needs.

age

Age in the specified units of measurement.

{
  "value": 0,
  "ageUnit": "YEAR"
}

barcodes

Type: string[] | 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 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

Min items: 1

Unique items: true

[
  "46012300000000"
]

boxCount

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: 1

category

Type: string

The product category in your store.

Example: example

certificates

Type: string[] | null

The numbers of the documents for the product: certificate, declaration of conformity, etc.

You can only transfer the numbers of the documents, the scans of which are uploaded in the merchant's office by Instructions.

Min items: 1

Max items: 6

Unique items: true

[
  "example"
]

commodityCodes

Product codes.

Min items: 1

[
  {
    "code": "example",
    "type": "CUSTOMS_COMMODITY_CODE"
  }
]

condition

The condition of the discounted product.

{
  "type": "PREOWNED",
  "quality": "PERFECT",
  "reason": "example"
}

customsCommodityCode

Type: string

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: 8517610008

description

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

Max length: 6000

Example: example

downloadable

Type: boolean

A sign of a digital product. Specify true if the product is delivered by e-mail.

How to work with digital goods

guaranteePeriod

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.

{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

lifeTime

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.

{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

manuals

A list of instructions on how to use the product.

Min items: 1

Max items: 6

[
  {
    "url": "example",
    "title": "example"
  }
]

manufacturerCountries

Type: string[] | null

The country where the product was produced.

Write down the names of the countries as they are written in the list.

Min items: 1

Unique items: true

[
  "Россия"
]

marketCategoryId

Type: integer

The ID of the category on the Market to which you attribute your product.

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.

Min value: 0

Exclusive min: true

name

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

Max length: 256

Example: Ударная дрель Makita HP1630, 710 Вт

params

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: 1

[
  {
    "name": "Wi-Fi",
    "value": "есть"
  }
]

pictures

Type: string[] | 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

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

Min items: 1

Max items: 30

[
  "example"
]

shelfLife

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.

{
  "timePeriod": 0,
  "timeUnit": "HOUR",
  "comment": "example"
}

tags

Type: string[] | 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: 1

Max items: 50

Unique items: true

[
  "до 500 рублей"
]

type

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.

Enum: DEFAULT, MEDICINE, BOOK, AUDIOBOOK, ARTIST_TITLE, ON_DEMAND, ALCOHOL

vendor

Type: string

The name of the brand or manufacturer. It should be written the way the brand itself writes it.

Example: LEVENHUK

vendorCode

Type: string

The article of the product from the manufacturer.

Example: VNDR-0005A

videos

Type: string[] | 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

Min items: 1

Max items: 6

[
  "example"
]

weightDimensions

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.

{
  "length": 65.55,
  "width": 50.7,
  "height": 20,
  "weight": 1.001
}

additionalExpenses

The price of the product.

{
  "value": 0,
  "currencyId": "RUR"
}

basicPrice

Type: object

Price with discount indication.

{
  "value": 0,
  "currencyId": "RUR",
  "discountBase": 0
}

deleteParameters

Type: string[] | null

The parameters that you previously passed to UpdateOfferDTO, and now you want to delete it.

If you send 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: 1

Unique items: true

[
  "ADDITIONAL_EXPENSES"
]

firstVideoAsCover

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.

parameterValues

A list of characteristics with their values.

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

Min items: 1

Max items: 300

[
  {
    "parameterId": 1,
    "unitId": 0,
    "valueId": 0,
    "value": "example"
  }
]

purchasePrice

The price of the product.

{
  "value": 0,
  "currencyId": "RUR"
}