🚚 CDEK: integracja i klucze API
Umowa z CDEK, klucz API w panelu klienta (Account i Secure password), opłaty za dostawę magazyn-magazyn/magazyn-drzwi, środowisko testowe EDU, CDEK Kazachstan i Białoruś.
Gdzie się konfiguruje: Panel sterowania → „Wysyłki” → przycisk „Firmy kurierskie” (lub karta placówki → WEB → „Firmy kurierskie”).
Co będzie potrzebne#
- umowa z CDEK na osobę prawną lub jednoosobową działalność gospodarczą;
- dostęp do panelu klienta lk.cdek.ru;
- adres, z którego wydajesz paczki (magazyn, sklep lub biuro).
Jak uzyskać klucze w panelu klienta firmy kurierskiej#
- Zawrzyj umowę z CDEK: wniosek na stronie cdek.ru („Dla biznesu” → „Zawrzeć umowę”) lub przez menedżera w Twoim mieście. Bez umowy klucze API nie są wydawane.
- Zaloguj się do panelu klienta lk.cdek.ru na konto, na które została zawarta umowa.
- Otwórz sekcję „Integracja” i utwórz klucz do API (jeśli klucz już istnieje — użyj go).
- Skopiuj dwie wartości: Account (identyfikator klienta) i Secure password (hasło tajne). Secure password przechowuj jak hasło: nie przesyłaj go w komunikatorach.
Co wpisać w karcie firmy kurierskiej#
| Pole | Co wpisać |
|---|---|
| Adres nadawcy | adres magazynu lub sklepu, z którego CDEK odbiera lub do którego przywozisz paczki |
| Które opłaty za dostawę pokazywać | „magazyn-magazyn” (oddajesz w punkcie odbioru, kupujący odbiera w punkcie odbioru), „magazyn-drzwi” (kurier do kupującego), „drzwi-drzwi” (kurier odbiera od Ciebie) |
| account (client_id) | wartość Account z panelu klienta |
| secure_password (client_secret) | wartość Secure password z panelu klienta |
Sprawdzenie#
- Kliknij „Zapisz”.
- Kliknij „Sprawdź połączenie”: pod kartą pojawią się opłaty za dostawę. Napis „Tryb mock” oznacza, że klucze nie są podłączone, a opłaty za dostawę są demonstracyjne.
- Zaznacz „Włącz …” w karcie — po tym firma kurierska pojawi się u kupującego przy składaniu zamówienia.
Bez kluczy i tryb testowy#
Bez kluczy karta działa w środowisku szkoleniowym CDEK, a jeśli jest ono niedostępne — pokazuje demonstracyjne opłaty za dostawę: tak można zobaczyć, jak dostawa wygląda w sklepie, jeszcze przed zawarciem umowy. Pole „Tryb testowy (sandbox)” wysyła zapytania do środowiska szkoleniowego api.edu.cdek.ru — wymaga ono osobnych kluczy testowych, które wydaje CDEK (opublikowane w dokumentacji klucze demo są przez nie odrzucane).
Częste problemy#
- „Błąd połączenia” / invalid_client — klucze są pomylone miejscami, skopiowane ze spacją lub włączony jest „Tryb testowy” z kluczami produkcyjnymi. Wyłącz tryb testowy i wstaw Account oraz Secure password ponownie.
- Brak opłat za dostawę w odpowiedzi — wybrana opłata za dostawę nie działa dla tego kierunku — zaznacz jeszcze „magazyn-drzwi” lub sprawdź adres nadawcy.
- Sklep w Kazachstanie lub na Białorusi — CDEK Kazachstan (cdek.kz) i CDEK Białoruś (cdek.by) to osobne firmy: klucze rosyjskiego panelu klienta tam nie działają, potrzebna jest umowa i panel klienta lokalnego CDEK. Sposób uzyskania kluczy jest taki sam.
Linki#
- Strona firmy kurierskiej: https://www.cdek.ru/
- Panel klienta: https://lk.cdek.ru/
- Dokumentacja API: https://apidoc.cdek.ru/