СДЭК API v2: POST /v2/print/orders — Формирование квитанции к заказу

Асинхронно формирует квитанцию; готовый PDF — GET /v2/print/orders/{uuid}.pdf. Штрихкод места — POST /v2/print/barcodes.

Базовые URL

• Боевой: https://api.cdek.ru
• Тестовый: https://api.edu.cdek.ru

Авторизация

Тип: OAuth 2.0

OAuth 2.0 (client credentials). Токен получают запросом POST /v2/oauth/token с grant_type=client_credentials, client_id (Account) и client_secret (Secure password) из личного кабинета СДЭК (раздел интеграции) и передают в заголовке Authorization: Bearer <token> (JWT). Для интеграции нужен договор со СДЭК.

Тестовая учётная запись для api.edu.cdek.ru (из документации):

Нюансы

• Создание сущностей асинхронное: статус запроса ACCEPTED означает только первичную валидацию, итог — SUCCESSFUL или INVALID. Обычно 200–500 мс, при пиковой нагрузке до 30–60 секунд; опрашивайте с паузой 2–3 секунды.
• В POST /v2/orders нельзя одновременно передавать shipment_point и from_location, а также delivery_point и to_location.
• Вес в граммах, габариты в сантиметрах.
• Изменять заказ можно только в статусах CREATED и ACCEPTED.
• Вебхуки: таймаут подключения 15 секунд, при ошибках — до 12 повторов за 75 минут, потом доставка прекращается.
• Данные о сущностях, созданных через API, хранятся 1 год.
• Сообщения — в UTF-8; обязательные поля не могут быть пустыми.

Сценарии с этим методом

• Напечатать квитанцию и вызвать курьера

---

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