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

Info

Console

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

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

offers-and-cards-management — 商品和卡片管理
all-methods — 全面管理账户

将产品添加到目录并传输:

他们的叶子类别 关于市场和分类特征;
主要特点;
商品在橱柜的价格。

它还结合卡上的产品，编辑和删除有关已添加产品的信息，包括机柜和产品类别中的价格。

您可以使用请求获取市场类别列表。 POST v2/categories/tree，以及按类别使用的产品特性 POST v2/category/{categoryId}/parameters.

添加新产品

使用以前从未在文件夹中使用过的新ID传输它。

请务必指定参数: offerId, name, marketCategoryId, pictures, vendor, description.

尝试一次传达尽可能多的信息 — 市场将需要它来选择合适的卡或创建一个新的。

如果您知道市场上的哪张卡对应的产品，您可以立即指定此卡的ID（SKU 在市场上）在现场 marketSKU.

对于Yandex Go市场的卖家:

将产品添加到目录时，请指定参数值 name 和 description 用俄语。要在展柜上以不同的语言显示它们，请再次提出请求。 POST v2/businesses/{businessId}/offer-mappings/update 在哪里指定:

参数中的语言 language;
参数值 name 和 description 在指定的语言。

不需要重新传输剩余的产品特性。

更改产品信息

通过指定in发送新数据 offerId SKU 产品在您的系统中。

可以省略任何更改的字段。

删除以前传输的产品参数

在 deleteParameters 指定要删除的参数值。您可以一次传递多个值。

对于具有类型的参数 string 您也可以传递空值。

参数 offerId (SKU 您系统中的产品）必须是 独特的 对于您转移的所有产品。

使用规则 SKU

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

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

目录中的数据不会立即更新

最多需要几分钟。

⚙️ 限制: 每分钟10,000个产品，每个请求不超过100个产品

Request

POST

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

Path parameters

Name

Description

businessId*

Type: integer<int64>

内阁ID。要找到答案，请使用请求 GET v2/campaigns.

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

Min value: 1

Query parameters

Name

Description

language

Type: CatalogLanguageType

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

默认值: RU.

CatalogLanguageType

语言:

RU — 俄语。
UZ — 乌兹别克。

Type	Description
CatalogLanguageType	Enum: `RU`, `UZ`

Body

application/json

{
    "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": "есть"
                    }
                ],
                "parameterValues": [
                    {
                        "parameterId": 0,
                        "unitId": 0,
                        "valueId": 0,
                        "value": "string"
                    }
                ],
                "basicPrice": {
                    "value": 0,
                    "currencyId": "RUR",
                    "discountBase": 0
                },
                "purchasePrice": {
                    "value": 0,
                    "currencyId": "RUR"
                },
                "additionalExpenses": {
                    "value": 0,
                    "currencyId": "RUR"
                },
                "firstVideoAsCover": false,
                "deleteParameters": [
                    "ADDITIONAL_EXPENSES"
                ]
            },
            "mapping": {
                "marketSku": 0
            }
        }
    ],
    "onlyPartnerMediaContent": false
}

Name

Description

offerMappings*

Type: UpdateOfferMappingDTO[]

需要添加或更新的产品列表。

我们将很快减少每个请求的最大产品数量.

现在不要发送超过100。

产品信息。

Min items: 1

Max items: 500

onlyPartnerMediaContent

Type: boolean

是否只会使用您提供的产品数据。

默认值: false. 要删除市场添加的数据，请传递值 true.

UpdateOfferMappingDTO

产品信息。

Name

Description

offer*

Type: UpdateOfferDTO

Параметры товара.
产品的主要参数。

mapping

Type: UpdateMappingDTO

Информация о карточке товара на Маркете.

UpdateOfferDTO

产品参数。

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: BasePriceDTO

品的价格。

adult

Type: boolean

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

age

Type: AgeDTO

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

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

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

basicPrice

Type: PriceWithDiscountDTO

价格与折扣指示.
品的价格。

boxCount

Type: integer<int32>

货位的数量。

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

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

Min value: 1

category

⦸

Type: string

相反，使用 marketCategoryId.

您商店中的产品类别。

certificates

Type: string[]

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

你只可将文件编号传送至商户的办公室，而文件编号的扫描资料则由指示说明.

Min items: 1

Max items: 6

Unique items

commodityCodes

Type: CommodityCodeDTO[]

产品代码。
产品代码。

Min items: 1

condition

Type: OfferConditionDTO

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

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

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

