חיבור חנות אונליין

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

1234

(1) חיבור חדש. (2) כתובת הקליטה של החיבור, עם כפתור העתקה. (3) המתג מפעיל ומשבית את החיבור. (4) האירועים האחרונים שנקלטו: מתי, מאיזה חיבור, הנושא, אם החתימה תקינה, והסטטוס.

הספקים שאפשר לבחור

חיבור WooCommerce

1. 1

   בלשונית חיבורים נכנסים לחצו חיבור חדש.

2. 2

   בחרו בספק את WooCommerce והקלידו שם לחיבור.

   למשל שם החנות.

   123

3. 3

   השאירו את סוד חתימה (רשות) ריק ולחצו יצירת חיבור.

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

4. 4

   ב-WooCommerce פתחו הגדרות ← מתקדם ← Webhooks, והדביקו את כתובת הקליטה ואת הסוד.

   כשתשמרו, WooCommerce שולחת הודעת בדיקה, ו-ViperFlow מאשרת אותה כדי שהשמירה תצליח.

5. 5

   ב-ViperFlow לחצו סיימתי, ואחר כך אירועים בשורת החיבור.

   ההודעות שהחנות שולחת מופיעות בטבלה אירועים נכנסים אחרונים.

חיבור Shopify

1. 1

   בהגדרות ה-Webhooks של החנות ב-Shopify העתיקו את סוד החתימה.

2. 2

   ב-ViperFlow לחצו חיבור חדש, בחרו בספק את Shopify, הקלידו שם והדביקו את הסוד.

   ב-Shopify סוד החתימה הוא שדה חובה.

3. 3

   לחצו יצירת חיבור והעתיקו את כתובת הקליטה.

4. 4

   ב-Shopify הגדירו Webhook שנשלח לכתובת הקליטה.

מה רואים בטבלת האירועים

חתימה

תקינה או שגויה. בקשה שהחתימה שלה לא נכונה נדחית ולא נשמרת.

סטטוס

התקבל, עובד, לא טופל או נכשל. הודעות מ-WooCommerce ומ-Shopify מסומנות כרגע לא טופל: הן נקלטו ונרשמו, אבל אין עדיין עיבוד אוטומטי. זה המצב הצפוי ולא תקלה.

נושא

סוג ההודעה כפי שהחנות שלחה אותו, למשל הזמנה חדשה.

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

ניהול החיבור

המתג בשורת החיבור

משבית את החיבור. חיבור מושבת דוחה את ההודעות שמגיעות אליו.

הגדרת סוד חתימה

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

יצירת סוד חדש

ViperFlow יוצרת סוד חדש והישן מפסיק לעבוד מיד. לא זמין ל-Shopify, שבה הסוד נקבע בחנות.

מחיקה

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

הכנסת הזמנות מהחנות דרך ה-API

כדי שהזמנה מהחנות תופיע ב-ViperFlow, מפתח בונה חיבור שמקבל את ההזמנה מהחנות ויוצר אותה ב-ViperFlow דרך ה-API, עם הלקוח, הפריטים והתאריכים. לחיבור הזה צריך מפתח API עם ההרשאות יצירה ועדכון הזמנות ויצירה ועדכון לקוחות, וכדי לקשר מוצרים קיימים גם ניהול מזהים חיצוניים. הדוגמה המלאה, כולל WooCommerce, במדריך ה-API.

מה שונה בהזמנה שנוצרה דרך ה-API

הזמנה מה-API לא עוברת באשף ההזמנה, ולכן אף אחד לא ראה אותה לפני שנשמרה. מה זה אומר בפועל:

• היא נכנסת כטיוטה. משימות הליקוט והשטח נוצרות רק אחרי שמאשרים אותה, ב-ViperFlow או דרך ה-API. ראו סטטוסים של הזמנה.
• המחירים, הסטים, שורות הלוגיסטיקה והסכומים מחושבים כמו באשף.
• זמינות המלאי לא נבדקת ביצירה, ולכן אף אחד לא ראה אזהרת חוסר. לפני האישור פתחו את ההזמנה ובדקו חוסרים. ראו זמינות מלאי וחוסרים.
• הנחה גבוהה מהסף של העסק נדחית, כי למפתח API אין אפשרות לאשר אותה.
• אחרי היצירה ה-API יכול לשנות רק את פרטי האירוע (תאריכים, מיקום, הערות, איש קשר) ולאשר או לבטל. פריטים, מחירים ותנאי תשלום משנים בעריכת ההזמנה ב-ViperFlow.
• מי יצר: ביומן הפעילות כתוב API · שם המפתח, ובלשונית שינויים השינויים מסומנים API.

מזהים חיצוניים

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