单位标记代码的转移

方法适用于模式DBS.

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

如果你按照模型工作 FBS

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

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

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

对于模型 DBS 系统中的标记代码 «Честный ЗНАК» 未在GIS MT中检查 — 仅对模型执行验证 FBS 和 Express.

接受以下类型的代码:

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

⚙️ 限制: 每小时100,000次请求

Request

PUT

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/identifiers

Path parameters

Name

Description

campaignId

Type: integer

广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。

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

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

⚠️ 不要把它与:

  • 商店的标识符，显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

orderId

Type: integer

的订单ID。

Body

application/json
{
  "items": [
    {
      "id": 0,
      "instances": [
        {
          "cis": "example",
          "uin": "example",
          "rnpt": "example",
          "gtd": "example",
          "countryCode": "RU"
        }
      ]
    }
  ]
}

Name

Description

items
Type: object[]

id

Type: integer

订单中的产品ID。

它来自方法的响应 POST v1/businesses/{businessId}/orders — 参数 id 在 items.

instances
Type: object[]

cis

Type: string

识别码 系统中的产品单元 "诚实的标志" 或 "ASL BELGISI" （对于Yandex Go市场的卖家）。

不要转义分隔符代码中的斜杠。 \u001d

✅ 01030410947874432155Qbag！\u001d93Zjqw

❌ 01030410947874432155Qbag！\\u001d93Zjqw

根据JSON规则在其他地方转义斜杠和引号。: \\ 和 \"

Example: example

countryCode

Type: string

生产国采用ISO3166-1alpha-2格式。 如何获得

Min length: 2

Max length: 2

Pattern: ^[A-Z]{2}$

Example: RU

gtd

Type: string

货物报关。

它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXXXXXX。

第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。

Example: example

rnpt

Type: string

品批次的注册号。

它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/XXX。

第一部分 — 登记货物申报的海关办公室的代码。 进一步 — 声明的日期、编号和声明中标记产品的编号。

Example: example

uin

Type: string

珠宝的唯一标识号。

这是一个16位数字。

Example: example

项标注代码的列表。

Example
[
  {
    "cis": "example",
    "uin": "example",
    "rnpt": "example",
    "gtd": "example",
    "countryCode": "RU"
  }
]

需要标注的项目列表。

Example
[
  {
    "id": 0,
    "instances": [
      {
        "cis": "example",
        "uin": "example",
        "rnpt": "example",
        "gtd": "example",
        "countryCode": "RU"
      }
    ]
  }
]

Responses

200 OK

回答 200 表示代码已成功记录。 响应包含有关标记产品的简要信息。

Body

application/json
{
  "status": "OK",
  "result": {
    "items": [
      {
        "id": 0,
        "vat": "NO_VAT",
        "count": 0,
        "price": 0.5,
        "offerName": "example",
        "offerId": "example",
        "instances": [
          null
        ]
      }
    ]
  }
}

Type: object

All of 2 types
  • Type: object

    status

    Type: string

    响应的类型。 可能的值:

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

    Enum: OK, ERROR

    服务器响应的标准包装器。

    Example
    {
  "status": "OK"
}
  • Type: object

    result
    Type: object

    items
    Type: object[]

    count

    Type: integer

    积单元的数量。

    id

    Type: integer

    订单中的产品ID。

    允许您在订单中识别产品。

    instances
    Type: object[]

    cis

    Type: string

    系统中的单元识别码 "诚实的标志" 没有密码或 "ASL BELGISI" （对于Yandex Go市场的卖家）。

    Example: example

    cisFull

    Type: string

    系统中的单元识别码 "诚实的标志" 用密码锁。

    Example: example

    countryCode

    Type: string

    生产国采用ISO3166-1alpha-2格式。 如何获得

    Min length: 2

    Max length: 2

    Pattern: ^[A-Z]{2}$

    Example: RU

    gtd

    Type: string

    货物报关。

    它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXXXXXX。

    第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。

    Example: example

    rnpt

    Type: string

    品批次的注册号。

    它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/XXX。

    第一部分 — 登记货物申报的海关办公室的代码。 进一步 — 声明的日期、编号和声明中标记产品的编号。

    Example: example

    uin

    Type: string

    珠宝的UIN(16位数字代码) 当制造商在贵金属和宝石的周转控制系统中注册产品时，他会获得胜利。 — GIIS DMDK。

    Example: example

    传输的标记代码。

    Min items: 1

    Example
    [
  {
    "cis": "example",
    "cisFull": "example",
    "uin": "example",
    "rnpt": "example",
    "gtd": "example",
    "countryCode": "RU"
  }
]

    offerId

    Type: string

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

    使用规则 SKU:

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

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

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

    重要

    值开头和结尾的空格会自动删除。 例如, " SKU123 " 和 "SKU123" 它们将被视为相同的值。

    什么是 SKU 以及如何分配它

    Min length: 1

    Max length: 255

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

    Example: example

    offerName

    Type: string

    产品名称。

    Example: example

    price

    Type: number

    品的价格。 它以目录中指定的货币指定。 整数和小数部分的分隔符 — 点。

    vat

    Type: string

    产品或交付的增值税:

    • NO_VAT — 增值税不收取，它仅用于某些类型的服务。

    • VAT_0 — 0%增值税。 例如，它用于销售在出口海关程序中出口的货物，或为国际货物运输提供服务。

    • VAT_10 — 10%增值税。 例如，它用于销售某些食品和医疗产品。

    • VAT_10_110 — 增值税 10/110. 10%增值税，仅适用于预付款。

    • VAT_20 — 增值税20%。 基本增值税从2019年到2026年1月1日。

    • 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）的增值税。

    • VAT_22 — 增值税是22％。 基本增值税从2026年1月1日开始。

    • 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, VAT_22, UNKNOWN_VALUE

    要标记的顺序的项目列表。

    Example
    [
  {
    "id": 0,
    "vat": "NO_VAT",
    "count": 0,
    "price": 0.5,
    "offerName": "example",
    "offerId": "example",
    "instances": [
      {
        "cis": "example",
        "cisFull": "example",
        "uin": "example",
        "rnpt": "example",
        "gtd": "example",
        "countryCode": "RU"
      }
    ]
  }
]

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

    Example
    {
  "items": [
    {
      "id": 0,
      "vat": "NO_VAT",
      "count": 0,
      "price": 0.5,
      "offerName": "example",
      "offerId": "example",
      "instances": [
        {
          "cis": "example",
          "cisFull": "example",
          "uin": "example",
          "rnpt": "example",
          "gtd": "example",
          "countryCode": "RU"
        }
      ]
    }
  ]
}
    Example
    {
  "result": {
    "items": [
      {
        "id": 0,
        "vat": "NO_VAT",
        "count": 0,
        "price": 0.5,
        "offerName": "example",
        "offerId": "example",
        "instances": [
          {}
        ]
      }
    ]
  }
}

400 Bad Request

请求包含不正确的数据。 详细了解处理订单时的错误

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

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

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

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

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

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

上一篇
订单状态的巨大变化
下一篇
标记代码验证状态