# 订单准备
{% list tabs %}
- Info
**方法适用于模式：[FBS](https://yandex.com/dev/market/partner-api/doc/zh/overview/fbs.md), [Express](https://yandex.com/dev/market/partner-api/doc/zh/overview/express.md) 和 [DBS](https://yandex.com/dev/market/partner-api/doc/zh/overview/dbs.md).**
{% cut "**如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一**" %}
* inventory-and-order-processing — [订单处理和商品核算](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/inventory-and-order-processing.md)
* all-methods — 全面管理账户
{% endcut %}
{% note tip "Подходит и для DBS" %}
该请求旨在与 FBS-订单，但您可以使用它进行处理 DBS-订单，如果方便的话。
{% endnote %}
允许您执行三个操作:
* 向市场发送有关按箱配送货物的信息;
* 将产品的标签代码发送到市场;
* 从订单中删除一个项目,如果它没有库存.
如果您需要修复传输数据中的某些内容，只需重复请求即可。 — 在订单状态更改之前，您可以根据需要多次执行此操作。 **准备装运**. ⚠️ 如果您在打印和粘贴标签后更改布局，请不要忘记重新打印并再次粘贴。
{% cut "Как передать информацию о распределении товаров" %}
在此请求中，您需要向市场发送一个盒子列表，并指定每个盒子中的产品。 有两种类型的盒子:
* **含整个产品。** 这样的盒子可以包含任何种类的任何数量的物品。
* **含有产品的一部分。**此类盒子包含一种产品的一部分。 例如，一个包含外部空调单元，另一个 — 的室内机。
⚠️ 一个盒子不能同时包含整个货物和部分货物。
{% endcut %}
{% cut "Как передавать коды маркировки и получать статус их проверки" %}
{% note info "Маркировка товаров в системе [«Честный ЗНАК»](https://честныйзнак.рф/) необязательна для заказов от физических лиц" %}
对于业务订单，您仍然需要发送标签代码。
{% endnote %}
如果订单中包含有标签的产品，则必须在请求中提供相应的唯一代码。 [什么是标签？](https://yandex.ru/support/marketplace/orders/cz.html)
接受以下类型的代码:
* 系统中的代码 ["诚实的标志"](https://честныйзнак.рф/) 或 ["ASL BELGISI"](https://aslbelgisi.uz) （对于卖家 Market Yandex Go).
* 赢得珠宝。
* 进口可追溯货物的RNPT和GTD.
对于需要标注的顺序中的每个项目，您需要提供代码列表。 — 每个项目一个。 例如，如果订单中有两双拖鞋和一双鞋子，您将获得第一个位置的两个代码列表和第二个位置的一个代码列表。
如果产品在多个盒子中旅行，则必须为每个盒子传输标签代码。
{% note warning "Если вы работаете по модели FBS, EXPRESS" %}
对于包含系统中标记的珠宝或产品的订单 «Честный ЗНАК»，转换为状态 `READY_TO_SHIP` 只有在以下情况下才可用:
1. 您将其转移到Yandex。街市 УИНы 对于订单中的每件珠宝和系统中的代码 «Честный ЗНАК» 对于订单中需要此标记的所有产品。
2. 所有标记代码将被成功验证。 [如何获取验证状态](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getOrderIdentifiersStatus.md)
{% endnote %}
{% endcut %}
{% cut "Как удалить товар из заказа" %}
从订单中删除商品:
1. 添加到请求中 `allowRemove: true`.
2. 将分发转移到没有要删除的项目的框中.
{% note warning "Удаление нельзя отменить" %}
此操作不可逆转：买方将立即收到通知，订单组成将发生变化。
{% endnote %}
要删除整个位置，请不要传递相应的 `OrderBoxLayoutItemDTO`. 要减少产品的数量，请在字段中传递减少的值 `fullCount`.
您不能删除或减少项目的数量，如果它:
* 特别优惠增加;
* 相当于订单价值的99%;
* 订单中唯一的产品。
如果您无法运送此类物品，请取消订单。 为此，请使用以下方法发送请求 [PUT v2/campaigns/{campaignId}/orders/{orderId}/status](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateOrderStatus.md) 并发送订单状态 `CANCELLED` 与取消的原因 `SHOP_FAILED`.
{% endcut %}
{% note info "Увеличить заказ нельзя" %}
您不能使用查询来增加相同物料的数量、向订单添加新物料或将一个物料替换为另一个物料。
{% endnote %}
## 例子：
{% cut "Товар умещается в коробку" %}
如果他们在同一个盒子里旅行，这就是请求的样子:
* 需要贴标签的同一产品的三个单元;
* 不需要标签的另一个产品的一个单元。
```json translate=no
{
"boxes": [
{
"items": [
{
"id": 123456,
"fullCount": 3,
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
},
{
"cis": "010304109478gftJ14545762!\u001dhGt264"
},
{
"cis": "010304109478fRs28323ks23!\u001dhet201"
}
]
},
{
"id": 654321,
"fullCount": 1
}
]
}
]
}
```
{% endcut %}
{% cut "Товар едет в разных коробках" %}
如果产品有两个盒子，这就是请求的样子:
```json translate=no
{
"boxes": [
{
"items": [
{
"id": 123456,
"partialCount": {
"current": 1,
"total": 2
},
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
}
]
}
]
},
{
"items": [
{
"id": 123456,
"partialCount": {
"current": 2,
"total": 2
},
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
}
]
}
]
}
]
}
```
{% endcut %}
{% cut "Одинаковые товары, где каждый едет в нескольких коробках" %}
如果两个相同的产品中的每一个都装在两个盒子里，这就是请求的样子:
```json translate=no
{
"boxes": [
{
"items": [
{
"id": 123456,
"partialCount": {
"current": 1,
"total": 2
},
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
}
]
}
]
},
{
"items": [
{
"id": 123456,
"partialCount": {
"current": 2,
"total": 2
},
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
}
]
}
]
},
{
"items": [
{
"id": 123456,
"partialCount": {
"current": 1,
"total": 2
},
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
}
]
}
]
},
{
"items": [
{
"id": 123456,
"partialCount": {
"current": 2,
"total": 2
},
"instances": [
{
"cis": "01030410947874432155Qbag!\u001d93Zjqw"
}
]
}
]
}
]
}
```
{% endcut %}
{% cut "Разные товары в разных коробках" %}
如果将两种不同的产品放在不同的盒子中，这就是请求的样子:
```json translate=no
{
"boxes": [
{
"items": [
{
"id": 123456,
"fullCount": 1
}
]
},
{
"items": [
{
"id": 654321,
"fullCount": 1
}
]
}
]
}
```
{% endcut %}
|
**⚙️ 限额:** 10 000 请求 每小时
|
|-|
## Request
PUT {.openapi__method}
```text translate=no
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/boxes
```
### Path parameters
#|
|| **Name** | **Description** ||
||
_campaignId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。
您可以使用查询找到它 [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/zh/reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**:
* 座 **运动ID**;
* 标签 **查询日志** →块中的下拉列表 **显示日志**.
⚠️ 不要把它与:
- 商店的标识符，显示在商家的个人帐户中。
- 广告活动。
_Min value:_{.json-schema-reset .json-schema-assertion} `1`
{.table-cell}
||
||
_orderId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
的订单ID。
{.table-cell}
||
|#{.json-schema-properties}
### Body
{% cut "application/json" %}
```json translate=no
{
"boxes": [
{
"items": [
{
"id": 0,
"fullCount": 1,
"partialCount": {},
"instances": [
null
]
}
]
}
],
"allowRemove": false
}
```
{% endcut %}
#|
|| **Name** | **Description** ||
||
_boxes_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_items_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
订单中的产品ID。
它来自方法的响应 [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md) — 参数 `id` 在 `items`.
{.table-cell}
||
||
_fullCount_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer
一个盒子里的项目数。
如果框中有未分成部分的整个项目，请使用此字段。 不要在同一时间使用此字段 `partialCount`.
_Min value:_{.json-schema-reset .json-schema-assertion} `1`
{.table-cell}
||
||
_instances_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_cis_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
[识别码](*cis-regular-value) 系统中的产品单元 ["诚实的标志"](https://честныйзнак.рф/) 或 ["ASL BELGISI"](https://aslbelgisi.uz) （对于Yandex Go市场的卖家）。
{% note warning "Не экранируйте косую черту в коде символа-разделителя `\u001d`" %}
✅ `01030410947874432155Qbag！\u001d93Zjqw`
❌ `01030410947874432155Qbag！\\u001d93Zjqw`
根据JSON规则在其他地方转义斜杠和引号。: `\\` 和 `\"`
{% endnote %}
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_countryCode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
生产国采用ISO3166-1alpha-2格式。 [如何获得](https://yandex.com/dev/market/partner-api/doc/zh/reference/regions/getRegionsCodes.md)
_Min length:_{.json-schema-reset .json-schema-assertion} `2`
_Max length:_{.json-schema-reset .json-schema-assertion} `2`
_Pattern:_{.json-schema-reset .json-schema-assertion} `^[A-Z]{2}$`
_Example:_{.json-schema-reset .json-schema-example} `RU`
{.table-cell}
||
||
_gtd_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
货物报关。
它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXXXX/XXXXXXXXXXX。
第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_rnpt_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
品批次的注册号。
它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/XXX。
第一部分 — 登记货物申报的海关办公室的代码。 进一步 — 声明的日期、编号和声明中标记产品的编号。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_uin_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
珠宝的唯一标识号。
这是一个16位数字。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
传输的标记代码。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"cis": "example",
"uin": "example",
"rnpt": "example",
"gtd": "example",
"countryCode": "RU"
}
]
```
{% endcut %}
{.table-cell}
||
||
_partialCount_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_current_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
零件编号，从1开始。
_Min value:_{.json-schema-reset .json-schema-assertion} `1`
{.table-cell}
||
||
_total_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
产品分成的总份数。
_Min value:_{.json-schema-reset .json-schema-assertion} `2`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
盒中的产品的部分的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"current": 1,
"total": 2
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
箱中的产品列表。
如果盒子里有一个大的产品的一部分，列表中只能有一个项目。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"id": 0,
"fullCount": 1,
"partialCount": {
"current": 1,
"total": 2
},
"instances": [
{
"cis": "example",
"uin": "example",
"rnpt": "example",
"gtd": "example",
"countryCode": "RU"
}
]
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
框的列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"items": [
{
"id": 0,
"fullCount": 1,
"partialCount": {
"current": 1,
"total": 2
},
"instances": [
{}
]
}
]
}
]
```
{% endcut %}
{.table-cell}
||
||
_allowRemove_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean
传下去 `true` 如果您要从订单中删除一些项目。
_Default:_{.json-schema-reset .json-schema-value} `false`
{.table-cell}
||
|#{.json-schema-properties}
## Responses
## 200 OK
作为响应，您将收到带有框Id的传输布局。 — 您将需要他们请求快捷方式。
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"result": {
"boxes": [
{}
]
}
}
```
{% endcut %}
**Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- {% cut "**Type**: object" %}
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- {% cut "**Type**: object" %}
#|
||
_result_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_boxes_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: object[]
框的列表。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"items": [
{
"id": 0,
"fullCount": 1,
"partialCount": {},
"instances": [
null
]
}
],
"boxId": 0
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
分箱配送货物。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"boxes": [
{
"items": [
{}
],
"boxId": 0
}
]
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"result": {
"boxes": [
{
"items": [
null
],
"boxId": 0
}
]
}
}
```
{% endcut %}
{% endcut %}
## 400 Bad Request
请求包含不正确的数据。 [详细了解处理订单时的错误](../../concepts/error-codes#orders)
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
**Type**: object
{% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- **Type**: object
#|
||
_errors_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
的错误代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
错误的描述。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
错误列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"code": "example",
"message": "example"
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
服务器错误的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
## 401 Unauthorized
请求中未指定授权数据。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#401)
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
**Type**: object
{% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- **Type**: object
#|
||
_errors_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
的错误代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
错误的描述。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
错误列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"code": "example",
"message": "example"
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
服务器错误的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
## 403 Forbidden
授权数据不正确或禁止访问资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#403)
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
**Type**: object
{% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- **Type**: object
#|
||
_errors_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
的错误代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
错误的描述。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
错误列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"code": "example",
"message": "example"
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
服务器错误的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
## 404 Not Found
找不到请求的资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#404)
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
**Type**: object
{% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- **Type**: object
#|
||
_errors_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
的错误代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
错误的描述。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
错误列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"code": "example",
"message": "example"
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
服务器错误的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
## 420 Method Failure
已超出资源访问限制。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#420)
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
**Type**: object
{% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- **Type**: object
#|
||
_errors_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
的错误代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
错误的描述。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
错误列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"code": "example",
"message": "example"
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
服务器错误的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
## 500 Internal Server Error
市场的内部错误。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#500)
### Body
{% cut "application/json" %}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
**Type**: object
{% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
{% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
- **Type**: object
#|
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
响应的类型。
可能的值:
* `OK` — 没有错误。
* `ERROR` — 处理请求时出错。
_Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
{.table-cell}
||
|#{.json-schema-properties}
服务器响应的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK"
}
```
{% endcut %}
- **Type**: object
#|
||
_errors_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
的错误代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
错误的描述。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
错误列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"code": "example",
"message": "example"
}
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
服务器错误的标准包装器。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
```
{% endcut %}
{% endcut %}
- Console
```openapi-sandbox translate=no
pathParams:
- description: "广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。\n\n您可以使用查询找到它 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**:\n\n* 座 **运动ID**;\n* 标签 **查询日志** →块中的下拉列表 **显示日志**.\n\n⚠️ 不要把它与:\n- 商店的标识符，显示在商家的个人帐户中。\n- 广告活动。\n"
name: campaignId
in: path
required: true
schema:
type: integer
format: int64
minimum: 1
- description: 的订单ID。
name: orderId
in: path
required: true
schema:
type: integer
format: int64
searchParams: []
headers: []
body: |-
{
"boxes": [
{
"items": [
{
"id": 0,
"fullCount": 1,
"partialCount": {},
"instances": [
null
]
}
]
}
],
"allowRemove": false
}
schema:
type: object
required:
- boxes
properties:
boxes:
description: 框的列表。
type: array
minItems: 1
items:
description: 箱的信息。
type: object
required:
- items
properties:
items:
description: |
箱中的产品列表。
如果盒子里有一个大的产品的一部分，列表中只能有一个项目。
type: array
minItems: 1
items:
description: 盒中的产品的信息。
type: object
required:
- id
properties:
id:
description: "订单中的产品ID。\n\n它来自方法的响应 [POST\_v1/businesses/{businessId}/orders](../../reference/orders/getBusinessOrders.md) — 参数 `id` 在 `items`.\n"
type: integer
format: int64
fullCount:
description: >
一个盒子里的项目数。
如果框中有未分成部分的整个项目，请使用此字段。 不要在同一时间使用此字段
`partialCount`.
type: integer
format: int32
minimum: 1
partialCount:
description: 盒中的产品的部分的信息。
type: object
required:
- current
- total
properties:
current:
description: 零件编号，从1开始。
type: integer
format: int32
minimum: 1
total:
description: 产品分成的总份数。
type: integer
format: int32
minimum: 2
instances:
description: 传输的标记代码。
type: array
nullable: true
minItems: 1
items:
description: >
产品单元ID。
只填写一个字段，具体取决于产品标记在哪个系统中。
阅读更多关于使用标签产品的信息。
[在市场对卖家的帮助](https://yandex.ru/support/marketplace/orders/cz.html).
type: object
properties:
cis:
description: >+
[识别码](*cis-regular-value) 系统中的产品单元
["诚实的标志"](https://честныйзнак.рф/) 或
["ASL BELGISI"](https://aslbelgisi.uz)
（对于Yandex Go市场的卖家）。
{% note warning "Не экранируйте косую черту в коде
символа-разделителя `\u001d`" %}
✅ `01030410947874432155Qbag！\u001d93Zjqw`
❌ `01030410947874432155Qbag！\\u001d93Zjqw`
根据JSON规则在其他地方转义斜杠和引号。: `\\` 和 `\"`
{% endnote %}
type: string
uin:
description: |
珠宝的唯一标识号。
这是一个16位数字。
type: string
rnpt:
description: >
品批次的注册号。
它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/XXX。
第一部分 — 登记货物申报的海关办公室的代码。 进一步
— 声明的日期、编号和声明中标记产品的编号。
type: string
gtd:
description: >
货物报关。
它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXXXX/XXXXXXXXXXX。
第一部分 — 登记进口货物申报的海关代码。 进一步
— 声明的日期和编号。
type: string
countryCode:
description: >
生产国采用ISO3166-1alpha-2格式。
[如何获得](../../reference/regions/getRegionsCodes.md)
type: string
minLength: 2
maxLength: 2
pattern: ^[A-Z]{2}$
example: RU
allowRemove:
description: 传下去 `true` 如果您要从订单中删除一些项目。
type: boolean
default: false
bodyType: application/json
method: put
security:
- type: apiKey
name: 'Api-Key'
in: header
- type: oauth2
x-inline: true
flows:
implicit:
authorizationUrl: https://oauth.yandex.ru/authorize
scopes:
market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/campaigns/{campaignId}/orders/{orderId}/boxes
host: https://api.partner.market.yandex.ru
```
{% endlist %}