目录中有关产品的信息

方法适用于模式：FBY, FBS, 快递和DBS.

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

返回目录中的产品列表，它们在市场上的类别以及每个产品的特性。

它可以用在三种方式:

  • 设置感兴趣的人的列表 SKU;
  • 设置过滤器—在这种情况下，结果将逐页返回;
  • 不要发送请求正文以获取目录中所有产品的列表。
**⚙️ 限制：**每分钟600个请求，每个请求不超过200个产品

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-mappings

Path parameters

Name

Description

businessId*

Type: integer<int64>

内阁ID。 要找到答案，请使用请求 :no-translate[GET v2/campaigns].

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

Query parameters

Name

Description

language

Type: CatalogLanguageType

接受和返回参数中的值的语言 name 和 description.

默认值: RU.

limit

Type: integer<int32>

每页的值数。

Min value: 1
Example: 20

page_token

Type: string

结果页面的ID。

如果省略该参数，则返回第一页。

我们建议传输输出参数的值 nextPageToken，在最后一次请求期间接收。

如果设置 page_token 并且请求有参数 page 和 pageSize 它们被忽略了。
Example: eyBuZXh0SWQ6IDIzNDIgfQ==

CatalogLanguageType

语言:

  • RU -俄语。
  • UZ -乌兹别克。

Type

Description

CatalogLanguageType

Enum: RU, UZ

Body

application/json
{
    "offerIds": [
        "string"
    ],
    "cardStatuses": [
        "HAS_CARD_CAN_NOT_UPDATE"
    ],
    "categoryIds": [
        0
    ],
    "vendorNames": [
        "string"
    ],
    "tags": [
        "string"
    ],
    "archived": false
}

Name

Description

archived

Type: boolean

按存档中的位置过滤。

传下去 true 以接收存档中的项目。 如果过滤器未填充或通过 false，响应返回不在存档中的项。

cardStatuses

Type: OfferCardStatusType[]

按卡状态过滤。

什么是产品卡？
产品卡状态:

  • 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

Min items: 1

Unique items  

categoryIds

Type: integer<int32>[]

在市场上按类别过滤。

Min value (exclusive): 0

Min items: 1

Unique items  

offerIds

Type: string[]

需要信息的产品的Id。

此列表仅完整返回。

如果您要求提供有关特定信息的信息 SKU，不填写:

  • page_token;
  • limit;
  • cardStatuses;
  • categoryIds;
  • vendorNames;
  • tags;
  • archived.


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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Min items: 1

Max items: 200

Unique items  

tags

Type: string[]

按标签过滤。

Min items: 1

Unique items  

vendorNames

Type: string[]

按品牌过滤。

Min items: 1

Unique items  

OfferCardStatusType

产品卡状态:

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

Type

Description

OfferCardStatusType

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

Responses

200 OK

目录中有关产品的信息。

Body