customsCommodityCode

⦸

Type: string

相反，使用 commodityCodes 与类型 CUSTOMS_COMMODITY_CODE.

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

一定要指出是否有。

Example: 8517610008

deleteParameters

Type: DeleteOfferParameterType[]

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

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

您可以一次传递多个值。

不要与相应的参数一起使用 UpdateOfferDTO. 这将导致错误。 400.
要删除的参数的值和相应的参数 UpdateOfferDTO 您之前传递这些值的方式:

ADDITIONAL_EXPENSES — 额外的产品成本（参数 additionalExpenses).
ADULT — 标记18+(参数 adult)
AGE — 儿童年龄限制（参数 age).
BARCODES — 条码(参数 barcodes).
BOX_COUNT — 货位数（参数 boxCount).
CERTIFICATES — 产品文档编号（参数 certificates).
COMMODITY_CODES — 产品代码（参数 commodityCodes).
CONDITION — 折扣产品的条件（参数 condition).
CUSTOMS_COMMODITY_CODE — HS代码中的产品代码（参数 customsCommodityCode).
DESCRIPTION — 产品说明（参数 description).
DOWNLOADABLE — 数字产品属性（参数 downloadable).
GUARANTEE_PERIOD — 保修期（参数 guaranteePeriod).
LIFE_TIME — 使用寿命（参数 lifeTime).
MANUALS — 产品使用说明列表（参数 manuals).
MANUFACTURER_COUNTRIES — 制造国家（参数 manufacturerCountries).
PARAMETERS — 产品特性（参数 params, parameterValues).
PICTURES — 产品图片链接（参数 pictures).
PURCHASE_PRICE — 成本价格（参数 purchasePrice).
SHELF_LIFE — 到期日期（参数 shelfLife).
TAGS — 商店使用的产品标签（参数 tags).
TYPE — 一种特殊类型的产品（参数 type).
VENDOR_CODE — 品牌或制造商的名称（参数 vendorCode).
VIDEOS — 产品视频链接（参数 videos).

Enum: ADDITIONAL_EXPENSES, ADULT, AGE, BARCODES, BOX_COUNT, CERTIFICATES, COMMODITY_CODES, CONDITION, CUSTOMS_COMMODITY_CODE, DESCRIPTION, DOWNLOADABLE, GUARANTEE_PERIOD, LIFE_TIME, MANUALS, MANUFACTURER_COUNTRIES, PARAMETERS, PICTURES, PURCHASE_PRICE, SHELF_LIFE, TAGS, TYPE, VENDOR_CODE, VIDEOS

Min items: 1

Unique items

description

Type: string

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

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

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

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

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

建议和规则

Max length: 6000

downloadable

Type: boolean

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

如何使用数字商品

firstVideoAsCover

⦸

Type: boolean

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

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

guaranteePeriod

Type: TimePeriodDTO

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

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

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

lifeTime

Type: TimePeriodDTO

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

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

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

manuals

Type: OfferManualDTO[]

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

Min items: 1

Max items: 6

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

name

Type: string

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

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

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

建议和规则

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

Max length: 256

parameterValues

Type: ParameterValueDTO[]

具有其值的特征列表。

始终与 marketCategoryId

如果你不通过它 marketCategoryId 当特征发生变化时，它们将被更新，但在响应中会收到警告（参数 warnings).

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

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

要删除给定特性的值，传递它 parameterId 与一个空 value.
特性的值。

您可以为同一特性指定多个值，前提是:

特征类型 — ENUM.
响应请求 POST v2/category/{categoryId}/parameters 这个特性有一个领域 multivalue 这很重要 true.

要做到这一点，在 parameterValues 分别传递每个值 — 带参数的多个对象 parameterId, valueId 和 value. 参数 parameterId 它必须是相同的。

Min items: 1

Max items: 300

params

⦸

Type: OfferParamDTO[]

传输特性时，使用 parameterValues.

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

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

例子：

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

Min items: 1

pictures

Type: string[]

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

连结要求

指定整个链接，包括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 length: 1

Max length: 2000

Min items: 1

Max items: 30

Unique items false

purchasePrice

Type: BasePriceDTO

品的价格。

shelfLife

Type: TimePeriodDTO

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

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

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

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

UpdateMappingDTO

从您的角度来看，市场上适合产品的卡片。要确定相应卡的ID，请使用机柜中的搜索（产品中心 → 目录 → 上传产品).

根据验证结果，市场可以将产品链接到更合适的卡。

