Information about the products in the catalog

marketSku

Type: integer

The ID of the product card on the Market.

Min value: 1

marketCategoryId

Type: integer

The ID of the category on the Market that the product is in.

It may be missing from the response if the Market has not yet determined the product category.

marketCategoryName

Type: string

The name of the card's category on the Market.

It may be missing from the response if the Market has not yet determined the product category.

Example: example

marketModelName

Type: string

The name of the model on the Market.

It may not be included in the response if the product is not linked to the card yet.

Example: example

marketSkuName

Type: string

The name of the product card.

It may not be included in the response if the product is not linked to the card yet.

Example: example

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 document numbers, the scans of which are uploaded in the merchant's office by Instructions.

Min items: 1

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

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

[
  {
    "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

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

• There can be up to 30 links.
• Specify the entire link, including the http or https protocol.
• Maximum length — 512 characters.
• 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

[
  "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.
• Maximum length — 512 characters.
• 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

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

Type: object

Price indicating the time of the last update.

{
  "value": 0,
  "currencyId": "RUR",
  "updatedAt": "2025-01-01T00:00:00Z"
}

archived

Type: boolean

The product has been archived.

basicPrice

Type: object

The price includes the currency, discount, and the time of the last update.

{
  "value": 0,
  "currencyId": "RUR",
  "discountBase": 0,
  "updatedAt": "2025-01-01T00:00:00Z"
}

campaigns

The list of stores where the product is placed.

Min items: 1

[
  {
    "campaignId": 1,
    "status": "PUBLISHED"
  }
]

cardStatus

Type: string

Product card status:

• HAS_CARD_CAN_NOT_UPDATE — The Market card.
• HAS_CARD_CAN_UPDATE — You can add it.
• HAS_CARD_CAN_UPDATE_ERRORS — The changes have not been accepted.
• HAS_CARD_CAN_UPDATE_PROCESSING — Changes are under review.
• NO_CARD_NEED_CONTENT — Create a card.
• NO_CARD_MARKET_WILL_CREATE — Creates a Marketplace.
• NO_CARD_ERRORS — It was not created due to an error.
• NO_CARD_PROCESSING — We check the data.
• NO_CARD_ADD_TO_CAMPAIGN — Place the product in the store.

Enum: HAS_CARD_CAN_NOT_UPDATE, HAS_CARD_CAN_UPDATE, HAS_CARD_CAN_UPDATE_ERRORS, HAS_CARD_CAN_UPDATE_PROCESSING, NO_CARD_NEED_CONTENT, NO_CARD_MARKET_WILL_CREATE, NO_CARD_ERRORS, NO_CARD_PROCESSING, NO_CARD_ADD_TO_CAMPAIGN

groupId

Type: string

The identifier of the product group.

Products that are grouped together will have the same identifier.

How to combine products on a card

Example: example

mediaFiles

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

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

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

Information about the product's media files.

{
  "firstVideoAsCover": true,
  "videos": [
    {
      "url": "example",
      "title": "example",
      "uploadState": "UPLOADING"
    }
  ],
  "pictures": [
    {
      "url": "example",
      "title": "example",
      "uploadState": "UPLOADING"
    }
  ],
  "manuals": [
    {
      "url": "example",
      "title": "example",
      "uploadState": "UPLOADING"
    }
  ]
}

purchasePrice

Type: object

Price indicating the time of the last update.

{
  "value": 0,
  "currencyId": "RUR",
  "updatedAt": "2025-01-01T00:00:00Z"
}

sellingPrograms

Information about which placement models are available for the product.

Min items: 1

[
  {
    "sellingProgram": "FBY",
    "status": "FINE"
  }
]