🚚 СДЭК: подключение и ключи API
Договор со СДЭК, ключ API в личном кабинете (Account и Secure password), тарифы склад-склад/склад-дверь, тестовый контур EDU, СДЭК Казахстан и Беларусь.
Где настраивается: Панель управления → «Отправления» → кнопка «Службы доставки» (или карточка точки → WEB → «Службы доставки»).
Что понадобится#
- договор со СДЭК на юрлицо или ИП;
- доступ в личный кабинет lk.cdek.ru;
- адрес, откуда вы отдаёте посылки (склад, магазин или офис).
Как получить ключи в кабинете службы#
- Заключите договор со СДЭК: заявка на сайте cdek.ru («Бизнесу» → «Заключить договор») или через менеджера вашего города. Без договора ключи API не выдаются.
- Войдите в личный кабинет lk.cdek.ru под учётной записью, на которую оформлен договор.
- Откройте раздел «Интеграция» и создайте ключ для API (если ключ уже есть — используйте его).
- Скопируйте два значения: Account (идентификатор клиента) и Secure password (секретный пароль). Secure password храните как пароль: не пересылайте его в мессенджерах.
Что вписать в карточку службы#
| Поле | Что вписать |
|---|---|
| Адрес отправителя | адрес склада или магазина, откуда СДЭК забирает или куда вы привозите посылки |
| Какие тарифы показывать | «склад-склад» (сдаёте в ПВЗ, покупатель забирает в ПВЗ), «склад-дверь» (курьер до покупателя), «дверь-дверь» (курьер забирает у вас) |
| account (client_id) | значение Account из кабинета |
| secure_password (client_secret) | значение Secure password из кабинета |
Проверка#
- Нажмите «Сохранить».
- Нажмите «Проверить подключение»: под карточкой появятся тарифы. Надпись «Мок-режим» означает, что ключи не подключены и тарифы демонстрационные.
- Отметьте «Включить …» в карточке — после этого служба появится у покупателя на оформлении заказа.
Без ключей и тестовый режим#
Без ключей карточка работает в учебном контуре СДЭК, а если он недоступен — показывает демонстрационные тарифы: так можно посмотреть, как доставка выглядит на витрине, ещё до договора. Галочка «Тестовый режим (sandbox)» отправляет запросы в учебный контур api.edu.cdek.ru — для него нужны отдельные тестовые ключи, их выдаёт СДЭК (опубликованные в документации демо-ключи он отклоняет).
Частые проблемы#
- «Ошибка подключения» / invalid_client — ключи перепутаны местами, скопированы с пробелом или включён «Тестовый режим» с боевыми ключами. Выключите тестовый режим и вставьте Account и Secure password заново.
- Тарифов нет в ответе — выбранный тариф не работает по этому направлению — отметьте ещё «склад-дверь» или проверьте адрес отправителя.
- Магазин в Казахстане или Беларуси — СДЭК Казахстан (cdek.kz) и СДЭК Беларусь (cdek.by) — отдельные компании: ключи российского кабинета там не работают, нужен договор и кабинет местного СДЭК. Порядок получения ключей тот же.
Ссылки#
- Сайт службы: https://www.cdek.ru/
- Кабинет: https://lk.cdek.ru/
- Документация API: https://apidoc.cdek.ru/