СДЭК API v2: POST /v2/orders — Регистрация заказа

Создаёт заказ на доставку. Возвращает 202 Accepted с UUID заказа и статусом запроса; статус ACCEPTED не гарантирует создание заказа.

Параметр	Где	Тип	Обяз.	Описание
type	body	integer	нет	1 — интернет-магазин, 2 — доставка
number	body	string	нет	Номер заказа в системе клиента (для ИМ), до 40 символов
tariff_code	body	integer	да	Код тарифа
comment	body	string	нет	Комментарий
shipment_point	body	string	нет	ПВЗ, куда клиент привезёт посылку; не вместе с from_location
delivery_point	body	string	нет	ПВЗ доставки; обязателен для тарифов «до склада»
sender	body	object	нет	Отправитель; обязателен для типа «доставка»
recipient	body	object	да	Получатель
recipient.name	body	string	да	ФИО контактного лица
recipient.phones	body	array	да	Телефоны (до 10): number, additional
recipient.email	body	string	нет	Email
from_location	body	object	нет	Адрес отправления; не вместе с shipment_point
to_location	body	object	нет	Адрес получения; не вместе с delivery_point
to_location.address	body	string	нет	Строка адреса
to_location.code	body	integer	нет	Код населённого пункта СДЭК
delivery_recipient_cost	body	object	нет	Доп. сбор за доставку с получателя (для ИМ)
services	body	array	нет	Дополнительные услуги
packages	body	array	да	Места, от 1 до 255
packages[].number	body	string	да	Номер упаковки
packages[].weight	body	integer	да	Вес, граммы
packages[].length	body	integer	нет	Длина, см
packages[].width	body	integer	нет	Ширина, см
packages[].height	body	integer	нет	Высота, см
packages[].items	body	array	нет	Товары; обязательно для заказов «интернет-магазин»
packages[].items[].name	body	string	да	Наименование товара
packages[].items[].ware_key	body	string	да	Артикул
packages[].items[].payment	body	object	да	Оплата при получении за единицу (value ≥ 0)
packages[].items[].cost	body	number	да	Объявленная стоимость за единицу
packages[].items[].weight	body	integer	да	Вес
packages[].items[].amount	body	integer	да	Количество
packages[].items[].marking	body	string	нет	Код маркировки «Честный знак»
print	body	string	нет	Тип печатной формы для формирования

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