单位标记代码的转移

方法适用于模式DBS.

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

如果你按照模型工作 FBS

将产品单元的标签代码按指定顺序传送到市场。

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

接受以下类型的代码:

在使用此方法之前

对于需要标签的顺序中的每个项目,您需要发送一个代码列表,每个项目一个。 例如,如果订单中有两双拖鞋和一双鞋子,您将获得第一个位置的两个代码列表和第二个位置的一个代码列表。

**⚙️ 限制:**每小时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] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:

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

,不要发送商店的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} -参数 iditems.

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/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

响应的类型。 可能的值:

  • 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/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

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

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.

Значение 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}))$.