🚚 CDEK: الربط ومفاتيح API
عقد مع CDEK، ومفتاح API في الحساب الشخصي (Account وSecure password)، ورسوم التوصيل من مستودع إلى مستودع ومن مستودع إلى باب، وبيئة الاختبار EDU، وCDEK كازاخستان وبيلاروسيا.
مكان الإعداد: لوحة التحكم → «الإرسالات» → زر «خدمات التوصيل» (أو بطاقة الفرع → WEB → «خدمات التوصيل»).
ما ستحتاجه#
- عقد مع CDEK لشخص اعتباري أو رجل أعمال فردي؛
- صلاحية الدخول إلى الحساب الشخصي lk.cdek.ru؛
- العنوان الذي تسلّم منه الطرود (مستودع أو متجر أو مكتب).
كيف تحصل على المفاتيح في حساب الخدمة#
- أبرم عقدًا مع CDEK: طلب على الموقع cdek.ru («للأعمال» → «إبرام عقد») أو عبر مدير مدينتك. بدون عقد لا تُمنح مفاتيح API.
- سجّل الدخول إلى الحساب الشخصي lk.cdek.ru بالحساب الذي أُبرم العقد باسمه.
- افتح قسم «التكاملات» وأنشئ مفتاحًا لـ API (إذا كان لديك مفتاح بالفعل — استخدمه).
- انسخ قيمتين: Account (معرّف العميل) وSecure password (كلمة المرور السرية). احفظ Secure password كما تحفظ كلمة المرور: لا ترسله في تطبيقات المراسلة.
ما تكتبه في بطاقة الخدمة#
| الحقل | ما تكتبه |
|---|---|
| عنوان المرسل | عنوان المستودع أو المتجر الذي يستلم منه CDEK أو الذي توصل إليه الطرود |
| رسوم التوصيل التي تظهر | «مستودع-مستودع» (تسلّم في نقطة استلام، ويستلم المشتري في نقطة استلام)، «مستودع-باب» (مندوب حتى المشتري)، «باب-باب» (المندوب يستلم من عندك) |
| account (client_id) | قيمة Account من الحساب |
| secure_password (client_secret) | قيمة Secure password من الحساب |
التحقق#
- اضغط «حفظ».
- اضغط «التحقق من الربط»: ستظهر رسوم التوصيل أسفل البطاقة. عبارة «وضع تجريبي» تعني أن المفاتيح غير مربوطة ورسوم التوصيل للعرض فقط.
- حدّد «تفعيل …» في البطاقة — بعد ذلك تظهر الخدمة للمشتري عند إتمام الطلب.
بدون مفاتيح ووضع الاختبار#
بدون مفاتيح تعمل البطاقة في بيئة الاختبار التعليمية لـ CDEK، وإذا كانت غير متاحة — تعرض رسوم توصيل للعرض: هكذا يمكنك رؤية شكل التوصيل في الواجهة قبل إبرام العقد. خيار «وضع الاختبار (sandbox)» يرسل الطلبات إلى بيئة الاختبار api.edu.cdek.ru — وتحتاج إلى مفاتيح اختبار منفصلة، يمنحها CDEK (المفاتيح التجريبية المنشورة في الوثائق يرفضها).
مشكلات شائعة#
- «خطأ في الربط» / invalid_client — المفاتيح متبادلة في مكانها، أو منسوخة مع مسافة، أو «وضع الاختبار» مفعّل مع مفاتيح حقيقية. أوقف وضع الاختبار وألصق Account وSecure password من جديد.
- لا توجد رسوم توصيل في الرد — رسوم التوصيل المختارة لا تعمل على هذا الاتجاه — حدّد أيضًا «مستودع-باب» أو تحقق من عنوان المرسل.
- متجر في كازاخستان أو بيلاروسيا — CDEK كازاخستان (cdek.kz) وCDEK بيلاروسيا (cdek.by) شركتان منفصلتان: مفاتيح الحساب الروسي لا تعمل هناك، ويلزم عقد وحساب لدى CDEK المحلي. طريقة الحصول على المفاتيح هي نفسها.
روابط#
- موقع الخدمة: https://www.cdek.ru/
- الحساب: https://lk.cdek.ru/
- وثائق API: https://apidoc.cdek.ru/