שילוב DPD API: דוגמאות קוד PHP ומדריך

מדריך זה עוזר לך לשלב משלוחי DPD באתר שלך במהירות. בעת שילוב DPD, מפתחים נתקלים לעתים קרובות בפרוטוקול SOAP: שגיאות בגוף התשובה, מערכת קידוד ערים קניינית, ושדות לא ברורים להזמנות. לדוגמה, כדי ליצור הזמנה, יש להעביר קודי ערים מספריית DPD, לא מ-KLADR — אחרת ה-API מחזיר שגיאת city not found. חישוב העלות דורש נפח מטען: אורך × רוחב × גובה / 1,000,000. ללא SDK מוכן, פיתוח עצמי אורך עד 10 ימים ועלול להוביל לשגיאות בטיפול בתשובות. צברנו ניסיון על 15+ פרויקטים וקיצרנו את משך הזמן הזה בחצי. שילוב מקצועי יכול לעזור להפחית עלויות משלוח על ידי בחירת תעריף אופטימלי ושמירת ספריות במטמון. העלות המדויקת מחושבת באופן אישי לאחר ניתוח.

שלבי שילוב DPD API

חיבור ל-DPD API

התקן את ה-SDK באמצעות Composer:

composer require dpd-ru/dpd-php-api-client 

אתחל את הלקוח עם סביבת הבדיקה:

use DPD\DPDClient;

$client = new DPDClient(
    username: config('services.dpd.username'),
    password: config('services.dpd.password'),
    clientNumber: config('services.dpd.client_number'),
    test: app()->environment('production') === false
);

סביבת הבדיקה (test: true) פועלת בכתובת https://test.dpd.ru. אישורי בדיקה מתבקשים ממנהל DPD בנפרד מאישורי הייצור.

שיטות שילוב מרכזיות

להלן הפונקציות העיקריות: חישוב עלות, חיפוש עיר, קבלת נקודות מסירה, יצירת הזמנה, מעקב, הדפסת תוויות וקריאת שליח.

// --- Расчёт стоимости ---
public function calculateDelivery(
    string $fromCityId, // код города DPD (не ISO)
    string $toCityId,
    float $weightKg,
    array $dimensions,
    float $declaredValue = 0
): array {
    $response = $this->client->getDPDOrderCost2([...]);
    // ... обработка
}

// --- Поиск города ---
public function findCity(string $cityName, string $countryCode = 'RU'): array {
    $response = $this->client->getCitiesCashPay([...]);
    // ...
}

// --- Пункты выдачи ---
public function getTerminals(?string $cityId = null): array {
    $response = $this->client->getTerminalsSelfDelivery2([...]);
    // ...
}

// --- Создание заказа ---
public function createOrder(Order $order): array {
    $response = $this->client->createOrder([...]);
    // ...
}

// --- Отслеживание ---
public function trackParcel(string $dpdOrderNum): array {
    $response = $this->client->getStatesByClient([...]);
    // ...
}

// --- Печать накладной ---
public function printLabel(string $dpdOrderNum, string $format = 'PDF'): string {
    $response = $this->client->createLabelFile([...]);
    // ...
}

// --- Вызов курьера ---
public function createPickupRequest(...): string {
    // ...
}

הגדרת חישוב עלות

1. קבל אישורי בדיקה ממנהל DPD.
2. התקן את ה-SDK באמצעות Composer.
3. אתחל את הלקוח עם test: true.
4. קרא לשיטת getDPDOrderCost2, תוך העברת קודי ערים, משקל ומידות.
5. עבד את התשובה: בדוק את הסטטוס, חלץ את העלות עבור כל שירות.

שמירת ספריית הערים במטמון מפחיתה את מספר הבקשות ב-80%. זמן החישוב הממוצע הוא פחות מ-500 אלפיות השנייה.

