Яндекс Доставка API (Доставка по России): Отследить заказ и при необходимости отменить

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

Показать покупателю статус доставки и отменить заявку, если заказ отменён.

Узнай статус: GET /api/b2b/platform/request/info с request_id (или request_code — твоим номером заказа). История статусов — /api/b2b/platform/request/history, актуальная дата доставки — /api/b2b/platform/request/actual_info.
Для синхронизации многих заказов используй выборку за период — /api/b2b/platform/requests/info, а не опрос по одному.
Отмени заявку: POST /api/b2b/platform/request/cancel с request_id. Курьерскую заявку можно отменить до статуса DELIVERY_TRANSPORTATION_RECIPIENT. В ответе status, reason и description — проверь, что отмена прошла.

curl -G https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/info \
  -H "Authorization: Bearer $YD_TOKEN" \
  -d request_id=77241d8009bb46d0bff5c65a73077bcd-udp

curl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/cancel \
  -H "Authorization: Bearer $YD_TOKEN" -H 'Content-Type: application/json' \
  -d '{"request_id": "77241d8009bb46d0bff5c65a73077bcd-udp"}'

Базовые URL

Боевой: https://b2b-authproxy.taxi.yandex.net
Тестовый: https://b2b.taxi.tst.yandex.net

Авторизация

Тип: Bearer-токен

Bearer-токен в заголовке Authorization: Bearer <token>. Для продакшена токен берут в личном кабинете в разделе «Профиль»; ID склада отгрузки (platform_station_id) выдаёт коммерческий менеджер.

Для тестового контура в документации даны:

Для корректной работы нужен TLS 1.2 и выше с шифрами по стандарту PCI DSS v4.

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

GET /api/b2b/platform/request/info — Информация о заявке

История статусов — GET /api/b2b/platform/request/history, актуальная дата доставки — GET /api/b2b/platform/request/actual_info, заявки за период — POST /api/b2b/platform/requests/info.

Параметр	Где	Тип	Обяз.	Описание
`request_id`	query	string	нет	ID заявки в платформе
`request_code`	query	string	нет	Номер заказа в системе заказчика

POST /api/b2b/platform/request/cancel — Отмена заявки

Курьерскую заявку можно отменить до статуса DELIVERY_TRANSPORTATION_RECIPIENT.

В ответе: status (CREATED, SUCCESS и др.), reason, description.

Параметр	Где	Тип	Обяз.	Описание
`request_id`	body	string	да	ID заявки в платформе

Нюансы

Основной поток — двухшаговый: offers/create возвращает офферы с ограниченным сроком (expires_at), заявка создаётся только после offers/confirm.
Суммы в товарах передаются в копейках, вес — в граммах, габариты — в сантиметрах.
Для destination заполняется либо platform_station (ПВЗ), либо custom_location (доставка до двери) в соответствии с type.
operator_request_id должен быть уникальным для каждого заказа.
В тестовом контуре используйте тестовый токен и тестовый склад из документации; продакшен-ID склада выдаёт менеджер.

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

Если этого недостаточно — официальная документация: https://yandex.ru/support/delivery-profile/ru/api/other-day/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-delivery.md