Shipnest

חיפוש בתיעוד

חפשו לפי נושא, endpoint, או מונח

ניהול תפעולי

ניהול משלוחים

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

עודכן: 23 ביוני 2026

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

  • גוביינא — סכום לגבייה במסירה וסוג (מזומן / שיק).
  • חבילות — מספר החבילות במשלוח (ברירת מחדל 1).
  • דחיפותREGULAR / EXPRESS / URGENT.
  • משקל, מחיר, מספר מסמך, הערות, והערות מסירה לשליח.
  • פרטי מקור — ממולאים אוטומטית מכתובת העסק של הלקוח, וניתנים לעריכה.
  • השאר ליד הדלת, משלוח דו-כיווני, ושדות מותאמים פר-טננט.

הברקוד נוצר אוטומטית (או מוזן ידנית) והוא ייחודי. בסיום ניתן להדפיס מדבקה מיד.

ייבוא מרובה (Excel / CSV)

לכמות גדולה — /shipments/import. מעלים קובץ Excel/CSV; המערכת ממפה את הכותרות אוטומטית (מזהה עשרות וריאציות לכל שדה) ומאפשרת תצוגה מקדימה לפני האישור. ניתן להוריד תבנית מוכנה עם כל העמודות הנתמכות.

יצירה דרך API

אפשר ליצור משלוחים גם דרך ה-API הציבורי: POST /api/v1/shipments. ראו תיעוד ה-API.
מחזור חיים

סטטוסי משלוח

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

text
UNASSIGNED    משלוח חדש            (טרם שובץ)
ASSIGNED      שובץ לשליח איסוף
ACTIVE        נאסף                 (בדרך למיון)
IN_INVENTORY  נקלט במחסן
OUT_INVENTORY יצא להפצה
IN_TRANSFER   בהעברה               (בין מוקדים)
COMPLETED     הושלם / נמסר
FAILED        נכשל   →  UNDELIVERABLE  נכשל סופית
CANCELED      בוטל
  • DELIVERED_PENDING_RETURN ("נמסר") — במשלוח דו-כיווני, המסירה הושלמה אך ההחזרה עדיין בדרך.
  • IN_INVENTORY / OUT_INVENTORY / IN_TRANSFER — סטטוסי מחסן שהם הרחבה של Shipnest; הם נדחפים גם ל-Lionwheel. ראו אינטגרציית Lionwheel.
  • סטטוס תפעולי — בנוסף לסטטוס המסירה, אפשר להגדיר סטטוסים תפעוליים מותאמים פר-טננט (ב-הגדרות → סטטוסי תפעול).

רשימת המשלוחים נתמכת בסינון מרובה-בחירה לפי:

  • סטטוס — כולל סטטוסי תפעול מותאמים.
  • לקוח / שולח, עיר יעד, שליח מסירה (כולל "לא משובץ").
  • אזור הפצה (כולל "ללא אזור הפצה").
  • סוג משימה — איסוף / מסירה / כפולה.

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

מסמנים שורות בעזרת ה-checkbox, וסרגל הפעולות נפתח. הפעולות הזמינות:

  • שיוך שליח — שיבוץ שליח לכל המשלוחים שנבחרו בבת אחת.
  • יעד שבת / יעד אקספרס — קביעת מועד יעד מרוכזת.
  • הוספה לליקוט, קביעת תווית צבע, שכפול.
  • סנכרון מ-Lionwheel — משיכת מצב עדכני לכל הנבחרים.
  • הדפסת מדבקות לכל הנבחרים.
  • מחיקה (רכה) ושחזור מסל המחזור.

מחיקה רכה

מחיקה מעבירה את המשלוח לסל המחזור — אפשר לשחזר. מחיקה לצמיתות (purge) מתבצעת רק מסל המחזור ואינה הפיכה.

עמוד הסריקה /shipments/scan מיועד לעבודה מהירה עם סורק USB או מצלמת הטלפון, בשני מצבים:

  1. קליטה במחסן — כל סריקה מסמנת את המשלוח כ"נקלט במחסן" ומכריזה קולית את האזור (כדי לכוון למיון הנכון).
  2. שיבוץ שליח מסירה — בוחרים שליח, וכל סריקה משייכת אליו את המשלוח. למשלוחים של שליחי-קבלן, המערכת משדרת אוטומטית למערכת החיצונית.

