推荐产品卡

Deprecated

方法适用于所有模式.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

返回市场上推荐用于您的产品的产品卡的Id。

您放置的每个产品必须在市场上有一个带有自己标识符的产品卡。 — SKU 在市场上。 它在指定 URL 产品卡，后 «...sku=» 例如:

https://market.yandex.ru/product--yandex-kniga/484830016?sku=484830016…

获得推荐的产品 SKU 在市场上，在体内发送 POST-请求尽可能多的关于他们的信息：名称，制造商，条形码，价格等。

收到 SKU 您可以使用请求将其与有关产品的信息一起发送。 POST v2/businesses/{businessId}/offer-mappings/update.

每个请求最多可获得500条建议。

⚙️ 限制: 每小时100,000条建议

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-mapping-entries/suggestions

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:

  • 座 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

Min value: 1

Body

application/json
{
    "offers": [
        {
            "name": "Ударная дрель Makita HP1630, 710 Вт",
            "shopSku": "string",
            "category": "string",
            "vendor": "LEVENHUK",
            "vendorCode": "VNDR-0005A",
            "description": "string",
            "id": "string",
            "feedId": 0,
            "barcodes": [
                "46012300000000"
            ],
            "urls": [
                "string"
            ],
            "pictures": [
                "string"
            ],
            "manufacturer": "string",
            "manufacturerCountries": [
                "string"
            ],
            "minShipment": 0,
            "transportUnitSize": 0,
            "quantumOfSupply": 0,
            "deliveryDurationDays": 0,
            "boxCount": 0,
            "customsCommodityCodes": [
                "string"
            ],
            "weightDimensions": {
                "length": 65.55,
                "width": 50.7,
                "height": 20,
                "weight": 1.001
            },
            "supplyScheduleDays": [
                "MONDAY"
            ],
            "shelfLifeDays": 0,
            "lifeTimeDays": 0,
            "guaranteePeriodDays": 0,
            "processingState": {
                "status": "UNKNOWN",
                "notes": [
                    {
                        "type": "ASSORTMENT",
                        "payload": "string"
                    }
                ]
            },
            "availability": "ACTIVE",
            "shelfLife": {
                "timePeriod": 0,
                "timeUnit": "HOUR",
                "comment": "string"
            },
            "lifeTime": {
                "timePeriod": 0,
                "timeUnit": "HOUR",
                "comment": "string"
            },
            "guaranteePeriod": {
                "timePeriod": 0,
                "timeUnit": "HOUR",
                "comment": "string"
            },
            "certificate": "string",
            "price": 0
        }
    ]
}

Name

Description

offers*

Type: MappingsOfferDTO[]

的产品清单。
目录中有关产品的信息。
目录中有关产品的基本信息。

Min items: 1

Max items: 500

MappingsOfferDTO

目录中有关产品的信息。

Name

Description

availability

Type: OfferAvailabilityStatusType

送货计划:

  • ACTIVE — 会有送货的。
  • INACTIVE — 不会有交付：产品有库存，但您不再计划交付。 产品缺货60天后，此状态将更改为 DELISTED.
  • DELISTED — 存档：该产品已缺货，将不再有交付。 如果产品退回仓库（例如，客户退回订单），则此状态将更改为 INACTIVE.

Enum: ACTIVE, INACTIVE, DELISTED

barcodes

Type: string[]

条形码。

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

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

【是什么 GTIN](*gtin)

Example: 46012300000000

Min items: 1

Unique items  

boxCount

Type: integer<int32>

产品占用多少个座位（如果超过一个）。

仅当产品占据多于一个位置（例如，空调占据两个位置：两个盒子中的外部和内部单元）时才指定该参数。 如果产品占据一个位置，请不要指定此参数。

category

⦸

Type: string

相反，使用 marketCategoryId.

您商店中的产品类别。

certificate

Type: string

产品的文档编号。

在指定号码之前，必须将文档上传到市场上的卖家帐户。 指示手册

customsCommodityCodes

Type: string[]

对外经济活动统一商品命名法（HS）中的产品代码列表。

如果产品需要进行特殊核算（例如，在汞系统中作为动物来源产品或诚实标志系统中），则为强制性参数。

它只能包含一个嵌套HS代码。

Min items: 1

Unique items  

deliveryDurationDays

Type: integer<int32>

卖方将货物交付仓库的期限，以天为单位。

description

Type: string

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

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

HTML标签可用于格式化文本:

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

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

