קבלת נתוני סשן של מעקב מזומנים

בתהליכי עבודה שדורשים נתוני סשן של מעקב מזומנים, אפשר להשתמש בפעולה קבלת נתוני סשן של מעקב מזומנים כדי לאחזר מידע על סשנים של מעקב מזומנים ממערכת ה-POS Pro שלך. נעשה שימוש בסשנים של מעקב מזומנים כדי לעקוב אחר המזומנים בקופות הרושמות של החנות שלך.

הגדרת תצורה

שדות

הפעולה קבלת נתוני סשן של מעקב מזומנים (Get cash tracking session data) מכילה את השדות הבאים.

שדות בשימוש בפעולות קבלת נתונים (Get data).
שדהתיאור
מיון נתונים לפישדה חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש.
מספר מקסימלי של תוצאותשדה חובה. הכמות המרבית של תוצאות שיכולות לחזור משאילתת החיפוש שבחרת. אפשר להחזיר עד 100 בכל פעם.
שאילתהשדה חובה. יש לבחור מבין השאילתות הנפוצות או לבחור באפשרות מתקדם (Advanced) כדי ליצור אחת משלך.

מחרוזת שאילתה

זוהי שאילתה לדוגמה לקבלת סשנים של מעקב מזומנים שנסגרו ביום האחרון:

closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'

המשתנה closing_time הוא מסנן הזמין בשאילתה CashTrackingSessions וניתן להשתמש בו מספר פעמים או לשלבו עם משתנים אחרים. משתנה ה-Liquid‏ scheduledAt זמין בזרימות עבודה המשתמשות בטריגר 'זמן מתוזמן'. תג ה-Liquid‏ date_minus הוא תג Flow מיוחד המאפשר להחסיר זמן מתאריך.

בעת תשאול נתונים, כדאי לדעת את הדברים הבאים:

  • רשימה של מסננים זמינים עבור סשנים של מעקב מזומנים

  • שאילתות חייבות להיות בהתאם לתחביר מסוים

  • ערכי שדות שאילתה אינם תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון במסמכי ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL בלוח המנהל בעת סינון. לדוגמה, כדי למצוא ערכים מסוימים של שאילתת הזמנה, יש לסנן את הדף 'הזמנות' בלוח המנהל ולאחר מכן לבדוק את כתובת ה-URL.

  • אפשר להפעיל או לבדוק שאילתה בחנות באמצעות האפליקציה Shopify GraphiQL.

  • כדאי לשים לב למה שקורה אם השאילתה נכשלת. לרוב, ה-API יחזיר את כל התוצאות (במקום לא להחזיר אף אחת).

נתונים שהוחזרו

כל הפעולות מסוג קבלת נתונים מחזירות רשימה של בין 0 ל-100 משאבים. בהתאם למקרה השימוש, ניתן להשתמש בנתונים אלה בדרכים שונות:

  • אם עליך לטפל בכל פריט ברשימה בנפרד, לדוגמה כדי להוסיף תג לכל פריט, תוכל להשתמש בפעולה For each.
  • אם עליך לצבור נתונים, למשל לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות Count או Sum.
  • אם עליך להפיק את הרשימה כפלט, כגון לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.

כדי לגשת לנתונים שהוחזרו בשלבים הבאים אחרי פעולה זו, יש להשתמש במשתנה Get cash tracking session data, שהוא רשימה של סשנים של מעקב מזומנים. אפשר להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, אפשר לשלוח את רשימת הסשנים של מעקב מזומנים בפעולה Send internal email כך:

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}

טריגרים

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

חומר עזר ל-API

למידע נוסף על ה-API שבו נעשה שימוש בפעולה זו, ניתן לעיין בשאילתה CashTrackingSessions.