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

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

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

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

```bash
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://mcp-everything.ru/integrations/yandex-delivery/scenarios/rasschitat-stoimost-dostavki.md)
- [Показать пункты выдачи и постаматы в городе](https://mcp-everything.ru/integrations/yandex-delivery/scenarios/pokazat-punkty-vydachi-i-postamaty.md)
- [Создать заказ: выбрать вариант доставки и подтвердить](https://mcp-everything.ru/integrations/yandex-delivery/scenarios/sozdat-zakaz-vybrat-variant-dostavki.md)
- [Напечатать ярлыки на посылки](https://mcp-everything.ru/integrations/yandex-delivery/scenarios/napechatat-yarlyki-na-posylki.md)

---

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