1C-Bitrix – אינטגרציה עם DostavkaBy (בלארוס): אוטומציה של משלוחים

העברת הזמנות ידנית לשירות השליחים גוזלת זמן ומובילה לשגיאות, במיוחד בעבודה עם מפעילים בלארוסיים. אנו מפתחים אינטגרציה של 1C-Bitrix עם DostavkaBy, המאוטמטת יצירת בקשות, חישוב עלויות וסנכרון סטטוסים. הצוות שלנו מספק את הפרויקט במפתח—מקבלת מפתחות API ועד לבדיקות ותמיכה שוטפת, תוך הבטחת פעולה אמינה וללא הפרעות של החנות המקוונת שלך.
11+שנות ניסיון900+פרויקטים שהושלמו100+עובדים במשרד19+שותפים
השירותים שאנו מציעים
מציג 1 מתוך 1כל 1626 השירותים
1C-Bitrix – אינטגרציה עם DostavkaBy (בלארוס): אוטומציה של משלוחים
בינוני
~1-2 שבועות

הכישורים שלנו:

שאלות נפוצות

אינטגרציה של 1C-Bitrix עם DostavkaBy (בלארוס)

אתם פותחים חנות מקוונת לבלארוס ומתמודדים עם אתגר: כיצד לחבר משלוח אמין ואוטומטי? Bitrix out of the box לא מכיר מפעילים מקומיים, והזנה ידנית של הזמנות ללוח הבקרה האישי של שירות המשלוחים גוזלת עד שעתיים ביום לכל מנהל.

עבור 50 הזמנות בחודש, מדובר ב-100 שעות של זמן אבוד על משימות שגרתיות. שגיאות בהזנה ידנית מתרחשות ב-15% מהמקרים. עיכובים, משלוחים שאבדו, קונפליקטים ולקוחות לא מרוצים.

DostavkaBy הוא אחד משירותי השליחים הפופולריים ביותר בבלארוס עם הכיסוי הרחב ביותר. אנו מבצעים אינטגרציות של Bitrix עם עשרות שירותי משלוחים ברחבי מדינות CIS כבר 6 שנים, כולל כל שירותי השליחים הגדולים.

עם DostavkaBy נתקלנו באתגרים: אימות לא סטנדרטי, מאפיינים ספציפיים של כתובות בלארוסיות ותוכנית מורכבת של תשלום בעת מסירה. אנו חולקים את הניסיון שצברנו ומוכנים ליישם אינטגרציה מלאה turnkey.

כיצד אנו מבצעים אינטגרציה? 5 שלבים

  1. השגת מפתחות API מ-DostavkaBy והגדרת פרמטרים של השולח.
  2. פיתוח מחלקת handler מותאמת אישית שיורשת מ-\Bitrix\Sale\Delivery\Services\Base.
  3. חיבור אירועים ליצירת הזמנה אוטומטית עם אישור ההזמנה.
  4. יישום חישוב עלות וסנכרון סטטוסים.
  5. בדיקת כל התרחישים: יצירה, ביטול, שינוי, תשלום בעת מסירה.

DostavkaBy API

DostavkaBy מספק API מסוג REST לשותפים. תיעוד ופרטי התחברות מסופקים עם חתימת חוזה. האימות הוא Basic Auth או token, בהתאם לגרסת ה-API. הפורמט הוא JSON.

פעולות בסיסיות:

  • יצירת הזמנת משלוח
  • קבלת סטטוס הזמנה
  • חישוב עלות
  • קבלת מעקב
  • ביטול/שינוי הזמנה

כיצד פועל מודול המשלוחים ב-Bitrix?

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

  • DOSTAVKA_API_KEY – מפתח API
  • SENDER_NAME – שם השולח
  • SENDER_PHONE – טלפון השולח
  • SENDER_ADDRESS – כתובת המחסן או נקודת האיסוף

לפי תיעוד Bitrix, פיתוח handler מותאם אישית הוא נוהג סטנדרטי.

שגיאות תצורה נפוצות
  • פורמט מפתח API שגוי (בדקו את האותיות הגדולות/קטנות).
  • היעדר נרמול טלפון: בבלארוס, מספרים חייבים להיות בפורמט +375XXXXXXXXX.
  • מטבע שגוי: כל הסכומים ב-BYN, נדרש המרה עבור חנויות מרובות מטבעות.