application/json
{
    "status": "OK",
    "result": {
        "paging": {
            "nextPageToken": "string",
            "prevPageToken": "string"
        },
        "offerMappings": [
            {
                "offer": {
                    "offerId": "string",
                    "name": "Ударная дрель Makita HP1630, 710 Вт",
                    "marketCategoryId": 0,
                    "category": "string",
                    "pictures": [
                        "string"
                    ],
                    "videos": [
                        "string"
                    ],
                    "manuals": [
                        {
                            "url": "string",
                            "title": "string"
                        }
                    ],
                    "vendor": "LEVENHUK",
                    "barcodes": [
                        "46012300000000"
                    ],
                    "description": "string",
                    "manufacturerCountries": [
                        "Россия"
                    ],
                    "weightDimensions": {
                        "length": 65.55,
                        "width": 50.7,
                        "height": 20,
                        "weight": 1.001
                    },
                    "vendorCode": "VNDR-0005A",
                    "tags": [
                        "до 500 рублей"
                    ],
                    "shelfLife": {
                        "timePeriod": 0,
                        "timeUnit": "HOUR",
                        "comment": "string"
                    },
                    "lifeTime": {
                        "timePeriod": 0,
                        "timeUnit": "HOUR",
                        "comment": "string"
                    },
                    "guaranteePeriod": {
                        "timePeriod": 0,
                        "timeUnit": "HOUR",
                        "comment": "string"
                    },
                    "customsCommodityCode": "8517610008",
                    "commodityCodes": [
                        {
                            "code": "string",
                            "type": "CUSTOMS_COMMODITY_CODE"
                        }
                    ],
                    "certificates": [
                        "string"
                    ],
                    "boxCount": 0,
                    "condition": {
                        "type": "PREOWNED",
                        "quality": "PERFECT",
                        "reason": "string"
                    },
                    "type": "DEFAULT",
                    "downloadable": false,
                    "adult": false,
                    "age": {
                        "value": 0,
                        "ageUnit": "YEAR"
                    },
                    "params": [
                        {
                            "name": "Wi-Fi",
                            "value": "есть"
                        }
                    ],
                    "basicPrice": {
                        "value": 0,
                        "currencyId": "RUR",
                        "discountBase": 0,
                        "updatedAt": "2022-12-29T18:02:01Z"
                    },
                    "purchasePrice": {
                        "value": 0,
                        "currencyId": "RUR",
                        "updatedAt": "2022-12-29T18:02:01Z"
                    },
                    "additionalExpenses": {
                        "value": 0,
                        "currencyId": "RUR",
                        "updatedAt": "2022-12-29T18:02:01Z"
                    },
                    "cardStatus": "HAS_CARD_CAN_NOT_UPDATE",
                    "campaigns": [
                        {
                            "campaignId": 0,
                            "status": "PUBLISHED"
                        }
                    ],
                    "sellingPrograms": [
                        {
                            "sellingProgram": "FBY",
                            "status": "FINE"
                        }
                    ],
                    "mediaFiles": {
                        "firstVideoAsCover": false,
                        "videos": [
                            {
                                "url": "string",
                                "title": "string",
                                "uploadState": "UPLOADING"
                            }
                        ],
                        "pictures": [
                            {
                                "url": "string",
                                "title": "string",
                                "uploadState": "UPLOADING"
                            }
                        ],
                        "manuals": [
                            {
                                "url": "string",
                                "title": "string",
                                "uploadState": "UPLOADING"
                            }
                        ]
                    },
                    "archived": false,
                    "groupId": "string"
                },
                "mapping": {
                    "marketSku": 0,
                    "marketSkuName": "string",
                    "marketModelId": 0,
                    "marketModelName": "string",
                    "marketCategoryId": 0,
                    "marketCategoryName": "string"
                },
                "showcaseUrls": [
                    {
                        "showcaseType": "B2B",
                        "showcaseUrl": "string"
                    }
                ]
            }
        ]
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Enum: OK, ERROR

result

Type: GetOfferMappingsResultDTO

有关产品的信息。

ApiResponseStatusType

响应的类型。 可能的值:

  • OK -没有错误。
  • ERROR -处理请求时发生错误。

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

GetOfferMappingsResultDTO

有关产品的信息。

Name

Description

offerMappings*

Type: GetOfferMappingDTO[]

有关产品的信息。
产品信息。

paging

Type: ScrollingPagerDTO

Идентификатор следующей страницы.
下一页的ID。

GetOfferMappingDTO

产品信息。

Name

Description

mapping

Type: GetMappingDTO

Информация о карточке товара на Маркете.
Идентификатор карточки на Маркете. Показывает текущую привязку товара к карточке.

Может отсутствовать в ответе, если товар еще не привязан к карточке. Проверьте статус карточки или исправьте ошибки.

offer

Type: GetOfferDTO

Основные параметры товара.
产品的主要参数。

showcaseUrls

Type: ShowcaseUrlDTO[]

链接到同一产品在市场的不同店面。
展示柜中产品的链接及其类型。

Min items: 1

ScrollingPagerDTO

有关结果页的信息。

Name

Description

nextPageToken

Type: string

下一个结果页面的ID。

prevPageToken

Type: string

上一个结果页面的ID。

GetMappingDTO

目录中有关产品的信息。

Name

Description

marketCategoryId

Type: integer<int64>

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

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

marketCategoryName

Type: string

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

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

marketModelId

⦸

Type: integer<int64>

市场上模型的ID。

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

marketModelName

⦸

Type: string

市场上型号的名称。

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

marketSku

Type: integer<int64>

Идентификатор карточки на Маркете.

Min value: 1

marketSkuName

Type: string

产品卡的名称。

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

GetOfferDTO

产品参数。

Name

Description

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}$

additionalExpenses

Type: GetPriceDTO

Дополнительные расходы на товар. Например, на доставку или упаковку.
品的价格。
上次更新的时间。

adult

Type: boolean

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

age

Type: AgeDTO

Если товар не предназначен для детей младше определенного возраста, укажите это.

Возрастное ограничение можно задавать в годах (с нуля, с 6, 12, 16 или 18) или в месяцах (любое число от 0 до 12).

archived

Type: boolean

产品已存档。

barcodes

Type: string[]

条形码。

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

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

什么是 GTIN

Example: 46012300000000

Min items: 1

Unique items  

basicPrice

Type: GetPriceWithDiscountDTO

Цена.
价格与折扣指示.
上次更新的时间。

boxCount

Type: integer<int32>

货位的数量。

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

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

Min value: 1

campaigns

Type: OfferCampaignStatusDTO[]

放置产品的商店列表。
品在商店中的状态。

Min items: 1

cardStatus

Type: OfferCardStatusType

产品卡状态:

  • 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

category

⦸

Type: string

相反，使用 marketCategoryId.

您商店中的产品类别。

certificates

Type: string[]

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

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

Min items: 1

Unique items  

commodityCodes

Type: CommodityCodeDTO[]

产品代码。
产品代码。

Min items: 1

condition

Type: OfferConditionDTO

Состояние уцененного товара.

Используется только для товаров, продаваемых с уценкой.

Правила продажи уцененных товаров

customsCommodityCode

⦸

Type: string

相反，使用 commodityCodes 与类型 CUSTOMS_COMMODITY_CODE.

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

一定要指出是否有一个。

Example: 8517610008

description

Type: string

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

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

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

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

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

建议和规则

downloadable

Type: boolean

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

如何使用数字商品

groupId

Type: string

产品组的标识符。

如果产品组合成一个组，它们将具有相同的ID。

guaranteePeriod

Type: TimePeriodDTO

Гарантийный срок — период, в течение которого можно заменить или починить товар без дополнительной платы.

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

В комментарии опишите особенности гарантийного обслуживания. Например, Гарантия на аккумулятор — 6 месяцев.

lifeTime

Type: TimePeriodDTO

Срок службы — период, в течение которого товар должен исправно выполнять свою функцию.

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

В комментарии укажите условия хранения. Например, Использовать при температуре не ниже −10 градусов.

manuals

Type: OfferManualDTO[]

使用产品的说明列表。
产品使用说明。

Min items: 1

manufacturerCountries

Type: string[]

产品生产的国家。

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

Example: Россия

Min items: 1

Unique items  

marketCategoryId

Type: integer<int64>

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

传输时始终指示 parameterValues

如果，在改变特征时，通过 parameterValues 并且不指定 marketCategoryId，特征将被更新，但您将在响应中收到警告（参数 warnings).