Name

Description

marketSku

Type: integer<int64>

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

Min value: 1

BasePriceDTO

品的价格。

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

value*

Type: number

品的价格。

Min value (exclusive): 0

AgeDTO

年龄在指定的测量单位。

Name

Description

ageUnit*

Type: AgeUnitType

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

Enum: YEAR, MONTH

value*

Type: number

意义。

Min value: 0

PriceWithDiscountDTO

价格与折扣指示.

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`
value*	Type: number 品的价格。 Min value (exclusive): `0`
discountBase	Type: number 划掉的价格。数字必须是整数。您可以指定折扣从5到99％的价格。如果您提供产品折扣，则在每次更新价格时传递此参数。 Min value (exclusive): `0`

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`

DeleteOfferParameterType

要删除的参数的值和相应的参数 UpdateOfferDTO 您之前传递这些值的方式:

ADDITIONAL_EXPENSES — 额外的产品成本（参数 additionalExpenses).
ADULT — 标记18+(参数 adult)
AGE — 儿童年龄限制（参数 age).
BARCODES — 条码(参数 barcodes).
BOX_COUNT — 货位数（参数 boxCount).
CERTIFICATES — 产品文档编号（参数 certificates).
COMMODITY_CODES — 产品代码（参数 commodityCodes).
CONDITION — 折扣产品的条件（参数 condition).
CUSTOMS_COMMODITY_CODE — HS代码中的产品代码（参数 customsCommodityCode).
DESCRIPTION — 产品说明（参数 description).
DOWNLOADABLE — 数字产品属性（参数 downloadable).
GUARANTEE_PERIOD — 保修期（参数 guaranteePeriod).
LIFE_TIME — 使用寿命（参数 lifeTime).
MANUALS — 产品使用说明列表（参数 manuals).
MANUFACTURER_COUNTRIES — 制造国家（参数 manufacturerCountries).
PARAMETERS — 产品特性（参数 params, parameterValues).
PICTURES — 产品图片链接（参数 pictures).
PURCHASE_PRICE — 成本价格（参数 purchasePrice).
SHELF_LIFE — 到期日期（参数 shelfLife).
TAGS — 商店使用的产品标签（参数 tags).
TYPE — 一种特殊类型的产品（参数 type).
VENDOR_CODE — 品牌或制造商的名称（参数 vendorCode).
VIDEOS — 产品视频链接（参数 videos).

Type	Description
DeleteOfferParameterType	Enum: `ADDITIONAL_EXPENSES`, `ADULT`, `AGE`, `BARCODES`, `BOX_COUNT`, `CERTIFICATES`, `COMMODITY_CODES`, `CONDITION`, `CUSTOMS_COMMODITY_CODE`, `DESCRIPTION`, `DOWNLOADABLE`, `GUARANTEE_PERIOD`, `LIFE_TIME`, `MANUALS`, `MANUFACTURER_COUNTRIES`, `PARAMETERS`, `PICTURES`, `PURCHASE_PRICE`, `SHELF_LIFE`, `TAGS`, `TYPE`, `VENDOR_CODE`, `VIDEOS`

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

ParameterValueDTO

特性的值。

您可以为同一特性指定多个值，前提是:

特征类型 — ENUM.
响应请求 POST v2/category/{categoryId}/parameters 这个特性有一个领域 multivalue 这很重要 true.

要做到这一点，在 parameterValues 分别传递每个值 — 带参数的多个对象 parameterId, valueId 和 value. 参数 parameterId 它必须是相同的。

Name	Description
parameterId*	Type: integer<int64> 特性的标识符。 Min value: `1`
unitId	Type: integer<int64> 测量单位的ID。如果没有传递参数 `unitId`，使用默认的测量单位。
value	Type: string 意义。对于类型特征 `ENUM` 与...... `valueId`.
valueId	Type: integer<int64> 值的ID。如果要从从市场接收的可接受值列表中传输值，请务必指定标识符。与...... `value`. 仅针对类型特征 `ENUM`.

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: есть

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`

CurrencyType

货币代码:

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

Type

Description

CurrencyType

AgeUnitType

年龄测量单位:

YEAR — 年。
MONTH — 月份。

Type	Description
AgeUnitType	Enum: `YEAR`, `MONTH`

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`

Responses

200 OK

请求已正确执行，并且数据已被处理。

回答 200 就其本身而言，它并不意味着传递的值是正确的。

请务必查看响应的详细信息。: status 和错误列表，如果有的话。

