קבלת נתוני הזמנת מילוי הזמנה
ניתן להשתמש בפעולה קבלת נתוני הזמנת מילוי הזמנה כדי לאחזר מידע על הזמנת מילוי הזמנה מהחנות שלך.
הגדרת תצורה
שדות
הפעולה קבלת נתוני הזמנת מילוי הזמנה (Get fulfillment order data) מכילה את השדות הבאים, שמשמשים ליצירת השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | שדה חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש. |
| מספר מקסימלי של תוצאות | שדה חובה. הכמות המרבית של תוצאות שיכולות לחזור משאילתת החיפוש שבחרת. אפשר להחזיר עד 100 בכל פעם. |
| שאילתה | שדה חובה. יש לבחור מבין השאילתות הנפוצות או לבחור באפשרות מתקדם (Advanced) כדי ליצור אחת משלך. |
מחרוזת שאילתה
זוהי שאילתה לדוגמה לקבלת הזמנות למילוי הזמנה שנמצאות כרגע בהמתנה:
status:ON_HOLDהמשתנה status הוא מסנן שזמין בשאילתה Fulfillment Orders וניתן להשתמש בו מספר פעמים או לשלבו עם משתנים אחרים.
בעת תשאול נתונים, כדאי לדעת את הדברים הבאים:
- רשימה של מסננים זמינים עבור הזמנות למילוי הזמנה
- שאילתות חייבות להיות בהתאם לתחביר מסוים
- ערכי שדות שאילתה אינם תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון במסמכי ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל בעת סינון. לדוגמה, כדי למצוא ערכים מסוימים של שאילתת הזמנה, יש לסנן את הדף 'הזמנות' במנהל ולאחר מכן לבדוק את כתובת ה-URL.
- אפשר להפעיל או לבדוק שאילתה בחנות באמצעות האפליקציה Shopify GraphiQL.
- כדאי לשים לב למה שקורה אם השאילתה נכשלת. לרוב, ה-API יחזיר את כל התוצאות (במקום לא להחזיר אף אחת).
נתונים שהוחזרו
כל הפעולות מסוג קבלת נתונים מחזירות רשימה של בין 0 ל-100 משאבים. בהתאם למקרה השימוש, ניתן להשתמש בנתונים אלה בדרכים שונות:
- אם עליך לטפל בכל פריט ברשימה בנפרד, לדוגמה כדי להוסיף תג לכל פריט, תוכל להשתמש בפעולה For each.
- אם עליך לצבור נתונים, למשל לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות Count או Sum.
- אם עליך להפיק את הרשימה כפלט, כגון לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים הבאים אחרי פעולה זו, יש להשתמש במשתנה שנקרא Get fulfillment order data, שהוא רשימה של הזמנות למילוי הזמנה. אפשר להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, אפשר לשלוח את רשימת ההזמנות למילוי הזמנה בפעולה Send internal email כך:
{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}טריגרים
אפשר להשתמש בפעולה זו בכל זרימת עבודה, כולל עם הטריגר זמן מתוזמן (Scheduled time). בזרימת עבודה שמשתמשת בטריגר זמן מתוזמן, זרימת העבודה מתחילה במועד שציינת, ולא כתוצאה מאירוע כלשהו. מכיוון שאין אירוע ספציפי בחנות שלך או מתוך אפליקציה שמתחיל את זרימת העבודה, לא נכללים בה נתונים באופן אוטומטי.
פרטי ה-API
תבניות
שליחת סיכום דוא"ל יומי עם רשימה של הזמנות למילוי הזמנה שנמצאות בהמתנה
בכל יום, זרימת עבודה זו תבצע תשאול לגבי כל ההזמנות למילוי הזמנה שנמצאות בהמתנה (עד 100 בכל פעם). היא תשלח סיכום בדוא"ל עם שם ההזמנה ומיקום מילוי ההזמנה שהוקצה. צפייה בתבנית