כל סריקה מציגה משוב מיידי (צליל הצלחה / התראת טעות מיון) והיסטוריית סריקות עם חותמת זמן.

לחיצה על שורה פותחת מגירת פרטים מלאה הכוללת:

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

ציר הזמן והמסרונים נפרדים

ציר זמן הפעילות מציג פעולות תפעוליות בלבד. כל מה שקשור ל-WhatsApp / הודעות יושב באקורדיון "מסרונים" הייעודי.

כפתור בכותרת כרטיס המשלוח פותח את תיק המשלוח — ציר זמן אחד שמרכז את כל מה שנאמר ונעשה סביב המשלוח, ולא רק את הפעולות שהמערכת ביצעה:

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

התיק מסונן לפי סוג, מקובץ לפי יום, ומכל פריט שמקורו בשיחה אפשר לקפוץ לשיחה המלאה ב-inbox.

מה נכנס לתיק — ומה לא

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

לכל משלוח יש שני קישורים ציבוריים, ותפריט "קישורים" בכרטיס המשלוח (וגם בפורטל הלקוחות) מעתיק כל אחד מהם ללוח. הם נבדלים במה שהם חושפים — ולא בכדִי.

  • קישור אישי לנמען/tracking/{מזהה} ו-/validate/{מזהה}. המזהה הוא מפתח אקראי וייחודי למשלוח, ולכן הקישור נשלח רק לנמען עצמו (בדרך כלל ב-WhatsApp דרך טריגר, עם המשתנים {{tracking_url}} ו-{{validation_url}}). הוא חושף את הכתובת המלאה, את שם הנמען ואת המפה, ומאפשר עדכון פרטי מסירה (קומה, דירה, הערות).
  • קישור גנרי לדיוור/tracking/{ברקוד}. אפשר להרכיב אותו לבד מתוך מספר המשלוח שכבר יש לכם, בלי לקרוא ל-API — למשל במיזוג-דואר במייל. הוא מציג מצב המשלוח, עיר היעד וצפי הגעה בלבד.

למה הקישור לפי ברקוד מצומצם

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

רוצים לשלוח את הקישור האישי בדיוור משלכם?

אין צורך להסתפק בקישור המצומצם. הקישור האישי המלא זמין בשלוש דרכים: עמודת "לינק מעקב" בטבלת המשלוחים (הפעילו אותה בתפריט העמודות — היא נכללת גם בייצוא לאקסל); השדה trackingUrl בתשובת GET /api/v1/shipments; ו-trackingUrl ב-webhook של shipment.created.

כפתור "הורדת Excel" מייצא את השורות המסוננות הנוכחיות. הקובץ מכבד את העמודות שבחרתם להציג ואת סדרן, מעוצב RTL, וכולל ברקוד, תאריך, לקוח, נמען, יעד, סטטוס, שליח, אזור, דחיפות, חבילות, גוביינא ושדות מותאמים.

מעבר לרשימה הראשית, יש תצוגות ייעודיות לזרימות עבודה ספציפיות:

שיבוץ איסופים

/pickups — מסך ייעודי לשיבוץ שליחי איסוף למשימות פתוחות, עם קיבוץ לפי לקוח/אזור/עיר, שיוך מהיר (כולל בפעולה מרובה), וסינון לפי שליח, אזור וסוכן.

מפה

/shipments/map — מפה גאוגרפית של המשלוחים, עם אותם סננים כמו הרשימה ועדכון בזמן אמת.

יעד שבת ויעד אקספרס

/target-shabbat מרכז משלוחים לפי פרשת השבוע שאליה הם מיועדים (בורר פרשות, רשימת תיוג שבועית, סנכרון מ-Lionwheel)./target-express עושה אותו דבר לפי תאריכי יעד אקספרס.

פערי הפצה

/distribution-gaps חושף משלוחים שמתעכבים — לפי לשוניות: פערי מסירה (מעבר לסף ימי עסקים), פערים קריטיים, יום אחרון להפצה, פערי איסוף, והחזרות/כפולות. את הספים מגדירים בהעדפות.

תמונת מחסן וסל מחזור

/shipments/warehouse-view מציג בזמן אמת את המשלוחים שבמחסן, מקובצים לעגלות לפי אזור, עם קוד-צבע לפי גיל וכמות./recycle-bin מנהל משלוחים שנמחקו (שחזור או מחיקה לצמיתות; נשמרים 6 חודשים).