即使仅在一个产品的特性中出现错误，也不会在目录中包含来自请求的任何更改。

Body

application/json

{
    "status": "OK",
    "results": [
        {
            "offerId": "string",
            "errors": [
                {
                    "type": "UNKNOWN_CATEGORY",
                    "parameterId": 0,
                    "message": "string"
                }
            ],
            "warnings": [
                {
                    "type": "UNKNOWN_CATEGORY",
                    "parameterId": 0,
                    "message": "string"
                }
            ]
        }
    ]
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

results

Type: UpdateOfferMappingResultDTO[]

处理特征列表时出现的错误和警告。列表中的每个项目对应一个产品。

如果没有错误或警告，则不传递该字段。
传输的特性而出现的错误和警告。

Min items: 1

ApiResponseStatusType

响应的类型。可能的值:

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

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

UpdateOfferMappingResultDTO

传输的特性而出现的错误和警告。

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}$`
errors	Type: OfferMappingErrorDTO[] 错误。如果至少有一个产品出现错误，目录中的信息将不会更新所有传输的产品。错误或警告的文本。 Min items: `1`
warnings	Type: OfferMappingErrorDTO[] 警告。目录中的信息将被更新。错误或警告的文本。 Min items: `1`

OfferMappingErrorDTO

错误或警告的文本。

Name	Description
message*	Type: string 错误或警告的文本。
type*	Type: OfferMappingErrorType 错误和警告的类型: `UNKNOWN_CATEGORY` — 指定未知类别。 `INVALID_CATEGORY` — 指定了非叶类别。指定没有子类别的类别。 `EMPTY_MARKET_CATEGORY` — 在传送类别特征时不指定市场类别。 `UNKNOWN_PARAMETER` — 已经传输了不属于该类别特征的特征。 `UNEXPECTED_BOOLEAN_VALUE` — 传递其他内容而不是布尔值。 `NUMBER_FORMAT` — 传递的字符串不代表数字，而不是数字。 `INVALID_UNIT_ID` — 特性不可接受的测量单位已经通过。 `INVALID_GROUP_ID_LENGTH` — 名称中超出允许的字符值 — 255. `INVALID_GROUP_ID_CHARACTERS` — 通过无效字符. `INVALID_PICKER_URL` — 已传输到缩略图图像的链接，该链接不包括在传输到产品图像的链接中。 `LOCKED_DIMENSIONS` — 包装的尺寸已转移，无法更改。 `INVALID_COMMODITY_CODE` — 传送了不正确的产品代码。您可以检查哪些类别特征可用于给定类别，并使用请求获取其设置。 POST v2/category/{categoryId}/parameters. Enum: `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `EMPTY_MARKET_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`, `INVALID_PICKER_URL`, `LOCKED_DIMENSIONS`, `INVALID_COMMODITY_CODE`
parameterId	Type: integer<int64> 与错误或警告相关联的功能的ID。

OfferMappingErrorType

错误和警告的类型:

UNKNOWN_CATEGORY — 指定未知类别。
INVALID_CATEGORY — 指定了非叶类别。指定没有子类别的类别。
EMPTY_MARKET_CATEGORY — 在传送类别特征时不指定市场类别。
UNKNOWN_PARAMETER — 已经传输了不属于该类别特征的特征。
UNEXPECTED_BOOLEAN_VALUE — 传递其他内容而不是布尔值。
NUMBER_FORMAT — 传递的字符串不代表数字，而不是数字。
INVALID_UNIT_ID — 特性不可接受的测量单位已经通过。
INVALID_GROUP_ID_LENGTH — 名称中超出允许的字符值 — 255.
INVALID_GROUP_ID_CHARACTERS — 通过无效字符.
INVALID_PICKER_URL — 已传输到缩略图图像的链接，该链接不包括在传输到产品图像的链接中。
LOCKED_DIMENSIONS — 包装的尺寸已转移，无法更改。
INVALID_COMMODITY_CODE — 传送了不正确的产品代码。

您可以检查哪些类别特征可用于给定类别，并使用请求获取其设置。 POST v2/category/{categoryId}/parameters.

Type	Description
OfferMappingErrorType	Enum: `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `EMPTY_MARKET_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`, `INVALID_PICKER_URL`, `LOCKED_DIMENSIONS`, `INVALID_COMMODITY_CODE`

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

423 Locked

指定的方法不能应用于资源。有关错误的更多信息

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

这篇文章是否有用？

按类别列出的产品特性

更改销售条款