צ'יטה שליחויות מפעילה רשת Cheetah Shops לאיסוף חבילות. איך יוצרים משלוח מהמערכת שלכם, מה נדרש כדי להתחבר, ואיך מנהלים שינויים אחרי שהמשלוח כבר נוצר.
עיקרי הדברים
- צ'יטה אינה מפרסמת תיעוד API פומבי באתר שלה. החיבור מתבצע בפועל דרך תוסף או פלטפורמה, עם פרטי חיבור שמתקבלים מנציג צ'יטה.
- לפי דף החיבור של ShipOS, החיבור לצ'יטה דורש שני פרטים מהחברה: קוד חיבור וטוקן אימות, שמוזנים במסך הרישיונות.
- רשת Cheetah Shops מונה למעלה מ-1,300 נקודות איסוף, ולכן בחירת נקודה בצ'קאאוט היא נתון תפעולי ולא טקסט חופשי.
- משלוח שנוצר הוא צילום מצב. שינוי כתובת או טלפון בהזמנה אחרי היצירה אינו משנה דבר אצל המוביל.
- ההחזרה או ההחלפה מיוצגת כמשלוח כפול - משלוח שני שקשור לראשון, ולא כעדכון של המשלוח המקורי.
צ'יטה שליחויות היא חברת שילוח ישראלית שמתמחה באיקומרס ומפעילה את רשת Cheetah Shops - נקודות איסוף בפריסה ארצית - לצד שליחויות עד הבית, שילוח בינלאומי ועמילות מכס. מבחינת מערכת ההזמנות, משלוח אצל צ'יטה הוא רשומה שנולדת מצילום מצב של ההזמנה ומתנהלת ממנה והלאה בנפרד.
המערכות של צ'יטה ומה חנות מתחברת אליו
צ'יטה מציגה באתר שלה כמה שירותים נפרדים: שליחויות בארץ, שילוח בינלאומי, רשת Cheetah Shops, עמילות מכס ופלטפורמת Cheetah CX. בנוסף קיימים ממשקי לקוח נפרדים לצפייה ומעקב.
מה שאין באתר: מפרט טכני פומבי. לא פורסמו endpoints, לא שמות שדות ולא מבנה הודעות. מי שמחפש "API של צ'יטה" מוצא בפועל שני מסלולים אמיתיים:
- תוסף או פלטפורמת ביניים. קיימים ממשקים מוכנים - למשל ב-ShipOS ובחנות התוספים של Konimbo - שמבצעים את השידור מול צ'יטה במקומכם.
- פנייה ישירה לצ'יטה. מי שרוצה לחבר מערכת פנימית פונה לחברה ומקבל את פרטי החיבור לחשבון שלו.
בשני המסלולים נקודת ההתחלה זהה: חשבון פעיל בצ'יטה. אין מסלול טכני שעוקף את המסלול המסחרי.
רשומת המשלוח: צילום מצב, לא תצוגה חיה של ההזמנה
הטעות הנפוצה היא לבנות את מסך המשלוח כתצוגה של ההזמנה. זה נראה נכון עד לרגע שבו לקוח משנה טלפון והמסך מציג טלפון שאינו הטלפון שנשלח לצ'יטה.
רשומת משלוח נכונה מחזיקה, כשדות משלה:
- שם הנמען, טלפון וכתובת כפי שהיו ברגע היצירה.
- סוג השירות שנבחר ומספר החבילות.
- מזהה נקודת האיסוף, אם נבחרה.
- מספר המעקב שהתקבל.
- מזהה ההזמנה שממנה נוצר המשלוח.
- לוג אירועים עם חותמות זמן.
התוצאה: כשמישהו שואל "לאן זה נשלח", התשובה נמצאת ברשומה ולא בשחזור. אותו עיקרון מופיע באוטומציה בלוגיסטיקה, שבה כל מסמך תפעולי הוא צילום מצב חתום ולא מראה של נתון חי.
איך מחברים חנות לצ'יטה בפועל?
- פותחים חשבון מסחרי מול צ'יטה ומסכמים תעריפים ואזורי חלוקה.
- מבקשים מנציג צ'יטה את פרטי החיבור - בדרך ShipOS מדובר בקוד חיבור ובטוקן אימות.
- מזינים את הפרטים בפלטפורמה או בתוסף, וממפים כל שיטת משלוח בצ'קאאוט לסוג שירות בצ'יטה.
- משדרים משלוח בדיקה אחד, מוודאים שהתקבל מספר מעקב, מדפיסים מדבקה ובודקים שהסטטוס מתעדכן.
השלב הרביעי הוא היחיד שמגלה טעויות מיפוי. משלוח בדיקה יחיד עולה מעט ומגלה כמעט הכול.
Cheetah Shops: רשת נקודות שמשתנה מתחתיכם
רשת Cheetah Shops מונה למעלה מ-1,300 נקודות איסוף לפי הפרסום, והיא לא סטטית. נקודות נסגרות, משנות שעות ומשנות כתובת.
לכן שלושה כללים:
- שומרים את מזהה הנקודה, לא רק את שמה. שם משתנה, מזהה נשאר.
- שומרים גם את הכתובת שהוצגה ללקוח ואת מועד הבחירה, כדי שאפשר יהיה להסביר בדיעבד מה בדיוק הוא בחר.
- לא מבצעים התאמה מחדש אוטומטית לנקודה אחרת. אם הנקודה כבר לא זמינה, פונים ללקוח לבחירה מחדש.
נושא בחירת הנקודה עצמו רחב יותר ומטופל בנפרד בלוקרים ונקודות איסוף בישראל.
החזרות והמשלוח הכפול
בעולם האיקומרס הישראלי, החזרה או החלפה מיוצגת לרוב כמשלוח כפול: משלוח יוצא ומשלוח חוזר שקשורים זה לזה. דף החיבור של ShipOS לצ'יטה מציין תמיכה ביצירת משלוח כפול.
מה זה אומר מבחינת נתונים:
- המשלוח החוזר הוא רשומה חדשה עם מספר מעקב משלו.
- הקשר בין השניים נשמר בשדה ייעודי, לא בהערה חופשית.
- סטטוס ההזמנה אינו חוזר אחורה. הוא ממשיך קדימה למצב "בהחזרה" ואחריו "הוחזר".
- הזיכוי הכספי הוא אירוע נפרד שתלוי בקבלת הפריט, ולא בסטטוס המשלוח.
מה קורה כשהלקוח משנה כתובת אחרי שהמשלוח כבר נוצר?
התשובה הקצרה: המערכת שלכם לא יכולה לשנות את זה לבד. אחרי שהמשלוח נוצר, הכתובת המחייבת נמצאת אצל המוביל, ולעיתים כבר על גבי מדבקה מודפסת.
הזרימה שעובדת:
- ההזמנה נועלת את שדות המשלוח ברגע השידור, ומציגה אותם לקריאה בלבד.
- בקשת שינוי נרשמת כאירוע על המשלוח, עם מי ביקש ומתי.
- הצוות מברר מול צ'יטה מה אפשרי לפי סטטוס החבילה בפועל.
- אם לא ניתן לשנות, מבטלים ויוצרים משלוח חדש - ושומרים את הקשר בין השניים.
טבלת האירועים שהצוות באמת קורא
| אירוע | מקור האמת | מה נשמר אצלכם |
|---|---|---|
| נוצר משלוח | המערכת שלכם | מזהה משלוח, מספר מעקב, צילום מצב ההזמנה |
| נאספה חבילה | המוביל | ערך גולמי מהמוביל וחותמת זמן |
| הגיעה לנקודת איסוף | המוביל | מזהה נקודה בפועל, זמן הגעה |
| נמסר | המוביל | זמן מסירה ופרטי מסירה כפי שהתקבלו |
| בקשת שינוי כתובת | הלקוח או הצוות | מי ביקש, מתי, ומה הוחלט |
| ביטול | המוביל מאשר | סטטוס בקשה ואחריו סטטוס אישור |
| החזרה | המערכת שלכם | משלוח חדש עם קישור למקורי |
הטבלה הזו היא גם חלוקת האחריות בפרויקט. כל שורה שמקור האמת שלה הוא המוביל אינה ניתנת לתיקון מהמערכת שלכם, וכל שורה שמקור האמת שלה הוא אתם חייבת להיות ניתנת לשחזור בלי לשאול אף אחד.
מה כדאי שיהיה מוכן לפני החיבור
לפני שמתחילים לפתח, שישה דברים חוסכים את רוב העיכובים:
- חשבון פעיל בצ'יטה עם סוגי השירות שאתם מתכוונים להשתמש בהם מופעלים בפועל.
- מיפוי מלא בין שיטות המשלוח בצ'קאאוט לבין סוגי השירות שקיימים בחשבון.
- טבלת משלוחים נפרדת מטבלת ההזמנות, עם מזהה משלוח משלה.
- לוג אירועים שמסוגל לשמור ערך גולמי מהמוביל לצד סטטוס פנימי.
- החלטה מי בצוות רשאי לבטל משלוח ומי רק לבקש ביטול.
- כתובת החזרה קבועה של העסק, לצורך משלוחים חוזרים ומשלוח כפול.
הפריט האחרון נראה שולי עד שמגלים שהוא חסר בדיוק ביום שבו נוצרת ההחזרה הראשונה, ואז מישהו מקליד כתובת ידנית שאף אחד לא בדק.
מקורות
שאלות נפוצות
האם לצ'יטה שליחויות יש API ציבורי?
לא פורסם תיעוד API פומבי באתר של צ'יטה. בפועל קיימים ממשקים מוכנים דרך פלטפורמות ותוספים, והחיבור נעשה עם פרטי חשבון שמתקבלים מהחברה. מי שרוצה חיבור למערכת פנימית פונה לצ'יטה ומקבל את הפרטים לחשבון שלו.
מה נדרש כדי לחבר חנות לצ'יטה דרך ShipOS?
לפי דף החיבור של ShipOS נדרשים שני פרטים שמתקבלים מנציג צ'יטה: קוד חיבור וטוקן אימות. שניהם מוזנים במסך הרישיונות של המערכת. בלי אחד מהם החיבור לא נוצר, ולכן זהו הצעד הראשון ולא האחרון בתהליך.
כמה נקודות איסוף יש ברשת Cheetah Shops?
לפי הפרסום הרשת מונה למעלה מ-1,300 נקודות איסוף בפריסה ארצית. המספר המדויק משתנה עם פתיחת וסגירת נקודות, ולכן שומרים מזהה נקודה ברשומת המשלוח ולא רשימה קפואה שמועתקת פעם אחת ולא מתעדכנת.
אפשר לשנות פרטי משלוח אחרי שהוא נוצר?
לא מהמערכת שלכם. אחרי היצירה, פרטי המשלוח נמצאים אצל המוביל ולעיתים על מדבקה מודפסת. בקשת שינוי נרשמת כאירוע ומבוררת מול צ'יטה לפי סטטוס החבילה; אם לא ניתן, מבטלים ויוצרים משלוח חדש עם קישור למקורי.
להמשך קריאה
שירות רלוונטי
אינטגרציות
לגרום למערכות שאתם כבר משלמים עליהן לדבר זו עם זו.
על הכותב
יהונתן סעדיה
מפתח פרילנסר לאוטומציה, אתרים ו-MVP
אני יהונתן סעדיה, מפתח בכיר שבונה אוטומציה עסקית, אתרים מותאמים ומוצרי MVP לעסקים קטנים ובינוניים בארה"ב, אירופה וישראל. המדריכים האלה נכתבים מתוך עבודה אמיתית עם לקוחות, לא מתיאוריה.
בוא נעבוד יחדיש לך פרויקט דומה?
ספר לי מה אתה רוצה לבנות או איזה תהליך להפוך לאוטומטי. אני חוזר תוך 24 שעות עסקים עם כמה שאלות ממוקדות, ואז עוברים על זה יחד בשיחת היכרות חינמית של 30 דקות, בלי התחייבות. בסוף יש לך היקף עבודה, לוח זמנים ומחיר קבוע - או תשובה כנה שלא שווה לבנות את זה.