שילוב Dostavista API: עלות, הזמנות, מעקב

שילוב API של Dostavista: חישוב עלויות, הזמנות ומעקב אחר שליחים

אובדן הזמנות בגלל חוסר בחישוב עלויות משלוח הוא מציאות עבור 30% מחנויות האונליין. לקוחות עוזבים אם הם לא רואים מחיר מדויק. שילוב Dostavista פותר את זה: ה-API מאפשר לחשב עלויות, ליצור הזמנות ולעקוב אחר שליחים בזמן אמת. הניסיון המצטבר שלנו (15+ פרויקטים) מבטיח פעילות יציבה ללא הפתעות. החיסכון הממוצע בעלויות המשלוח בהשוואה לשירותים מסורתיים הוא 25%. צרו קשר להערכת פרויקט — נציע את הפתרון האופטימלי.

למה לשלב את Dostavista?

Dostavista היא פלטפורמת מיקור המונים שמספקת משלוחים פי 2 מהר יותר משירותי שליחויות מסורתיים. מערכת גמישה של סוגי רכב מאפשרת להעביר כל דבר ממסמכים ועד רהיטים גדולים. ה-API מספק את כל השיטות הנדרשות: חישוב עלויות, יצירת הזמנות, מעקב אחר סטטוסים. אנו משתמשים בניסיון של 10+ שנים בפיתוח אתרים לשילוב אמין. לפי הנתונים שלנו, שיעור ההמרה בעגלת הקניות עולה ב-15% בממוצע לאחר השילוב.

שיטות API של Dostavista

Dostavista מספקת REST API עם אימות באמצעות X-User-Email ו-X-User-Token. סביבת ארגז חול זמינה בכתובת robotapitest.dostavista.ru. לפני השימוש, צרו חשבון וקבלו אסימון API מהאזור האישי שלכם. ל-API יש מגבלה של 10 בקשות בשנייה לחשבון. חריגה ממנה מחזירה 429 Too Many Requests, לכן השתמשו במטמון לחישובים. לפרטים נוספים, ראו את תיעוד ה-API של Dostavista.

איך לחשב עלות משלוח

POST /api/business/v1/calculate-order
{
  "matter": "Документы",
  "insurance_amount": "0",
  "vehicle_type_id": 1, // 1=пешеход, 2=велосипед, 3=мотоцикл, 8=авто
  "points": [
    {
      "address": "Москва, Тверская, 1",
      "client_order_id": "pickup"
    },
    {
      "address": "Москва, Арбат, 10",
      "client_order_id": "delivery"
    }
  ]
}

התשובה כוללת POST /api/business/v1/calculate-order { "matter": "Документы", "insurance_amount": "0", "vehicle_type_id": 1, // 1=пешеход, 2=велосипед, 3=мотоцикл, 8=авто "points": [ { "address": "Москва, Тверская, 1", "client_order_id": "pickup" }, { "address": "Москва, Арбат, 10", "client_order_id": "delivery" } ] } בקופיקות — עלות המשלוח. אנו ממליצים להוסיף מרווח קטן (+5–10%) לעלות המוצגת, מכיוון שהמחיר הסופי עשוי להשתנות מעט בשל תמחור דינמי. שמרו תוצאות במטמון למשך דקה כדי להפחית בקשות.

איך ליצור הזמנה

POST /api/business/v1/create-order
{
    "matter": "Одежда",
    "vehicle_type_id": 3,
    "backpay_amount": "0", // наложенный платёж
    "points": [
        {
            "address": "Москва, Складской переулок, 5",
            "contact_person": {"phone": "+79001234567", "name": "Склад"},
            "taking_amount": "0",
            "note": "Позвонить за 15 минут"
        },
        {
            "address": "Москва, Ленина, 20, кв 5",
            "contact_person": {"phone": "+79007654321", "name": "Покупатель"},
            "is_door_to_door": true,
            "note": "Код домофона: 456"
        }
    ]
}

אם delivery_fee_amount אינו תקין, ה-API מחזיר שגיאת 400. השתמשו ב-POST /api/business/v1/create-order { "matter": "Одежда", "vehicle_type_id": 3, "backpay_amount": "0", // наложенный платёж "points": [ { "address": "Москва, Складской переулок, 5", "contact_person": {"phone": "+79001234567", "name": "Склад"}, "taking_amount": "0", "note": "Позвонить за 15 минут" }, { "address": "Москва, Ленина, 20, кв 5", "contact_person": {"phone": "+79007654321", "name": "Покупатель"}, "is_door_to_door": true, "note": "Код домофона: 456" } ] } ייחודי עבור אידמפוטנטיות — זה מונע הזמנות כפולות בניסיונות חוזרים.

הגדרת Webhooks להתראות

1. באזור האישי של Dostavista, ציינו את כתובת ה-URL של נקודת הקצה שלכם לקבלת בקשות POST.
2. יישמו טיפול באירועים: vehicle_type_id, client_order_id, order.created.
3. ה-webhook שולח JSON עם שדות: order.status_changed, order.finished, order_id, status.
4. ודאו שהשרת שלכם מגיב עם 200 OK תוך 5 שניות — במקרה של פסק זמן, ההקשר נשלח שוב עד 3 פעמים.
5. בדקו בסביבת ארגז החול על ידי חיקוי סטטוסים שונים. לניפוי באגים מקומי, השתמשו בשירותים כמו webhook.site או ngrok.

מעקב אחר שליח בזמן אמת

ניתן לעקוב אחר סטטוסי הזמנה באמצעות שאילתות חוזרות (courier_latitude) או webhooks. הסטטוסים הנוכחיים:

התשובה כוללת courier_longitude ו-GET /api/business/v1/orders/{id} — קואורדינטות השליח. השתמשו בספריות JavaScript כמו Leaflet להצגה על מפה.

בחירת סוג רכב

Dostavista מאפשרת לבחור רכב לפי המטען:

בצד הלקוח, יישמו זאת כשלב נוסף בבחירת המשלוח או אוטומטית לפי מידות המוצר.

טיפול בשגיאות

השילוב במפתח כולל

• ניתוח דרישות והגדרת מפתח API
• חישוב עלות משלוח באתר
• טופס הזמנה עם בחירת סוג רכב
• מעקב אחר שליח על מפה
• התראות Webhook על שינויי סטטוס
• בדיקות וניפוי באגים בסביבת ארגז חול
• תיעוד ומסירת גישה

שלבי העבודה

1. ניתוח ועיצוב — יום אחד. איסוף דרישות, חיבור לארגז חול.
2. פיתוח השילוב — 2–3 ימים. יישום חישוב, יצירת הזמנות, מעקב.
3. בדיקות והשקה — יום אחד. בדיקת כל התרחישים, כולל שגיאות API.

לוח זמנים לשילוב

שילוב בסיסי עם חישוב ויצירת הזמנות אורך 2 עד 3 ימי עסקים. עם מעקב על מפה וטיפול ב-webhooks, זה אורך 4 עד 5 ימים. לוחות הזמנים המדויקים תלויים במורכבות הפרויקט שלכם. לדוגמה, עבור רשת בתי קפה שילבנו תוך 3 ימים, והפחתנו את זמן המשלוח ב-30%.

הניסיון שלנו (10+ שנים בפיתוח אתרים, 15+ שילובי שירותי שליחויות) מבטיח אמינות ועמידה בזמנים. קבלו הערכת פרויקט — נציע את הפתרון הטוב ביותר. צרו קשר להערכת הפרויקט שלכם — נציע את הפתרון האופטימלי.