# Яндекс Доставка API (Доставка по России): Напечатать ярлыки на посылки

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

Подготовить отгрузку: ярлыки на каждое место и акт приёма-передачи для курьера.

1. Получи ярлыки: POST /api/b2b/platform/request/generate-labels со списком request_ids. generate_type = one печатает по ярлыку на лист, many — несколько на лист; label_size_mm — размер под твой принтер (100x150 для термопринтера, 210x297 — лист A4).
2. Наклей ярлык на каждое грузоместо.
3. Для передачи курьеру сформируй акт методом /api/b2b/platform/request/get-handover-act.

```bash
curl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/generate-labels \
  -H "Authorization: Bearer $YD_TOKEN" -H 'Content-Type: application/json' \
  -o labels.pdf \
  -d '{"request_ids": ["77241d8009bb46d0bff5c65a73077bcd-udp"], "generate_type": "one", "label_size_mm": "100x150"}'
```

## Базовые 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.

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

### POST /api/b2b/platform/request/generate-labels — Получение ярлыков

Акты приёма-передачи — `POST /api/b2b/platform/request/get-handover-act`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `request_ids` | body | array | да | ID заказов |
| `generate_type` | body | string | нет | one (по одному на лист, по умолчанию) или many |
| `label_size_mm` | body | string | нет | 210x297 (по умолчанию), 100x150, 75x120, 58x60, 58x40 |
| `language` | body | string | нет | Язык надписей, по умолчанию ru |

## Нюансы

- Основной поток — двухшаговый: `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/otsledit-zakaz-i-pri-neobhodimosti.md)

---

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