建议和规则

Max length: 6000

feedId

Type: integer<int64>

的feed ID。

guaranteePeriod

Type: TimePeriodDTO

Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.

Обязательный параметр, если у товара есть гарантийный срок.

У товара есть гарантийный срок, а вы не укажете его

Товар будет скрыт с Маркета.

guaranteePeriodDays

Type: integer<int32>

产品保修期：多少天可以服务和修理产品或退款，制造商或销售商将对产品的缺陷负责。

id

Type: string

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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

lifeTime

Type: TimePeriodDTO

Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.

Обязательный параметр, если у товара есть срок службы.

У товара есть срок службы, а вы не укажете его

Товар будет скрыт с Маркета.

lifeTimeDays

⦸

Type: integer<int32>

相反，使用 lifeTime. 同时使用这两个参数将导致错误。

使用寿命：产品正常运行多少天，制造商 — 对其显着缺点负责。

manufacturer

Type: string

产品制造商：生产该产品的公司，其地址和注册号（如果有的话）。

可选参数。

manufacturerCountries

Type: string[]

生产产品的国家列表。

所需参数。

它必须包含至少一个，但不超过5个国家。

Min items: 1

Max items: 5

Unique items  

minShipment

Type: integer<int32>

交付到仓库的最小物料数。

例如，如果以至少10个盒子的批次供应婴儿食品，并且每个盒子包含6个罐子，则指定值60。

name

Type: string

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

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

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

建议和规则

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

Max length: 256

pictures

Type: string[]

