🚚 СДЭК: свързване и 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/