🚚 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 («İşletmeler için» → «Sözleşme yap») veya şehrinizdeki müşteri temsilcisi 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 |
|---|---|
| Sender address (Gönderici adresi) | CDEK'in kargoları aldığı veya sizin kargoları getirdiğiniz depo ya da mağaza adresi |
| Which tariffs to show (Gösterilecek tarifeler) | «Warehouse-to-warehouse» (depodan depoya) (teslim noktasına bırakırsınız, alıcı teslim noktasından alır), «Warehouse-to-door» (depodan kapıya) (kurye alıcıya kadar), «Door-to-door» (kapıdan kapıya) (kurye sizden alır) |
| account (client_id) | Hesaptaki Account değeri |
| secure_password (client_secret) | Hesaptaki Secure password değeri |
Kontrol#
- «Save» (Kaydet) düğmesine basın.
- «Test connection» (Bağlantıyı kontrol et) düğmesine basın: kartın altında teslimat ücretleri görünecek. «Mock mode» (Demo modu) yazısı, anahtarların bağlı olmadığını ve teslimat ücretlerinin örnek olduğunu gösterir.
- Kartta «Enable CDEK shipping» (CDEK teslimatını 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 mode (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#
- «Connection failed» (Bağlantı kurulamadı) / invalid_client — anahtarların yeri karıştırılmış, kopyalarken boşluk girmiş veya canlı anahtarlarla «Test mode» açık. Test modunu kapatın ve Account ile Secure password'ü yeniden girin.
- Yanıtta teslimat ücreti yok — seçilen tarife bu güzergâhta geçerli değil — «Warehouse-to-door» (depodan kapıya) 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/