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