如果您不传递这两个参数，则将使用来自过时参数的信息。 params 和 category，而 marketCategoryId 它将被自动检测到。

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

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

Min value (exclusive): 0

mediaFiles

Type: OfferMediaFilesDTO

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

name

Type: string

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

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

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

建议和规则

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

params

⦸

Type: OfferParamDTO[]

传输特性时，使用 parameterValues.

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

如果产品具有相同参数的多个值，则使用相同的值发送它们 name，但不同 value.

例子：
"params": [
  {
    "name": "Цвет для фильтра",
    "value": "Зеленый"
  },
  {
    "name": "Цвет для фильтра",
    "value": "Желтый"
  }
]

Min items: 1

pictures

Type: string[]

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

连结要求

  • 最多可以有30个链接。
  • 指定整个链接，包括http或https协议。
  • 最大长度为512个字符。
  • Url中的俄语字母是允许的。
  • 您可以使用直接链接到图像和Yandex的。磁盘。 Yandex上的链接。必须使用函数复制磁盘 分享. 相对链接和其他云存储的链接不起作用。

✅ ：没有-翻译[https://example-shop.ru/images/sku12345.jpg]

✅ ：没有-翻译[https://yadi.sk/i/NaBoRsimVOLov]

❌ /:没有-翻译[图片/sku12345.jpg]

❌ ：没有-翻译[https://www.dropbox.com/s/818f/tovar.jpg]

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

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

图像要求

Min length: 1

Max length: 2000

Min items: 1

Unique items false

purchasePrice

Type: GetPriceDTO

Себестоимость — затраты на самостоятельное производство товара или закупку у производителя или поставщиков.
品的价格。
上次更新的时间。

sellingPrograms

Type: OfferSellingProgramDTO[]

有关产品可用的放置模型的信息。
关于哪些型号可以用于销售产品以及哪些型号不能使用的信息。

Min items: 1

shelfLife

Type: TimePeriodDTO

Срок годности — период, по прошествии которого товар становится непригоден.

Указывайте срок, указанный на банке или упаковке. Текущая дата, дата поставки или дата отгрузки значения не имеет.

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

В комментарии укажите условия хранения. Например, Хранить в сухом помещении.

tags

Type: string[]

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

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

Example: до 500 рублей

Min items: 1

Max items: 50

Unique items  

type

Type: OfferType

Особый тип товара. Указывается, если товар:

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

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

vendor

Type: string

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

Example: LEVENHUK

vendorCode

Type: string

从制造商的产品的文章。

Example: VNDR-0005A

videos

Type: string[]

产品视频的链接（Url）。

连结要求

  • 指定整个链接，包括http或https协议。
  • 最大长度为512个字符。
  • Url中的俄语字母是允许的。
  • 您可以使用视频和Yandex的直接链接。磁盘。 Yandex上的链接。必须使用函数复制磁盘 分享. 相对链接和其他云存储的链接不起作用。

✅ ：没有-翻译[https://example-shop.ru/video/sku12345.avi]

✅ ：没有-翻译[https://yadi.sk/i/NaBoRsimVOLov]

❌ /:没有-翻译[视频/sku12345.avi]

❌ ：没有-翻译[https://www.dropbox.com/s/818f/super-tovar.avi]

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

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

视频要求

Min length: 1

Max length: 2000

Min items: 1

Unique items false

weightDimensions

Type: OfferWeightDimensionsDTO

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

ShowcaseUrlDTO

展示柜中产品的链接及其类型。

Name

Description

showcaseType*

Type: ShowcaseType

Тип витрины.

Enum: B2B, B2C

showcaseUrl*

Type: string

产品的链接。

GetPriceDTO

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

Name

Description

currencyId*

Type: CurrencyType

Валюта.

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

updatedAt*

Type: string<date-time>

上次更新的时间。

value*

Type: number

品的价格。

Min value (exclusive): 0

AgeDTO

年龄在指定的测量单位。

Name

Description

ageUnit*

Type: AgeUnitType

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

Enum: YEAR, MONTH

value*

Type: number

意义。

Min value: 0

GetPriceWithDiscountDTO

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

Name

Description

updatedAt*

Type: string<date-time>

上次更新的时间。

currencyId

Type: CurrencyType

Валюта.

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

discountBase

Type: number

划掉的价格。

数字必须是整数。 您可以指定折扣从5到99％的价格。

如果您提供产品折扣，则在每次更新价格时传递此参数。

Min value (exclusive): 0

value

Type: number

品的价格。

Min value (exclusive): 0

OfferCampaignStatusDTO

品在商店中的状态。

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:

  • 模块和 API→区块 向Yandex发送数据。街市.
  • 查询日志 →块中的下拉列表 显示日志.

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

status*

Type: OfferCampaignStatusType

Статус товара.

Enum: PUBLISHED, CHECKING, DISABLED_BY_PARTNER, DISABLED_AUTOMATICALLY, REJECTED_BY_MARKET, CREATING_CARD, NO_CARD, NO_STOCKS, ARCHIVED

CommodityCodeDTO

产品代码。

Name

Description

code*

Type: string

产品代码。

type*

Type: CommodityCodeType

Тип товарного кода.

Enum: CUSTOMS_COMMODITY_CODE, IKPU_CODE

OfferConditionDTO

折扣产品的状况。

Name

Description

quality

Type: OfferConditionQualityType

Внешний вид товара.

Enum: PERFECT, EXCELLENT, GOOD, NOT_SPECIFIED

reason

Type: string

产品说明。 详细描述缺陷，它们的明显程度以及在哪里寻找它们。

type

Type: OfferConditionType

Тип уценки.

Enum: PREOWNED, SHOWCASESAMPLE, REFURBISHED, REDUCTION, RENOVATED, NOT_SPECIFIED

TimePeriodDTO

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

Name

Description

timePeriod*

Type: integer

指定单位的持续时间。

timeUnit*

Type: TimeUnitType

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

Enum: HOUR, DAY, WEEK, MONTH, YEAR

comment

Type: string

评论。

Max length: 500

OfferManualDTO

产品使用说明。

Name

Description

url*

Type: string

链接到说明。

Min length: 1

Max length: 2000

title

Type: string

将显示在产品卡上的指令的名称。

Max length: 500

OfferMediaFilesDTO

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

Name

Description

firstVideoAsCover

⦸

Type: boolean

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

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

manuals

Type: OfferMediaFileDTO[]

产品使用指南。
产品的媒体文件的信息。

Min items: 1

pictures

Type: OfferMediaFileDTO[]

产品图像。
产品的媒体文件的信息。

Min items: 1

videos

Type: OfferMediaFileDTO[]

产品的视频文件。
产品的媒体文件的信息。

Min items: 1

OfferParamDTO

产品参数。

如果产品具有相同参数的多个值，则使用相同的值发送它们 name，但不同 value.

例子：
"params": [
  {
    "name": "Цвет для фильтра",
    "value": "Зеленый"
  },
  {
    "name": "Цвет для фильтра",
    "value": "Желтый"
  }
]

Name

Description

name*

Type: string

特性的名称。

它必须与市场上的功能名称相匹配。 您可以从类别的Excel模板或通过查询找到它。 POST v2/category/{categoryId}/parameters.

Example: Wi-Fi

Max length: 200

value*

Type: string

意义。

Example: есть

OfferSellingProgramDTO

关于哪些型号可以用于销售产品以及哪些型号不能使用的信息。

Name

Description

sellingProgram*

Type: SellingProgramType

安置模式:

  • FBY -FBY。
  • FBS -FBS。
  • DBS -DBS。
  • EXPRESS -快递。

Enum: FBY, FBS, DBS, EXPRESS, LAAS

status*

Type: OfferSellingProgramStatusType

Информация о том, можно ли по этой модели продавать товар.

Enum: FINE, REJECT

OfferType

特殊类型的产品:

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

如果你的产品是一本书

在产品规格中指定发布年份。 有关参数的更多信息

Type

Description

OfferType

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

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

ShowcaseType

展柜类型:

Type

Description

ShowcaseType

Enum: B2B, B2C

CurrencyType

货币代码:

  • RUR -俄罗斯卢布。
  • UAH -乌克兰格里夫纳。
  • BYR -白俄罗斯卢布。
  • KZT -哈萨克斯坦坚戈。
  • UZS -乌兹别克总和。

Type

Description

CurrencyType

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

AgeUnitType

年龄测量单位:

  • YEAR -一年。
  • MONTH -一个月。

Type

Description

AgeUnitType

Enum: YEAR, MONTH

OfferCampaignStatusType

产品状况:

  • PUBLISHED -准备出售。
  • CHECKING -检查时。
  • DISABLED_BY_PARTNER -被你藏起来了
  • REJECTED_BY_MARKET -被拒绝。
  • DISABLED_AUTOMATICALLY -修正错误。
  • CREATING_CARD -正在创建一张卡片。
  • NO_CARD -我需要一张卡片
  • NO_STOCKS -没有存货。
  • ARCHIVED -在档案中。

每个状态意味着什么？

Type

Description

OfferCampaignStatusType

Enum: PUBLISHED, CHECKING, DISABLED_BY_PARTNER, DISABLED_AUTOMATICALLY, REJECTED_BY_MARKET, CREATING_CARD, NO_CARD, NO_STOCKS, ARCHIVED

CommodityCodeType

产品代码类型:

  • CUSTOMS_COMMODITY_CODE -外国经济活动统一商品命名法（HS）中的产品代码为10或14位数字，不带空格。
  • IKPU_CODE -乌兹别克斯坦产品和服务的识别码为17位，不含空格。

不要发送相同类型的多个代码。

Type

Description

CommodityCodeType

Enum: CUSTOMS_COMMODITY_CODE, IKPU_CODE

OfferConditionQualityType

产品外观:

  • PERFECT -完美。
  • EXCELLENT -太好了。
  • GOOD -一个好的。
  • NOT_SPECIFIED -未选择。

Type

Description

OfferConditionQualityType

Enum: PERFECT, EXCELLENT, GOOD, NOT_SPECIFIED

OfferConditionType

标记类型:

  • PREOWNED -曾经属于另一个人的二手货。
  • SHOWCASESAMPLE -展示样品。
  • REFURBISHED -产品的再销售。
  • REDUCTION -有缺陷的产品。
  • RENOVATED -恢复产品。
  • NOT_SPECIFIED -未选择。

REFURBISHED -衣服，鞋子和配饰的特殊价值。 它仅用于此类别的折扣产品。 不使用服装、鞋和配件的其他值。

Type

Description

OfferConditionType

Enum: PREOWNED, SHOWCASESAMPLE, REFURBISHED, REDUCTION, RENOVATED, NOT_SPECIFIED

TimeUnitType

时间测量单元:

  • HOUR "一个小时。"
  • DAY -一天。
  • WEEK -一周
  • MONTH -一个月。
  • YEAR -一年。

Type

Description

TimeUnitType

Enum: HOUR, DAY, WEEK, MONTH, YEAR

OfferMediaFileDTO

产品的媒体文件的信息。

Name

Description

title

Type: string

媒体文件的名称。

uploadState

Type: MediaFileUploadStateType

Состояние загрузки медиафайла.

Enum: UPLOADING, UPLOADED, FAILED

url

Type: string

媒体文件的链接。

Min length: 1

Max length: 2000

SellingProgramType

安置模式:

  • FBY -FBY。
  • FBS -FBS。
  • DBS -DBS。
  • EXPRESS -快递。

Type

Description

SellingProgramType

Enum: FBY, FBS, DBS, EXPRESS, LAAS

OfferSellingProgramStatusType

可用性或不可用性的信息。

  • FINE -可用。
  • REJECT -没有。

Type

Description

OfferSellingProgramStatusType

Enum: FINE, REJECT

MediaFileUploadStateType

媒体文件下载状态:

  • UPLOADING -装货了
  • UPLOADED -成功上传。
  • FAILED -上传时发生错误。 请稍后再试。

Type

Description

MediaFileUploadStateType

Enum: UPLOADING, UPLOADED, FAILED

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

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

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 и зарегистрировать товары.

上一篇
编辑产品类别特征
下一篇
在商店里