# Яндекс Еда Vendor API: Временно закрыть ресторан и сверить заказы

Сценарий из mcp-everything. Актуально на 2026-10-24.

Кухня перегружена или ресторан закрыт на санитарный день — приём заказов останавливается из твоей системы. В конце месяца заказы сверяются с кассой.

1. Заблокируй приём заказов: POST /block на dc-partner.eda.yandex.net с vendorInfo (какие рестораны), from, to (без него блокировка бессрочная), message (причина) и tag. Заголовки — Authorization и Partner-Name.
2. Сними блокировку методом unblock, когда ресторан снова готов. Статус блокировок отдаёт отдельный метод статуса.
3. Для сверки выгрузи историю: POST /v1/orders-history с origin_ids (рестораны и тип доставки), from и to в RFC3339 и pagination. В ответе до 1000 заказов, история хранится 180 дней — выгружай ежемесячно.

```bash
curl -s -X POST https://dc-partner.eda.yandex.net/block \
  -H "Authorization: Bearer $PUSH_TOKEN" -H 'Partner-Name: <partner_name>' \
  -H 'Content-Type: application/json' \
  -d '{
        "vendorInfo": <рестораны в формате из документации метода>,
        "from": "2026-10-25T10:00:00.000+03:00",
        "to": "2026-10-25T23:00:00.000+03:00",
        "message": "Санитарный день",
        "tag": "<тег блокировки>"
      }'
```

## Базовые URL

- Боевой (push-методы Vendor Management Integration API): `https://dc-partner.eda.yandex.net`
- Методы меню, заказов, ресторанов, зон и графика размещаются на сервере партнёра (: `{host}`

## Авторизация

Тип: OAuth 2.0

На своей стороне партнёр реализует OAuth 2.0 `client_credentials`: метод `POST /security/oauth/token` выдаёт токен по `client_id`, `client_secret`, `grant_type` и `scope` (`read`, `write`). Яндекс Еда передаёт токен в каждом запросе как `Authorization: Bearer token`.

Для push-методов партнёр получает токен на стороне Яндекс Еды (`POST /oauth2/token` на `dc-partner.eda.yandex.net`) и передаёт заголовки `Authorization` и `Partner-Name`.

## Методы сценария

### POST /block — Блокировка ресторанов

Хост `dc-partner.eda.yandex.net`. Разблокировка — `POST /unblock`, статус блокировок — `POST /v2/status`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `Authorization` | header | string | нет | Токен |
| `Partner-Name` | header | string | нет | Имя партнёра |
| `vendorInfo` | body | array | да | Рестораны для блокировки |
| `from` | body | string | да | Начало блокировки |
| `to` | body | string | нет | Окончание; без него — навсегда |
| `message` | body | string | нет | Причина блокировки |
| `tag` | body | string | да | Тег блокировки |

### POST /v1/orders-history — История заказов

Хост `dc-partner.eda.yandex.net`. До 1000 заказов в ответе; история хранится 180 дней.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `origin_ids` | body | array | да | Рестораны партнёра и тип доставки в них |
| `from` | body | string | да | С какой даты, RFC3339 |
| `to` | body | string | да | По какую дату, RFC3339 |
| `service` | body | array | нет | Сервисы, для которых вернуть заказы |
| `status` | body | array | нет | Фильтр по статусам |
| `pagination` | body | object | да | Пагинация |

## Нюансы

- Направление вызовов: методы меню, заказов, ресторанов, зон доставки и графика реализует партнёр, а Яндекс Еда их вызывает; push-методы вызывает партнёр на `dc-partner.eda.yandex.net`.
- Модели запросов и ответов версионируются через `Content-Type`/`Accept`: `application/vnd.eats.order.v2+json`, `application/vnd.eats.menu.composition.v2+json` и т. п.
- Статус заказа меняется только вперёд по цепочке; приготовленный заказ нельзя снова сделать новым.
- Даты — RFC3339 с дробной частью секунд.
- Есть также методы отзывов (`POST /v1/feedback`, `POST /feedback-answer`), зон доставки (`GET /places/{restaurantId}/zones`), графика работы (`GET /places/{restaurantId}/schedule`) и валидации кода курьера.

## Другие сценарии

- [Принимать заказы Яндекс Еды в своей системе](https://mcp-everything.ru/integrations/yandex-eda-vendor/scenarios/prinimat-zakazy-yandeks-edy-v-svoey.md)
- [Отдавать меню и стоп-лист](https://mcp-everything.ru/integrations/yandex-eda-vendor/scenarios/otdavat-menyu-i-stop-list.md)

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/eda-vendor/doc/ru/ref/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-eda-vendor.md