单位标记代码的转移
方法适用于模式DBS.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
- inventory-and-order-processing — 订单处理和商品核算
- all-methods — 全面管理账户
如果你按照模型工作 FBS
将产品单元的标签代码按指定顺序传送到市场。
系统中货物的标签 «Честный ЗНАК» 可选择的 对于来自个人的命令,但 需要 用于商业订单。
接受以下类型的代码:
- 系统中的代码 «Честный ЗНАК» 或 «ASL BELGISI» (对于卖家 Market Yandex Go).
- 赢得珠宝。
- 进口可追溯货物的RNPT和GTD.
在使用此方法之前
请务必阅读 一篇关于处理标签商品的文章.
对于需要标签的顺序中的每个项目,您需要发送一个代码列表,每个项目一个。 例如,如果订单中有两双拖鞋和一双鞋子,您将获得第一个位置的两个代码列表和第二个位置的一个代码列表。
**⚙️ 限制:**每小时100,000次请求 |
---|
Request
PUT
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/identifiers
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> 活动ID。 您可以使用查询找到它 :no-translate[GET v2/campaigns] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:
,不要发送商店的ID,而不是,这是在卖方的帐户在市场上的商店名称旁边和一些报告。
Min value: |
orderId* |
Type: integer<int64> 的订单ID。 |
Body
application/json
{
"items": [
{
"id": 0,
"instances": [
{
"cis": "string",
"uin": "string",
"rnpt": "string",
"gtd": "string",
"countryCode": "RU"
}
]
}
]
}
Name |
Description |
items* |
Type: OrderItemInstanceModificationDTO[] 需要标注的项目列表。
|
OrderItemInstanceModificationDTO
购物车中需要贴标签的物品。
Name |
Description |
id* |
Type: integer<int64> 订单中的产品ID。 它是为了响应一个请求 GET v2/campaigns/{campaignId}/orders/{orderId} -参数 |
instances* |
Type: BriefOrderItemInstanceDTO[] 项标注代码的列表。
只填写一个字段,具体取决于产品标记在哪个系统中。 提供了有关使用标签商品的详细信息 在市场对卖家的帮助. |
BriefOrderItemInstanceDTO
产品单元ID。
只填写一个字段,具体取决于产品标记在哪个系统中。
提供了有关使用标签商品的详细信息 在市场对卖家的帮助.
Name |
Description |
cis |
Type: string 识别码 系统中的产品单元 "诚实的标志" 或 "ASL BELGISI" (对于Yandex Go市场的卖家)。 不要转义分隔符代码中的斜杠。 ✅ ❌ 根据JSON规则在其他地方转义斜杠和引号。: |
countryCode |
Type: string 生产国采用ISO3166-1alpha-2格式。 如何获得 Example: Min length: Max length: Pattern: |
gtd |
Type: string 货物报关。 它是由斜杠分隔的三个数字组成的字符串:XXXXXXX/XXXXXXXXX/XXXXXXXXXXX。 第一部分是登记进口货物申报的海关编码。 接下来是声明的日期和编号。 |
rnpt |
Type: string 品批次的注册号。 它是由斜杠分隔的四个数字组成的字符串:XXXXXXX/XXXXXXX/XXXXXXXXX/XXX。 第一部分是注册货物申报的海关办公室的代码。 接下来是日期、声明编号以及声明中标记产品的编号。 |
uin |
Type: string 珠宝的唯一标识号。 这是一个16位数字。 |
Responses
200 OK
回答 200
表示代码已成功记录。 响应包含有关标记产品的简要信息。
Body
application/json
{
"status": "OK",
"result": {
"items": [
{
"id": 0,
"vat": "NO_VAT",
"count": 0,
"price": 0,
"offerName": "string",
"offerId": "string",
"instances": [
{
"cis": "string",
"cisFull": "string",
"uin": "string",
"rnpt": "string",
"gtd": "string",
"countryCode": "RU"
}
]
}
]
}
}
Name |
Description |
status* |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
result |
Type: OrderItemsModificationResultDTO 标商品的简要信息。 如果响应为 |
ApiResponseStatusType
响应的类型。 可能的值:
OK
-没有错误。ERROR
-处理请求时发生错误。
Type |
Description |
Enum: |
OrderItemsModificationResultDTO
标商品的简要信息。 如果响应为 OK
.
Name |
Description |
items* |
Type: BriefOrderItemDTO[] 要标记的顺序的项目列表。 |
BriefOrderItemDTO
有关标记产品的信息。
Name |
Description |
count |
Type: integer<int32> 积单元的数量。 |
id |
Type: integer<int64> 订单中的产品ID。 允许您在此订单范围内识别产品。 |
instances |
Type: OrderItemInstanceDTO[] 您提供的标记代码。 Min items: |
offerId |
Type: string Ваш идентификатор товара. Min length: Max length: Pattern: |
offerName |
Type: string 产品名称。 |
price |
Type: number 品的价格。 它以目录中指定的货币指定。 整体和小数部分的分隔符是一个点。 |
vat |
Type: OrderVatType 产品的增值税(VAT):
仅与参数结合使用 Enum: |
OrderItemInstanceDTO
您为此职位提供的标记或故障代码。 "诚实的标志"代码以两个版本返回—有和没有密码。
Name |
Description |
cis |
Type: string 系统中的单元识别码 "诚实的标志" 没有密码或 "ASL BELGISI" (对于Yandex Go市场的卖家)。 |
cisFull |
Type: string 系统中的单元识别码 "诚实的标志" 用一个密码。 |
countryCode |
Type: string 生产国采用ISO3166-1alpha-2格式。 如何获得 Example: Min length: Max length: Pattern: |
gtd |
Type: string 货物报关。 它是由斜杠分隔的三个数字组成的字符串:XXXXXXX/XXXXXXXXX/XXXXXXXXXXX。 第一部分是登记进口货物申报的海关编码。 接下来是声明的日期和编号。 |
rnpt |
Type: string 品批次的注册号。 它是由斜杠分隔的四个数字组成的字符串:XXXXXXX/XXXXXXX/XXXXXXXXX/XXX。 第一部分是注册货物申报的海关办公室的代码。 接下来是日期、声明编号以及声明中标记产品的编号。 |
uin |
Type: string 珠宝的UIN(16位数字代码) 当制造商在贵金属和宝石周转控制系统中注册产品时,制造商会收到UIN—GIIS DMDK。 |
OrderVatType
产品的增值税(VAT):
-
NO_VAT
-不收取增值税,仅用于某些类型的服务。 -
VAT_0
-0%增值税。 例如,在出口海关程序中销售出口货物时,或为国际货物运输提供服务时使用。 -
VAT_10
-10%增值税。 例如,它用于销售某些食品和医疗产品。 -
VAT_10_110
-增值税 10/110. 10%增值税,仅适用于预付款。 -
VAT_20
-20%增值税。 基本增值税从2019年开始。 -
VAT_20_120
-增值税 20/120. 增值税为20%,仅适用于预付款。 -
VAT_18
-增值税18%。 基本增值税至2019年。 -
VAT_18_118
-增值税 18/118. 增值税用于预付款,直到2019年1月1日。 -
VAT_12
-12%增值税。 它仅在乌兹别克斯坦使用。 -
VAT_05
-5%增值税。 简化税制(USN)的增值税。 -
VAT_07
-7%增值税。 简化税制(USN)的增值税。 -
UNKNOWN_VALUE
-未知类型。
仅与参数结合使用 付款方法=氨纶
.
Type |
Description |
Enum: |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
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: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
Yandex的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.
Значение cis
должно соответствовать регулярному выражению ^(?=.{1,256}$)\u001D?(\(?01\)?\d{14}\(?21\)?([!-~]{6,8}|[!-~]{13}|[!-~]{20})(\u001D\(?240\)?.{1,30})?\u001D\(?9[1,3]\)?.+)$
.
Без криптохвоста — ^(?=[!-~]{1,256}$)(\(?01\)?\d{14}\(?21\)?(.{6,8}|.{13}|.{20}))$
.