🚚 CDEK: conectare și chei API
Contract cu CDEK, cheie API în contul personal (Account și Secure password), tarife depozit-depozit/depozit-ușă, mediul de test EDU, CDEK Kazahstan și Belarus.
Unde se configurează: Panoul de control → „Expedieri” → butonul „Servicii de livrare” (sau fișa punctului de lucru → WEB → „Servicii de livrare”).
Ce este necesar#
- contract cu CDEK pentru persoană juridică sau întreprinzător individual;
- acces la contul personal lk.cdek.ru;
- adresa de unde predați coletele (depozit, magazin sau birou).
Cum obțineți cheile în contul serviciului#
- Încheiați un contract cu CDEK: cerere pe site-ul cdek.ru („Pentru business” → „Încheierea contractului”) sau prin managerul din orașul dumneavoastră. Fără contract, cheile API nu se emit.
- Autentificați-vă în contul personal lk.cdek.ru cu contul pe care este încheiat contractul.
- Deschideți secțiunea „Integrare” și creați o cheie pentru API (dacă cheia există deja — folosiți-o).
- Copiați două valori: Account (identificatorul clientului) și Secure password (parola secretă). Păstrați Secure password ca pe o parolă: nu îl trimiteți prin mesagerie.
Ce se completează în fișa serviciului#
| Câmp | Ce se completează |
|---|---|
| Adresa expeditorului | adresa depozitului sau magazinului de unde CDEK ridică ori unde dumneavoastră aduceți coletele |
| Ce tarife se afișează | „depozit-depozit” (predați la punctul de ridicare, cumpărătorul ridică de la punctul de ridicare), „depozit-ușă” (curier până la cumpărător), „ușă-ușă” (curierul ridică de la dumneavoastră) |
| account (client_id) | valoarea Account din contul personal |
| secure_password (client_secret) | valoarea Secure password din contul personal |
Verificare#
- Apăsați „Salvează”.
- Apăsați „Verifică conexiunea”: sub fișă vor apărea tarifele. Mențiunea „Mod mock” înseamnă că cheile nu sunt conectate și tarifele sunt demonstrative.
- Bifați „Activează …” în fișă — după aceasta serviciul va apărea pentru cumpărător la finalizarea comenzii.
Fără chei și modul de test#
Fără chei, fișa funcționează în mediul de instruire CDEK, iar dacă acesta nu este disponibil — afișează tarife demonstrative: astfel puteți vedea cum arată livrarea în vitrină, chiar înainte de contract. Caseta „Mod de test (sandbox)” trimite solicitări către mediul de instruire api.edu.cdek.ru — pentru acesta sunt necesare chei de test separate, emise de CDEK (cheile demo publicate în documentație sunt respinse).
Probleme frecvente#
- „Eroare de conexiune” / invalid_client — cheile sunt inversate, copiate cu un spațiu sau este activat „Modul de test” cu chei de producție. Dezactivați modul de test și introduceți din nou Account și Secure password.
- Nu există tarife în răspuns — tariful selectat nu funcționează pe această rută — bifați și „depozit-ușă” sau verificați adresa expeditorului.
- Magazin în Kazahstan sau Belarus — CDEK Kazahstan (cdek.kz) și CDEK Belarus (cdek.by) sunt companii separate: cheile contului personal din Rusia nu funcționează acolo, este nevoie de un contract și un cont personal la CDEK local. Procedura de obținere a cheilor este aceeași.
Linkuri#
- Site-ul serviciului: https://www.cdek.ru/
- Contul personal: https://lk.cdek.ru/
- Documentația API: https://apidoc.cdek.ru/