שילוב Shiptor ל-Bitrix: מודול משלוחים ומילוי הזמנות

שילוב Shiptor עבור Bitrix: מודול משלוחים ומילוי הזמנות

תארו לעצמכם: חנות מקוונת על Bitrix מאבדת עד 20% מההזמנות כי הלקוח לא רואה אפשרויות משלוח משתלמות או נתקל בחיבור לא תקין לנקודות איסוף. נתקלנו בזה עשרות פעמים. Shiptor—אגרגטור שירותי משלוחים ומפעיל מילוי הזמנות—פותר את הבעיה תוך 4–10 ימים. ה-API המאוחד שלו מספק גישה ל-50+ חברות שילוח, ואינטגרציה מוגדרת כראוי מפחיתה דליפת הזמנות ב-15–30%. אחד הלקוחות שלנו עם קטלוג של 12,000 מוצרים השיג חיסכון משמעותי בעמלות לאחר חיבור Shiptor.

Shiptor הוא בעצם שני מוצרים באחד: אגרגטור לוגיסטי (API יחיד לגישה ל-CDEK, Boxberry, DPD, דואר רוסי ואחרים) ומילוי הזמנות (אחסון סחורות במחסני Shiptor עם משלוח לפי הזמנה). עבור חנות מקוונת על Bitrix, האינטגרציה מכסה את שתי המשימות דרך API אחד.

איך עובד ה-API של Shiptor

כתובת בסיס: https://api.shiptor.ru. אימות: אסימון Bearer. תיעוד זמין ב-shiptor.ru.

תכונות עיקריות:

• חישוב עלות עבור מספר חברות שילוח בבקשה אחת
• יצירה, עדכון וביטול משלוחים
• ניהול מלאי מחסן (מילוי הזמנות)
• רשימת נקודות איסוף וארונות חבילות
• מעקב אחר משלוחים
• הדפסת תוויות אוטומטית

ארכיטקטורת אינטגרציה ב-Bitrix

Shiptor יכול לפתור שתי משימות שונות בפרויקט, והארכיטקטורה שלהן שונה:

אפשרות 1: לוגיסטיקה בלבד. החנות מאחסנת ואוספת סחורות בעצמה; Shiptor הוא רק חברת השילוח. האינטגרציה מוגבלת למודול משלוחים: חישוב → יצירת הזמנה → מעקב → תווית.

אפשרות 2: מילוי הזמנות. סחורות מאוחסנות במחסן של Shiptor. בעת יצירת הזמנה ב-Bitrix, אנו שולחים בקשת הרכבה ומשלוח ל-Shiptor. רמות המלאי מסונכרנות מ-Shiptor ל-Bitrix דרך סוכן. זה מורכב יותר ודורש הגדרת חילופי נתונים דו-כיווניים.

מודול משלוחים (אפשרות 1)

מחלקה — יורשת מ-\Bitrix\Sale\Delivery\Services\Base. פרמטרים:

