---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/orders-receive.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/orders-receive.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/orders-receive.md
  - href: zh/step-by-step/orders-receive.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt

# 接收订单：API调查或通知

选择以下方法之一：API通知（推荐）或通过订单信息的定期调查。

## 方法1。 空气污染指数通知书

<!-- source: zh/_includes/mermaid/orders-receive-notification.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的商店
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
      note right of Merchant: 接收新订单通知
      Market -->> Merchant: POST notification
    end

    rect rgb(251, 243, 232)
      note right of Merchant: 获取新订单信息
      Merchant ->> Market: POST v1/businesses/{businessId}/orders
      Market -->>+ Merchant: OK: 订单信息
      Merchant ->>- Merchant: 检查订单商品<br>库存情况
    end
```
<!-- endsource: zh/_includes/mermaid/orders-receive-notification.md -->

- 启用请求接受 [POST 通知书](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)
- 立即接收订单事件并请求详细信息: [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md)
- 通知类型和数据格式: [POST 通知书](https://yandex.com/dev/market/partner-api/doc/zh/push-notifications/reference/sendNotification.md)

## 方法2。 定期空气污染指数调查

<!-- source: zh/_includes/mermaid/orders-receive-poll.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的商店
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: 获取新订单列表
        Merchant ->> Market: POST v1/businesses/{businessId}/orders
        Market -->>+ Merchant: OK: 订单列表
        Merchant ->>- Merchant: 检查商品<br>库存情况
    end
```
<!-- endsource: zh/_includes/mermaid/orders-receive-poll.md -->

- 请求订单列表:
  - [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md)
- 使用过滤器:
  - `fromDate` 和 `toDate` — 抽样新订单的交货日期范围
  - `updatedAtFrom` 和 `updatedAtTo` — 更改订单的选择
- 观察轮询间隔:
  - Express — 每10-15分钟一班
  - FBS, DBS — 至少每小时一次
- 要处理特定订单，请使用以下方法获取详细信息 [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md)