אינטגרציה של 1C-Bitrix עם אגרגטור המשלוחים ApiShip

אינטגרציה של 1C-Bitrix עם אגרגטור המשלוחים ApiShip

חנות Bitrix עם 500 הזמנות בחודש מבלה עד 40 שעות בתחזוקת אינטגרציות ישירות עם CDEK, Boxberry ו-Russian Post. כל שינוי ב-API של שירות הוא מצב חירום: עריכות קוד, בדיקות, פריסה. ApiShip מרכזת הכל: API יחיד ל-30+ מובילים, חישוב ומעקב אחידים.

יישמנו פתרון כזה עבור לקוח בסקטור ה-DIY — לאחר האינטגרציה, זמן התמיכה במשלוחים ירד מ-20 שעות בשבוע ל-2, והחיסכון החודשי הסתכם בעלות המחושבת לאחר ביקורת.

מדוע לבחור באגרגטור ApiShip במקום אינטגרציות ישירות?

אינטגרציה ישירה עם כל שירות משמעה מודולים נפרדים עם אישורים שונים, סכמות בקשה ותגובה שונות, וצורך לנטר שינויים ב-API עבור כל מוביל ולעדכן את הקוד.

ApiShip מאחדת הכל: אימות יחיד (Bearer token), חישוב עלות across כל המובילים בבקשה אחת, יצירת משלוח דרך endpoint יחיד, מעקב בפורמט אחיד.

הצד השני של המטבע: האגרגטור מוסיף שכבה — לעיתים קיים עיכוב של 1–2 ימים כאשר ה-API של מוביל מתעדכן. עבור חנויות עם דרישות לא סטנדרטיות למוביל ספציפי, אינטגרציה ישירה עשויה להיות מדויקת יותר. אך ב-90% מהמקרים ApiShip היא הבחירה האופטימלית: אנו מבטיחים יציבות ותמיכה בזמן.

ApiShip API: endpoints עיקריים

Base URL: https://api.apiship.ru/v2. אימות: Bearer token. סביבת בדיקות: https://api.test.apiship.ru/v2. לפרטים נוספים, ראו את התיעוד של ApiShip API.

כיצד אנו מיישמים את האינטגרציה של ApiShip ב-Bitrix?

מודול יחיד מכסה את כל השירותים. בחירה ארכיטקטונית: או מחלקה יחידה \Bitrix\Sale\Delivery\Services\Base עם פרמטר "carrier", או מספר מופעים של מחלקה אחת עבור מובילים שונים (שליח, נקודת איסוף וכו'). הגישה השנייה נוחה יותר ללקוח: הוא רואה שיטות משלוח נפרדות.

פרמטרים ב-b_sale_delivery_service_params:

• APISHIP_API_KEY — מפתח מחשבון ApiShip;
• PROVIDER_KEY — קוד המוביל (cdek, boxberry, russian_post וכו');
• FROM_POINT_ID — מזהה נקודת השילוח (מחסן במערכת ApiShip);
• DELIVERY_TYPE — door (שליח) או point (נקודת איסוף).

חישוב עלות

$calcRequest = [
    'fromPoint' => ['id' => $fromPointId],
    'toPoint' => [
        'address' => $deliveryAddress,
        'cityId' => $apishipCityId,
    ],
    'parameters' => [
        'weight' => $weightGram,
        'length' => $lengthCm,
        'width' => $widthCm,
        'height' => $heightCm,
        'declaredValue' => $declaredValue,
    ],
    'deliveryType' => $deliveryType,
    'providers' => [$providerKey], // empty array = all carriers
];
$results = $httpClient->post('/v2/calculator', $calcRequest); // $results — array of options with rates and timeframes for each carrier
"}

אם providers הוא מערך ריק, ApiShip תחזיר חישוב across כל המובילים הפעילים. זה מאפשר ליישם בלוק השוואת שיטות משלוח עם תעריפים באתר.

אחזור ואחסון נקודות איסוף

נקודות איסוף ב-ApiShip נדרשות לפי סינון:

GET /points?cityId={id}&providerKey={key}&type=pickup_point

אנו טוענים אותן פעם ביום באמצעות agent עבור מובילים פעילים. אנו מאחסנים אותן ב-HL block "נקודות איסוף" עם שדות: providerKey, pointId, name, address, lat, lng, workingHours, maxWeight. על המפה אנו מציגים הכל בצורה מאוחדת — הלקוח בוחר כל נקודת איסוף של כל מוביל.

כאשר נבחרת נקודת איסוף, אנו שומרים ב-b_sale_order_props: APISHIP_PROVIDER_KEY ו-APISHIP_POINT_ID.

יצירת בקשה

$orderPayload = [
    'providerKey' => $providerKey,
    'senderPointId' => $fromPointId,
    'deliveryType' => $deliveryType,
    'toPoint' => [
        'id' => $pvzId, // if pickup point
        'address' => $address, // if courier
    ],
    'recipient' => [
        'name' => $name,
        'phone' => $phone
    ],
    'parameters' => $parameters,
    'orderNumber' => 'SHOP-' . $bitrixOrderId,
    'declaredValue' => $declaredValue,
    'cashOnDelivery' => $codAmount,
    'places' => $places,
];

תגובה: orderId במערכת ApiShip ו-trackingNumber של המוביל. אנו שומרים את שניהם ב-b_sale_order_props.

מעקב וסטטוסים

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

בעת הזמנת אינטגרציה turnkey, אנו מספקים:

• ניתוח של תוכנית המשלוחים הנוכחית והמלצות;
• פיתוח מודול המותאם לתהליכים העסקיים שלך;
• הגדרת חישוב עלות, בחירת נקודות איסוף ויצירת בקשות;
• אינטגרציה עם מעקב ו-webhooks;
• תיעוד API ומדריך הפעלה למפעילים;
• אחריות של 3 חודשים לפעולה ללא הפרעות.

הניסיון והאחריות שלנו

אנו מפתחים על 1C-Bitrix ו-Bitrix24 כבר 5+ שנים. יש לנו 10+ פרויקטים מוצלחים של אינטגרציית שירותי משלוחים, כולל עם ApiShip, APIs ישירים של מובילים ופתרונות מותאמים אישית. אנו מספקים אחריות על כל העבודות — אם משהו משתבש, נתקן זאת בעדיפות. צרו קשר לקבלת ייעוץ והערכה לפרויקט שלך.

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

התקציב מחושב באופן אישי — הוא תלוי בהיקף ובמורכבות. שלחו לנו תיאור של תוכנית המשלוחים שלכם — נעריך את הפרויקט ונכין הצעה מסחרית. צרו קשר לדיון בפרטים.