---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
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: ru/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/ru/llms.txt

# Получение заказов: опрос API или уведомления

Выберите один из способов: API‑уведомления (рекомендуется) или через регулярный опрос информации по заказам.

## Способ 1. API‑уведомления

<!-- source: ru/_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 Яндекс Маркет

    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: ru/_includes/mermaid/orders-receive-notification.md -->

- Подключите прием запросов [POST notification](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/reference/sendNotification.md). Как работать с уведомлениями: [Инструкция](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/index.md)
- Получайте события о заказах и сразу запрашивайте подробности: [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/ru/reference/orders/getBusinessOrders.md)
- Типы уведомлений и формат данных: [POST notification](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/reference/sendNotification.md)

## Способ 2. Регулярный опрос API

<!-- source: ru/_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 Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Получение списка новых заказов
        Merchant ->> Market: POST v1/businesses/{businessId}/orders
        Market -->>+ Merchant: OK: список заказов.
        Merchant ->>- Merchant: Проверяет наличие<br>заказанных товаров.
    end

```
<!-- endsource: ru/_includes/mermaid/orders-receive-poll.md -->

- Запрашивайте списки заказов:
  - [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/ru/reference/orders/getBusinessOrders.md)
- Используйте фильтры:
  - `fromDate` и `toDate` — диапазон дат доставки для выборки новых заказов
  - `updatedAtFrom` и `updatedAtTo` — выборка заказов с изменениями
- Соблюдайте интервалы опроса:
  - Экспресс — каждые 10-15 минут
  - FBS, DBS — не реже одного раза в час
- Для обработки определенного заказа получите детали с помощью метода [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/ru/reference/orders/getBusinessOrders.md)