目录中有关产品的信息

marketSku

Type: integer

市场上的产品卡的ID。

Min value: 1

marketCategoryId

Type: integer

品所属的市场上的类别的ID。

如果市场尚未确定产品类别，则可能会在响应中缺失。

marketCategoryName

Type: string

卡在市场上的类别的名称。

如果市场尚未确定产品类别，则可能会在响应中缺失。

Example: example

marketModelName

Type: string

市场上模型的名称。

如果产品尚未链接到卡，则可能不会包含在响应中。

Example: example

marketSkuName

Type: string

产品卡的名称。

如果产品尚未链接到卡，则可能不会包含在响应中。

Example: example

offerId

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

• 对于每个产品 SKU 一定有一个。

• 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Example: example

adult

Type: boolean

该参数包括产品的18+标签。 仅将其设置为与满足性需求相关的产品。

age

年龄在指定的测量单位。

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

barcodes

Type: string[] | null

条形码。

将其指定为数字序列。 密码可以 EAN-13, EAN-8, UPC-A, UPC-E 或 Code 128. 对于书籍 — ISBN.

对于产品 某些类别和品牌 条形码必须是有效的代码。 GTIN. 请注意：内部条码以2或02开头，以及格式代码 Code 128 他们不是 GTIN.

【是什么 GTIN](*gtin)

Min items: 1

Unique items: true

[
  "46012300000000"
]

boxCount

Type: integer

货位的数量。

如果产品由多个盒子、包装等组成，则使用此参数。 例如，空调占用两个座位 — 外部和内部单元在两个盒子里。

对于占据一个位置的产品，不要传递此参数。

Min value: 1

category

Type: string

您商店中的产品类别。

Example: example

certificates

Type: string[] | null

产品文件的编号:证书、符合性声明等.

您只能通过以下方式将文档的扫描件上传到商家的办公室 指示说明.

Min items: 1

Unique items: true

[
  "example"
]

commodityCodes

产品代码。

Min items: 1

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

condition

折扣产品的状况。

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

customsCommodityCode

Type: string

对外经济活动统一商品命名法（HS）中的产品代码 — 没有空格的10或14位数字。

一定要指出是否有一个。

Example: 8517610008

description

Type: string

详细的产品说明：例如，它的优点和特点。

说明中不提供安装和装配说明。 不要使用"折扣"，"销售"，"便宜"，"礼品"（礼品类别除外），"免费"，"特价"，"特价"，"新奇"，"新"，"模拟"，"订单"，"点击"等字样。 不要提供任何联系信息或链接。

您可以使用HTML标记来格式化文本:

• <h>，<h1>，<h2>等等 — 新闻标题;
• <br>和<p> — 对于换行符;
• <ol> — 对于编号列表;
• <ul> — 对于项目符号列表。
• <李> — 创建列表项（必须在<ol>或<ul>内）;
• <div> — 支持，但不影响文本显示。

最佳长度 — 400-600个字符。

建议和规则

Example: example

downloadable

Type: boolean

数字产品的标志。 指定 true 如果产品是通过电子邮件交付的。

如何使用数字商品

guaranteePeriod

带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。

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

lifeTime

带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。

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

manuals

使用产品的说明列表。

Min items: 1

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

manufacturerCountries

Type: string[] | null

产品生产的国家。

写下这些国家的名字，因为它们是写在 名单.

Min items: 1

Unique items: true

[
  "Россия"
]

marketCategoryId

Type: integer

您将产品归因于市场上类别的ID。

更改类别时，请确保参数中的产品特性及其值 parameterValues 您正在提交一个新的类别.

您可以使用请求获取市场类别列表。 POST v2/categories/tree.

Min value: 0

Exclusive min: true

name

Type: string

根据方案组成名称：类型+品牌或制造商+型号+功能，如果有（例如，颜色，尺寸或重量）和数量在包装中。

不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。). 不要用大写字母写单词。 — 除了成熟的品牌名称和型号。

