🚚 СДЭК: підключення та ключі 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/