חישוב העלות דורש העברת קודי ערים של שולח ומקבל, משקל ומידות. DPD מחזיר את העלות עבור כל שירות זמין. ה-SDK מעבד את התשובה אוטומטית ויוצר מערך עם מחירים. השוואת עלויות משירותים שונים מאפשרת בחירה אוטומטית של האפשרות המשתלמת ביותר, וחוסכת עד 30% על משלוח.

שירותי משלוח נתמכים של DPD

שירותים נוספים עם תנאים מיוחדים נתמכים גם הם, כגון "החזרת חבילה" להחזרות.

סביבת בדיקה לעומת סביבת ייצור

שימוש ב-SDK הרשמי מקצר את זמן הפיתוח פי 2 בהשוואה ליישום בקשות SOAP מאפס.

מהם היתרונות של שילוב DPD מקצועי?

יתרונות השילוב המקצועי

מפרט ה-SOAP של DPD מכיל ניואנסים רבים: תשובות מחזירות שגיאות בגוף, לא בקודי סטטוס HTTP; קודי ערים אינם תואמים ל-KLADR; נדרשת מערכת מיפוי קניינית. המהנדסים המוסמכים שלנו שילבו את DPD עבור 15+ פרויקטים, ולכן אנו מבטיחים:

• טיפול נכון בכל סוגי התשובות (כולל שגיאות עם סטטוס !== 'OK')
• אופטימיזציה של שאילתות: שמירת ספריית ערים במטמון, מקביליות בחישובים
• תמיכה בכל השירותים: מ-PCL ועד EXPRESS
• קיצור זמן הפיתוח ל-5–7 ימים לשילוב בסיסי

שילוב מקצועי זול ב-40% מיישום עצמי בשל היעדר שגיאות ובזבוז זמן.

כמה עולה שילוב DPD?

• חיבור ל-DPD API (קבלת גישות, הגדרת SDK)
• יישום חישוב עלות עם בחירת שירות והתחשבות במידות
• שילוב מפת נקודות מסירה עם סינון והצגת שעות פעילות
• יצירת הזמנות עם העברת נתונים אוטומטית ל-DPD
• מעקב אחר סטטוסים ועדכון סטטוס ההזמנה במערכת שלך
• הדפסת תוויות בפורמטים PDF או ZPL למדפסות תרמיות
• קריאת שליח לאיסוף משלוח
• בדיקות בסביבת בדיקה וייצור
• תיעוד שילוב ותמיכה לחודש אחד לאחר ההשקה

שילוב בסיסי (חישוב, נקודות מסירה, יצירת הזמנה, מעקב) — מ-5 עד 7 ימים. שילוב מורחב (כולל קריאת שליח, הדפסת תוויות, ריבוי מחסנים) — מ-10 ימים. שילוב בסיסי מתחיל ב-$1,500 ושילוב מורחב מ-$3,000. העלות מחושבת באופן אישי לפי היקף העבודה. צור קשר להערכת פרויקט — נכין הצעה מסחרית תוך יום אחד. קבל ייעוץ על שילוב DPD כבר עכשיו.

כיצד להימנע ממלכודות נפוצות ביישום עצמי?

• שגיאות בתשובה: DPD אינו משתמש בקודי סטטוס HTTP; כל פעולה דורשת בדיקת סטטוס בגוף התשובה.
• קודי ערים: נדרש חיפוש נפרד באמצעות getCitiesCashPay מכיוון ש-DPD משתמש במספור משלו.
• נפח מטען: פרמטר הנפח מחושב במטר מעוקב; שגיאה בנוסחה מובילה לעלות שגויה.
• פסקי זמן: בקשות לסביבת הבדיקה עשויות להיות איטיות; מומלץ לשמור ספריות במטמון.

שילוב לוגיסטיקה לחנויות מקוונות כולל חישוב עלות ויצירת הזמנות. שילוב SOAP עם DPD דורש תשומת לב קפדנית לקודי ערים וחישוב נפח.