REST API CDEK — расчёт, заказы, статусы за 200 мс
Готовые модули для 9 платформ, webhooks, sandbox и документация на apidoc.cdek.ru. Доступ к API получают все клиенты с действующим договором.
- версия v2
- стоимость 0 ₽
- время ответа ~200 мс
Готовые модули для типовых платформ.
Официальные модули CDEK для популярных CMS и ecom-платформ. Обычно достаточно установить модуль, добавить ключи в админке и проверить тестовый заказ.
- [ 01 ]1С-Битрикс
Расчёт в корзине, выбор ПВЗ, накладные, отслеживание статусов.
- [ 02 ]1С (УТ, КА, ERP)
Обработка для Управления торговлей, Комплексной автоматизации и ERP.
- [ 03 ]WooCommerce
Плагин для WordPress. Карта ПВЗ в корзине, расчёт стоимости, ТТН.
- [ 04 ]Tilda
Встроенный блок CDEK на платформе. Включается в настройках сайта.
- [ 05 ]InSales
Встроенный модуль платформы. Включается в админке за 10 минут.
- [ 06 ]OpenCart
Модуль для версий 2.x и 3.x. Доставка курьером, ПВЗ, постаматы.
- [ 07 ]Ecwid
Cloud-приложение. Расчёт стоимости, выбор ПВЗ на карте, статусы.
- [ 08 ]МойСклад
Двусторонняя синхронизация заказов, автосоздание накладных.
- [ 09 ]RetailCRM
Модуль доставки в CRM. Управление заказами и трекинг в одном окне.
↗ Остальные готовые модули — на странице cdek.ru/ru/integration/modules
Ключевые эндпоинты API.
Базовый URL — api.cdek.ru. Авторизация — OAuth2 client_credentials. Клик по строке копирует путь в буфер.
https://api.cdek.ru Webhooks вместо постоянного опроса API.
Вы регистрируете URL, а CDEK отправляет POST с JSON в момент наступления события. Это снижает нагрузку на API и ускоряет реакцию ваших внутренних систем.
- ORDER_STATUS
Смена статуса заказа
Создан, передан перевозчику, в пути, прибыл в ПВЗ, выдан, возврат.
payload{ "type":"ORDER_STATUS", "uuid":"72753bee-...", "code":"DELIVERED", "date_time":"2026-05-08T14:23:00+03:00", "city":"Новосибирск" } - PRINT_FORM
Готова печатная форма
PDF накладной сформирован и доступен для скачивания.
payload{ "type":"PRINT_FORM", "uuid":"a4b2c8e1-...", "url":"https://api.cdek.ru/print/...", "ready":true } - DELIVERY_POINT
Изменение ПВЗ
Открыли, закрыли, изменили режим работы или габаритные ограничения.
payload{ "type":"DELIVERY_POINT", "code":"NSK11", "action":"UPDATED", "fields":["work_time","weight_max"] } - DOWNLOAD_PHOTO
Загрузка фото при доставке
Курьер прикрепил фото подписи или вручения. Доступно по ссылке.
payload{ "type":"DOWNLOAD_PHOTO", "uuid":"72753bee-...", "photo_url":"https://api.cdek.ru/...", "kind":"DELIVERY" }
Sandbox и production без разницы в API-контракте.
Тестовая среда подходит для разработки и приёмки, боевая — для реальных отправлений. Структура эндпоинтов в обеих средах совпадает.
https://api.edu.cdek.ru Тестовая среда. Ключи для разработки выдаются по запросу через менеджера.
- Полный цикл: заказы, накладные, статусы
- Тестовые webhooks без реальных доставок
- Эмуляция статусов и сроков
- Без затрат на доставку
https://api.cdek.ru Боевая среда. Ключи появляются в личном кабинете после подписания договора.
- Реальная регистрация отправлений
- Боевые webhooks с фактическими событиями
- 10 запросов/сек на ключ — рекомендуемый rate-limit
- Поддержка batch-операций
Первый запрос можно сделать за 30 минут.
Если договор уже действует, ключи доступны в личном кабинете сразу. Если договора ещё нет, его можно оформить за один рабочий день.
- STEP 01
Получите ключи в личном кабинете
В разделе «Интеграции → API» сгенерируйте client_id и client_secret. Сохраните их в защищённом хранилище и перевыпустите при подозрении на компрометацию.
# .env CDEK_CLIENT_ID=<your-client-id> CDEK_CLIENT_SECRET=<your-client-secret>
- STEP 02
Получите OAuth-токен
Эндпоинт `/oauth/token` с grant_type=client_credentials. Токен живёт 1 час, обновляйте по истечении.
curl -X POST https://api.cdek.ru/oauth/token \ -d "grant_type=client_credentials" \ -d "client_id=$CDEK_CLIENT_ID" \ -d "client_secret=$CDEK_CLIENT_SECRET"
- STEP 03
Сделайте первый расчёт
POST `/calculator/tarifflist` с кодами городов и весом. Ответ — массив тарифов с ценой и сроком.
POST /calculator/tarifflist Authorization: Bearer eyJhbGc... { "from_location": { "code": 270 }, "to_location": { "code": 44 }, "packages": [{ "weight": 2000 }] }
Частые вопросы по интеграции.
1 Сколько стоит подключение к API?
API бесплатен. Доступ открывается всем клиентам с действующим договором CDEK. После подключения вы получаете ключи доступа в личном кабинете и можете сразу работать с production-средой.
2 Есть ли тестовая среда для разработки?
Да. Sandbox доступен по адресу api.edu.cdek.ru. Тестовые ключи выдаются по запросу через менеджера. В тестовой среде можно создавать заказы, получать статусы и проверять webhooks без реальных отправлений.
3 Какой плагин выбрать, если у меня сайт на WordPress?
Для WordPress обычно выбирают официальный плагин CDEK для WooCommerce. Он поддерживает расчёт стоимости в корзине, выбор ПВЗ на карте, передачу заказа в CDEK после оформления и обновление статусов. Подключение обычно занимает 1–2 часа.
4 Что делать, если нет готового плагина для моей CMS?
В этом случае используется кастомная интеграция через REST API. На базовый набор операций — расчёт, создание заказа и получение статусов — обычно уходит 1–5 дней разработки. Документация подробная, есть примеры на PHP, Python и JavaScript.
5 Поддерживаются ли webhooks — push-уведомления о статусах?
Да. Webhooks доступны для событий смены статуса заказа, формирования печатной формы, изменения данных ПВЗ и загрузки фото при доставке. URL можно зарегистрировать в личном кабинете или через API.
6 Как часто можно опрашивать API без блокировок?
Публично жёсткие rate-limit не заявлены, но рекомендуется не превышать 10 запросов в секунду на ключ. Для массовых операций есть batch-методы. Если нужны статусы и события, webhooks обычно эффективнее, чем постоянный polling.
7 Можно ли получить список всех ПВЗ для отображения на карте?
Да. Метод `/deliverypoints` возвращает ПВЗ с координатами, адресами, режимом работы и габаритными ограничениями. Данные можно фильтровать по городу, типу точки и доступным услугам. Список регулярно обновляется.
8 Что входит в данные о статусе заказа?
В ответе доступны текущий статус, история изменений с датами, ориентировочный срок доставки, информация о попытках вручения, а при наличии — фото от курьера и причина возврата.
9 Как формируется и печатается накладная?
После создания заказа через API можно получить печатную форму в PDF через метод `/print/orders`. Поддерживается поштучная и пакетная печать. Штрихкод из PDF считывается в ПВЗ, также доступна термопечать на этикетках 100×100 мм.
10 Какие SDK или библиотеки есть для разработчиков?
Официальных SDK у CDEK нет — интеграция строится поверх REST API. На GitHub есть community-библиотеки для PHP, Python и Node.js. Перед внедрением стоит проверить, поддерживают ли они API v2 и как давно обновлялись.
Договор — и доступ к API уже на следующий день.
Ключи открываются всем клиентам с действующим договором. Заявка занимает 2 минуты, оформление договора — 1 рабочий день. API, плагины и webhooks входят в подключение.