连结(URL）产品图像质量好。

您最多可以指定30个链接。 在这种情况下，第一个链接上的图像将是主要的。 它被用作市场搜索和产品卡上的产品图像。 放大图像视图中提供其他产品图像。

Min length: 1

Max length: 2000

Min items: 1

Max items: 30

Unique items false

price

Type: number

品的价格。

processingState

Type: OfferProcessingStateDTO

Информация о статусе публикации товара на Маркете.

quantumOfSupply

⦸

Type: integer<int32>

附加批次：最低数量可以添加多少项 minShipment.

例如，如果您以至少10盒的批次供应婴儿食品，并希望在最小批次中添加2盒，每盒中有6个罐子，请指定值12。

shelfLife

Type: TimePeriodDTO

Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты.

Обязательный параметр, если у товара есть срок годности.

У товара есть срок годности, а вы не укажете его

Товар будет скрыт с Маркета.

shelfLifeDays

⦸

Type: integer<int32>

相反，使用 shelfLife. 同时使用这两个参数将导致错误。

到期日期：经过多少天的产品将变得不可用。

shopSku

Type: string

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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

supplyScheduleDays

Type: DayOfWeekType[]

卖方将货物交付到仓库的一周中的几天。
星期几:

  • MONDAY — 星期一。
  • TUESDAY — 星期二。
  • WEDNESDAY — 星期三。
  • THURSDAY — 星期四。
  • FRIDAY — 星期五。
  • SATURDAY — 星期六。
  • SUNDAY — 星期天。

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

Min items: 1

Unique items  

transportUnitSize

Type: integer<int32>

您交付到仓库的一个包中的物料数量。

例如，如果您以6罐的盒子供应婴儿食品，请指定值6。

urls

Type: string[]

URL 您网站上的产品照片或描述页面。

传输的数据不会显示在展柜上，但它将帮助市场专家为您的产品找到一张卡片。

必须包含一个嵌套参数。 url.

Min length: 1

Max length: 2000

Min items: 1

Unique items  

vendor

Type: string

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

Example: LEVENHUK

vendorCode

Type: string

从制造商的产品的文章。

Example: VNDR-0005A

weightDimensions

Type: OfferWeightDimensionsDTO

Габариты упаковки и вес товара.

OfferAvailabilityStatusType

送货计划:

  • ACTIVE — 会有送货的。
  • INACTIVE — 不会有交付：产品有库存，但您不再计划交付。 产品缺货60天后，此状态将更改为 DELISTED.
  • DELISTED — 存档：该产品已缺货，将不再有交付。 如果产品退回仓库（例如，客户退回订单），则此状态将更改为 INACTIVE.

Type

Description

OfferAvailabilityStatusType

Enum: ACTIVE, INACTIVE, DELISTED

TimePeriodDTO

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

Name

Description

timePeriod*

Type: integer

指定单位的持续时间。

timeUnit*

Type: TimeUnitType

Единица измерения.

Enum: HOUR, DAY, WEEK, MONTH, YEAR

comment

Type: string

评论。

Max length: 500

OfferProcessingStateDTO

品在市场上的发布状态的信息。

Name

Description

notes

Type: OfferProcessingNoteDTO[]

产品审核失败的原因。
产品审核失败的原因。

Min items: 1

status

Type: OfferProcessingStatusType

产品发布状态:

  • UNKNOWN — 状态不明。
  • READY — 该产品已通过审核。 要将其投放市场，请为其设定价格。
  • IN_WORK — 该产品正在进行适度。 这需要几天的时间。
  • NEED_INFO — 由于产品描述中的错误或信息缺失，产品审核失败。 参数中返回有关偏差原因的信息 notes.
  • NEED_MAPPING — 您无法为产品创建卡片。
  • NEED_CONTENT — 对于没有的产品 SKU 在市场上（marketSku）您需要自己找到卡（通过API或市场上的卖家帐户），或者如果产品尚未在市场上销售，则创建它。
  • CONTENT_PROCESSING — 该产品处于适度状态。
  • SUSPENDED — 该产品尚未通过审核，因为市场尚未放置此类产品。
  • REJECTED — 该产品没有通过审核，因为市场不打算发布此类产品。
  • REVIEW — 正在就产品的放置做出决定。
  • CREATE_ERROR — 无法创建产品配置文件。
  • UPDATE_ERROR — 产品卡有未使用的更改。

Enum: UNKNOWN, READY, IN_WORK, NEED_INFO, NEED_MAPPING, NEED_CONTENT, CONTENT_PROCESSING, SUSPENDED, REJECTED, REVIEW, CREATE_ERROR, UPDATE_ERROR

DayOfWeekType

星期几:

  • MONDAY — 星期一。
  • TUESDAY — 星期二。
  • WEDNESDAY — 星期三。
  • THURSDAY — 星期四。
  • FRIDAY — 星期五。
  • SATURDAY — 星期六。
  • SUNDAY — 星期天。

Type

Description

DayOfWeekType

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

OfferWeightDimensionsDTO

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

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

多座位货物测量方案

Name

Description

height*

Type: number

包装高度以厘米为单位。

Example: 20

Min value: 0

length*

Type: number

包装长度以厘米为单位。

Example: 65.55

Min value: 0

weight*

Type: number

以公斤为单位的产品重量，包括包装（毛）。

Example: 1.001

Min value: 0

width*

Type: number

包装宽度以厘米为单位。

Example: 50.7

Min value: 0

TimeUnitType

时间测量单元:

  • HOUR — 小时。
  • DAY — 一天。
  • WEEK — 一个星期。
  • MONTH — 月份。
  • YEAR — 年。

Type

Description

TimeUnitType

Enum: HOUR, DAY, WEEK, MONTH, YEAR

OfferProcessingNoteDTO

产品审核失败的原因。

Name

Description

payload

Type: string

有关产品拒绝原因的其他信息。

type

Type: OfferProcessingNoteType

Тип причины, по которой товар не прошел модерацию.

Enum: ASSORTMENT, CANCELLED, CONFLICTING_INFORMATION, OTHER, DEPARTMENT_FROZEN, INCORRECT_INFORMATION, LEGAL_CONFLICT, NEED_CLASSIFICATION_INFORMATION, NEED_INFORMATION, NEED_PICTURES, NEED_VENDOR, NO_CATEGORY, NO_KNOWLEDGE, NO_PARAMETERS_IN_SHOP_TITLE, NO_SIZE_MEASURE, SAMPLE_LINE

OfferProcessingStatusType

产品发布状态:

  • UNKNOWN — 状态不明。
  • READY — 该产品已通过审核。 要将其投放市场，请为其设定价格。
  • IN_WORK — 该产品正在进行适度。 这需要几天的时间。
  • NEED_INFO — 由于产品描述中的错误或信息缺失，产品审核失败。 参数中返回有关偏差原因的信息 notes.
  • NEED_MAPPING — 您无法为产品创建卡片。
  • NEED_CONTENT — 对于没有的产品 SKU 在市场上（marketSku）您需要自己找到卡（通过API或市场上的卖家帐户），或者如果产品尚未在市场上销售，则创建它。
  • CONTENT_PROCESSING — 该产品处于适度状态。
  • SUSPENDED — 该产品尚未通过审核，因为市场尚未放置此类产品。
  • REJECTED — 该产品没有通过审核，因为市场不打算发布此类产品。
  • REVIEW — 正在就产品的放置做出决定。
  • CREATE_ERROR — 无法创建产品配置文件。
  • UPDATE_ERROR — 产品卡有未使用的更改。

Type

Description

OfferProcessingStatusType

Enum: UNKNOWN, READY, IN_WORK, NEED_INFO, NEED_MAPPING, NEED_CONTENT, CONTENT_PROCESSING, SUSPENDED, REJECTED, REVIEW, CREATE_ERROR, UPDATE_ERROR

OfferProcessingNoteType

产品审核失败的原因类型:

  • ASSORTMENT — 该产品以不同的版本生产。 他们每个人都应该被描述为一个单独的产品（参数 offerMappings 在请求 POST v2/businesses/{businessId}/offer-mappings/update 或目录中的一行，如果您通过市场上的卖家帐户上传产品）。
  • CANCELLED — 该产品是在你的主动下退出的.
  • CONFLICTING_INFORMATION （以前错误地 CONFLICTING) — 您提供了有关产品的冲突信息。 需要修复的参数在参数中指定 payload.
  • OTHER — 由于另一个原因，该产品未能审核。 联系客户支持或您的经理。
  • DEPARTMENT_FROZEN — 在此类别中放置产品的规则正在处理中，因此该产品还不能通过审核。
  • INCORRECT_INFORMATION — 您提供的产品信息与制造商的描述相矛盾。 需要修复的参数在参数中指定 payload.
  • LEGAL_CONFLICT — 由于法律原因，该产品未通过审核。 例如，它没有在俄罗斯正式销售，或者你没有许可证出售它。
  • NEED_CLASSIFICATION_INFORMATION — 您提供的有关产品的信息不足以对其进行分类。 确保您已正确指定产品的名称，类别，制造商和制造国家，以及 URL 带有可用于识别产品的描述的图像或页面。
  • NEED_INFORMATION — 该产品之前尚未在俄罗斯销售，目前尚未上市。 你可以为它创建一张卡片。 有关更多信息，请参阅部分 使用产品卡 燕基科斯. 卖家的市场帮助。
  • NEED_PICTURES — 要识别产品，您需要其图像。 发送出去 URL 请求中的产品图像 POST v2/businesses/{businessId}/offer-mappings/update 或者通过市场上的卖家账户下载更新的目录。
  • NEED_VENDOR — 产品制造商指定不正确。
  • NO_CATEGORY, NO_KNOWLEDGE — 该类别的产品尚未投放市场。 如果出现类别，产品将再次发送审核。
  • NO_PARAMETERS_IN_SHOP_TITLE — 该产品以不同的版本生产，并且从名称中不清楚它是关于哪一个。 要添加到产品名称的参数在参数中指定 payload.
  • NO_SIZE_MEASURE — 您需要此产品的尺寸网格。 将其发送给支持服务或您的经理。 尺寸网格要求在参数中指定 payload.
  • SAMPLE_LINE — 由于多了一条线,该产品没有通过审核.

