单位标记代码的转移

Info

Console

方法适用于模式DBS.

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

inventory-and-order-processing — 订单处理和商品核算
all-methods — 全面管理账户

如果你按照模型工作 FBS

使用方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

将产品单元的标签代码按指定顺序传送到市场。有关使用带标签产品的详细信息，请参阅卖方在市场上的信息.

系统中货物的标签 «Честный ЗНАК» 可选择的 对于来自个人的命令，但需要用于商业订单。

接受以下类型的代码:

系统中的代码 «Честный ЗНАК» 或 «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。

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

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

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

Min value: 1

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} — 参数 id 在 items.

instances*

Type: BriefOrderItemInstanceDTO[]

项标注代码的列表。
产品单元ID。

只填写一个字段，具体取决于产品标记在哪个系统中。

提供了有关使用标签商品的详细信息在市场对卖家的帮助.

BriefOrderItemInstanceDTO

产品单元ID。

只填写一个字段，具体取决于产品标记在哪个系统中。

提供了有关使用标签商品的详细信息在市场对卖家的帮助.

Name	Description
cis	Type: string 识别码系统中的产品单元 "诚实的标志" 或 "ASL BELGISI" （对于Yandex Go市场的卖家）。不要转义分隔符代码中的斜杠。 `\u001d` ✅ `01030410947874432155Qbag！\u001d93Zjqw` ❌ `01030410947874432155Qbag！\\u001d93Zjqw` 根据JSON规则在其他地方转义斜杠和引号。: `\\` 和 `\"`
countryCode	Type: string 生产国采用ISO3166-1alpha-2格式。如何获得 Example: `RU` Min length: `2` Max length: `2` Pattern: `^[A-Z]{2}$`
gtd	Type: string 货物报关。它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXXXX。第一部分 — 登记进口货物申报的海关代码。进一步 — 声明的日期和编号。
rnpt	Type: string 品批次的注册号。它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/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

响应的类型。可能的值:

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

Enum: OK, ERROR

result

Type: OrderItemsModificationResultDTO

标记的商品的简要信息。如果响应为 OK.

ApiResponseStatusType

响应的类型。可能的值:

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

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

OrderItemsModificationResultDTO

标记的商品的简要信息。如果响应为 OK.

Name

Description

items*

Type: BriefOrderItemDTO[]

要标记的顺序的项目列表。
有关标记产品的信息。

BriefOrderItemDTO

有关标记产品的信息。

Name	Description
count	Type: integer<int32> 积单元的数量。
id	Type: integer<int64> 订单中的产品ID。允许您在此订单范围内识别产品。
instances	Type: OrderItemInstanceDTO[] 您提供的标记代码。您为此职位提供的标记或故障代码。 "公平标志"代码以两个版本返回 — 有和没有密码。 Min items: `1`
offerId	Type: string Ваш идентификатор товара. Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
offerName	Type: string 产品名称。
price	Type: number 品的价格。它以目录中指定的货币指定。整数和小数部分的分隔符 — 点。
vat	Type: 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` — 未知类型。仅与参数结合使用 `付款方法=氨纶`. Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `VAT_12`, `VAT_05`, `VAT_07`, `UNKNOWN_VALUE`

OrderItemInstanceDTO

您为此职位提供的标记或故障代码。 "公平标志"代码以两个版本返回 — 有和没有密码。

Name	Description
cis	Type: string 系统中的单元识别码 "诚实的标志" 没有密码或 "ASL BELGISI" （对于Yandex Go市场的卖家）。
cisFull	Type: string 系统中的单元识别码 "诚实的标志" 用密码锁。
countryCode	Type: string 生产国采用ISO3166-1alpha-2格式。如何获得 Example: `RU` Min length: `2` Max length: `2` Pattern: `^[A-Z]{2}$`
gtd	Type: string 货物报关。它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXXXX。第一部分 — 登记进口货物申报的海关代码。进一步 — 声明的日期和编号。
rnpt	Type: string 品批次的注册号。它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/XXX。第一部分 — 登记货物申报的海关办公室的代码。进一步 — 声明的日期、编号和声明中标记产品的编号。
uin	Type: string 珠宝的UIN(16位数字代码) 当制造商在贵金属和宝石的周转控制系统中注册产品时，他就会获得胜利。 — 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
OrderVatType	Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `VAT_12`, `VAT_05`, `VAT_07`, `UNKNOWN_VALUE`

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

这篇文章是否有用？

订单状态的巨大变化

标记代码验证状态