将产品添加到目录并更改有关它们的信息

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

Max items: 6

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个字符。

建议和规则

Max length: 6000

Example: example

downloadable

Type: boolean

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

如何使用数字商品

guaranteePeriod

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

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

lifeTime

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

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

manuals

使用产品的说明列表。

Min items: 1

Max items: 6

[
  {
    "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个字符。

建议和规则

Max length: 256

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

params

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

Min items: 1

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

pictures

Type: string[] | null

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

连结要求

• 指定整个链接，包括http或https协议。
• 俄文字母 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

Max items: 30

[
  "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协议。
• 俄文字母 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

Max items: 6

[
  "example"
]

weightDimensions

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

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

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

additionalExpenses

品的价格。

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

basicPrice

Type: object

价格与折扣指示.

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

deleteParameters

Type: string[] | null

您之前传递给的参数 UpdateOfferDTO，现在你想删除它。

如果您发送 adult, downloadable 和 firstVideoAsCover 它们不会被删除 — 它们的值将变为 false.

您可以一次传递多个值。

不要与相应的参数一起使用 UpdateOfferDTO. 这将导致错误。 400.

Min items: 1

Unique items: true

[
  "ADDITIONAL_EXPENSES"
]

firstVideoAsCover

Type: boolean

使用卡中的第一个视频作为视频背景。

传下去 true 为第一视频作为视频背景，或 false 使视频背景不显示在产品配置文件中。

parameterValues

具有其值的特征列表。

当改变特性时，仅传送其值需要更新的那些。 如果在 marketCategoryId 您正在更改类别，新旧类别的共同特征的值将保留，并且您不需要转移它们。

阅读更多 "特性值的传递".

Min items: 1

Max items: 300

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

purchasePrice

品的价格。

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