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

ההתראות שנשלחות מהחנות עוברות רינדור באמצעות Liquid.‏ Liquid היא שפת התכנות הפשוטה והקלה לשימוש של Shopify. זו אותה שפת תכנות שעליה מבוססות ערכות הנושא מ-חנות ערכות הנושא.

כדי לערוך את ההתראות שנשלחות מהחנות, אפשר לבצע התאמות אישיות בסיסיות לתבניות ההתראות. כדי לגשת לרשימה המלאה של ההתראות שאפשר להתאים אישית, יש לעבור אל הדף התראות בלוח המנהל של Shopify.

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

בדף זה

מאפייני הזמנה

מאפיינים רבים של הזמנה זמינים לשימוש ישיר באמצעות Liquid, ובתבניות.

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם האובייקט order בתבניות התראה
מאפיין	תיאור
`id`	מזהה הזמנה ייחודי ברמת המערכת לשימוש פנימי. אפשר להשתמש בדוגמה הבאה כדי ליצור קישור להזמנה באזור הניהול של החנות שלכם. לדוגמה, בתבנית הזמנה חדשה, אפשר להוסיף את הקוד הבא: `צפייה בהזמנה`
`email`	כתובת הדוא"ל שמשויכת להזמנה.
`name`	לרוב, זהו סמל סולמית ולאחריו `order_number`. דוגמה: #1004
`order_name`	זהה ל-name.
`order_number`	מספר ייחודי של ההזמנה בחנות, ללא קידומת הסולמית (#), וללא שום קידומת או סיומת שהוסיף בעל החנות למזהה ההזמנה בהגדרות החנות שלו. דוגמה: 1004
`confirmation_number`	מזהה אלפא-נומרי (אותיות ומספרים) להזמנה שנוצר באופן אקראי, אשר עשוי להיות מוצג ללקוח במקום שם ההזמנה הסידורי. אין ערובה לכך שערך זה הוא ייחודי. דוגמה: XPAV284CT
`created_at`	התאריך והשעה שבהם הלקוח יצר את ההזמנה. ניתן לעצב זאת באמצעות המסנן date. דוגמה: 2009-05-30T17:43:51+02:00
`payment_terms`	תנאי תשלום מציינים את התאריך שבו נדרש לשלם עבור ההזמנה. מידע נוסף על הוספת תנאי תשלום לחשבוניות של הזמנות. לפרטים נוספים, אפשר לעיין בחומר העזר של Liquid עבור payment_terms.
`destination`	היעד שאליו יש לשלוח את הפריטים.
`tags`	מחזיר מערך של כל התגים של ההזמנה. התגים מוחזרים בסדר אלפביתי. ייתכן שתגים שמוחלים באופן דינמי על-ידי אפליקציות או תכונות של הפלטפורמה, כגון התג `Shopify Collective`, לא יהיו זמינים בעת יצירת דוא"ל ההתראה. כדי לזהות פריטים מתכונה ספציפית, מומלץ לבדוק במקום זאת תגים ברמת המוצר בכל פריט שורה. לפרטים נוספים, יש לעיין בתיעוד העזר של Liquid.
`transactions`	מחזיר מערך של עסקאות מההזמנה.
`tax_price`	סך כל המיסים של כל הפריטים בהזמנה.
`tax_lines`	מיסים בחלוקה לפי סוג מס: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	שם המס. לדוגמה, QST או מע"מ.
`tax_line.price`	סכום המס.
`tax_line.rate`	שיעור המס כמספר עשרוני. יוחזר 0.175 עבור 17.5%.
`tax_line.rate_percentage`	שיעור המס בפורמט קריא. יוחזר 17.5 אם השיעור הוא 0.175.
`customer`	אובייקט לקוח שמכיל את המאפיינים של פלט הלקוח.
`billing_address`	כתובת החיוב.
`billing_address.first_name`	השם הפרטי של הלקוח.
`billing_address.last_name`	שם המשפחה של הלקוח.
`billing_address.company`	שם החברה לחיוב.
`billing_address.phone`	מספר הטלפון מכתובת החיוב.
`shop.name`	שם החנות שלך.
`shop.phone`	מספר הטלפון של החנות שלך.
`subtotal_price`	סכום המחירים של פריטי השורה בהזמנה לאחר ניכוי של הנחות על פריטי שורה או הנחות על הסל. סכום הביניים אינו כולל מיסים (אלא אם המיסים כלולים במחירים), עלויות שילוח או טיפים.
`discounts`	רשימה של הנחות.
`discounts_amount`	סכום ההנחה שהוחל על-ידי כל ההנחות. לדוגמה: +$5.00
`discounts_savings`	סכום החיסכון כתוצאה מכל ההנחות. לדוגמה: -$5.00
`total_price`	סך כל ההזמנה (סכום ביניים + עלות שילוח - הנחה על השילוח + מס).
`financial_status`	סטטוס התשלום הנוכחי. אחד מהערכים: nil, ‏`pending`, ‏`authorized`, ‏`paid`, ‏`voided`, ‏`refunded`.
`requires_shipping`	(בוליאני) מחזיר true אם יש לפחות פריט אחד בהזמנה שדורש שילוח.
`shipping_method.title`	שם תעריף השילוח. בהתראות שנשלחות ללקוחות, שם תעריף השילוח מתורגם לשפה שבה הלקוח ביצע את התשלום בקופה, אם שפה זו שונה משפת ברירת המחדל של החנות. לדוגמה: Standard Shipping
`shipping_method.price`	מחיר השילוח כולל כל הנחה על השילוח. לדוגמה: `{{ shipping_method.price \| money }}`
`shipping_price`	מחיר השילוח. לדוגמה: `{{ shipping_price \| money }}`
`shipping_address`	הכתובת לשילוח.
`shipping_address.first_name`	השם הפרטי עבור הכתובת לשילוח.
`shipping_address.company`	שם החברה עבור הכתובת לשילוח.
`shipping_address.phone`	מספר הטלפון מתוך הכתובת לשילוח.
`line_items`	רשימה של כל פריטי השורה בהזמנה.
`line_items_including_zero_quantity`	רשימה של כל פריטי השורה בהזמנה, כולל פריטים עם כמות של אפס. לפריטי שורה תהיה כמות של אפס כאשר ניתן עבורם החזר כספי מלא.
`line_item_groups`(Orders and POS only)	רשימה של כל קבוצות פריטי השורה שמכילות רכיבי פריטי שורה בהזמנה.
`item_count`	הסכום של כל כמויות הפריטים.
`fulfillment_status`	סטטוס המילוי הנוכחי של ההזמנה. אחד מהערכים: `unfulfilled`, ‏`partial`, ‏`fulfilled`.
`note`	ההערה שמצורפת להזמנה. אפשר לקבל את ההערה מהלקוח ו/או לערוך אותה במסך פרטי ההזמנה בממשק המנהל שלך.
`attributes`	כל המאפיינים שצורפו להזמנה. לדוגמה: `{{ attributes.gift-note }}`
`metafields`	כל מטא השדות שבהזמנה. יש להשתמש בתחביר הבא: metafields.NAMESPACE.KEY
`referring_site`	מכיל את כתובת ה-URL של המפנה שהביא את הלקוח לחנות שלך. לדוגמה: `https://www.google.com/?s=great+products`
`landing_site`	מכיל את הנתיב של אתר הנחיתה שבו הלקוח השתמש. זהו הדף הראשון שהלקוח ראה כשהוא הגיע לחנות. לדוגמה: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	סוקר את אתר הנחיתה ומחלץ ממנו פרמטר הפניה. פרמטרי הפניה יכולים להיות: `ref`, ‏`source`, ‏`r`. אם ה-`landing_site` הוא `/products/great-product?ref=my-tracking-token`, אז ה- `landing_site_ref` הוא `my-tracking-token`. אפשר לבצע פעולה מסוימת אם ה-ref שווה לערך מסוים: `{% if landing_site_ref == 'my-tracking-token' %} הפעולה שלי... {% endif %}`
`cancelled`	(בוליאני) מחזיר true אם ההזמנה בוטלה.
`cancelled_at`	הזמן שבו ההזמנה בוטלה.
`cancel_reason`	הסיבה שנבחרה בעת ביטול ההזמנה. אחד מהערכים: `inventory`, ‏`customer`, ‏`declined`, ‏`fraud` או `other`.
`has_high_risks?`(deprecated)	מחזיר true אם ההזמנה היא בסיכון גבוה
`unique_gateways`	מחזיר רשימה של ספקי תשלומים ייחודיים בהזמנה. לדוגמה, אם מישהו שילם ב-Visa, ב-Mastercard ובמזומן, הרשימה שתוחזר תהיה `shopify_payments, cash`.
`location`(POS only)	מציג את המיקום הפיזי של ההזמנה. קיימים מספר מאפייני מיקום זמינים, שמפורטים כאן. אפשר להגדיר מיקומים באזור המיקומים בלוח המנהל.
`order_status_url`	מחזיר את הקישור לדף סטטוס ההזמנה עבור הזמנה זו.
`fulfilled_line_items`(deprecated)	רשימה של פריטי שורה שמולאו.
`unfulfilled_line_items`(deprecated)	רשימה של פריטי שורה שלא מולאו במלואם.
`b2b?`	מחזיר true אם ההזמנה היא הזמנת B2B. אפשר להשתמש במאפיין הזה עם משתני B2B כדי להציג מידע רלוונטי, כמו שם החברה, מיקום החברה והכתובת באימיילים. לדוגמה, בהזמנות B2B אפשר להוסיף לתבנית כותרת עם המידע הבא: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	החברה שאתה מוכר לה בהזמנת B2B.
`company.name`	שם החברה בהזמנת B2B.
`company.id`	המזהה של החברה בהזמנת B2B.
`company_location`	המיקום של החברה בהזמנת B2B. לחברה שקונה ממך יכול להיות יותר ממיקום אחד.
`company_location.name`	שם מיקום החברה בהזמנת B2B.
`company_location.id`	מספר המזהה של מיקום החברה בהזמנת B2B.
`company_location.shipping_address`	הכתובת לשילוח של מיקום החברה בהזמנת B2B.
`company_location.billing_address`	הכתובת חיוב של מיקום החברה בהזמנת B2B.
`customer_order_url`	הדף החדש של סטטוס הזמנה של הזמנה שעבורה הלקוח ביקש החזרה דרך חשבונות לקוח.

מאפיינים של טיוטת הזמנה

תיאורים של מאפייני Liquid שבהם אפשר להשתמש עם האובייקט של טיוטת הזמנה בתבניות התראה
מאפיין	תיאור
`id`	מזהה ייחודי של טיוטת ההזמנה לשימוש פנימי.
`invoice_url`	קישור שהלקוח יכול ללחוץ עליו כדי לשלם את החשבונית באמצעות התשלום המאובטח של Shopify.
`reserve_inventory_until`	התאריך והשעה שעד אליהם שמורים פריטי השורה בטיוטה, לדוגמה, `2015-05-30T17:43:51+02:00`. אפשר לעצב תאריכים באמצעות המסנן תאריכים של Liquid.
`user`	איש הצוות האחרון ששינה את טיוטת ההזמנה.
`user.name`	השם של איש הצוות האחרון ששינה את טיוטת ההזמנה.
`user.email`	כתובת הדוא"ל של איש הצוות האחרון ששינה את טיוטת ההזמנה.
`email`	כתובת הדוא"ל שמשויכת לטיוטת ההזמנה.
`name`	ה `number` הייחודי של טיוטת ההזמנה, בתוספת סולמית (`#`) כקידומת.
`number`	המספר הייחודי של טיוטת ההזמנה ללא הקידומת או הסיומת של ההזמנה.
`created_at`	התאריך והשעה שבהם הלקוח יצר את טיוטת ההזמנה, לדוגמה, `2009-05-30T17:43:51+02:00`. אפשר לעצב תאריכים באמצעות המסנן תאריכים של Liquid.
`tags`	מחזיר מערך של כל התגים של ההזמנה. התגים מוחזרים בסדר אלפביתי. לפרטים נוספים, אפשר לעיין במסמכי התיעוד של Liquid.
`tax_price`	המסים המשולבים של כל הפריטים בטיוטת ההזמנה.
`tax_lines`	המסים בחלוקה לפי סוגי מס: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	שם המס. דוגמאות: QST או מע"מ
`tax_line.price`	סכום המס.
`tax_line.rate`	שיעור המס בצורה עשרונית. לדוגמה, שיעור מס של 17.5% יחזיר את הערך `0.175`.
`tax_line.rate_percentage`	שיעור המס באחוזים. לדוגמה, `rate` של 0.175 יחזיר את הערך `17.5`.
`customer`	אובייקט לקוח שמכיל את המאפיינים של פלט הלקוח.
`billing_address`	הכתובת חיוב של טיוטת ההזמנה.
`billing_address.first_name`	השם הפרטי של הלקוח.
`billing_address.last_name`	שם המשפחה של הלקוח.
`billing_address.company`	שם החברה בכתובת החיוב.
`billing_address.phone`	מספר הטלפון בכתובת החיוב.
`shop.name`	שם החנות שלך.
`shop.phone`	מספר הטלפון של החנות שלך.
`subtotal_price`	סכום המחירים של פריטי השורה בטיוטת ההזמנה, לאחר הפחתה של הנחה על פריטי שורה או הנחה על הסל. סכום הביניים לא כולל מסים (אלא אם הם מגולמים במחירים) או עלויות שילוח.
`discounts`	רשימה של הנחות.
`discounts_amount`	סכום ההנחה שהוחל על ידי כל ההנחות. לדוגמה: +$5.00
`discounts_savings`	סכום החיסכון כתוצאה מכל ההנחות. לדוגמה: -$5.00
`total_price`	המחיר הכולל של ההזמנה (סכום ביניים + עלות שילוח - הנחת שילוח + מס).
`amount_due_now`	הסכום הנדרש בחשבונית של טיוטת ההזמנה.
`requires_shipping`	מחזיר את הערך `true` אם יש לפחות פריט אחד בטיוטת ההזמנה שדורש שילוח. מחזיר את הערך `false` אם אף פריט בטיוטת ההזמנה לא דורש שילוח.
`shipping_method.title`	השם של תעריף השילוח. דוגמה: שילוח רגיל
`shipping_method.price`	המחיר של שיטת השילוח. מחזיר מידע זהה ל- `shipping_price`.
`shipping_price`	מחיר השילוח. אפשר לעצב את הסכום הזה באמצעות מסנני כספים (money filters) של Liquid.
`shipping_address`	הכתובת לשילוח. הערה: בניגוד להזמנות רגילות, הכתובת לשילוח של טיוטת ההזמנה עשויה להיות לא שלמה.
`shipping_address.first_name`	השם הפרטי עבור הכתובת לשילוח.
`shipping_address.company`	שם החברה בכתובת לשילוח.
`shipping_address.phone`	מספר הטלפון בכתובת לשילוח.
`line_items`	רשימה של כל פריטי השורה בטיוטת ההזמנה.
`item_count`	הסכום של כל כמויות הפריטים בטיוטת ההזמנה.
`note`	ההערה המצורפת לטיוטת ההזמנה. אפשר לקבל את ההערה מהלקוח וגם לערוך אותה במסך פרטי טיוטת ההזמנה במנהל Shopify.
`metafields`	כל המטא שדות בטיוטת ההזמנה. יש להשתמש בתחביר הבא: metafields.NAMESPACE.KEY
`location`	המיקום הפיזי של ההזמנה. קיימים מספר מאפייני מיקום זמינים. אפשר להגדיר מיקומים בדף מיקומים במנהל Shopify.
`b2b?`	מחזיר true אם ההזמנה היא הזמנת B2B. אפשר להשתמש במאפיין הזה עם משתני B2B כדי להציג מידע רלוונטי, כמו שם החברה, מיקום החברה והכתובת באימיילים. לדוגמה, בהזמנות B2B אפשר להוסיף לתבנית כותרת עם המידע הבא: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	החברה שאתה מוכר לה בהזמנת B2B.
`company.name`	שם החברה בהזמנת B2B.
`company.id`	המזהה של החברה בהזמנת B2B.
`company_location`	המיקום של החברה בהזמנת B2B. לחברה שקונה ממך יכול להיות יותר ממיקום אחד.
`company_location.name`	שם מיקום החברה בהזמנת B2B.
`company_location.id`	מספר המזהה של מיקום החברה בהזמנת B2B.
`company_location.shipping_address`	הכתובת לשילוח של מיקום החברה בהזמנת B2B.
`company_location.billing_address`	הכתובת חיוב של מיקום החברה בהזמנת B2B.
`payment_methods`	רשימה של אמצעי תשלום שמורים הזמינים לעיבוד הסכום הכולל של הטיוטה.
`payment_method.payment_instrument`	אמצעי התשלום, שמכיל פרטים לגבי אמצעי התשלום השמור.
`payment_method.payment_instrument.payment_type`	סוג אמצעי התשלום שנשמר. לדוגמה "credit_card, apple_pay"
`payment_method.payment_instrument.credit_card_brand`	המותג של הכרטיס, כאשר הערך של `payment_type` הוא "credit_card"
`payment_method.payment_instrument.credit_card_company`	חברת הכרטיס, כאשר הערך של `payment_type` הוא "credit_card"
`payment_method.payment_instrument.credit_card_company`	4 הספרות האחרונות של הכרטיס, כאשר הערך של `payment_type` הוא "credit_card"

מאפיינים של לוח זמנים לתשלום

תיאורים של מאפייני Liquid שבהם אפשר להשתמש עם האובייקט של לוח זמנים לתשלום בתבניות התראה
מאפיין	תיאור
`payment_schedule.amount_due`	הסכום שיש לשלם עבור לוח תשלומים. אפשר לעצב סכומים עם מטבעות באמצעות ה-מסנן money של Liquid.
`payment_schedule.due_at`	תאריך היעד עבור לוח התשלומים. אפשר לעצב תאריכים באמצעות המסנן תאריכים של Liquid.
`payment_schedule.due_in_days`	מספר הימים עד לתאריך היעד, אם לוח התשלומים עדיין לא שולם.
`payment_schedule.due_later?`	מחזיר true אם לוח תשלומים לא שולם ותאריך היעד שלו נמצא בעתיד.
`payment_schedule.number_of_days_overdue?`	מספר הימים מתאריך היעד כאשר לוח תשלומים נמצא בפיגור.
`payment_schedule.overdue?`	מחזיר true אם לוח תשלומים לא שולם ותאריך היעד שלו עבר.

מאפייני סטטוס תשלום

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט סטטוס התשלום בתבניות של התראות
מאפיין	תיאור
`has_pending_payment`	(בוליאני) מחזיר true אם להזמנה יש עסקה עם תשלום ממתין. למידע נוסף על תשלומים ממתינים.
`buyer_action_required`	(בוליאני) מחזיר true אם להזמנה יש עסקה עם תשלום ממתין, ונדרשת פעולה של הקונה כדי לשחרר את התשלום. כשהערך הזה מחזיר true ואמצעי התשלום תומך בהוראות תשלום, ה- `buyer_pending_payment_instructions` מספק פרטים שהלקוח יכול להשתמש בהם כדי להשלים את הרכישה באופן לא מקוון. למידע נוסף על אובייקט transaction של Liquid.

מאפייני רכיב חבילה

לכל bundle_component ברשימה של line_item.bundle_components יש את המאפיינים הבאים. (טיוטות הזמנה בלבד)

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט רכיב החבילה בתבניות של התראות
מאפיין	תיאור
`bundle_component.image_url`	כתובת ה-URL של תמונת רכיב החבילה.
`bundle_component.product.title`	הכותרת של מוצר רכיב החבילה.
`bundle_component.quantity`	הכמות עבור רכיב החבילה.
`bundle_component.variant.title`	השמות הנוכחיים של ערכי האפשרויות של גרסת רכיב החבילה, מחוברים בתווי `/`. דוגמה: small / red

מאפייני רכיב

לכל component ברשימה של line_item.components יש את המאפיינים הבאים. (תשלום נטוש בלבד) `

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט הרכיב בתבניות של התראות
מאפיין	תיאור
`component.image_url`	כתובת ה-URL של תמונת הרכיב.
`component.product.title`	הכותרת של מוצר הרכיב.
`component.quantity`	הכמות עבור הרכיב.
`component.variant.title`	השמות הנוכחיים של ערכי האפשרויות של גרסת הרכיב, מחוברים בתווי `/`. דוגמה: small / red

מאפייני פריט שורה

לכל line ברשימה של line_items או subtotal_line_items יש את המאפיינים הבאים.

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט פריט השורה בתבניות של התראות
מאפיין	תיאור
`line.applied_discounts`(POS and draft orders only)	רשימת ההנחות שהופעלו על פריט זה (לכל הנחה יש את המאפיינים `title`,‏ `code`,‏ `amount`,‏ `savings` ו-`type`).
`line.bundle_components`(Draft orders only)	רשימה של פריטי שורה שהם רכיבי חבילה של פריט זה. מחזיר רשימה רק אם פריט שורה זה הוא מוצר שהוא חבילה.
`line.bundle_parent?`(Draft orders only)	(בוליאני) מחזיר true אם פריט השורה הוא מוצר שהוא חבילה.
`line.components`(Abandoned checkout only)	רשימה של פריטי שורה שהם רכיבים של פריט זה.
`line.parent?`(Abandoned checkout only)	(בוליאני) מחזיר true אם לפריט השורה יש רכיבים.
`line.custom`(Draft orders only)	(בוליאני) מחזיר true אם הפריט הוא פריט שורה מותאם אישית עבור טיוטת הזמנה.
`line.delivery_agreement`	ה-הסכם המשלוח (Delivery Agreement) המשויך לפריט שורה זה.
`line.grams`	המשקל של פריט בודד.
`line.groups`	קבוצת פריט שורה של הפריט.
`line.image`	מחזיר את כתובת ה-URL של התמונה המשויכת לפריט שורה זה. אפשר גם להשתמש ב-מסנן img_url כדי לקבל גדלים מסוימים של תמונות, לדוגמה `{{ line.image \| img_url: 'small' }}`
`line.line_price`	המחיר כפול הכמות עבור פריט זה.
`line.original_line_price`	המחיר המשולב של כמות הפריטים הכלולים בשורה, לפני שהופעלו הנחות.
`line.final_line_price`	המחיר המשולב של כל הפריטים בפריט השורה, כולל כל סכומי ההנחות ברמת השורה.
`line.pre_tax_price`	המחיר לפני מס של פריטי השורה, כפול הכמות של פריט השורה שנרכשה.
`line.price`	המחיר לפריט בודד.
`line.product.metafields`	כל מטא השדות ברמת המוצר. יש להשתמש בתחביר הבא: line.product.metafields.NAMESPACE.KEY
`line.product.title`	השם הנוכחי של המוצר.
`line.product.vendor`	הספק של הפריט.
`line.properties`	מחזיר מערך של מידע מותאם אישית עבור פריט. מאפייני פריט שורה מצוינים על ידי הלקוח בדף המוצר, לפני הוספת מוצר לסל.
`line.quantity`	הכמות עבור פריט זה.
`line.current_quantity`	הכמות הנוכחית של הפריט לאחר הסרות.
`line.requires_shipping`	(בוליאני) מחזיר true אם לגרסה של הפריט יש את ההגדרה Physical product (מוצר פיזי) מופעלת בדף המוצר.
`line.selling_plan_allocation`	מחזיר אובייקט `selling_plan_allocation`, המתאר כיצד תוכנית מכירה כגון מינוי משפיעה על פריט השורה.
`line.taxable`	(בוליאני) מחזיר true אם לגרסה של הפריט מסומנת תיבת הסימון 'Charge taxes on this product' (גביית מס על מוצר זה) בדף המוצר.
`line.title`	שם המוצר במועד המכירה, ואחריו מקף ושם הגרסה במועד המכירה. שם הגרסה לא נכלל כשהוא "Default Title" (כותרת ברירת מחדל). בהתראות שנשלחות ללקוחות, שם המוצר ושם הגרסה מתורגמים לשפה שבה הלקוח ביצע את התשלום, אם השפה שונה משפת ברירת המחדל של החנות.
`line.url`	כתובת ה-URL היחסית של הגרסה של פריט השורה. כתובת ה-URL היחסית לא כוללת את כתובת ה-URL הראשית של החנות שלך (`mystore.myshopify.com`).
`line.variant.barcode`	הברקוד המשויך לגרסת המוצר.
`line.variant.compare_at_price`	ה-מחיר לפני הנחה המשויך לגרסת המוצר.
`line.variant.image`	התמונה עבור גרסת המוצר. מחזיר תמונה רק אם יש תמונה מסוימת שהוקצתה לגרסה בפריט השורה.
`line.variant.metafields`	כל מטא השדות ברמת הגרסה. יש להשתמש בתחביר הבא: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	המק"ט שמשויך לגרסת המוצר.
`line.variant.title`	השמות הנוכחיים של ערכי האפשרויות של הגרסה, מחוברים באמצעות התו `/`. דוגמה: small / red
`line.refunded.quantity`(within refund notifications)	הכמות של פריט שעליו יינתן החזר כספי. אפשר להשתמש במאפיין זה כדי להוסיף מזהה לפריטים בהזמנה שעליהם ניתן החזר כספי. לדוגמה: `{% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}`

זיהוי פריטי Shopify Collective בתבניות של התראות

התג Shopify Collective מוחל על הזמנה לאחר שדוא"ל אישור ההזמנה נשלח, לכן {% if tags contains 'Shopify Collective' %} אף פעם לא מחזיר true בתבנית של אישור הזמנה. כדי לזהות פריטים של Shopify Collective, יש לבדוק תגים ברמת המוצר בכל פריט שורה במקום זאת:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

מאפיינים של קבוצת פריטי שורה

לכל line_item_group ברשימה line_item_groups יש את המאפיינים הבאים.

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם האובייקט של קבוצת פריטי שורה בתבניות של התראות
מאפיין	תיאור
`line_item_group.display_title`	הכותרת של קבוצת פריטי השורה.
`line_item_group.components`	רשימה של רכיבים של פריטי שורה ששייכים לקבוצה.
`line_item_group.image`	התמונה של קבוצת פריטי השורה.
`line_item_group.product_id`	מזהה המוצר של קבוצת פריטי השורה.
`line_item_group.variant`	האובייקט של הגרסה של קבוצת פריטי השורה.
`line_item_group.variant_id`	מזהה הגרסה של קבוצת פריטי השורה.

מאפיינים של החזרים כספיים

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט ההחזר הכספי בתבניות של התראות
מאפיין	תיאור
`amount`	סכום הכסף שהוחזר.
`refund_line_items`	רשימה של פריטי שורה להחזר שעליהם יינתן החזר כספי.

מאפיינים של Refund_line_item

לכל refund_line ברשימה של refund_line_items יש את המאפיינים הבאים:

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט פריטי השורה להחזר בתבניות של התראות
מאפיין	תיאור
`refund_line.line_item`	ה-line_item (פריט שורה) שעליו ניתן ההחזר. מאפשר גישה לכל המאפיינים של line_item.
`refund_line.quantity`	הכמות של פריט השורה שעליה יש לתת החזר כספי.

מאפיינים של מילוי הזמנות

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם האובייקט של מילוי הזמנה בתבניות של התראות
מאפיין	תיאור
`service_name`	שם השירות המותאם אישית כפי שהוגדר בדף הגדרות > שילוח ואספקה. (בקשת מילוי בלבד)
`fulfillment.estimated_delivery_at`	תאריך אספקה משוער שמבוסס על מספר המעקב (אם זמין) שסופק על-ידי אחת מחברות השילוח הבאות: USPS, FedEx, UPS, Canada Post (בקנדה בלבד). מאפיין זה זמין רק בשימוש בתעריפים המחושבים על ידי חברות שילוח.
`fulfillment.fulfillment_line_items`	רשימה של פריטי שורה של מילוי הזמנה שיש למלא.
`fulfillment.item_count`	סכום הכמויות של כל הפריטים. המספר הכולל של פריטים הממולאים בבקשה זו.
`fulfillment.requires_shipping`	(בוליאני) מחזיר true אם בקשת המילוי הזו דורשת שילוח.
`fulfillment.tracking_company`	החברה המבצעת את המעקב.
`fulfillment.tracking_numbers`	רשימה של מספרי מעקב.
`fulfillment.tracking_urls`	רשימה של כתובות URL למעקב.
`items_to_fulfill`(deprecated)	רשימה של פריטי שורה שיש למלא באמצעות שירות מותאם אישית למילוי הזמנות זה. (בקשת מילוי בלבד)
`items_to_fulfill_count`(deprecated)	המספר הכולל של הפריטים שיש למלא בבקשה זו. (בקשת מילוי בלבד)

מאפיינים של Fulfillment_line_item

לכל fulfillment_line ברשימה של fulfillment_line_items יש את המאפיינים הבאים.

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט של פריטי שורת מילוי בתבניות של התראות
מאפיין	תיאור
`fulfillment_line.line_item`	ה-line_item שממולא. מאפשר גישה לכל המאפיינים של line_item.
`fulfillment_line.quantity`	הכמות של פריט השורה שממולא כעת.

מאפיינים של חבילה מוכנה

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

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט החבילה המוכנה בתבניות של התראות
מאפיין	תיאור
`item_count`	סך כל כמויות הפריטים בחבילה המוכנה.
`prepared_package_line_items`	רשימה של פריטי שורה של חבילה מוכנה.

מאפיינים של Prepared_package_line_item

לכל prepared_package_line_item ברשימה של prepared_package_line_items יש את המאפיינים הבאים.

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט פריט השורה של חבילה מוכנה בתבניות של התראות
מאפיין	תיאור
`line_item`	ה-line_item המשויך. מאפשר גישה לכל המאפיינים של line_item.
`quantity`	הכמות של פריט השורה שסומנה כמוכנה לאיסוף.

מאפיינים של מסירה

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט המסירה בתבניות של התראות
מאפיין	תיאור
`delivery_agreements`	רשימה של כל הסכמי המסירה עבור ההזמנה.
`delivery_instructions`	מידע על אספקה מקומית לשיתוף עם הלקוח. מידע זה נשלט על ידי השדה מידע על מסירה בהגדרות האספקה המקומית שלך.
`consolidated_estimated_delivery_time`	מידע על תאריכי אספקה של ההזמנה לשיתוף עם הלקוח. מידע זה נשלט על ידי ההגדרה זמן עיבוד שהגדרת בדף שילוח ואספקה. כאשר להזמנה יש מספר שיטות אספקה, תוצג רשימה של שיטות ותאריכי אספקה.
`has_multiple_delivery_methods`	(בוליאני) מחזיר true אם להזמנה יש מספר שיטות אספקה.

מאפיינים של הסכם מסירה

תיאורים של מאפייני Liquid שאפשר להשתמש בהם עם אובייקט של הסכם מסירה בתבניות של התראות
מאפיין	תיאור
`delivery_agreement.delivery_method_type`	הסוג של שיטת האספקה.
`delivery_agreement.delivery_method_name`	הסוג של שיטת האספקה מתורגם לשפה שבה הקונה ביצע את התשלום בקופה, במקרה שבו השפה שונה משפת ברירת המחדל של החנות.
`delivery_agreement.line_item_groups`	רשימה של כל הקבוצות של פריטי שורה שמכילות רכיבים של פריטי שורה מאוגדים בהסכם המסירה.
`delivery_agreement.line_items`	רשימה של כל פריטי השורה המשויכים להסכם מסירה זה.

מאפיינים של הנחות

ישנם שני סוגים של מאפייני הנחות.

discount_applications מתאר מדוע וכיצד יושמה הנחה על פריט.

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

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

דוגמה

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

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

התוצאה עשויה להיות דומה לזו:

SPRING5 (-$5.00)

מאפייני discount_allocation

לכל discount_allocation ברשימה discount_allocations יש את המאפיינים הבאים.

תיאורים של מאפייני Liquid שניתן להשתמש בהם עם האובייקט discount_allocation בתבניות התראה
מאפיין	תיאור
`discount_allocation.amount`	סכום הכסף שהלקוח חסך על פריט שורה. יש להזין את המאפיין בלולאה כדי לאפשר שימוש במספר קודי הנחה.
`discount_allocation.discount_application`	החלת ההנחה שמקצה את הסכום על פריט השורה.

מאפייני discount_application

לכל discount_application ברשימה discount_applications יש את המאפיינים הבאים.

תיאורים של מאפייני Liquid שניתן להשתמש בהם עם האובייקט discount_application בתבניות התראה
מאפיין	תיאור
`discount_application.target_selection`	מתאר כיצד הנחה בוחרת פריטי שורה בסל שעליהם היא תוחל. אחד מהערכים הבאים: `all`: ההנחה חלה על כל פריטי השורה. `entitled`: ההנחה חלה על תת-קבוצה מסוימת של פריטי שורה, שלרוב מוגדרת על ידי תנאי. `explicit`: ההנחה חלה על פריט שורה או שורת שילוח שנבחרו באופן ספציפי.
`discount_application.target_type`	סוג הפריט שעליו חלה ההנחה (`line_item` או `shipping_line`).
`discount_application.title`	השם של ההנחה שמוצג ללקוח. דוגמאות: Welcome10 או CBBWQQAKYBYY
`discount_application.total_allocated_amount`	הסכום הכולל שמופחת ממחיר ההזמנה בעקבות ההנחה.
`discount_application.type`	סוג ההנחה. אחד מהערכים הבאים: `automatic`, ‏`discount_code`, ‏`manual`, או `script`.
`discount_application.value`	הערך של ההנחה.
`discount_application.value_type`	סוג הערך של ההנחה. אחד מהערכים הבאים: `fixed_amount` או `percentage`.

מאפייני מינוי

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

כדי לערוך תבניות התראה על מינויים, יש להתקין את האפליקציה Shopify Subscriptions, ולאחר מכן לאתר את התבנית בהגדרות > התראות תחת המקטע מינויים.

מאפיינים של מחזור החיוב עבור חוזה מינוי

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

דוגמה

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

תוצאה:

This contract is currently paused.

מאפיינים

תיאורים של מאפייני Liquid שניתן להשתמש בהם עם האובייקט של מחזור החיוב עבור חוזה המינוי בתבניות התראה
מאפיין	תיאור
`status`	הסטטוס של החוזה. אחד מהערכים הבאים: `active`, ‏`paused`, ‏`cancelled`, ‏`failed`, ‏`expired`, ‏`stale`,
`delivery_method`	שיטת האספקה של המינוי. אם המינוי הוא עבור שירות או מוצר דיגיטלי, יוחזר הערך `nil`.
`billing_frequency`	תדירות החיוב של המינוי.
`delivery_frequency`	תדירות האספקה של המינוי.
`origin_order`	ההזמנה המקורית שיצרה לראשונה את המינוי. אם המינוי לא נוצר מהזמנה של Shopify, יוחזר הערך `nil`.
`customer`	הלקוח של המינוי.
`line_items`	פריטי השורה במחזור החיוב של המינוי.
`product_names`	רשימה של שמות המוצרים שנכללים במחזור החיוב של המינוי.
`update_payment_method_url`	כתובת ה-URL שהלקוח יכול להשתמש בה כדי לעדכן את אמצעי התשלום עבור חוזה זה.
`shipping_address`	הכתובת לשילוח של המינוי. אם המינוי הוא עבור שירות או מוצר דיגיטלי, יוחזר הערך `nil`.
`billing_address`	כתובת החיוב של המינוי.
`subtotal_price`	סכום הביניים של פריטי השורה במינוי.
`shipping_price`	מחיר השילוח של המינוי.
`total_tax`	סך המס של המינוי.
`total_price`	המחיר הכולל של המינוי.
`total_discounts`	סך ההנחות של המינוי.
`customer_self_serve_url`	כתובת ה-URL לשירות עצמי שהלקוח יכול להשתמש בה כדי לנהל את המינויים שלו.
`billing_attempt_expected_date`	תאריך החיוב עבור מחזור חיוב זה.
`next_billing_date`	תאריך החיוב הבא שלא דולג לאחר מחזור חיוב זה.
`last_attempted_billing_date`	תאריך החיוב האחרון שבו בוצע ניסיון חיוב עבור מחזור זה.
`days_overdue`	מספר הימים שבהם החיוב נמצא בפיגור עבור מחזור חיוב זה.
`payment_instrument`	אמצעי התשלום המשויך לחוזה המינוי. אמצעי תשלום זה משמש לחיוב הלקוח.

מאפייני פריטי שורה בחוזה המינוי

המאפיינים של כל פריט שורה שנכלל במחזור החיוב. ניתן לגשת למאפיינים של פריט השורה בחוזה דרך מאפיין האב subscription_contract_billing_cycle.line_items.

דוגמה

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

תיאורים של מאפייני Liquid שניתן להשתמש בהם עם אובייקט פריט השורה בחוזה המינוי בתבניות התראה
מאפיין	תיאור
`url`	כתובת ה-URL לדף פרטי המוצר עבור גרסת המוצר של פריט השורה.
`requires_shipping`	קובע אם פריט השורה דורש שילוח פיזי.
`unit_price_measurement`	יחידת המידה של המחיר עבור פריט השורה.
`selling_plan_allocation`	הקצאת תוכנית המכירה של פריט השורה.

מאפייני שיטת אספקה של חוזה המינוי

המאפיינים של שיטת האספקה המשמשת במחזור חיוב זה. ניתן לגשת למאפייני שיטת האספקה דרך מאפיין האב subscription_contract_billing_cycle.delivery_method.

דוגמה

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

תיאורים של מאפייני Liquid שניתן להשתמש בהם עם אובייקט שיטת האספקה של חוזה המינוי בתבניות התראה
מאפיין	תיאור
`title`	הכותרת של אפשרות השילוח המשויכת לשיטת האספקה.
`type`	סוג שיטת האספקה. אחד מהערכים `shipping`, `local` או `pick-up`.

מאפייני אמצעי תשלום של חוזה מינוי

פרטים על אמצעי התשלום עבור חוזה המינוי. אמצעי תשלום זה משמש לחיוב הלקוח. אפשר לגשת למאפייני אמצעי התשלום דרך מאפיין האב subscription_contract_billing_cycle.payment_instrument.

דוגמה

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

תיאורים של מאפייני Liquid שבהם ניתן להשתמש עם אובייקט אמצעי התשלום של חוזה המינוי בתבניות של התראות
מאפיין	תיאור
`payment_type`	סוג אמצעי התשלום המיוצג על ידי אמצעי התשלום. יש להשתמש ב-מסנני תשלום כדי להפיק כתובת URL של תמונה או SVG.
`credit_card_brand`	מותג כרטיס האשראי.
`credit_card_company`	שם חברת כרטיסי האשראי.
`credit_card_last_four_digits`	4 הספרות האחרונות של כרטיס האשראי.

מאפייני התראות דוא"ל

תיאורים של מאפייני Liquid שבהם ניתן להשתמש עם אובייקט התראות הדוא"ל בתבניות של התראות
מאפיין	תיאור
`shop.email_logo_url`	כתובת ה-URL עבור הלוגו שצוינה בסעיף התאמה אישית של תבניות דוא"ל במנהל.
`shop.email_logo_width`	רוחב הלוגו (בפיקסלים) שצוין בסעיף התאמה אישית של תבניות דוא"ל במנהל.
`shop.email_accent_color`	קוד ה-HEX עבור צבע ההדגשה שצוין בסעיף התאמה אישית של תבניות דוא"ל במנהל.

מאפייני אשראי בחנות

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

תיאורים של מאפייני Liquid שבהם ניתן להשתמש עם אובייקט אשראי בחנות שהונפק בתבניות של התראות
מאפיין	תיאור
`issued_store_credit.amount`	סכום האשראי בחנות שהונפק. אפשר לעצב את הסכום הזה באמצעות מסנני כספים (money filters) של Liquid.
`issued_store_credit.expires_at`	התאריך והשעה שבהם יפוג תוקפו של האשראי בחנות שהונפק. ניתן לעצב סכום זה באמצעות מסנני תאריך של Liquid.
`issued_store_credit.balance_after_transaction`	היתרה של חשבון האשראי בחנות לאחר הנפקת האשראי. אפשר לעצב את הסכום הזה באמצעות מסנני כספים (money filters) של Liquid.
`customer`	אובייקט לקוח שמכיל את המאפיינים של פלט הלקוח.