מדריך הגדרה — Chita Delivery for WooCommerce

מדריך חיבור מלא בין החנות שלכם לחשבון צ’יטה – הגדרת החשבון, שיטות המשלוח והוובהוק.

התוסף מחבר את החנות שלכם ישירות ל-API של צ’יטה (Run system) – יצירת משלוחים, מעקב, נקודות איסוף ומשלוחים ידניים חיצוניים, בלי לצאת מוורדפרס.

לפני שמתחילים

• צריך WooCommerce מותקן ופעיל – בלי זה התוסף לא יעבוד ותופיע הודעת אזהרה בניהול האתר.
• צריך חשבון פעיל אצל צ’יטה (Run system) עם מספר לקוח וקודי סוג משלוח/סוג מטען (P3/P7) – אלה מתקבלים ישירות מצ’יטה, לא מהתוסף. בלי הפרטים האלה אי אפשר ליצור משלוחים.
• צריך את מפתח הרישיון שקיבלתם בעמוד ההזמנה שלכם באתר Smartfish (בפורמט SF-XXXX-XXXX-XXXX-XXXX).

שלבי ההגדרה

1. התקנה והפעלה.
   לאחר הרכישה תקבלו קובץ ZIP להורדה. בניהול האתר: תוספים ← הוספת תוסף ← העלאת תוסף, בחרו את הקובץ ולחצו התקן, ואז הפעלה.
2. הזנת מפתח הרישיון.
   עברו ל-WooCommerce ← משלוחי צ’יטה. בשדה “מפתח רישיון” הזינו את המפתח שקיבלתם ולחצו “שמור שינויים”. ליד השדה יופיע סטטוס – “פעיל” בירוק אומר שהרישיון עבד. עד שהרישיון פעיל, שאר הגדרות התוסף (שיטות המשלוח, יצירת משלוחים וכו’) לא זמינות – רק עמוד ההגדרות עצמו נגיש.
3. מילוי פרטי החשבון בצ’יטה.
   באותו עמוד הגדרות, מלאו:
   • כתובת שרת (Host) – ברירת המחדל https://chita-il.com מתאימה כמעט תמיד, אין צורך לשנות אלא אם צ’יטה הנחו אחרת.
   • טוקן API – רק אם צ’יטה סיפקו לכם אחד (לא כל חשבון מקבל).
   • מספר לקוח – המספר שקיבלתם מצ’יטה.
   • שם החברה – עד 10 תווים, נשלח כשם השולח.
   • קודי סוג משלוח/סוג מטען (P3/P7) – בנפרד לכל אחת משתי השיטות: “משלוח עד הבית” ו”איסוף מנקודת חלוקה”. הקודים ספציפיים לחשבון שלכם ולמחירון הפעיל אצל צ’יטה – קבלו אותם ישירות מצ’יטה. חשוב: לרוב יש לחשבון רק קוד מטען אחד פעיל למשלוח עד הבית (199 או 200, לא שניהם) – אם מקבלים שגיאת “מחיר-משך” בעת יצירת משלוח, זה הדבר הראשון לבדוק מול צ’יטה.
   • טלפון בית העסק – אופציונלי.
4. הוספת שיטות המשלוח.
   עברו ל-WooCommerce ← הגדרות ← משלוח, בחרו את אזור המשלוח הרלוונטי ולחצו “הוסף שיטת משלוח”. יש להוסיף את שתיהן בנפרד:
   • שליח עד הבית – צ’יטה
   • איסוף מנקודת חלוקה – צ’יטה

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

   שדרוג מגרסה ישנה (1.x)? שיטת המשלוח האחודה הישנה תופיע כ”שיטת משלוח לא ידועה” – יש להסיר אותה ולהוסיף במקומה את שתי השיטות החדשות.

5. (אופציונלי) חיבור Webhook לעדכון סטטוס אוטומטי.
   בתחתית עמוד ההגדרות מופיעה כתובת Webhook מוכנה. אפשר למסור אותה לצ’יטה כדי שיעדכנו סטטוס משלוח אוטומטית (למשל “נמסר”). זה לא חובה – אפשר גם לבדוק סטטוס ידנית בכל הזמנה בלחיצת כפתור. אם רוצים שההזמנה תסומן “הושלם” אוטומטית כשהמשלוח נמסר, יש לסמן את התיבה המתאימה מעל שדה ה-Webhook.

אחרי ההגדרה – איך זה עובד

1. בעמוד עריכת הזמנה (שנשלחה דרך אחת משיטות המשלוח של צ’יטה) תופיע תיבת “משלוח צ’יטה” עם כפתור “צור משלוח בצ’יטה”.
2. לאחר יצירת המשלוח אפשר לבדוק סטטוס, להדפיס תווית משלוח או לבטל אותו – הכל מאותה תיבה.
3. אם ההזמנה בפועל נשלחה בדרך אחרת (שליח פרטי, איסוף עצמי) – אפשר לרשום זאת בשדה החופשי “נשלח ידנית” בעמוד ההזמנה. זה תיעוד פנימי בלבד, לא מבצע קריאת API.
4. בקאסה, לקוח שבוחר “איסוף מנקודת חלוקה” יראה רשימת נקודות איסוף לפי העיר שמילא בכתובת המשלוח.

שאלות נפוצות

• קיבלתי שגיאת “מחיר-משך” ביצירת משלוח. כמעט תמיד זה קוד סוג מטען (P7) שגוי או לא פעיל אצל צ’יטה עבור סוג המשלוח שבחרתם. בדקו מול צ’יטה איזה קוד מוגדר בפועל לחשבון שלכם (בדרך כלל 199 או 200, לא שניהם).
• למה יש שתי שיטות משלוח נפרדות ולא אחת עם שתי אפשרויות? כדי שכל אחת תתנהג בדיוק כמו שיטת משלוח רגילה – עם מחיר וכותרת משלה, ואפשרות להוסיף/להסיר אותה בנפרד בכל אזור משלוח.
• לקוחות עם שם ברוסית/קירילית נשלחים בסדר? כן – התוסף מתעתק אוטומטית את השם ללטינית לפני השליחה לצ’יטה (ה-API שלהם מוחק שמות בקירילית לחלוטין). השם המקורי נשמר כהערה על ההזמנה, כך שלא הולך לאיבוד.
• חובה לחבר Webhook? לא. בלי Webhook פשוט לוחצים “בדוק סטטוס” ידנית בכל הזמנה.
• הרישיון מציג “לא הופעל” או “לא תקף”. ודאו שהמפתח הוזן בדיוק כפי שהתקבל (בלי רווחים מיותרים) ושמרתם את הטופס. שימו לב שמפתח רישיון מוגבל לאתר אחד – אם כבר הופעל באתר אחר, יש ליצור קשר לקבלת מפתח נוסף.

← חזרה לעמוד התוסף