最佳长度 — 50-60个字符。

建议和规则

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

params

只有特定类别的产品才具有的特性。 — 例如，自行车车轮的直径或鞋底的材料。

Min items: 1

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

pictures

Type: string[] | null

产品图片的链接。 第一个链接上的图像被认为是主要的，其他的是额外的。

连结要求

• 最多可以有30个链接。
• 指定整个链接，包括http或https协议。
• 最大长度 — 512个字符。
• 俄文字母 URL 阿美。
• 您可以使用直接链接到图像和Yandex的。磁盘。 Yandex上的链接。必须使用函数共享复制磁盘。 与其他云存储的相对链接和链接 — 它们不起作用。

✅ https://example-shop.ru/images/sku12345.jpg

✅ https://yadi.sk/i/NaBoRsimVOLov

❌ /images/sku12345.jpg

❌ https://www.dropbox.com/s/818f/tovar.jpg

与图像的链接必须是永久性的。 不能使用从上载更改为上载的动态链接。

如果您需要替换图像，请通过新链接上传新图像，并删除到旧图像的链接。 如果您只是使用旧链接替换图像，它将不会更新。

图像要求

Min items: 1

[
  "example"
]

shelfLife

带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。

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

tags

Type: string[] | null

商店使用的产品标签。 标签对客户不可见。 您可以按标签对目录中的不同产品进行分组和过滤。 — 例如，同一系列、系列或系列的产品。

最大标签长度 — 20个字符。 一个产品最多可以有10个标签.

Min items: 1

Max items: 50

Unique items: true

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

type

Type: string

特殊类型的产品:

• DEFAULT — 产品，你以前提供了一个特殊的类型，并希望将其删除。
• MEDICINE — 药品。
• BOOK — 纸质和电子书。
• AUDIOBOOK — 有声读物。
• ARTIST_TITLE — 音乐和视频制作。
• ON_DEMAND — 定制产品。
• ALCOHOL — 酒精。

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

vendor

Type: string

品牌或制造商的名称。 它应该按照品牌本身的方式来写。

Example: LEVENHUK

vendorCode

Type: string

从制造商的产品的文章。

Example: VNDR-0005A

videos

Type: string[] | null

连结(URL）上的产品视频。

连结要求

• 指定整个链接，包括http或https协议。
• 最大长度 — 512个字符。
• 俄文字母 URL 阿美。
• 您可以使用视频和Yandex的直接链接。磁盘。 Yandex上的链接。必须使用函数共享复制磁盘。 与其他云存储的相对链接和链接 — 它们不起作用。

✅ https://example-shop.ru/video/sku12345.avi

✅ https://yadi.sk/i/NaBoRsimVOLov

❌ /video/sku12345.avi

❌ https://www.dropbox.com/s/818f/super-tovar.avi

视频链接必须是永久性的。 不能使用从上载更改为上载的动态链接。

如果您需要更换视频，请通过新链接上传新视频，并删除旧视频的链接。 如果您只是使用旧链接替换视频，它将不会更新。

视频要求

Min items: 1

[
  "example"
]

weightDimensions

包装的尺寸和产品的重量。

如果产品占用几个盒子，在测量尺寸之前将它们紧凑地折叠起来。

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

additionalExpenses

Type: object

指示上次更新时间的价格。

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

archived

Type: boolean

产品已存档。

basicPrice

Type: object

价格包括货币、折扣和上次更新的时间.

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

campaigns

放置产品的商店列表。

Min items: 1

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

cardStatus

Type: string

产品卡状态:

• 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 — 将产品放在商店里。

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

产品组的标识符。

组合在一起的产品将具有相同的标识符。

如何将产品组合在卡片上

Example: example

mediaFiles

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

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

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

有关产品的媒体文件的信息。

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

指示上次更新时间的价格。

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

sellingPrograms

有关产品可用的放置模型的信息。

Min items: 1

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