🚚 CDEK: entegrasyon ve API anahtarları
CDEK ile sözleşme, kişisel hesaptaki API anahtarı (Account ve Secure password), depo-depo/depo-kapı teslimat ücretleri, EDU test ortamı, CDEK Kazakistan ve Belarus.
Nerede yapılandırılır: Yönetim paneli → «Gönderiler» → «Teslimat hizmetleri» düğmesi (veya şube kartı → WEB → «Teslimat hizmetleri»).
Neye ihtiyacınız olacak#
- CDEK ile tüzel kişi veya şahıs işletmesi adına sözleşme;
- lk.cdek.ru kişisel hesabına erişim;
- kargoları teslim ettiğiniz adres (depo, mağaza veya ofis).
Hizmet hesabında anahtarlar nasıl alınır#
- CDEK ile sözleşme yapın: cdek.ru sitesinden başvuru («Bize işletmeniz için» → «Sözleşme yapın») veya şehrinizdeki yönetici aracılığıyla. Sözleşme olmadan API anahtarları verilmez.
- Sözleşmenin düzenlendiği hesap ile lk.cdek.ru kişisel hesabına giriş yapın.
- «Entegrasyon» bölümünü açın ve API için bir anahtar oluşturun (anahtar zaten varsa onu kullanın).
- İki değeri kopyalayın: Account (müşteri kimliği) ve Secure password (gizli parola). Secure password'ü parola gibi saklayın: mesajlaşma uygulamalarında göndermeyin.
Hizmet kartına ne yazılır#
| Alan | Ne yazılır |
|---|---|
| Gönderici adresi | CDEK'in kargoları aldığı veya sizin kargoları getirdiğiniz depo ya da mağaza adresi |
| Hangi teslimat ücretleri gösterilsin | «depo-depo» (teslim noktasına bırakırsınız, alıcı teslim noktasından alır), «depo-kapı» (kurye alıcıya kadar), «kapı-kapı» (kurye sizden alır) |
| account (client_id) | Hesaptaki Account değeri |
| secure_password (client_secret) | Hesaptaki Secure password değeri |
Kontrol#
- «Kaydet» düğmesine basın.
- «Bağlantıyı kontrol et» düğmesine basın: kartın altında teslimat ücretleri görünecek. «Mock modu» yazısı, anahtarların bağlı olmadığını ve teslimat ücretlerinin örnek olduğunu gösterir.
- Kartta «Etkinleştir …» seçeneğini işaretleyin — bundan sonra hizmet, alıcının sipariş oluşturma ekranında görünür.
Anahtarlar olmadan ve test modu#
Anahtarlar olmadan kart, CDEK'in eğitim ortamında çalışır; bu ortam kullanılamıyorsa örnek teslimat ücretlerini gösterir: böylece sözleşmeden önce bile teslimatın vitrinde nasıl göründüğüne bakabilirsiniz. «Test modu (sandbox)» onay kutusu, istekleri api.edu.cdek.ru eğitim ortamına gönderir — bunun için ayrı test anahtarları gerekir, bunları CDEK verir (dokümantasyonda yayımlanan demo anahtarları reddeder).
Sık karşılaşılan sorunlar#
- «Bağlantı hatası» / invalid_client — anahtarların yeri karıştırılmış, kopyalarken boşluk girmiş veya canlı anahtarlarla «Test modu» açık. Test modunu kapatın ve Account ile Secure password'ü yeniden girin.
- Yanıtta teslimat ücreti yok — seçilen teslimat ücreti bu güzergâhta çalışmıyor — «depo-kapı» seçeneğini de işaretleyin veya gönderici adresini kontrol edin.
- Mağaza Kazakistan veya Belarus'ta — CDEK Kazakistan (cdek.kz) ve CDEK Belarus (cdek.by) ayrı şirketlerdir: Rusya hesabının anahtarları orada çalışmaz, yerel CDEK ile sözleşme ve hesap gerekir. Anahtar alma süreci aynıdır.
Bağlantılar#
- Hizmet sitesi: https://www.cdek.ru/
- Hesap: https://lk.cdek.ru/
- API dokümantasyonu: https://apidoc.cdek.ru/