🚚 CDEK: integrasi dan kunci API
Perjanjian dengan CDEK, kunci API di akun pribadi (Account dan Secure password), biaya pengiriman gudang-gudang/gudang-pintu, lingkungan uji EDU, CDEK Kazakhstan dan Belarus.
Tempat pengaturan: Panel kontrol → «Pengiriman» → tombol «Layanan pengiriman» (atau kartu cabang → WEB → «Layanan pengiriman»).
Yang diperlukan#
- perjanjian dengan CDEK untuk badan hukum atau perorangan usaha;
- akses ke akun pribadi lk.cdek.ru;
- alamat tempat Anda menyerahkan paket (gudang, toko, atau kantor).
Cara mendapatkan kunci di akun layanan#
- Buat perjanjian dengan CDEK: permohonan di situs cdek.ru («Bisnis» → «Buat perjanjian») atau melalui manajer di kota Anda. Tanpa perjanjian, kunci API tidak diterbitkan.
- Masuk ke akun pribadi lk.cdek.ru dengan akun yang digunakan untuk membuat perjanjian.
- Buka bagian «Integrasi» dan buat kunci untuk API (jika kunci sudah ada — gunakan kunci tersebut).
- Salin dua nilai: Account (identitas klien) dan Secure password (kata sandi rahasia). Simpan Secure password seperti kata sandi: jangan mengirimkannya melalui aplikasi pesan.
Yang diisi di kartu layanan#
| Kolom | Yang diisi |
|---|---|
| Alamat pengirim | alamat gudang atau toko tempat CDEK menjemput atau tempat Anda mengantar paket |
| Biaya pengiriman yang ditampilkan | «gudang-gudang» (Anda menyerahkan di titik pengambilan, pembeli mengambil di titik pengambilan), «gudang-pintu» (kurir sampai ke pembeli), «pintu-pintu» (kurir menjemput dari Anda) |
| account (client_id) | nilai Account dari akun |
| secure_password (client_secret) | nilai Secure password dari akun |
Pemeriksaan#
- Klik «Simpan».
- Klik «Periksa integrasi»: biaya pengiriman akan muncul di bawah kartu. Tulisan «Mode tiruan» berarti kunci belum terhubung dan biaya pengiriman hanya demonstrasi.
- Centang «Aktifkan …» di kartu — setelah itu layanan akan muncul bagi pembeli saat menyelesaikan pesanan.
Tanpa kunci dan mode uji#
Tanpa kunci, kartu berfungsi di lingkungan uji CDEK, dan jika tidak tersedia — menampilkan biaya pengiriman demonstrasi: dengan begitu Anda dapat melihat bagaimana pengiriman tampil di etalase, bahkan sebelum ada perjanjian. Centang «Mode uji (sandbox)» mengirim permintaan ke lingkungan uji api.edu.cdek.ru — untuk itu diperlukan kunci uji terpisah, yang diterbitkan oleh CDEK (kunci demo yang dipublikasikan di dokumentasi ditolaknya).
Masalah umum#
- «Kesalahan integrasi» / invalid_client — kunci tertukar, tersalin dengan spasi, atau «Mode uji» aktif dengan kunci produksi. Nonaktifkan mode uji dan masukkan kembali Account dan Secure password.
- Biaya pengiriman tidak ada dalam respons — biaya pengiriman yang dipilih tidak berlaku untuk tujuan ini — centang juga «gudang-pintu» atau periksa alamat pengirim.
- Toko di Kazakhstan atau Belarus — CDEK Kazakhstan (cdek.kz) dan CDEK Belarus (cdek.by) adalah perusahaan terpisah: kunci akun Rusia tidak berfungsi di sana, diperlukan perjanjian dan akun CDEK setempat. Prosedur mendapatkan kunci sama.
Tautan#
- Situs layanan: https://www.cdek.ru/
- Akun: https://lk.cdek.ru/
- Dokumentasi API: https://apidoc.cdek.ru/