מדריך מעשי ל-API המשלוחים של LionWheel לעסקים ולחברות שליחויות: באיזה טוקן להשתמש, אילו שדות tasks/create דורש, איך נמנעים ממשלוחים כפולים עם original_order_id, קודי הסטטוס המספריים, גבייה במסירה באגורות, ו-webhooks לעדכוני סטטוס.
עיקרי הדברים
- כל קריאה ל-LionWheel מעבירה את הטוקן בפרמטר query בשם key, ב-HTTPS עם גוף JSON.
- טוקן של חברת שליחויות דורש company_id בגוף הבקשה; טוקן של לקוח מתחיל ב-c_key ומשויך לחברת השליחויות אוטומטית.
- original_order_id חייב להיות ייחודי - בודקים אותו ב-tasks/by_order_id לפני יצירה, כדי שניסיון חוזר לא ישלח פעמיים.
- תאריכים בפורמט dd/mm/yyyy, ו-money_collect באגורות - 150 ש"ח הם 15000.
ה-API של LionWheel מאפשר לחנות, ל-ERP או למערכת ההזמנות ליצור משימות משלוח ב-LionWheel אוטומטית, במקום שמישהו יקליד מחדש כל הזמנה. שולחים POST /api/v1/tasks/create לכתובת members.lionwheel.com עם כתובת היעד, שם הנמען והטלפון, מעבירים את הטוקן בפרמטר key, ומקבלים בחזרה מזהה משימה, ברקוד, תווית להדפסה וקישור מעקב.
LionWheel היא פלטפורמה ישראלית לניהול משלוחים, שמשמשת חברות שליחויות ועסקים שמפעילים נהגים משלהם. המדריך מיועד לעסק או למפתח שמחברים אליה הזמנות, והוא עוסק בפרטים ששוברים את החיבור הכי הרבה.
באיזה טוקן של LionWheel להשתמש?
ל-LionWheel יש שני סוגי טוקנים, ושימוש בסוג הלא נכון הוא הטעות הראשונה שרוב החיבורים נתקלים בה:
| מי אתם | מאיפה הטוקן | מה חייב להופיע בבקשה |
|---|---|---|
| חברת השליחויות | הגדרות > הגדרת API > מפתח API | company_id של העסק שהמשלוח שייך לו, מראש דף ההגדרות של אותו לקוח |
| עסק ששולח דרך חברת שליחויות | מבקשים מחברת השליחויות, שמעתיקה אותו מדף הלקוח שלכם | שום דבר נוסף - המשימה משויכת אליכם ולחברת השליחויות אוטומטית. הטוקן מתחיל ב-c_key |
אם אתם חנות שמתחברת לחשבון LionWheel של חברת השליחויות שלכם, אתם צריכים את הסוג השני. טוקן שלא מתחיל ב-c_key הוא כנראה המפתח של חברת השליחויות עצמה, והוא דורש company_id בכל קריאה.
השדות ש-tasks/create דורש
התיעוד מסמן את השדות האלה כחובה:
pickup_at- תאריך המשלוח, בפורמט dd/mm/yyyy (ברירת מחדל: היום).original_order_id- מספר ההזמנה שלכם. חייב להיות ייחודי.destination_city,destination_street,destination_number- הכתובת, בשלושה שדות נפרדים.destination_recipient_nameו-destination_phone.
השדות האופציונליים מכסים את רוב מה שמשלוח בישראל צריך: destination_floor, destination_apartment, destination_entrance_code, חלון זמן עם earliest ו-latest, packages_quantity, urgency (0 רגיל, 1 דחוף, 2 דחוף מאוד), line_items עם מק"ט וכמות, is_roundtrip, age_verification, ו-documents בפורמט PDF, PNG או JPEG ב-Base64 - חשבונית או תעודת משלוח שנמסרות ליד הדלת.
חיבור ההזמנות ל-LionWheel, שלב אחר שלב
- משיגים את הטוקן הנכון (לפי הטבלה למעלה) ומבקשים מהתמיכה של LionWheel סביבת בדיקות לפני שנוגעים בייצור.
- מפרקים את הכתובת במערכת ההזמנות לעיר, רחוב ומספר בית. מחרוזת כתובת אחת לא מתאימה לשדות החובה.
- לפני יצירת משימה קוראים ל-
GET /api/v1/tasks/by_order_id/{order_id}. אם כבר קיימת משימה להזמנה הזו, לא יוצרים עוד אחת. - שולחים
POST /api/v1/tasks/create?key=...עם שדות ההזמנה. - שומרים על ההזמנה את
task_id,public_idו-tracking_linkשחזרו, ושולחים ללקוח את קישור המעקב. - ב-LionWheel פותחים את הגדרות הארגון > לשונית API, מזינים את כתובת ה-webhook ובוחרים את הסטטוסים שרוצים לקבל.
- כשמגיע סטטוס, מעדכנים את ההזמנה במערכת שלכם - ומתריעים למישהו על
FAILED.
לחנויות WooCommerce, מרכז העזרה של LionWheel מתעד חיבור מוכן, ושווה לבדוק אותו לפני שכותבים קוד.
מה המשמעות של מספרי הסטטוס ב-LionWheel?
השדה status של משימה הוא מספר שלם, וגם tasks/show וגם קריאת העדכון משתמשים באותם קודים:
| קוד | סטטוס |
|---|---|
| 0 | UNASSIGNED - לא שובץ |
| 1 | ASSIGNED - שובץ לנהג |
| 2 | ACTIVE - בדרך |
| 3 | COMPLETED - נמסר |
| 4 | CANCELED - בוטל |
| 5 | ROUNDTRIP_DELIVERED - הלוך-חזור הושלם |
| 6 / 7 | IN_INVENTORY / OUT_INVENTORY - נכנס למחסן / יצא ממנו |
| 8 | FAILED - נכשל |
| 9 | FINAL_FAILED - נכשל סופית |
| 10 | IN_TRANSFER - בהעברה |
ממפים את הקודים למצבי ההזמנה שלכם במקום אחד. FAILED (8) בדרך כלל אומר שעוד אפשר לנסות שוב, ו-FINAL_FAILED (9) אומר שהמשלוח הסתיים וההזמנה צריכה טיפול של אדם. מי שמתייחס לשניהם באותו אופן מחזיר כסף מוקדם מדי או לא חוזר ללקוח בכלל.
מה משתבש בחיבור ל-LionWheel
- גבייה במסירה בשקלים במקום באגורות.
money_collectהוא מספר שלם ביחידה הקטנה: 150 ש"ח הם15000. שליחת150אומרת לנהג לגבות 1.50 ש"ח. מגדירים גםcod_type: 0 מזומן, 1 צ'ק, 2 כרטיס, 3 העברה בנקאית. - תאריכים בפורמט ISO.
2026-10-01אינו01/10/2026. ה-API מצפה ל-dd/mm/yyyy. - משלוחים כפולים בניסיון חוזר. פסק זמן לא אומר שהמשימה לא נוצרה. תמיד בודקים לפי מספר הזמנה לפני שמנסים שוב.
- 401 מול 403. 401 היא שגיאת אימות - המפתח. 403 היא מה שהתיעוד מכנה אי-התאמה בנתונים; הדבר הראשון לבדוק הוא
company_idשלא שייך לטוקן. - פורמטים של טלפון. שומרים פורמט אחיד אחד, כי
tasks/by_phone/{phone}מחפש לפי המחרוזת המדויקת.
השאלה הרחבה, על איזו שכבת משלוחים לבנות, נמצאת בשכבת משלוחים מאגדת מול API ישיר של חברת שליחויות, והתוויות באוטומציה של תוויות משלוח בישראל. למה משלוחים נכשלים ואיך תופסים את זה מוקדם - בסיבות לכשל במסירה ובקרות.
מה להכין לפני שמתחילים
- הטוקן, ו-
company_idאם זה טוקן של חברת שליחויות. - כתובות שמורות כעיר, רחוב ומספר, עם קומה ודירה כשיש.
- פורמט טלפון אחד בכל מערכת ההזמנות.
- החלטה איזה אירוע בהזמנה יוצר את המשלוח - תשלום, אריזה או כפתור ידני.
- כתובת HTTPS ל-webhooks של סטטוס, ומישהו שמקבל התראה כשמשלוח נכשל.
מקורות
שאלות נפוצות
האם ל-LionWheel יש API?
כן. LionWheel מפרסמת API בסגנון REST עם גוף JSON בכתובת members.lionwheel.com/api/v1, מתועד ב-GitHub. הוא יוצר, קורא ומעדכן משימות משלוח, מחפש משימות לפי מספר הזמנה או טלפון, מנהל חברות ומסלולים יומיים של נהגים, ושולח עדכוני סטטוס ל-webhook שמגדירים בהגדרות ה-API של הארגון.
אילו שדות חובה כדי ליצור משלוח ב-LionWheel?
pickup_at בפורמט dd/mm/yyyy, original_order_id ייחודי, destination_city, destination_street, destination_number, destination_recipient_name ו-destination_phone. טוקן של חברת השליחויות עצמה דורש גם את ה-company_id של העסק שהמשלוח שייך לו. כל השאר, כמו קומה, חלון זמן או מספר חבילות, אופציונלי.
איך נמנעים מיצירת אותו משלוח פעמיים?
משתמשים במספר ההזמנה כ-original_order_id, ש-LionWheel מצפה שיהיה ייחודי, וקוראים ל-GET /api/v1/tasks/by_order_id/{order_id} לפני כל יצירה או ניסיון חוזר. פסק זמן לא מוכיח שהמשימה לא נוצרה, ולכן הבדיקה, ולא השגיאה, קובעת אם לשלוח שוב.
איך מקבלים עדכוני סטטוס של משלוחים מ-LionWheel?
בהגדרות הארגון ב-LionWheel, בלשונית API, מזינים כתובת webhook ובוחרים את הסטטוסים שרוצים לקבל. LionWheel שולחת POST עם מבנה זהה לקריאת יצירת המשלוח בכל פעם שמשימה מגיעה לאחד מהם. אפשר גם לשאול משימה בודדת ב-GET /api/v1/tasks/show/{task_id}.
למה LionWheel מחזירה 403?
התיעוד מתאר את 403 כשגיאת אי-התאמה בנתונים, ואת 401 כשגיאת אימות. הדבר הראשון לבדוק הוא company_id שהטוקן לא מורשה להשתמש בו, מה שקורה כשמתבלבלים בין טוקן של חברת שליחויות לטוקן לקוח מסוג c_key. בדקו קודם איזה סוג טוקן יש לכם.
להמשך קריאה
שירות רלוונטי
אינטגרציות
לגרום למערכות שאתם כבר משלמים עליהן לדבר זו עם זו.
על הכותב
יהונתן סעדיה
מפתח פרילנסר לאוטומציה, אתרים ו-MVP
אני יהונתן סעדיה, מפתח בכיר שבונה אוטומציה עסקית, אתרים מותאמים ומוצרי MVP לעסקים קטנים ובינוניים בארה"ב, אירופה וישראל. המדריכים האלה נכתבים מתוך עבודה אמיתית עם לקוחות, לא מתיאוריה.
בוא נעבוד יחדיש לך פרויקט דומה?
ספר לי מה אתה רוצה לבנות או איזה תהליך להפוך לאוטומטי. אני חוזר תוך 24 שעות עסקים עם כמה שאלות ממוקדות, ואז עוברים על זה יחד בשיחת היכרות חינמית של 30 דקות, בלי התחייבות. בסוף יש לך היקף עבודה, לוח זמנים ומחיר קבוע - או תשובה כנה שלא שווה לבנות את זה.