• SHIPTOR_TOKEN — אסימון Bearer
• WAREHOUSE_ID — מזהה מחסן שולח ב-Shiptor
• PROVIDER — קוד חברת שילוח (cdek, boxberry, dpd וכו') או auto לבחירה אוטומטית

חישוב עלות:

$calcRequest = [
    'warehouse_id' => $warehouseId,
    'destination' => [
        'city' => $city,
        'address' => $address,
        'type' => 'door', // или 'point'
        'point_id' => $pvzId,
    ],
    'packages' => [[
        'weight' => $weightGram,
        'length' => $lengthCm,
        'width' => $widthCm,
        'height' => $heightCm,
    ]],
    'declared_value' => $declaredValue,
    'payment_method' => $isPrepaid ? 'prepaid' : 'cod',
];

התשובה — מערך של הצעות מחברות שילוח. עם $calcRequest = [ 'warehouse_id' => $warehouseId, 'destination' => [ 'city' => $city, 'address' => $address, 'type' => 'door', // или 'point' 'point_id' => $pvzId, ], 'packages' => [[ 'weight' => $weightGram, 'length' => $lengthCm, 'width' => $widthCm, 'height' => $heightCm, ]], 'declared_value' => $declaredValue, 'payment_method' => $isPrepaid ? 'prepaid' : 'cod', ]; , אנו בוחרים את המחיר המינימלי או חברת שילוח מועדפת לפי ההגדרות.

יצירת משלוח

$shipmentPayload = [
    'warehouse_id' => $warehouseId,
    'provider' => $selectedProvider,
    'order_number' => 'SHOP-' . $bitrixOrderId,
    'recipient' => [
        'name' => $name,
        'phone' => $phone,
    ],
    'destination' => $destination,
    'packages' => $packages,
    'items' => $items,
    'declared_value' => $declaredValue,
    'cash_on_delivery' => $codAmount,
];

התשובה מכילה provider = auto (מזהה ב-Shiptor) ו-$shipmentPayload = [ 'warehouse_id' => $warehouseId, 'provider' => $selectedProvider, 'order_number' => 'SHOP-' . $bitrixOrderId, 'recipient' => ['name' => $name, 'phone' => $phone], 'destination' => $destination, 'packages' => $packages, 'items' => $items, 'declared_value' => $declaredValue, 'cash_on_delivery' => $codAmount, ]; (אצל חברת השילוח). בקשו את התווית דרך shipment_id — PDF.

למה Shiptor משתלם יותר מאינטגרציות ישירות?

אינטגרציה ישירה עם כל חברת שילוח דורשת תחזוקה של N ממשקי API שונים, טיפול בשגיאות ועדכונים. Shiptor מאחד את הפרוטוקול—אתם כותבים קוד פעם אחת ומקבלים גישה ל-50+ חברות שילוח. בפועל, חיסכון בזמן הפיתוח נע בין 30% ל-50%, ועלויות התחזוקה מופחתות פי 2–3. עבור חנות עם 200 הזמנות בחודש, זה מביא לחיסכון משמעותי.

איך עובד סנכרון המלאי?

במודל המילוי, המלאי נמצא פיזית במחסן של Shiptor. אנו מסנכרנים אותו ל-Bitrix:

1. סוכן קורא ל-tracking_number פעם בשעה—רשימת פריטים עם כמויות.
2. מיפוי לפי GET /shipments/{id}/label או קוד חיצוני: מצא את המוצר ב-GET /inventory לפי מק"ט.
3. עדכון הכמות דרך sku או ישירות ב-b_iblock_element.

אם מוצר לא נמצא ב-Bitrix לפי מק"ט, אנו מתעדים אותו לבדיקה ידנית.

יצירת בקשת הרכבה (מילוי הזמנות)

במקום לשלוח פיזית חבילה מהמחסן שלכם, אנו שולחים משימת הרכבה ל-Shiptor:

$fulfillmentOrder = [
    'order_number' => 'SHOP-' . $bitrixOrderId,
    'recipient' => $recipient,
    'destination' => $destination,
    'provider' => $selectedProvider,
    'items' => array_map(fn($item) => [
        'sku' => $item['sku'],
        'quantity' => $item['qty'],
    ], $basketItems),
];

$response = $httpClient->post('/fulfillment/orders', $fulfillmentOrder);

Shiptor מרכיב את ההזמנה, אורז אותה ומוסר אותה לחברת השילוח. מספר המעקב מוחזר לאחר מסירת ההזמנה.

נקודות איסוף ומפה

רשימת נקודות איסוף: CCatalogProduct::Update(). שמירה במטמון בבלוק highload, עדכון פעם ביום. במפת Yandex/Google, אנו מציגים נתונים מצטברים מכל חברות השילוח.

השוואת אפשרויות אינטגרציה

מה כלול בעבודה

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

לוחות זמנים ועלות

העלות מחושבת באופן אישי לאחר ניתוח הפרויקט שלכם. צרו קשר—נעריך את עומס העבודה ונציע את הפתרון הטוב ביותר במפתח פתוח. אנו מבטיחים 10+ שנות ניסיון בפיתוח Bitrix ומעל 50 אינטגרציות מוצלחות עם מערכות משלוחים. הזמינו אינטגרציית Shiptor היום וקבלו ייעוץ מהנדס.