החזרה עודכנה
הטריגר החזרה עודכנה מפעיל זרימת עבודה כאשר שדה אחד או יותר בהחזרה, בפריטי השורה שלה או בהזמנות המילוי ההפוכות שלה משתנה בחנות שלך. אפשר לבחור אילו שדות בהחזרה חשובים לך, וזרימת העבודה רצה רק כשאחד מהשדות האלה משתנה, למשל כשהסטטוס של ההחזרה משתנה או כשנוספת עמלת החזרת מלאי.
כדי להפעיל זרימת עבודה כשהחזרה מגיעה לשלב מסוים, אפשר גם להשתמש בטריגר של אותו שלב, כמו החזרה התבקשה, החזרה אושרה או החזרה נסגרה.
בעמוד זה
שדות זמינים למעקב
הטריגר החזרה עודכנה מחייב לבחור לפחות שדה אחד למעקב. אפשר לבחור עד חמישה שדות. כשאחד מהשדות שנבחרו משתנה, זרימת העבודה רצה. שינויים בשדות שלא נבחרו לא מפעילים את זרימת העבודה.
בטבלה הבאה אפשר למצוא מידע נוסף על השדות שאפשר לעקוב אחריהם.
| סוג השדה | שדות |
|---|---|
| החזרה | closedAt, decline, requestApprovedAt, status |
| פריטי שורה להחזרה | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| פריטי שורה להחלפה | exchangeLineItems |
| עמלות שילוח להחזרה | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| הזמנות מילוי הפוכות | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
שדה ששמו מסתיים ב-amountSet מכיל סכום בשני מטבעות. בעת מעקב אחר השדה, שינוי באחד מהסכומים מפעיל את זרימת העבודה. כדי לעקוב רק אחר אחד מהסכומים, יש לבחור בשדה המשנה shopMoney עבור הסכום במטבע החנות, או בשדה המשנה presentmentMoney עבור הסכום במטבע הלקוח.
חלק מהשדות מפעילים את זרימת העבודה גם כשפריט נוסף להחזרה או מוסר ממנה:
- אם מתבצע מעקב אחר שדה בקבוצה פריטי שורה להחזרה, הוספת פריט שורה להחזרה או הסרת פריט שורה ממנה תפעיל את זרימת העבודה.
- אם מנטרים שדה של עמלת החזרת מלאי, כגון
returnLineItems.restockingFee.percentage, הוספת עמלת החזרת מלאי לפריט שורה או הסרתה מפעילה את זרימת העבודה. - אם מוגדר מעקב אחר השדה
exchangeLineItems, הוספת פריט להחלפה להחזרה או הסרתו ממנה מפעילה את זרימת העבודה. - אם מוגדר מעקב אחר שדה בקבוצה עמלות שילוח להחזרה, הוספה או הסרה של עמלת שילוח להחזרה מפעילה את זרימת העבודה.
- אם מוגדר מעקב אחר שדה בקבוצה הזמנות מילוי הפוכות, הוספת הזמנת מילוי הפוכה להחזרה מפעילה את זרימת העבודה. אם מוגדר מעקב אחר השדה
reverseFulfillmentOrdersאו השדהreverseFulfillmentOrders.lineItems, גם הסרת פריט שורה מהזמנת מילוי הפוכה מפעילה את זרימת העבודה.
בחירת השדות שמפעילים את זרימת העבודה
יש לבחור את השדות ששינוי בהם יפעיל את זרימת העבודה.
שלבים:
- בעורך זרימת העבודה, יש ללחוץ על הטריגר החזרה עודכנה.
- במקטע בחירת שדות החזרה, יש ללחוץ על בחירת שדות.
- בתיבת הדו-שיח הוספת שדה למעקב, יש לחפש את השדה הרצוי או לנווט אליו, ואז לבחור בו.
- אופציונלי: אפשר לחזור על שלבים 2 ו-3 כדי לעקוב אחר עד חמישה שדות.
שדות
הטריגר החזרה עודכנה כולל את השדות הבאים, שאפשר להשתמש בהם בתנאים ובפעולות ולקבלת נתונים בזרימת העבודה. השדות החזרה ו-חנות זמינים תמיד. שאר השדות זמינים רק כשמוגדר מעקב אחר שדה קשור. לדוגמה, השדה הזמנת מילוי הפוכה זמין כשמוגדר מעקב אחר שדה של הזמנת מילוי הפוכה, כמו reverseFulfillmentOrders.status.
| שדה | תיאור |
|---|---|
| החזרה | ההחזרה שעודכנה. |
| חנות | החנות שבה עודכנה ההחזרה. |
| פריט שורה להחזרה | פריט השורה להחזרה שהשתנה. ריק אם הוסר פריט שורה מההחזרה. זמין בעת מעקב אחר returnLineItems.quantity או אחר שדה של עמלת החזרת מלאי. |
| פריט שורה להחלפה | פריט השורה להחלפה שנוסף. ריק אם הוסר פריט שורה להחלפה. זמין בעת מעקב אחר השדה exchangeLineItems. |
| הזמנת מילוי הפוכה | הזמנת המילוי ההפוכה שהשתנתה. השדה זמין כשמוגדר מעקב אחר שדה של הזמנת מילוי הפוכה. |
בעת מעקב אחר שדות מסוגים שונים, השדות פריט שורה להחזרה, פריט שורה להחלפה ו-הזמנת מילוי הפוכה עשויים להיות ריקים כשזרימת העבודה רצה. לדוגמה, אם מוגדר מעקב גם אחר status וגם אחר returnLineItems.quantity, השדה פריט שורה להחזרה יהיה ריק כאשר רק הסטטוס משתנה. השדות פריט שורה להחזרה ו-פריט שורה להחלפה עשויים להיות ריקים גם כאשר המעקב מוגדר רק אחר שדות מהסוג שלהם. לפני שימוש באחד מהשדות האלה בפעולה, יש להוסיף תנאי שבודק שיש בשדה ערך.
הטריגר החזרה עודכנה מספק רק את הערכים הנוכחיים של ההחזרה ושל פריטי השורה שלה. הערכים הקודמים של השדות שהשתנו אינם זמינים בזרימת העבודה. לדוגמה, אם מוגדר מעקב אחר השדה status, אפשר להשתמש בסטטוס הנוכחי של ההחזרה בתנאי או בפעולה, אבל אי אפשר להשתמש בסטטוס שהיה לפני השינוי.
פעולות
הטריגר הזה מספק אובייקט החזרה, ולכן מאפשר להשתמש בכל פעולה שדורשת החזרה. בנוסף, מכיוון שאובייקט ההחזרה כולל הזמנה, אפשר להשתמש בטריגר עם כל פעולה הקשורה להזמנות, כולל:
- הוספת פריט שורה להזמנה
- הוספת תגים להזמנה
- העברת הזמנה לארכיון
- ביטול הזמנה
- גביית תשלום
- השהיית הזמנת מילוי
- סימון הזמנה כמשולמת
הזמנות מאפשרות גישה לנתונים נוספים, כמו פרטי הלקוח, ולכן אפשר להשתמש בטריגר גם עם פעולות הקשורות ללקוח. פעולות אלה כוללות:
הזמנות כוללות גם רשימות נתונים, כגון פריטי שורה. באמצעות הפעולה לכל אחד, אפשר לעבור בלולאה על הרשימות האלה ולבצע פעולות על כל פריט. לדוגמה, אפשר לעבור בלולאה על פריטי השורה ולהוסיף תג לכל מוצר.
בדיקת הטריגר החזרה עודכנה
כדי לבדוק זרימת עבודה שמתחילה בטריגר הזה, יש להפעיל אותה ואז לשנות ב-Shopify Admin אחד מהשדות בהחזרה שזרימת העבודה עוקבת אחריהם. לדוגמה, אפשר ליצור החזרה ואז לעבד את ההחזרה או לסגור את ההחזרה.
פרטי API
הטריגר החזרה עודכנה מאפשר לבצע פעולות באמצעות אובייקט ההחזרה של GraphQL API. הטריגר הזה תואם לפעולת update של נושא ההחזרות ב-תיעוד של Shopify Events, עם סינון לפי השדות שנבחרו למעקב.