Type

Description

OfferProcessingNoteType

Enum: ASSORTMENT, CANCELLED, CONFLICTING_INFORMATION, OTHER, DEPARTMENT_FROZEN, INCORRECT_INFORMATION, LEGAL_CONFLICT, NEED_CLASSIFICATION_INFORMATION, NEED_INFORMATION, NEED_PICTURES, NEED_VENDOR, NO_CATEGORY, NO_KNOWLEDGE, NO_PARAMETERS_IN_SHOP_TITLE, NO_SIZE_MEASURE, SAMPLE_LINE

Responses

200 OK

目录中有关产品的信息。

Body

application/json
{
    "status": "OK",
    "result": {
        "offers": [
            {
                "name": "Ударная дрель Makita HP1630, 710 Вт",
                "shopSku": "string",
                "category": "string",
                "vendor": "LEVENHUK",
                "vendorCode": "VNDR-0005A",
                "description": "string",
                "id": "string",
                "feedId": 0,
                "barcodes": [
                    "46012300000000"
                ],
                "urls": [
                    "string"
                ],
                "pictures": [
                    "string"
                ],
                "manufacturer": "string",
                "manufacturerCountries": [
                    "string"
                ],
                "minShipment": 0,
                "transportUnitSize": 0,
                "quantumOfSupply": 0,
                "deliveryDurationDays": 0,
                "boxCount": 0,
                "customsCommodityCodes": [
                    "string"
                ],
                "weightDimensions": {
                    "length": 65.55,
                    "width": 50.7,
                    "height": 20,
                    "weight": 1.001
                },
                "supplyScheduleDays": [
                    "MONDAY"
                ],
                "shelfLifeDays": 0,
                "lifeTimeDays": 0,
                "guaranteePeriodDays": 0,
                "processingState": {
                    "status": "UNKNOWN",
                    "notes": [
                        {
                            "type": "ASSORTMENT",
                            "payload": "string"
                        }
                    ]
                },
                "availability": "ACTIVE",
                "shelfLife": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "lifeTime": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "guaranteePeriod": {
                    "timePeriod": 0,
                    "timeUnit": "HOUR",
                    "comment": "string"
                },
                "certificate": "string",
                "price": 0,
                "marketCategoryId": 0,
                "marketCategoryName": "string",
                "marketModelId": 0,
                "marketModelName": "string",
                "marketSku": 0,
                "marketSkuName": "string"
            }
        ]
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

result

Type: OfferMappingSuggestionsListDTO

推荐产品卡列表。

ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

OfferMappingSuggestionsListDTO

推荐产品卡列表。

Name

Description

offers*

Type: EnrichedMappingsOfferDTO[]

的产品清单。
有关推荐产品卡的信息。
目录中有关产品的信息。

EnrichedMappingsOfferDTO

有关推荐产品卡的信息。

Name

Description

availability

Type: OfferAvailabilityStatusType

送货计划:

  • ACTIVE — 会有送货的。
  • INACTIVE — 不会有交付：产品有库存，但您不再计划交付。 产品缺货60天后，此状态将更改为 DELISTED.
  • DELISTED — 存档：该产品已缺货，将不再有交付。 如果产品退回仓库（例如，客户退回订单），则此状态将更改为 INACTIVE.

Enum: ACTIVE, INACTIVE, DELISTED

barcodes

Type: string[]

条形码。

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

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

【是什么 GTIN](*gtin)

Example: 46012300000000

Min items: 1

Unique items  

boxCount

Type: integer<int32>

产品占用多少个座位（如果超过一个）。

仅当产品占据多于一个位置（例如，空调占据两个位置：两个盒子中的外部和内部单元）时才指定该参数。 如果产品占据一个位置，请不要指定此参数。

category

⦸

Type: string

相反，使用 marketCategoryId.

您商店中的产品类别。

certificate

Type: string

产品的文档编号。

在指定号码之前，必须将文档上传到市场上的卖家帐户。 指示手册

customsCommodityCodes

Type: string[]

对外经济活动统一商品命名法（HS）中的产品代码列表。

如果产品需要进行特殊核算（例如，在汞系统中作为动物来源产品或诚实标志系统中），则为强制性参数。

它只能包含一个嵌套HS代码。

Min items: 1

Unique items  

deliveryDurationDays

Type: integer<int32>

卖方将货物交付仓库的期限，以天为单位。

description

Type: string

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

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

HTML标签可用于格式化文本:

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

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

建议和规则

Max length: 6000

feedId

Type: integer<int64>

的feed ID。

guaranteePeriod

Type: TimePeriodDTO

Информация о гарантийном сроке: в течение какого периода (в годах, месяцах, днях, неделях или часах) возможны обслуживание и ремонт товара или возврат денег, а изготовитель или продавец будет нести ответственность за недостатки товара.

Обязательный параметр, если у товара есть гарантийный срок.

У товара есть гарантийный срок, а вы не укажете его

Товар будет скрыт с Маркета.

guaranteePeriodDays

Type: integer<int32>

产品保修期：多少天可以服务和修理产品或退款，制造商或销售商将对产品的缺陷负责。

id

Type: string

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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

lifeTime

Type: TimePeriodDTO

Информация о сроке службы: в течение какого периода (в годах, месяцах, днях, неделях или часах) товар будет исправно выполнять свою функцию, а изготовитель — нести ответственность за его существенные недостатки.

Обязательный параметр, если у товара есть срок службы.

У товара есть срок службы, а вы не укажете его

Товар будет скрыт с Маркета.

lifeTimeDays

⦸

Type: integer<int32>

相反，使用 lifeTime. 同时使用这两个参数将导致错误。

使用寿命：产品正常运行多少天，制造商 — 对其显着缺点负责。

manufacturer

Type: string

产品制造商：生产该产品的公司，其地址和注册号（如果有的话）。

可选参数。

manufacturerCountries

Type: string[]

生产产品的国家列表。

所需参数。

它必须包含至少一个，但不超过5个国家。

Min items: 1

Max items: 5

Unique items  

marketCategoryId

Type: integer<int64>

市场上推荐产品卡的类别ID。

它只与参数一起返回 marketSku.

marketCategoryName

Type: string

市场上推荐产品卡的类别名称。

它可能会从响应中丢失。

marketModelId

⦸

Type: integer<int64>

市场上推荐产品卡的型号ID。

它可能会从响应中丢失。

marketModelName

⦸

Type: string

市场上推荐产品卡的型号名称。

它只与参数一起返回 市场推广.

marketSku

Type: integer<int64>

SKU на Маркете — идентификатор рекомендованной карточки товара на Маркете.

Параметр возвращается, если для товара нашлась карточка. Если параметра нет в ответе, возможно, товар еще не продается на Маркете или вы передали неполные (некорректные) данные в запросе.

Min value: 1

marketSkuName

Type: string

来自市场上推荐卡的产品名称。

它可能会从响应中丢失。

minShipment

Type: integer<int32>

交付到仓库的最小物料数。

例如，如果以至少10个盒子的批次供应婴儿食品，并且每个盒子包含6个罐子，则指定值60。

name

Type: string

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

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

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

建议和规则

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

Max length: 256

pictures

Type: string[]

连结(URL）产品图像质量好。

您最多可以指定30个链接。 在这种情况下，第一个链接上的图像将是主要的。 它被用作市场搜索和产品卡上的产品图像。 放大图像视图中提供其他产品图像。

Min length: 1

Max length: 2000

Min items: 1

Max items: 30

Unique items false

price

Type: number

品的价格。

processingState

Type: OfferProcessingStateDTO

Информация о статусе публикации товара на Маркете.

quantumOfSupply

⦸

Type: integer<int32>

附加批次：最低数量可以添加多少项 minShipment.

例如，如果您以至少10盒的批次供应婴儿食品，并希望在最小批次中添加2盒，每盒中有6个罐子，请指定值12。

shelfLife

Type: TimePeriodDTO

Информация о сроке годности: через какое время (в годах, месяцах, днях, неделях или часах) товар станет непригоден для использования. Например, срок годности есть у таких категорий, как продукты питания и медицинские препараты.

Обязательный параметр, если у товара есть срок годности.

У товара есть срок годности, а вы не укажете его

Товар будет скрыт с Маркета.

shelfLifeDays

⦸

Type: integer<int32>

相反，使用 shelfLife. 同时使用这两个参数将导致错误。

到期日期：经过多少天的产品将变得不可用。

shopSku

Type: string

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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

supplyScheduleDays

Type: DayOfWeekType[]

卖方将货物交付到仓库的一周中的几天。
星期几:

  • MONDAY — 星期一。
  • TUESDAY — 星期二。
  • WEDNESDAY — 星期三。
  • THURSDAY — 星期四。
  • FRIDAY — 星期五。
  • SATURDAY — 星期六。
  • SUNDAY — 星期天。

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

Min items: 1

Unique items  

transportUnitSize

Type: integer<int32>

您交付到仓库的一个包中的物料数量。

例如，如果您以6罐的盒子供应婴儿食品，请指定值6。

urls

Type: string[]

URL 您网站上的产品照片或描述页面。

传输的数据不会显示在展柜上，但它将帮助市场专家为您的产品找到一张卡片。

必须包含一个嵌套参数。 url.

Min length: 1

Max length: 2000

Min items: 1

Unique items  

vendor

Type: string

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

Example: LEVENHUK

vendorCode

Type: string

从制造商的产品的文章。

Example: VNDR-0005A

weightDimensions

Type: OfferWeightDimensionsDTO

Габариты упаковки и вес товара.

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

市场的内部错误。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.

什么是GTIN？
[医]GTIN — 这是在单个国际数据库中分配给产品的唯一编号。 GS1. 此编号生成EAN、UPC或ISBN条形码。

如何确保产品在数据库中
你可以在 验证页面 在GS1协会的网站上。 如果未找到产品，请向供应商索取GTIN代码。

如何为您的产品获得GTIN
要接收GTIN代码，制造商需要加入GS1协会并注册产品。

上一篇
设定货物数量和最低数量的限制
下一篇
查看匹配的卡片