🚚 СДЭК: поврзување и 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/