# 有关柜内订单的信息
{% list tabs %}
- Info
**方法适用于[所有模式](https://yandex.com/dev/market/partner-api/doc/zh/overview/business.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)
* inventory-and-order-processing:read-only — [查看订单信息](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/inventory-and-order-processing_read-only.md)
* finance-and-accounting — [查看财务信息和报告](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/finance-and-accounting.md)
* all-methods — 全面管理账户
* all-methods:read-only — 查看所有数据
{% endcut %}
返回商家配置文件中有关订单的信息。 查询可用于跟踪订单及其状态。
{% note tip "Вы также можете настроить API-уведомления" %}
燕基科斯.市场会送你 [请求](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md) 当新订单出现或其状态发生变化时。 使用这种方法可以获得完整的信息。
[如何使用通知](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/index.md)
{% endnote %}
可按参数过滤:
* 订单的日期。
* 订单更新的日期和时间;
* 装运日期;
* 订单状态(`statuses`);
* 处理阶段或取消原因（`substatuses`);
* 活动Id;
* 订单Id;
* 外部订单Id;
* 订单类型（真实或测试）;
* 就业模式;
* 客户要求取消订单的可用性.
每个请求的最大日期范围 — 30天（在参数中传递 `fromDate` 和 `toDate`). 如果未传输，则返回过去30天的信息。
结果逐页返回。 要导航，请使用参数 `pageToken` 和 `limit`.
您可以通过请求获取有关买家及其电话号码的更多详细信息 [GET v2/campaigns/{campaignId}/orders/{orderId}/buyer](https://yandex.com/dev/market/partner-api/doc/zh/reference/order-delivery/getOrderBuyerInfo.md).
|
### Path parameters
#|
|| **Name** | **Description** ||
||
_businessId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
内阁ID。
_Min value:_{.json-schema-reset .json-schema-assertion} `1`
{.table-cell}
||
|#{.json-schema-properties}
### Query parameters
#|
|| **Name** | **Description** ||
||
_limit_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer
每页的值数。
如果参数值超过允许的最大值，它将减少到最大值。
_Default:_{.json-schema-reset .json-schema-value} `50`
_Min value:_{.json-schema-reset .json-schema-assertion} `1`
_Max value:_{.json-schema-reset .json-schema-assertion} `50`
{.table-cell}
||
||
_pageToken_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
结果页面的ID。
如果省略该参数，则返回第一页。
传递输出参数的值 `nextPageToken`，在最后一次请求期间接收。
_Example:_{.json-schema-reset .json-schema-example} ``
{.table-cell}
||
|#{.json-schema-properties}
### Body
{% cut "application/json" %}
```json translate=no
{
"orderIds": [
0
],
"externalOrderIds": [
"example"
],
"programTypes": [
"FBY"
],
"campaignIds": [
1
],
"statuses": [
"PLACING"
],
"substatuses": [
"RESERVATION_EXPIRED"
],
"dates": {
"creationDateFrom": "2025-01-01",
"creationDateTo": "2025-01-01",
"shipmentDateFrom": "2025-01-01",
"shipmentDateTo": "2025-01-01",
"updateDateFrom": "2025-01-01T00:00:00Z",
"updateDateTo": "2025-01-01T00:00:00Z"
},
"fake": true,
"waitingForCancellationApprove": true,
"sourcePlatforms": [
"MARKET"
]
}
```
{% endcut %}
#|
|| **Name** | **Description** ||
||
_campaignIds_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer[] | null
商店活动的id。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Max items:_{.json-schema-reset .json-schema-assertion} `50`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
1
]
```
{% endcut %}
{.table-cell}
||
||
_dates_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_creationDateFrom_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
按结帐日期筛选订单的开始日期。
日期格式: `YYYY-MM-DD`.
开始和结束日期之间（参数 `creationDateTo`）应该不超过30天。
默认值:从当前日期起30天前.
开始日期包含在筛选的间隔中。
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_creationDateTo_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
按结帐日期筛选订单的结束日期。
日期格式: `YYYY-MM-DD`.
在初始（参数 `creationDateFrom`）和结束日期应不超过30天。
默认值：当前日期。
如果之间的时间间隔 `creationDateTo` 和 `creationDateFrom` 不到一天，那么 `creationDateTo` 等于 `creationDateFrom` +一天。
结束日期不包括在过滤间隔中。
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_shipmentDateFrom_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
按发货到送货服务的日期筛选订单的开始日期（参数 `shipmentDate`).
日期格式: `YYYY-MM-DD`.
开始和结束日期之间（参数 `shipmentDateTo`）应该不超过30天。
开始日期包含在筛选的间隔中。
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_shipmentDateTo_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
按发货到送货服务的日期筛选订单的结束日期（参数 `shipmentDate`).
日期格式: `YYYY-MM-DD`.
在初始（参数 `shipmentDateFrom`）和结束日期应不超过30天。
如果之间的时间间隔 `shipmentDateTo` 和 `shipmentDateFrom` 不到一天，那么 `shipmentDateTo` 等于 `shipmentDateFrom` +一天。
结束日期不包括在过滤间隔中。
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_updateDateFrom_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date-time>
订单更新的初始日期（ISO 8601).
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
{.table-cell}
||
||
_updateDateTo_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date-time>
订单更新的结束日期（ISO 8601).
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
按订单日期筛选。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"creationDateFrom": "2025-01-01",
"creationDateTo": "2025-01-01",
"shipmentDateFrom": "2025-01-01",
"shipmentDateTo": "2025-01-01",
"updateDateFrom": "2025-01-01T00:00:00Z",
"updateDateTo": "2025-01-01T00:00:00Z"
}
```
{% endcut %}
{.table-cell}
||
||
_externalOrderIds_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
外部订单Id。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Max items:_{.json-schema-reset .json-schema-assertion} `50`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"example"
]
```
{% endcut %}
{.table-cell}
||
||
_fake_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean
订单类型:
* `false` — 真正的客户的订单。
* `true` — [测试订单](https://yandex.com/dev/market/partner-api/doc/zh/concepts/sandbox.md) 燕基科斯. 市场。
{.table-cell}
||
||
_orderIds_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer[] | null
订单Id。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Max items:_{.json-schema-reset .json-schema-assertion} `50`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
0
]
```
{% endcut %}
{.table-cell}
||
||
_programTypes_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
商店在市场上的运作模式。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"FBY"
]
```
{% endcut %}
{.table-cell}
||
||
_sourcePlatforms_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
平台是订单的来源。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"MARKET"
]
```
{% endcut %}
{.table-cell}
||
||
_statuses_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
订单状态。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"PLACING"
]
```
{% endcut %}
{.table-cell}
||
||
_substatuses_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
处理阶段或取消订单的原因。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"RESERVATION_EXPIRED"
]
```
{% endcut %}
{.table-cell}
||
||
_waitingForCancellationApprove_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean
**只适用于型号 DBS**
用于接收具有取消请求的订单的过滤器。
与值 `true` 仅返回处于状态的那些订单。 `DELIVERY` 或 `PICKUP`，而用户决定取消它们。
{.table-cell}
||
|#{.json-schema-properties}
## 200 OK
内阁的订单清单。
### Body
{% cut "application/json" %}
```json translate=no
{
"orders": [
{
"orderId": 0,
"campaignId": 1,
"programType": "FBY",
"externalOrderId": "example",
"status": "PLACING",
"substatus": "RESERVATION_EXPIRED",
"creationDate": "2020-02-02T14:30:30+03:00",
"updateDate": "2020-02-02T14:30:30+03:00",
"paymentType": "PREPAID",
"paymentMethod": "CASH_ON_DELIVERY",
"fake": true,
"items": [
{
"id": 0,
"offerId": "example",
"offerName": "example",
"count": 0,
"prices": {},
"instances": [
null
],
"requiredInstanceTypes": [
null
],
"itemStatuses": [
null
],
"tags": [
null
]
}
],
"prices": {
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"cashback": {
"value": 0.5,
"currencyId": "RUR"
},
"delivery": {
"payment": {},
"subsidy": {},
"vat": "NO_VAT"
}
},
"delivery": {
"type": "DELIVERY",
"serviceName": "example",
"deliveryServiceId": 0,
"warehouseId": "example",
"deliveryPartnerType": "SHOP",
"dispatchType": "UNKNOWN",
"dates": {
"fromDate": "2025-01-01",
"toDate": "2025-01-01",
"fromTime": "12:00:00",
"toTime": "12:00:00",
"realDeliveryDate": "2025-01-01"
},
"shipment": {
"id": 0,
"shipmentDate": "2025-01-01",
"shipmentTime": "12:00:00"
},
"courier": {
"address": {},
"region": {}
},
"pickup": {
"address": {},
"region": {},
"logisticPointId": 1,
"outletCode": "example",
"outletStorageLimitDate": "2025-01-01"
},
"transfer": {
"courier": {},
"eac": {}
},
"boxesLayout": [
{}
],
"tracks": [
{}
],
"estimated": true,
"receiveBarcode": "example",
"receiveCode": "example",
"digitalGoods": {
"type": "EMAIL",
"steamLink": "example"
}
},
"services": {
"liftType": "NOT_NEEDED"
},
"buyerType": "PERSON",
"notes": "example",
"cancelRequested": true,
"sourcePlatform": "MARKET"
}
],
"paging": {
"nextPageToken": "example"
}
}
```
{% endcut %}
#|
|| **Name** | **Description** ||
||
_orders_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_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}
||
||
_creationDate_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string<date-time>
订单的日期和时间。
日期格式: ISO 8601 具有相对于 UTC.
_Example:_{.json-schema-reset .json-schema-example} `2020-02-02T14:30:30+03:00`
{.table-cell}
||
||
_delivery_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_dates_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_fromDate_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string<date>
最近的交货日期。
日期格式: `YYYY-MM-DD`.
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_fromTime_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<time>
送时间间隔的开始。
它仅与参数一起传递 `类型=交付`.
时间格式：24小时, `HH：MM`. 而不是 `毫米` 始终指定 `00` （例外 — `23:59`).
最小值: `00:00`.
_Example:_{.json-schema-reset .json-schema-example} `12:00:00`
{.table-cell}
||
||
_realDeliveryDate_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
产品送到提货点（如果是提货）或买方（如果订单是由快递公司交付）的日期。
日期格式: `YYYY-MM-DD`.
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_toDate_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
最晚交货日期。
如果 `toDate` 省略，参数中的日期被认为是 `fromDate`.
日期格式: `YYYY-MM-DD`.
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_toTime_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<time>
送时间间隔的结束。
它仅与参数一起传递 `类型=交付`.
时间格式：24小时, `HH：MM`. 而不是 `毫米` 始终指定 `00` （例外 — `23:59`).
最大值: `23:59`.
_Example:_{.json-schema-reset .json-schema-example} `12:00:00`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
交货日期的范围。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"fromDate": "2025-01-01",
"toDate": "2025-01-01",
"fromTime": "12:00:00",
"toTime": "12:00:00",
"realDeliveryDate": "2025-01-01"
}
```
{% endcut %}
{.table-cell}
||
||
_deliveryPartnerType_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
在特定订单内与送货服务的合作类型:
* `SHOP` — 商店直接与送货服务合作或独立交付订单。
* `YANDEX_MARKET` — 这家商店通过市场提供送货服务.
* `UNKNOWN` — 未知类型。
_Enum:_{.json-schema-reset .json-schema-value} `SHOP`, `YANDEX_MARKET`, `UNKNOWN`
{.table-cell}
||
||
_deliveryServiceId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
送服务ID。
{.table-cell}
||
||
_serviceName_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
送货服务的名称。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
订单交付方法:
* `DELIVERY` — 快递送货。
* `PICKUP` — 皮卡。
* `POST` — 邮件。
* `DIGITAL` — 用于数字商品。
* `UNKNOWN` — 未知类型。
_Enum:_{.json-schema-reset .json-schema-value} `DELIVERY`, `PICKUP`, `POST`, `DIGITAL`, `UNKNOWN`
{.table-cell}
||
||
_boxesLayout_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_barcode_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
商店系统中货位的ID。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_boxId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
箱的ID。
{.table-cell}
||
||
_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。
参数 `id` 在 `items`.
{.table-cell}
||
||
_fullCount_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer
一个盒子里的项目数量。
_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/XXXXXXX/XXXXXXXXX。
第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。
_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": [
{}
]
}
],
"boxId": 0,
"barcode": "example"
}
]
```
{% endcut %}
{.table-cell}
||
||
_courier_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_address_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_apartment_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
公寓或办公室号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_block_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
身体。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_city_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
一个城市或地方。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_country_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
一个国家。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_district_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
区。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_entrance_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
入口号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_entryphone_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
的对讲代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_floor_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
地板。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_gps_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_latitude_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
宽度。
{.table-cell}
||
||
_longitude_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
经度。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
纬度和经度的GPS坐标。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"latitude": 0.5,
"longitude": 0.5
}
```
{% endcut %}
{.table-cell}
||
||
_house_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
门牌号。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_postcode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
邮政编码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_street_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
街道。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_subway_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
地铁站。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
送货地址。
如果参数指定 `type` 取值 `DELIVERY`, `POST` 或 `PICKUP` （仅适用于模型 DBS). 如果 `类型=皮卡`，返回取件点的地址。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {
"latitude": 0.5,
"longitude": 0.5
}
}
```
{% endcut %}
{.table-cell}
||
||
_region_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
区域的ID。
{.table-cell}
||
||
_name_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
区域的名称。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
区域的类型。
可能的值:
* `CITY_DISTRICT` — 城市的面积。
* `CITY` — 一个大城市。
* `CONTINENT` — 大陆。
* `COUNTRY_DISTRICT` — 区域。
* `COUNTRY` — 国家。
* `REGION` — 地区。
* `REPUBLIC_AREA` — 联的主体的区。
* `REPUBLIC` — 联的主体。
* `SUBWAY_STATION` — 地铁站。
* `VILLAGE` — 城市。
* `OTHER` — 未知区域。
_Enum:_{.json-schema-reset .json-schema-value} `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`
{.table-cell}
||
||
_parent_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: unknown
有关父区域的信息。
父区域指定到国家级别。
_Example:_{.json-schema-reset .json-schema-example} `null`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
的输送区域。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
关于快递的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"address": {
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {
"latitude": 0.5,
"longitude": 0.5
}
},
"region": {
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
}
}
```
{% endcut %}
{.table-cell}
||
||
_digitalGoods_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
接收数字产品的方法:
* `EMAIL` — 通过邮件激活代码：买方将通过邮件收到一封电子邮件，其中包含代码和说明。
* `ACTIVATION_CODE` — 市场上订单中的激活码：买方将在与商店的聊天中收到指令和代码，并能够复制订单列表中的代码。
* `STEAM_GIFT` — 游戏作为礼物在蒸汽：您将收到一个链接从买方的格式 https://s.team/p/m**-***/******** 添加到朋友。 点击链接，将买家添加为朋友并向他发送游戏。 发送订单已交付给Yandex的状态。三小时内上市。 — 通过API或订单页面。
* `CHAT` — 与市场上的客户聊天中的游戏和产品：客户将在与商店的聊天中收到证书。 发送状态到Yandex。订单已交付的市场 — 通过API或订单页面。
_Enum:_{.json-schema-reset .json-schema-value} `EMAIL`, `ACTIVATION_CODE`, `STEAM_GIFT`, `CHAT`
{.table-cell}
||
||
_steamLink_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
链接到买方的蒸汽帐户. 仅为类型传递 `STEAM_GIFT`.
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关数字商品交付的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"type": "EMAIL",
"steamLink": "example"
}
```
{% endcut %}
{.table-cell}
||
||
_dispatchType_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
装运方法:
* `BUYER` — 快递交付给买方。
* `MARKET_BRANDED_OUTLET` — 送到市场的提货点。
* `SHOP_OUTLET` — 送货到商店的订单提货点.
* `UNKNOWN` — 未知类型。
_Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN`, `BUYER`, `MARKET_BRANDED_OUTLET`, `SHOP_OUTLET`
{.table-cell}
||
||
_estimated_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean
交货日期是否近似。
{.table-cell}
||
||
_pickup_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_address_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_apartment_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
公寓或办公室号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_block_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
身体。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_city_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
一个城市或地方。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_country_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
一个国家。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_district_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
区。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_entrance_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
入口号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_entryphone_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
的对讲代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_floor_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
地板。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_gps_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_latitude_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
宽度。
{.table-cell}
||
||
_longitude_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
经度。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
纬度和经度的GPS坐标。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"latitude": 0.5,
"longitude": 0.5
}
```
{% endcut %}
{.table-cell}
||
||
_house_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
门牌号。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_postcode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
邮政编码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_street_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
街道。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_subway_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
地铁站。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
送货地址。
如果参数指定 `type` 取值 `DELIVERY`, `POST` 或 `PICKUP` （仅适用于模型 DBS). 如果 `类型=皮卡`，返回取件点的地址。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {
"latitude": 0.5,
"longitude": 0.5
}
}
```
{% endcut %}
{.table-cell}
||
||
_logisticPointId_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer
取件点的ID。
使用该方法可以找到 [POST v1/businesses/{businessId}/logistics-points](https://yandex.com/dev/market/partner-api/doc/zh/reference/logistic-points/getLogisticPoints.md).
_Min value:_{.json-schema-reset .json-schema-assertion} `1`
{.table-cell}
||
||
_outletCode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
店分配的取件点ID。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_outletStorageLimitDate_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date>
订单将储存在提货点的日期。 当订单状态更改为 `PICKUP`.
您可以使用该方法更改日期一次 [PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit](https://yandex.com/dev/market/partner-api/doc/zh/reference/order-delivery/updateOrderStorageLimit.md).
日期格式: `YYYY-MM-DD`.
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_region_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
区域的ID。
{.table-cell}
||
||
_name_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
区域的名称。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
区域的类型。
可能的值:
* `CITY_DISTRICT` — 城市的面积。
* `CITY` — 一个大城市。
* `CONTINENT` — 大陆。
* `COUNTRY_DISTRICT` — 区域。
* `COUNTRY` — 国家。
* `REGION` — 地区。
* `REPUBLIC_AREA` — 联的主体的区。
* `REPUBLIC` — 联的主体。
* `SUBWAY_STATION` — 地铁站。
* `VILLAGE` — 城市。
* `OTHER` — 未知区域。
_Enum:_{.json-schema-reset .json-schema-value} `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`
{.table-cell}
||
||
_parent_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: unknown
有关父区域的信息。
父区域指定到国家级别。
_Example:_{.json-schema-reset .json-schema-example} `null`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
的输送区域。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
送到取件点的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"address": {
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {
"latitude": 0.5,
"longitude": 0.5
}
},
"region": {
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
},
"logisticPointId": 1,
"outletCode": "example",
"outletStorageLimitDate": "2025-01-01"
}
```
{% endcut %}
{.table-cell}
||
||
_receiveBarcode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
**仅适用于LaaS模型**
收到PVZ订单的条形码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_receiveCode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
**仅适用于LaaS模型**
PVZ的订单收据代码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_shipment_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_shipmentDate_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string<date>
装运日期。
日期格式: `YYYY-MM-DD`.
_Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
{.table-cell}
||
||
_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: integer | null
装运ID。
{.table-cell}
||
||
_shipmentTime_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<time> | null
装运时间。
_Example:_{.json-schema-reset .json-schema-example} `12:00:00`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关订单装运的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"id": 0,
"shipmentDate": "2025-01-01",
"shipmentTime": "12:00:00"
}
```
{% endcut %}
{.table-cell}
||
||
_tracks_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_deliveryServiceId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
送服务ID。 有关派递服务的资料，可透过要求 [GET delivery/services](https://yandex.com/dev/market/partner-api/doc/zh/reference/delivery-services/getDeliveryServices.md).
{.table-cell}
||
||
_trackCode_{.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
[
{
"trackCode": "example",
"deliveryServiceId": 0
}
]
```
{% endcut %}
{.table-cell}
||
||
_transfer_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_courier_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_fullName_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
全名。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_phone_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
电话号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_phoneExtension_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
分机电话号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_vehicleDescription_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
车辆的描述。 例如，模型和颜色。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_vehicleNumber_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
车辆号码。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
关于快递员的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"fullName": "example",
"phone": "example",
"phoneExtension": "example",
"vehicleNumber": "example",
"vehicleDescription": "example"
}
```
{% endcut %}
{.table-cell}
||
||
_eac_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_eacType_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
EAPP确认码的类型:
* `MERCHANT_TO_COURIER` (暂时不退款) — 卖方将代码传送给快递员以接收非购买。
* `COURIER_TO_MERCHANT` — 快递员将代码传送给卖方以接收订单。
* `CHECKING_BY_MERCHANT` — 卖方检查他身边的代码。
_Enum:_{.json-schema-reset .json-schema-value} `MERCHANT_TO_COURIER`, `COURIER_TO_MERCHANT`, `CHECKING_BY_MERCHANT`
{.table-cell}
||
||
_eacCode_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
EAPP确认码（适用于类型 `MERCHANT_TO_COURIER`).
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
确认码的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"eacType": "MERCHANT_TO_COURIER",
"eacCode": "example"
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关快递员和确认码的信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"courier": {
"fullName": "example",
"phone": "example",
"phoneExtension": "example",
"vehicleNumber": "example",
"vehicleDescription": "example"
},
"eac": {
"eacType": "MERCHANT_TO_COURIER",
"eacCode": "example"
}
}
```
{% endcut %}
{.table-cell}
||
||
_warehouseId_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
为其下订单的商店系统中仓库的ID。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
订单配送信息。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"type": "DELIVERY",
"serviceName": "example",
"deliveryServiceId": 0,
"warehouseId": "example",
"deliveryPartnerType": "SHOP",
"dispatchType": "UNKNOWN",
"dates": {
"fromDate": "2025-01-01",
"toDate": "2025-01-01",
"fromTime": "12:00:00",
"toTime": "12:00:00",
"realDeliveryDate": "2025-01-01"
},
"shipment": {
"id": 0,
"shipmentDate": "2025-01-01",
"shipmentTime": "12:00:00"
},
"courier": {
"address": {
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {
"latitude": 0.5,
"longitude": 0.5
}
},
"region": {
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
}
},
"pickup": {
"address": {
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {
"latitude": 0.5,
"longitude": 0.5
}
},
"region": {
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
},
"logisticPointId": 1,
"outletCode": "example",
"outletStorageLimitDate": "2025-01-01"
},
"transfer": {
"courier": {
"fullName": "example",
"phone": "example",
"phoneExtension": "example",
"vehicleNumber": "example",
"vehicleDescription": "example"
},
"eac": {
"eacType": "MERCHANT_TO_COURIER",
"eacCode": "example"
}
},
"boxesLayout": [
{
"items": [
{
"id": 0,
"fullCount": 1,
"partialCount": {},
"instances": [
null
]
}
],
"boxId": 0,
"barcode": "example"
}
],
"tracks": [
{
"trackCode": "example",
"deliveryServiceId": 0
}
],
"estimated": true,
"receiveBarcode": "example",
"receiveCode": "example",
"digitalGoods": {
"type": "EMAIL",
"steamLink": "example"
}
}
```
{% endcut %}
{.table-cell}
||
||
_fake_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: boolean
订单类型:
* `false` — 真正的客户的订单。
* `true` — [测试订单](https://yandex.com/dev/market/partner-api/doc/zh/concepts/sandbox.md) 燕基科斯. 市场。
{.table-cell}
||
||
_items_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_count_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
积单元的数量。
{.table-cell}
||
||
_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
订单中的产品ID。
允许您在订单中识别产品。
{.table-cell}
||
||
_offerId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
你的 SKU — 系统中的产品ID。
使用规则 SKU:
* 对于每个产品 SKU 一定有一个。
* 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).
{% note warning %}
值开头和结尾的空格会自动删除。 例如, `" SKU123 "` 和 `"SKU123"` 它们将被视为相同的值。
{% endnote %}
[什么是 SKU 以及如何分配它](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)
_Min length:_{.json-schema-reset .json-schema-assertion} `1`
_Max length:_{.json-schema-reset .json-schema-assertion} `255`
_Pattern:_{.json-schema-reset .json-schema-assertion} `^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_offerName_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
产品名称。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.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
系统中的单元识别码 ["诚实的标志"](https://честныйзнак.рф/) 没有密码或 ["ASL BELGISI"](https://aslbelgisi.uz) （对于Yandex Go市场的卖家）。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_cisFull_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
系统中的单元识别码 ["诚实的标志"](https://честныйзнак.рф/) 用密码锁。
_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/XXXXXXX/XXXXXXXXX。
第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。
_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
珠宝的UIN(16位数字代码)
当制造商在贵金属和宝石的周转控制系统中注册产品时，他就会获得胜利。 — GIIS DMDK。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
品单元的标签的信息。
返回请求中传递的标记数据:
* 为 DBS — [PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/provideOrderItemIdentifiers.md) 或 [PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/setOrderBoxLayout.md).
* 为 FBS 和快递 — [PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/setOrderBoxLayout.md).
为 FBY 在交付过程中传输的标记代码被返回.
如果商店尚未发送此订单的代码, `instances` 缺席。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"cis": "example",
"cisFull": "example",
"uin": "example",
"rnpt": "example",
"gtd": "example",
"countryCode": "RU"
}
]
```
{% endcut %}
{.table-cell}
||
||
_itemStatuses_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object[]" %}
#|
||
_count_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
积单元的数量。
{.table-cell}
||
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
订单中物料的状态。
* `CREATED` — 创造出来的。
* `SHIPPED` — 送递。
* `CANCELLED` — 取消或从订单中删除。
* `DELIVERED_TO_BUYER` — 转让给买方。
* `LOST` — 失去了。
* `REJECTED` — 不间断。
* `RETURNED` — 回来了。
_Enum:_{.json-schema-reset .json-schema-value} `CREATED`, `SHIPPED`, `CANCELLED`, `DELIVERED_TO_BUYER`, `LOST`, `REJECTED`, `RETURNED`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关订单中各个项目状态的信息。
如果没有关于各个产品单元状态的数据，则省略该字段。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"status": "CREATED",
"count": 0
}
]
```
{% endcut %}
{.table-cell}
||
||
_prices_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_cashback_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_payment_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_subsidy_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_vat_{.json-schema-reset .json-schema-property}
{.table-cell}|
**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:_{.json-schema-reset .json-schema-value} `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`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关付款和奖励的信息。
{% note info "Как рассчитывается стоимость всех единиц товара и вознаграждение продавцу" %}
* 产品的所有单位的成本由参数组成 `payment` 和 `cashback`.
* 在参数中返回给卖家的奖励总额 `subsidy`.
* 意义 `payment`, `cashback` 和 `subsidy` 它可能与目录中的价格不同，因为有关商店促销的信息不会返回。
* 如果订单中有多个项目，则在参数中返回总价值。
* 所有金额均以商店的货币表示。
{% endnote %}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"cashback": {
"value": 0.5,
"currencyId": "RUR"
},
"vat": "NO_VAT"
}
```
{% endcut %}
{.table-cell}
||
||
_requiredInstanceTypes_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
所需产品标记的列表。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"CIS"
]
```
{% endcut %}
{.table-cell}
||
||
_tags_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
产品属性。
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"ULTIMA"
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
订单中的产品列表。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"id": 0,
"offerId": "example",
"offerName": "example",
"count": 0,
"prices": {
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"cashback": {
"value": 0.5,
"currencyId": "RUR"
},
"vat": "NO_VAT"
},
"instances": [
{
"cis": "example",
"cisFull": "example",
"uin": "example",
"rnpt": "example",
"gtd": "example",
"countryCode": "RU"
}
],
"requiredInstanceTypes": [
"CIS"
],
"itemStatuses": [
{
"status": "CREATED",
"count": 0
}
],
"tags": [
"ULTIMA"
]
}
]
```
{% endcut %}
{.table-cell}
||
||
_orderId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer
的订单ID。
{.table-cell}
||
||
_paymentMethod_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
订单的付款方式:
* 如果在结账时选择付款，则值（`"paymentType": "PREPAID"`):
* `YANDEX` — 通过银行卡。
* `APPLE_PAY` — Apple Pay（未使用）。
* `GOOGLE_PAY` — Google Pay（未使用）。
* `CREDIT` — 赊帐。
* `TINKOFF_CREDIT` — 从廷科夫银行贷到的。
* `TINKOFF_INSTALLMENTS` — 分期付款在廷科夫银行。
* `EXTERNAL_CERTIFICATE` — 与礼券（例如，从Sberbank在线应用程序）。
* `SBP` — 通过快速支付系统。
* `B2B_ACCOUNT_PREPAYMENT` — 组织支付订单。
* `MICROCREDIT` -基于MCC（小额信贷公司）的拆分。
* `BNPL_TBC` -BNPL通过外部TBC银行。
* `DIGITAL_RUBLE` -数字卢布。
* 如果在收到订单时选择付款的值（`"paymentType": "POSTPAID"`):
* `CARD_ON_DELIVERY` — 通过银行卡。
* `BOUND_CARD_ON_DELIVERY` — 收到时附有连结的银行卡。
* `BNPL_BANK_ON_DELIVERY` — 超级分裂。
* `BNPL_ON_DELIVERY` — 分裂。
* `BNPL_TBYB` -基于拆分交货后付款。
* `CASH_ON_DELIVERY` — 现金。
* `B2B_ACCOUNT_POSTPAYMENT` — 订单在交货后由组织支付。
* `UNKNOWN` — 未知类型。
默认值: `CASH_ON_DELIVERY`.
_Enum:_{.json-schema-reset .json-schema-value} `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `BOUND_CARD_ON_DELIVERY`, `BNPL_BANK_ON_DELIVERY`, `BNPL_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `MICROCREDIT`, `BNPL_TBYB`, `BNPL_TBC`, `DIGITAL_RUBLE`, `UNKNOWN`
{.table-cell}
||
||
_paymentType_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
订购付款类别:
* `PREPAID` — 结账时付款。
* `POSTPAID` — 在收到订单后付款。
* `UNKNOWN` — 未知类型。
如果省略此参数，订单将在收到时支付。
_Enum:_{.json-schema-reset .json-schema-value} `PREPAID`, `POSTPAID`, `UNKNOWN`
{.table-cell}
||
||
_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
订单状况:
* `PLACING` — 它正在处理中,正在准备预订。
* `RESERVED` — 保留，但发行不足（仅适用于LaaS）。
* `UNPAID` — 已发出，但尚未付款（如果在结账时选择付款）。
* `PROCESSING` — 它正在处理中。
* `DELIVERY` — 转移到送货服务。
* `PICKUP` — 送到取件点。
* `DELIVERED` — 由买方接收。
* `CANCELLED` — 取消。
* `PENDING` — 等待卖方处理。
* `PARTIALLY_RETURNED` — 部分返回。
* `RETURNED` — 全额回来了。
* `UNKNOWN` — 状态不明。
也可以返回其他值。 您不需要处理它们。
_Enum:_{.json-schema-reset .json-schema-value} `PLACING`, `RESERVED`, `UNPAID`, `PROCESSING`, `DELIVERY`, `PICKUP`, `DELIVERED`, `CANCELLED`, `PENDING`, `PARTIALLY_RETURNED`, `RETURNED`, `UNKNOWN`
{.table-cell}
||
||
_substatus_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
订单处理阶段（状态 `PROCESSING`）或取消订单的原因（状态 `CANCELLED`).
* 状态中的订单值 `PROCESSING`:
* `STARTED` — 订单已确认，可以处理。
* `READY_TO_SHIP` — 订单已组装并准备装运。
* 状态中的订单值 `CANCELLED`:
* `RESERVATION_EXPIRED` — 客户没有在10分钟内完成预订订单。
* `USER_NOT_PAID` — 买方没有为订单付款（对于付款类型 `PREPAID`）30分钟。
* `USER_UNREACHABLE` — 无法联系买家。 为此取消，必须满足以下条件:
* 至少3个电话从8到21在买方的时区;
* 第一次和第三次通话之间的休息时间至少为90分钟;
* 连接不短于5秒。
如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。 将返回带有错误代码400的响应。
* `USER_CHANGED_MIND` — 客户因个人原因取消了订单。
* `USER_REFUSED_DELIVERY` — 买方对交货条件不满意.
* `USER_REFUSED_PRODUCT` — 该产品不适合买方。
* `SHOP_FAILED` — 商店无法完成订单。
* `USER_REFUSED_QUALITY` — 买方对产品的质量不满意。
* `USER_IDENTIFICATION_MISMATCH` — 买方的身份证明文件与订单中的数据不匹配。
* `PURCHASE_GROUP_THRESHOLD_NOT_REACHED_CANCELLED` — 该订单是团体购买的一部分，并被取消，因为没有达到所需的购买数量。
* `REPLACING_ORDER` — 买方决定主动更换另一种产品。
* `PROCESSING_EXPIRED` — 值不再使用。
* `PICKUP_EXPIRED` — 取货点的订单保质期已过期。
* `TOO_MANY_DELIVERY_DATE_CHANGES` — 订单被推迟了太多次。
* `TOO_LONG_DELIVERY` — 订单太长时间无法交付。
* `INCORRECT_PERSONAL_DATA` — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。
* `TECHNICAL_ERROR` — 市场方面的技术错误。 联系支持。
也可以返回其他值。 您不需要处理它们。
_Enum:_{.json-schema-reset .json-schema-value} `RESERVATION_EXPIRED`, `USER_NOT_PAID`, `USER_UNREACHABLE`, `USER_CHANGED_MIND`, `USER_REFUSED_DELIVERY`, `USER_REFUSED_PRODUCT`, `SHOP_FAILED`, `USER_REFUSED_QUALITY`, `REPLACING_ORDER`, `PROCESSING_EXPIRED`, `PENDING_EXPIRED`, `SHOP_PENDING_CANCELLED`, `PENDING_CANCELLED`, `USER_FRAUD`, `RESERVATION_FAILED`, `USER_PLACED_OTHER_ORDER`, `USER_BOUGHT_CHEAPER`, `MISSING_ITEM`, `BROKEN_ITEM`, `WRONG_ITEM`, `PICKUP_EXPIRED`, `DELIVERY_PROBLEMS`, `LATE_CONTACT`, `CUSTOM`, `DELIVERY_SERVICE_FAILED`, `WAREHOUSE_FAILED_TO_SHIP`, `DELIVERY_SERVICE_UNDELIVERED`, `PREORDER`, `AWAIT_CONFIRMATION`, `STARTED`, `PACKAGING`, `READY_TO_SHIP`, `SHIPPED`, `ASYNC_PROCESSING`, `WAITING_USER_INPUT`, `WAITING_BANK_DECISION`, `BANK_REJECT_CREDIT_OFFER`, `CUSTOMER_REJECT_CREDIT_OFFER`, `CREDIT_OFFER_FAILED`, `AWAIT_DELIVERY_DATES_CONFIRMATION`, `SERVICE_FAULT`, `DELIVERY_SERVICE_RECEIVED`, `USER_RECEIVED`, `WAITING_FOR_STOCKS`, `AS_PART_OF_MULTI_ORDER`, `READY_FOR_LAST_MILE`, `LAST_MILE_STARTED`, `ANTIFRAUD`, `DELIVERY_USER_NOT_RECEIVED`, `DELIVERY_SERVICE_DELIVERED`, `DELIVERED_USER_NOT_RECEIVED`, `USER_WANTED_ANOTHER_PAYMENT_METHOD`, `USER_RECEIVED_TECHNICAL_ERROR`, `USER_FORGOT_TO_USE_BONUS`, `DELIVERY_SERVICE_NOT_RECEIVED`, `DELIVERY_SERVICE_LOST`, `SHIPPED_TO_WRONG_DELIVERY_SERVICE`, `DELIVERED_USER_RECEIVED`, `WAITING_TINKOFF_DECISION`, `COURIER_SEARCH`, `COURIER_FOUND`, `COURIER_IN_TRANSIT_TO_SENDER`, `COURIER_ARRIVED_TO_SENDER`, `COURIER_RECEIVED`, `COURIER_NOT_FOUND`, `COURIER_NOT_DELIVER_ORDER`, `COURIER_RETURNS_ORDER`, `COURIER_RETURNED_ORDER`, `WAITING_USER_DELIVERY_INPUT`, `PICKUP_SERVICE_RECEIVED`, `PICKUP_USER_RECEIVED`, `CANCELLED_COURIER_NOT_FOUND`, `COURIER_NOT_COME_FOR_ORDER`, `DELIVERY_NOT_MANAGED_REGION`, `INCOMPLETE_CONTACT_INFORMATION`, `INCOMPLETE_MULTI_ORDER`, `INAPPROPRIATE_WEIGHT_SIZE`, `TECHNICAL_ERROR`, `SORTING_CENTER_LOST`, `COURIER_SEARCH_NOT_STARTED`, `LOST`, `AWAIT_PAYMENT`, `AWAIT_LAVKA_RESERVATION`, `USER_WANTS_TO_CHANGE_ADDRESS`, `FULL_NOT_RANSOM`, `PRESCRIPTION_MISMATCH`, `DROPOFF_LOST`, `DROPOFF_CLOSED`, `DELIVERY_TO_STORE_STARTED`, `USER_WANTS_TO_CHANGE_DELIVERY_DATE`, `WRONG_ITEM_DELIVERED`, `DAMAGED_BOX`, `AWAIT_DELIVERY_DATES`, `LAST_MILE_COURIER_SEARCH`, `PICKUP_POINT_CLOSED`, `LEGAL_INFO_CHANGED`, `USER_HAS_NO_TIME_TO_PICKUP_ORDER`, `DELIVERY_CUSTOMS_ARRIVED`, `DELIVERY_CUSTOMS_CLEARED`, `FIRST_MILE_DELIVERY_SERVICE_RECEIVED`, `AWAIT_AUTO_DELIVERY_DATES`, `AWAIT_USER_PERSONAL_DATA`, `NO_PERSONAL_DATA_EXPIRED`, `CUSTOMS_PROBLEMS`, `AWAIT_CASHIER`, `WAITING_POSTPAID_BUDGET_RESERVATION`, `AWAIT_SERVICEABLE_CONFIRMATION`, `POSTPAID_BUDGET_RESERVATION_FAILED`, `AWAIT_CUSTOM_PRICE_CONFIRMATION`, `READY_FOR_PICKUP`, `TOO_MANY_DELIVERY_DATE_CHANGES`, `TOO_LONG_DELIVERY`, `DEFERRED_PAYMENT`, `POSTPAID_FAILED`, `INCORRECT_PERSONAL_DATA`, `CUSTOMS_FAILED_MARKET`, `CUSTOMS_FAILED_USER_COMMERCIAL_ITEMS`, `CUSTOMS_FAILED_USER_DUTY_NOT_PAID`, `CUSTOMS_FAILED_USER_INVALID_PERSONAL_DATA`, `CUSTOMS_FAILED_USER_ADDITIONAL_DATA_NOT_PROVIDED`, `AWAIT_PAYMENT_AFTER_DELIVERY`, `AWAIT_USER_STEAM_FAST_URL`, `USER_IDENTIFICATION_MISMATCH`, `PURCHASE_GROUP_THRESHOLD_NOT_REACHED_CANCELLED`, `UNKNOWN`
{.table-cell}
||
||
_buyerType_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
买方类型:
* `PERSON` — 一个自然人。
* `BUSINESS` — 组织。
_Enum:_{.json-schema-reset .json-schema-value} `PERSON`, `BUSINESS`
{.table-cell}
||
||
_cancelRequested_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean
**只适用于型号 DBS**
是否已要求取消。
{.table-cell}
||
||
_externalOrderId_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
您提交的订单的外部ID [POST v2/campaigns/{campaignId}/orders/{orderId}/external-id](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateExternalOrderId.md).
_Min length:_{.json-schema-reset .json-schema-assertion} `1`
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_notes_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
对订单进行评论。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||
_prices_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_cashback_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_delivery_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_payment_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_subsidy_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_vat_{.json-schema-reset .json-schema-property}
{.table-cell}|
**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:_{.json-schema-reset .json-schema-value} `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`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关交付成本的信息，包括上到地板。
{% note info "Как рассчитывается стоимость доставки" %}
* 交付成本由参数组成 `payment` 和 `subsidy`.
* 所有金额均以商店的货币表示。
{% endnote %}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"vat": "NO_VAT"
}
```
{% endcut %}
{.table-cell}
||
||
_payment_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
||
_subsidy_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_currencyId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
_Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
{.table-cell}
||
||
_value_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number
意义。
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
货币及其价值。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"value": 0.5,
"currencyId": "RUR"
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
有关订单成本的信息。
{% note info "Как рассчитывается стоимость заказа, доставки и вознаграждение продавцу" %}
* 订单中货物的成本由参数组成 `payment` 和 `cashback`.
* 在参数中返回给卖家的奖励总额 `subsidy`.
* 意义 `payment`, `cashback` 和 `subsidy` 它可能与目录中的价格不同，因为有关商店促销的信息不会返回。
* 交付成本由参数组成 `payment` 和 `subsidy` 在 `delivery`.
* 所有金额均以商店的货币表示。
{% endnote %}
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"cashback": {
"value": 0.5,
"currencyId": "RUR"
},
"delivery": {
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"vat": "NO_VAT"
}
}
```
{% endcut %}
{.table-cell}
||
||
_programType_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
工作模式:
* `FBY` — FBY.
* `FBS` — FBS.
* `DBS` — DBS.
* `EXPRESS` — Express.
* `LAAS` — 拉斯。
_Enum:_{.json-schema-reset .json-schema-value} `FBY`, `FBS`, `DBS`, `EXPRESS`, `LAAS`
{.table-cell}
||
||
_services_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_liftType_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
将订单提升到地板的类型:
* `NOT_NEEDED` — 不需要。
* `MANUAL` — 手册。
* `ELEVATOR` — 电梯。
* `CARGO_ELEVATOR` — 货运电梯。
* `FREE` — 以上任何一项，如果启用了自由升降选项。
* `UNKNOWN` — 未知类型。
_Enum:_{.json-schema-reset .json-schema-value} `NOT_NEEDED`, `MANUAL`, `ELEVATOR`, `CARGO_ELEVATOR`, `FREE`, `UNKNOWN`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
添加到订单中的服务。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"liftType": "NOT_NEEDED"
}
```
{% endcut %}
{.table-cell}
||
||
_sourcePlatform_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
该网站是订单的来源:
* `MARKET` — 市场上的订单。
* `OTHER` — LaaS是卖方创建的订单。
_Enum:_{.json-schema-reset .json-schema-value} `MARKET`, `OZON`, `WILDBERRIES`, `OTHER`
{.table-cell}
||
||
_updateDate_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string<date-time>
上次订单更新的日期和时间。
日期格式: ISO 8601 具有相对于 UTC.
_Example:_{.json-schema-reset .json-schema-example} `2020-02-02T14:30:30+03:00`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
内阁的订单清单。
_Max items:_{.json-schema-reset .json-schema-assertion} `50`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
{
"orderId": 0,
"campaignId": 1,
"programType": "FBY",
"externalOrderId": "example",
"status": "PLACING",
"substatus": "RESERVATION_EXPIRED",
"creationDate": "2020-02-02T14:30:30+03:00",
"updateDate": "2020-02-02T14:30:30+03:00",
"paymentType": "PREPAID",
"paymentMethod": "CASH_ON_DELIVERY",
"fake": true,
"items": [
{
"id": 0,
"offerId": "example",
"offerName": "example",
"count": 0,
"prices": {
"payment": {},
"subsidy": {},
"cashback": {},
"vat": "NO_VAT"
},
"instances": [
{}
],
"requiredInstanceTypes": [
"CIS"
],
"itemStatuses": [
{}
],
"tags": [
"ULTIMA"
]
}
],
"prices": {
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"cashback": {
"value": 0.5,
"currencyId": "RUR"
},
"delivery": {
"payment": {
"value": 0.5,
"currencyId": "RUR"
},
"subsidy": {
"value": 0.5,
"currencyId": "RUR"
},
"vat": "NO_VAT"
}
},
"delivery": {
"type": "DELIVERY",
"serviceName": "example",
"deliveryServiceId": 0,
"warehouseId": "example",
"deliveryPartnerType": "SHOP",
"dispatchType": "UNKNOWN",
"dates": {
"fromDate": "2025-01-01",
"toDate": "2025-01-01",
"fromTime": "12:00:00",
"toTime": "12:00:00",
"realDeliveryDate": "2025-01-01"
},
"shipment": {
"id": 0,
"shipmentDate": "2025-01-01",
"shipmentTime": "12:00:00"
},
"courier": {
"address": {
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {}
},
"region": {
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
}
},
"pickup": {
"address": {
"country": "example",
"postcode": "example",
"city": "example",
"district": "example",
"subway": "example",
"street": "example",
"house": "example",
"block": "example",
"entrance": "example",
"entryphone": "example",
"floor": "example",
"apartment": "example",
"gps": {}
},
"region": {
"id": 0,
"name": "example",
"type": "OTHER",
"parent": null
},
"logisticPointId": 1,
"outletCode": "example",
"outletStorageLimitDate": "2025-01-01"
},
"transfer": {
"courier": {
"fullName": "example",
"phone": "example",
"phoneExtension": "example",
"vehicleNumber": "example",
"vehicleDescription": "example"
},
"eac": {
"eacType": "MERCHANT_TO_COURIER",
"eacCode": "example"
}
},
"boxesLayout": [
{
"items": [
null
],
"boxId": 0,
"barcode": "example"
}
],
"tracks": [
{
"trackCode": "example",
"deliveryServiceId": 0
}
],
"estimated": true,
"receiveBarcode": "example",
"receiveCode": "example",
"digitalGoods": {
"type": "EMAIL",
"steamLink": "example"
}
},
"services": {
"liftType": "NOT_NEEDED"
},
"buyerType": "PERSON",
"notes": "example",
"cancelRequested": true,
"sourcePlatform": "MARKET"
}
]
```
{% endcut %}
{.table-cell}
||
||
_paging_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Type**: object" %}
#|
||
_nextPageToken_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string
下一个结果页面的ID。
_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}
{% endcut %}
下一页的ID。
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
{
"nextPageToken": "example"
}
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
- Console
```openapi-sandbox translate=no
pathParams:
- description: "内阁ID。\n\n\n:::no-translate\n{% if audience == \"partner\" %}\n:::\n\n\n要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n\n\n:::no-translate\n{% endif %}\n:::\n\n"
name: businessId
in: path
required: true
schema:
type: integer
format: int64
minimum: 1
searchParams:
- name: pageToken
description: |
结果页面的ID。
如果省略该参数，则返回第一页。
传递输出参数的值 `nextPageToken`，在最后一次请求期间接收。
in: query
required: false
x-transform: token
x-aliases:
- pageToken
- page_token
schema:
type: string
- name: limit
description: |
每页的值数。
如果参数值超过允许的最大值，它将减少到最大值。
in: query
required: false
x-transform: truncateLimit
schema:
type: integer
format: int32
minimum: 1
default: 50
maximum: 50
headers: []
body: |-
{
"orderIds": [
0
],
"externalOrderIds": [
"example"
],
"programTypes": [
"FBY"
],
"campaignIds": [
1
],
"statuses": [
"PLACING"
],
"substatuses": [
"RESERVATION_EXPIRED"
],
"dates": {
"creationDateFrom": "2025-01-01",
"creationDateTo": "2025-01-01",
"shipmentDateFrom": "2025-01-01",
"shipmentDateTo": "2025-01-01",
"updateDateFrom": "2025-01-01T00:00:00Z",
"updateDateTo": "2025-01-01T00:00:00Z"
},
"fake": true,
"waitingForCancellationApprove": true,
"sourcePlatforms": [
"MARKET"
]
}
schema:
type: object
description: 请求有关业务订单的信息。
properties:
orderIds:
description: 订单Id。
nullable: true
uniqueItems: true
type: array
items:
type: integer
format: int64
minItems: 1
maxItems: 50
externalOrderIds:
description: 外部订单Id。
nullable: true
uniqueItems: true
type: array
items:
description: "您提交的订单的外部ID [POST\_v2/campaigns/{campaignId}/orders/{orderId}/external-id](../../reference/orders/updateExternalOrderId.md)."
type: string
minLength: 1
minItems: 1
maxItems: 50
programTypes:
description: 商店在市场上的运作模式。
nullable: true
uniqueItems: true
type: array
items:
description: |
工作模式:
* `FBY` — FBY.
* `FBS` — FBS.
* `DBS` — DBS.
* `EXPRESS` — Express.
* `LAAS` — 拉斯。
type: string
enum:
- FBY
- FBS
- DBS
- EXPRESS
- LAAS
minItems: 1
campaignIds:
description: 商店活动的id。
nullable: true
uniqueItems: true
type: array
items:
description: "广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。\n\n您可以使用查询找到它 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**:\n\n* 座 **运动ID**;\n* 标签 **查询日志** →块中的下拉列表 **显示日志**.\n\n⚠️ 不要把它与:\n- 商店的标识符，显示在商家的个人帐户中。\n- 广告活动。\n"
type: integer
format: int64
minimum: 1
minItems: 1
maxItems: 50
statuses:
description: 订单状态。
nullable: true
uniqueItems: true
type: array
items:
description: |
订单状况:
* `PLACING` — 它正在处理中,正在准备预订。
* `RESERVED` — 保留，但发行不足（仅适用于LaaS）。
* `UNPAID` — 已发出，但尚未付款（如果在结账时选择付款）。
* `PROCESSING` — 它正在处理中。
* `DELIVERY` — 转移到送货服务。
* `PICKUP` — 送到取件点。
* `DELIVERED` — 由买方接收。
* `CANCELLED` — 取消。
* `PENDING` — 等待卖方处理。
* `PARTIALLY_RETURNED` — 部分返回。
* `RETURNED` — 全额回来了。
* `UNKNOWN` — 状态不明。
也可以返回其他值。 您不需要处理它们。
type: string
enum:
- PLACING
- RESERVED
- UNPAID
- PROCESSING
- DELIVERY
- PICKUP
- DELIVERED
- CANCELLED
- PENDING
- PARTIALLY_RETURNED
- RETURNED
- UNKNOWN
minItems: 1
substatuses:
description: 处理阶段或取消订单的原因。
nullable: true
uniqueItems: true
type: array
items:
description: >
订单处理阶段（状态 `PROCESSING`）或取消订单的原因（状态
`CANCELLED`).
* 状态中的订单值 `PROCESSING`:
* `STARTED` — 订单已确认，可以处理。
* `READY_TO_SHIP` — 订单已组装并准备装运。
* 状态中的订单值 `CANCELLED`:
* `RESERVATION_EXPIRED` — 客户没有在10分钟内完成预订订单。
* `USER_NOT_PAID` — 买方没有为订单付款（对于付款类型 `PREPAID`）30分钟。
* `USER_UNREACHABLE` — 无法联系买家。 为此取消，必须满足以下条件:
* 至少3个电话从8到21在买方的时区;
* 第一次和第三次通话之间的休息时间至少为90分钟;
* 连接不短于5秒。
如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。 将返回带有错误代码400的响应。
* `USER_CHANGED_MIND` — 客户因个人原因取消了订单。
* `USER_REFUSED_DELIVERY` — 买方对交货条件不满意.
* `USER_REFUSED_PRODUCT` — 该产品不适合买方。
* `SHOP_FAILED` — 商店无法完成订单。
* `USER_REFUSED_QUALITY` — 买方对产品的质量不满意。
* `USER_IDENTIFICATION_MISMATCH` — 买方的身份证明文件与订单中的数据不匹配。
* `PURCHASE_GROUP_THRESHOLD_NOT_REACHED_CANCELLED` — 该订单是团体购买的一部分，并被取消，因为没有达到所需的购买数量。
* `REPLACING_ORDER` — 买方决定主动更换另一种产品。
* `PROCESSING_EXPIRED` — 值不再使用。
* `PICKUP_EXPIRED` — 取货点的订单保质期已过期。
* `TOO_MANY_DELIVERY_DATE_CHANGES` — 订单被推迟了太多次。
* `TOO_LONG_DELIVERY` — 订单太长时间无法交付。
* `INCORRECT_PERSONAL_DATA` — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。
* `TECHNICAL_ERROR` — 市场方面的技术错误。 联系支持。
也可以返回其他值。 您不需要处理它们。
type: string
enum:
- RESERVATION_EXPIRED
- USER_NOT_PAID
- USER_UNREACHABLE
- USER_CHANGED_MIND
- USER_REFUSED_DELIVERY
- USER_REFUSED_PRODUCT
- SHOP_FAILED
- USER_REFUSED_QUALITY
- REPLACING_ORDER
- PROCESSING_EXPIRED
- PENDING_EXPIRED
- SHOP_PENDING_CANCELLED
- PENDING_CANCELLED
- USER_FRAUD
- RESERVATION_FAILED
- USER_PLACED_OTHER_ORDER
- USER_BOUGHT_CHEAPER
- MISSING_ITEM
- BROKEN_ITEM
- WRONG_ITEM
- PICKUP_EXPIRED
- DELIVERY_PROBLEMS
- LATE_CONTACT
- CUSTOM
- DELIVERY_SERVICE_FAILED
- WAREHOUSE_FAILED_TO_SHIP
- DELIVERY_SERVICE_UNDELIVERED
- PREORDER
- AWAIT_CONFIRMATION
- STARTED
- PACKAGING
- READY_TO_SHIP
- SHIPPED
- ASYNC_PROCESSING
- WAITING_USER_INPUT
- WAITING_BANK_DECISION
- BANK_REJECT_CREDIT_OFFER
- CUSTOMER_REJECT_CREDIT_OFFER
- CREDIT_OFFER_FAILED
- AWAIT_DELIVERY_DATES_CONFIRMATION
- SERVICE_FAULT
- DELIVERY_SERVICE_RECEIVED
- USER_RECEIVED
- WAITING_FOR_STOCKS
- AS_PART_OF_MULTI_ORDER
- READY_FOR_LAST_MILE
- LAST_MILE_STARTED
- ANTIFRAUD
- DELIVERY_USER_NOT_RECEIVED
- DELIVERY_SERVICE_DELIVERED
- DELIVERED_USER_NOT_RECEIVED
- USER_WANTED_ANOTHER_PAYMENT_METHOD
- USER_RECEIVED_TECHNICAL_ERROR
- USER_FORGOT_TO_USE_BONUS
- DELIVERY_SERVICE_NOT_RECEIVED
- DELIVERY_SERVICE_LOST
- SHIPPED_TO_WRONG_DELIVERY_SERVICE
- DELIVERED_USER_RECEIVED
- WAITING_TINKOFF_DECISION
- COURIER_SEARCH
- COURIER_FOUND
- COURIER_IN_TRANSIT_TO_SENDER
- COURIER_ARRIVED_TO_SENDER
- COURIER_RECEIVED
- COURIER_NOT_FOUND
- COURIER_NOT_DELIVER_ORDER
- COURIER_RETURNS_ORDER
- COURIER_RETURNED_ORDER
- WAITING_USER_DELIVERY_INPUT
- PICKUP_SERVICE_RECEIVED
- PICKUP_USER_RECEIVED
- CANCELLED_COURIER_NOT_FOUND
- COURIER_NOT_COME_FOR_ORDER
- DELIVERY_NOT_MANAGED_REGION
- INCOMPLETE_CONTACT_INFORMATION
- INCOMPLETE_MULTI_ORDER
- INAPPROPRIATE_WEIGHT_SIZE
- TECHNICAL_ERROR
- SORTING_CENTER_LOST
- COURIER_SEARCH_NOT_STARTED
- LOST
- AWAIT_PAYMENT
- AWAIT_LAVKA_RESERVATION
- USER_WANTS_TO_CHANGE_ADDRESS
- FULL_NOT_RANSOM
- PRESCRIPTION_MISMATCH
- DROPOFF_LOST
- DROPOFF_CLOSED
- DELIVERY_TO_STORE_STARTED
- USER_WANTS_TO_CHANGE_DELIVERY_DATE
- WRONG_ITEM_DELIVERED
- DAMAGED_BOX
- AWAIT_DELIVERY_DATES
- LAST_MILE_COURIER_SEARCH
- PICKUP_POINT_CLOSED
- LEGAL_INFO_CHANGED
- USER_HAS_NO_TIME_TO_PICKUP_ORDER
- DELIVERY_CUSTOMS_ARRIVED
- DELIVERY_CUSTOMS_CLEARED
- FIRST_MILE_DELIVERY_SERVICE_RECEIVED
- AWAIT_AUTO_DELIVERY_DATES
- AWAIT_USER_PERSONAL_DATA
- NO_PERSONAL_DATA_EXPIRED
- CUSTOMS_PROBLEMS
- AWAIT_CASHIER
- WAITING_POSTPAID_BUDGET_RESERVATION
- AWAIT_SERVICEABLE_CONFIRMATION
- POSTPAID_BUDGET_RESERVATION_FAILED
- AWAIT_CUSTOM_PRICE_CONFIRMATION
- READY_FOR_PICKUP
- TOO_MANY_DELIVERY_DATE_CHANGES
- TOO_LONG_DELIVERY
- DEFERRED_PAYMENT
- POSTPAID_FAILED
- INCORRECT_PERSONAL_DATA
- CUSTOMS_FAILED_MARKET
- CUSTOMS_FAILED_USER_COMMERCIAL_ITEMS
- CUSTOMS_FAILED_USER_DUTY_NOT_PAID
- CUSTOMS_FAILED_USER_INVALID_PERSONAL_DATA
- CUSTOMS_FAILED_USER_ADDITIONAL_DATA_NOT_PROVIDED
- AWAIT_PAYMENT_AFTER_DELIVERY
- AWAIT_USER_STEAM_FAST_URL
- USER_IDENTIFICATION_MISMATCH
- PURCHASE_GROUP_THRESHOLD_NOT_REACHED_CANCELLED
- UNKNOWN
minItems: 1
dates:
type: object
description: 按订单日期筛选。
properties:
creationDateFrom:
description: |
按结帐日期筛选订单的开始日期。
日期格式: `YYYY-MM-DD`.
开始和结束日期之间（参数 `creationDateTo`）应该不超过30天。
默认值:从当前日期起30天前.
开始日期包含在筛选的间隔中。
type: string
format: date
creationDateTo:
description: >
按结帐日期筛选订单的结束日期。
日期格式: `YYYY-MM-DD`.
在初始（参数 `creationDateFrom`）和结束日期应不超过30天。
默认值：当前日期。
如果之间的时间间隔 `creationDateTo` 和
`creationDateFrom` 不到一天，那么
`creationDateTo` 等于 `creationDateFrom`
+一天。
结束日期不包括在过滤间隔中。
type: string
format: date
shipmentDateFrom:
description: |
按发货到送货服务的日期筛选订单的开始日期（参数 `shipmentDate`).
日期格式: `YYYY-MM-DD`.
开始和结束日期之间（参数 `shipmentDateTo`）应该不超过30天。
开始日期包含在筛选的间隔中。
type: string
format: date
shipmentDateTo:
description: >
按发货到送货服务的日期筛选订单的结束日期（参数 `shipmentDate`).
日期格式: `YYYY-MM-DD`.
在初始（参数 `shipmentDateFrom`）和结束日期应不超过30天。
如果之间的时间间隔 `shipmentDateTo` 和
`shipmentDateFrom` 不到一天，那么
`shipmentDateTo` 等于 `shipmentDateFrom`
+一天。
结束日期不包括在过滤间隔中。
type: string
format: date
updateDateFrom:
description: 订单更新的初始日期（ISO 8601).
type: string
format: date-time
updateDateTo:
description: 订单更新的结束日期（ISO 8601).
type: string
format: date-time
fake:
description: >
订单类型:
* `false` — 真正的客户的订单。
* `true` —
[测试订单](../../concepts/sandbox.md) 燕基科斯. 市场。
type: boolean
waitingForCancellationApprove:
description: >
**只适用于型号 DBS**
用于接收具有取消请求的订单的过滤器。
与值 `true` 仅返回处于状态的那些订单。 `DELIVERY` 或
`PICKUP`，而用户决定取消它们。
type: boolean
sourcePlatforms:
description: 平台是订单的来源。
nullable: true
uniqueItems: true
type: array
items:
description: |
该网站是订单的来源:
* `MARKET` — 市场上的订单。
* `OTHER` — LaaS是卖方创建的订单。
type: string
enum:
- MARKET
- OZON
- WILDBERRIES
- OTHER
minItems: 1
bodyType: application/json
method: post
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: v1/businesses/{businessId}/orders
host: https://api.partner.market.yandex.ru
```
{% endlist %}