מאפיינים ספציפיים של לוגיסטיקה בלארוסית

פורמט טלפון. כל המספרים הם +375XXXXXXXXX. אנו מנרמלים את המספר הנכנס לפני השליחה: מסירים רווחים, סוגריים, מקפים, מוסיפים 375 אם הוזן בפורמט מקומי 80XXXXXXXX.

מטבע BYN. כל הסכומים בדולרים בלארוסיים. עבור חנויות מרובות מטבעות, המרה דרך CCurrencyRates של Bitrix.

כתובות. בלארוס אינה משתמשת ב-FIAS/KLADR. כתובות מוזנות כטקסט חופשי או דרך מסווגים עצמאיים של שירות המשלוחים. במקרים מסוימים, מספיק להעביר city + address כמחרוזות.

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

מדוע תשלום בעת מסירה דורש אינטגרציה נפרדת?

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

כיצד לסנכרן סטטוסים של הזמנות?

עבור נפחי הזמנות נמוכים (עד 100 ביום), polling מספיק: סוכן Bitrix בודק סטטוסים של הזמנות פעילות כל 30 דקות. עבור נפחים גבוהים יותר, אנו מגדירים webhooks: DostavkaBy שולח התראות על שינויי סטטוס.

מיפוי סטטוסים אופייני:

סטטוס DostavkaBy סטטוס הזמנה ב-Bitrix
New נשלח למשלוח
Picked up by courier בדרך
Delivered נמסר
Cancelled בוטל
Return החזרה

מה כלול בעבודת האינטגרציה?

אנו מספקים היקף עבודה מלא:

  • פיתוח מחלקת handler מותאמת אישית למשלוחים שיורשת מ-Base
  • הגדרת מפתחות API ופרמטרים של השולח
  • יצירת אירועים ליצירת הזמנה אוטומטית עם אישור ההזמנה
  • אינטגרציה עם מערכת התשלומים למעקב תשלום בעת מסירה
  • בדיקת כל התרחישים: חישוב, יצירה, ביטול, שינויי סטטוס
  • תיעוד והדרכה למנהלים על שימוש בבלוק ניהול ההזמנות
  • אחריות ל-30 יום על תפקוד האינטגרציה לאחר השלמה

חישוב עלות

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

אם מתקבל HTTP 200 עם מחיר, אנו מחזירים אותו באובייקט CalculationResult. אם הכתובת מחוץ לאזור הכיסוי או ה-API אינו זמין, אנו מחזירים שגיאה מבלי לחסום את תהליך השלמת ההזמנה (הקונה רואה "משלוח אינו זמין לכתובתך").

יצירה וניהול של הזמנות

הזמנות נוצרות אוטומטית עם אישור ההזמנה (hook על אירוע OnSaleStatusOrder) או ידנית על ידי המנהל. בכרטיס ההזמנה באזור הניהול, אנו מוסיפים בלוק "משלוח DostavkaBy" עם כפתורים:

  • "צור הזמנה" (אם טרם נוצרה)
  • "הצג סטטוס"
  • "הדפס תווית"
  • "בטל הזמנה"

מזהה ההזמנה של DostavkaBy נשמר ב-b_sale_order_props כמאפיין מותאם אישית DOSTAVKA_BY_ID.

לוח זמנים

היקף רכיבים זמן
אינטגרציה בסיסית חישוב + יצירת הזמנה + סטטוסים 3–4 ימים
+ ממשק ניהול בלוק ניהול הזמנות בכרטיס ההזמנה +1–2 ימים
+ התאמה חשבונאית של תשלום בעת מסירה דוח + התאמה עם תשלומים +2 ימים

במהלך 6 שנים, יישמנו יותר מ-50 אינטגרציות עם שירותי משלוחים שונים, כולל DostavkaBy. אוטומציה מפחיתה את זמן עיבוד ההזמנות פי 3 ומבטלת שגיאות. צרו קשר לקבלת הערכת פרויקט. או הזמינו ייעוץ – נספק פרטים.

עוד על תיעוד שירותי המשלוחים של Bitrix.

מצגת 1C Bitrixמצגת 1C Bitrix24מצגת 1C Enterprise