🚚 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/