עזרה
התחברות

עורך הקוד של הקבלות המודפסות עבור ה-Shopify POS שלך

ניתן להתאים אישית את הקבלות המודפסות שלך באמצעות עורך הקוד במנהל Shopify שלך. הקבצים המרכיבים את הקבלות מכילים את Liquid, שפת התבניות של Shopify. בעזרת עורך הקוד, תוכל ליצור התאמות אישיות מתקדמות יותר באמצעות HTML, CSS ו-Liquid בהשוואה לעורך החזותי.

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

בדף זה

שיקולים לשימוש בעורך הקוד של הקבלות

לפני שתשתמש בעורך הקוד של הקבלות, עיין בשיקולים הבאים:

הגבלות גישה

  • ניתן להשתמש בעורך הקוד רק ממנהל Shopify במחשב שולחני.
  • עורך הקוד אינו זמין עבור מיקומי POS באיטליה או בצרפת.

היכן חלים השינויים

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

שפות קוד

  • הקבצים שמרכיבים את הקבלות שלך מכילים קוד Liquid, שפת התבניות של Shopify. למידע נוסף על השימוש ב-Liquid.
  • כדי לערוך את התבניות בעורך הקוד של הקבלות, נדרשת היכרות עם HTML, CSS ו-Liquid. התמיכה של Shopify בערכות נושא אינה יכולה לערוך עבורך תבניות קבלה באופן מקיף, אך ייתכן שתוכל לעזור בהתאמות קלות לערכות נושא חינמיות של Shopify במסגרת ההיקף של מדיניות העיצוב של Shopify. במקרה של שינויים מורכבים יותר, כדאי לשקול לשכור שותף Shopify.

מגבלות התאמה אישית

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

תחזוקת תבניות

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

גישה לעורך הקוד

באפשרותך לערוך את התבניות שלך באמצעות עורך הקוד. תחילה עליך לעבור לשימוש בעורך הקוד מתוך העורך החזותי המוגדר כברירת מחדל, ותוכל לחזור לעורך החזותי בכל שלב.

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

שלבים:

כל מיקומי POS Pro

  1. ממנהל Shopify, עבור אל Point of Sale > הגדרות.

  2. במקטע התאמה אישית, לחץ על קבלות מודפסות כדי לפתוח את עורך ה-POS.

  3. לחץ על הסמל מקטעים בסרגל הצדדי השמאלי.

  4. לחץ על ערוך קוד.

  5. בתיבת הדו-שיח עריכת קוד לקבלות מודפסות, ערוך את הקוד שברצונך לשנות.

  6. לחץ על שמירה.

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

כשיש מיקומים בתוכנית Lite או באיטליה

  1. ממנהל Shopify, עבור אל Point of Sale > הגדרות.

  2. במקטע התאמה אישית, לחץ על קבלות מודפסות כדי לפתוח את עורך ה-POS.

  3. בדף התאמה אישית של קבלה, לחץ על עורך קוד.

שימוש בקבצים מותאמים אישית בתבנית הקבלה שלך

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

חובה להעלות את הקובץ למנהל Shopify לפני שתוכל להשתמש בו בקבלה מודפסת. למידע נוסף על העלאות קבצים.

שלבים:

  1. ממנהל Shopify, עבור אל תוכן > קבצים.

  2. לצד הקובץ שברצונך לכלול בקוד של הקבלה המודפסת, לחץ על העתק קישור כדי להעתיק את הקישור.

  3. נווט אל עורך הקוד.

  4. כלול את הקישור לנכס בתבנית שלך.

איפוס תבנית הקבלה לברירת מחדל

ניתן לאפס תבנית קבלה לגרסת ברירת המחדל באמצעות עורך הקוד.

שלבים:

כל מיקומי POS Pro

  1. ממנהל Shopify, עבור אל Point of Sale > הגדרות.

  2. במקטע התאמה אישית, לחץ על קבלות מודפסות כדי לפתוח את עורך ה-POS.

  3. לחץ על התאם אישית את הקבלות שלך.

  4. לחץ על ערוך קוד.

  5. לחץ על קובץ הקוד שברצונך לאפס.

  6. לחץ על הסמל איפוס לברירת מחדל.

  7. בתיבת הדו-שיח אפס את הקובץ לברירת מחדל, לחץ על איפוס.

כשיש מיקומים בתוכנית Lite או באיטליה

  1. ממנהל Shopify, עבור אל Point of Sale > הגדרות.

  2. במקטע התאמה אישית, לחץ על קבלות מודפסות כדי לפתוח את עורך ה-POS.

  3. בדף התאמה אישית של קבלה, לחץ על עורך קוד.

  4. לחץ על קובץ הקוד שברצונך לאפס.

  5. לחץ על הסמל איפוס לברירת מחדל.

  6. בתיבת הדו-שיח אפס את הקובץ לברירת מחדל, לחץ על איפוס.

משתני Liquid הזמינים בעורך הקוד של הקבלות

באפשרותך להשתמש בקוד Liquid כדי להתאים אישית את תבנית הקבלה המודפסת ואת סוגי הקבלות.

אובייקטי הנתונים הבאים זמינים עבור עורך הקוד של הקבלות:

אובייקטים של קבלות

תיאור אובייקטי נתונים של קבלות
אובייקטתיאור
shop
 מכיל את פרטי החנות, כגון שם החנות. 
location
 מכיל את פרטי המיקום הקמעונאי, כגון כתובת ומספר טלפון. 
order
 מכיל את נתוני ההזמנה, כולל פריטי השורה, ההנחות, המיסים ופרטי העסקה. 
return
 זמין רק בתוך התבנית return-and-exchange-receipt.liquid ובתבניות החלקיות המשויכות אליה. מכיל נתוני החזרה והחלפה, כולל פריטי השורה שהוחזרו, פריטי השורה החדשים, הסכום הכולל נטו ופרטי העסקה. 
gift_card
 זמין רק בתוך התבנית gift-card.liquid. מכיל את נתוני כרטיס המתנה, כולל היתרה, הקוד האלפאנומרי והתוכן של קוד QR שניתן לסריקה באמצעות יישום POS.

אובייקט הזמנה

תיאור אובייקט ההזמנה
מאפייןתיאור
id
 מזהה של ההזמנה. 
created_at
 התאריך והשעה שבהם ההזמנה נוצרה, בפורמט ISO 8601. 
source_identifier
 מזהה הזמנה ייחודי של POS או של צד שלישי. 
change_due
 עודף שמגיע על ההזמנה. 
balance_due
 הסכום לתשלום עבור הזמנה זו. 
name
 המזהה הייחודי של ההזמנה, שמופיע בדף ההזמנה במנהל Shopify ובדף סטטוס ההזמנה. לדוגמה, "#1001", "EN1001" או "1001-A". ערך זה אינו ייחודי על פני מספר חנויות. 
note
 תוכן ההערה המשויכת להזמנה. 
line_items
 רשימה של פריטי השורה של ההזמנה. 
subtotal_price
 סכום המחירים של כל פריטי השורה לאחר הנחות ולפני החזרות. אם taxesIncluded הוא true, אז סכום הביניים כולל גם מס. 
total_price
 המחיר הכולל של ההזמנה, לפני החזרות. הוא כולל מיסים והנחות. 
total_tip_received
 סכום כל הטיפים עבור ההזמנה. 
discounts
 הסכום הכולל של ההנחות. 
transactions
 רשימה של עסקאות המשויכות להזמנה. 
taxes_included
 האם מיסים כלולים במחיר סכום הביניים של ההזמנה. 
tax_lines
 רשימה של כל שורות המס שהוחלו על פריטי שורה בהזמנה, לפני החזרות. מחירי שורת מס מייצגים את המחיר הכולל לכל שורות המס בעלות אותו שיעור ואותה כותרת. 
customer
 הלקוח שביצע את ההזמנה. 
shipping_address
 הכתובת לשילוח של ההזמנה. 
shipping_groups
 רשימה של קבוצות השילוח של ההזמנה. כל קבוצה מכילה פריטי שורה שממולאים יחד.

אובייקט החזרה

תיאור של אובייקט החזרה
מאפייןתיאור
name
 המזהה הייחודי של ההחזרה, שמופיע בדף ההזמנה במנהל Shopify ובדף סטטוס ההזמנה. לדוגמה, "#1000-R1". ערך זה אינו ייחודי על פני מספר חנויות. 
created_at
 התאריך והשעה בפורמט ISO 8601 שבהם נוצרה ההחזרה. 
is_unverified
 ערך בוליאני המציין אם ההחזרה נוצרה בתור החזרה לא מאומתת. 
is_exchange
 ערך בוליאני המציין אם ההחזרה כוללת החלפה. זה כולל החזרים כספיים לכרטיס מתנה. 
exchange_type
 סוג ההחלפה, אם ההחזרה כוללת החלפה. הערכים האפשריים הם LIKE_FOR_LIKE,‏ NET_REFUNDABLE ו-NET_PAYABLE. 
return_discount
 הסכום הכולל של הנחות בהזמנה שעבורן ניתן החזר כספי. 
return_subtotal
 סכום המחירים של כל פריטי השורה של ההחזרה לפני הנחות. אם taxesIncluded הוא true, אז סכום הביניים כולל גם מס. 
return_total
 סכום ההחזר הכספי האפשרי הכולל. הוא כולל מיסים, הנחות, שילוח וטיפים. ייתכן שזה אינו סכום ההחזר הכספי בפועל. 
exchange_subtotal
 סכום המחירים של כל פריטי השורה החדשים בהחלפה לפני הנחות. אם taxesIncluded הוא true, אז סכום הביניים כולל גם מס. 
exchange_total
 הסכום הכולל עבור כל פריטי השורה החדשים בהחלפה. הוא כולל מיסים והנחות. 
total_cash_rounding_adjustment
 התאמת העיגול שהוחלה על ההחזרה או ההחלפה. 
total_adjusted_amount
 הסכום הכולל עבור ההחזרה או ההחלפה שעבר התאמה של העיגול. 
net_total
 הסכום הכולל בפועל ששולם או שהתקבל עבורו החזר כספי בגין ההחזרה או ההחלפה, ולפני העיגול. 
return_line_items
 פריטי השורה שהוחזרו. 
exchange_line_items
 פריטי השורה החדשים בהחלפה. 
return_tax_lines
 שורות המס עבור פריטי השורה שהוחזרו. 
exchange_tax_lines
 שורות המס עבור פריטי השורה החדשים בהחלפה. 
shipping_refund_amount
 סכום השילוח שניתן עליו החזר כספי. 
tip_refund_amount
 סכום הטיפ שניתן עליו החזר כספי. 
transactions
 העסקאות המשויכות להחזרה או להחלפה.

אובייקט קבוצת שילוח

תיאור של אובייקט קבוצת השילוח
מאפייןתיאור
destination
 היעד של המוצרים הנשלחים. 
products
 רשימה של מוצרים נשלחים.

אובייקט פריט שורה

תיאור של אובייקט פריט השורה
מאפייןתיאור
id
 המזהה של פריט השורה. 
name
 הכותרת של המוצר, בתוספת אופציונלית של כותרת הגרסה (אם רלוונטי). 
variant_title
 כותרת הגרסה בעת יצירת ההזמנה. 
price
 המחיר ליחידה של פריט השורה כאשר נוצרה ההזמנה. ערך זה אינו כולל הנחות. 
is_gift_card
 האם פריט השורה מייצג רכישה של כרטיס מתנה. 
discount
 ההנחה הכוללת שהוקצתה לפריט השורה על ידי החלות הנחה, כולל הנחות שהוקצו לכמויות שהוסרו וכמויות שעבורן ניתן החזר כספי. 
total_price
 הסכום הכולל עבור פריט שורה זה. 
selling_plan_name
 השם של מסלול המנוי שהוקצה לפריט השורה. 
tax_rates
 שורות המס עבור פריט שורה זה. 
custom_attributes
 רשימה של מאפיינים המייצגים תכונות מותאמות אישית או בקשות מיוחדות. 
variant_title
 כותרת הגרסה. 
variant_id
 המזהה של הגרסה. 
variant_metafields
 רשימה של שדות מותאמים אישית שסוחר שייך לגרסה. 
staff_member_description
 איש הצוות המשויך לפריט השורה. 
product_metafields
 רשימה של שדות מותאמים אישית שסוחר שייך למוצר.

אובייקט פריט שורה של החזרה

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

תיאור של אובייקט פריט השורה
מאפייןתיאור
return_reason
 סיבת ההחזרה עבור פריט השורה. 
return_reason_note
 הערה אופציונלית שתצורף לסיבת ההחזרה.

מסנני Liquid הזמינים בעורך הקוד של הקבלה

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

כדי להחיל מסנן, יש להוסיף תו קו אנכי | ולאחריו את המסנן בתוך בלוק קוד ה-Liquid, בין סוגריים מסולסלים כפולים {{ }}. ניתן להחיל מסננים רק על בלוקים של קוד Liquid.

בדוגמה הבאה, המסנן משנה את קוד המס מאותיות קטנות לאותיות גדולות (רישיות).

{{ tax_line.title | upcase }}

בבלוק הקוד לדוגמה, product הוא האובייקט, title הוא המאפיין שלו, ו-upcase הוא המסנן שהוחל. המסנן upcase משנה את סוג האותיות של הערך tax_line.title לאותיות רישיות. לדוגמה, אם ל-tax_line.title יש ערך של Hst, המסנן upcase ישנה את הערך ל-HST.

עיין במקטע המסננים (Filters) מתוך התיעוד של Liquid עבור ערכות נושא ב-Shopify לפרטים על אופן השימוש במסנני Liquid.

המסננים הבאים זמינים בעורך קוד הקבלות:

תיאור מסנני קבלות
מאפייןתיאור
t
 מתרגם תוויות מוגדרות מראש לשפה המוקצית למיקום שלך. 
money
 מעצב את המחיר במטבע של המיקום שלך. 
escape
 ממיר תווים מיוחדים ב-HTML, כגון <>, ' ו-&, לרצפי מילוט (escape sequences). 
barcode
 מייצר קובץ SVG של ברקוד 1D. 
qrcode
 מייצר קובץ SVG של ברקוד 2D.

דוגמה להתאמה אישית של קוד תבנית לקבלה מודפסת

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

אפשר להוסיף הודעה מותאמת אישית לתבנית header.liquid בתיקייה מקטעים (Sections) שבעורך הקוד, ולהשתמש ב-Liquid כדי להציג את ההודעה רק עבור מיקום הדגל שלך.

הקוד הבא בודק את שם המיקום, במקרה זה המיקום המקורי שלך שנקרא "Home", ומציג את ההודעה "Welcome to our original store, opened in 1972." אם המיקום תואם לשם. קבלות המודפסות מהמיקומים האחרים שלך יציגו במקום זאת את ההודעה "Welcome to our store.".

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

תצוגה מקדימה של שינויי הקוד בעורך הקוד

אפשר להציג תצוגה מקדימה של השינויים בקבלות המודפסות בעורך הקוד של POS במנהל Shopify.

בהתאם לקובץ ה-Liquid שנבחר, חלון התצוגה המקדימה מדגיש את העיצוב או את המקטע של הקבלה שמושפע מהקובץ. כברירת מחדל, חלון התצוגה המקדימה מציג את התוכן עבור הזמנת ה-POS האחרונה שלך. אפשר לבחור הזמנה ספציפית לשימוש כתוכן הקבלה בחלון התצוגה המקדימה עבור כל קובצי ה-Liquid, למעט הקובץ gift-card.liquid, אשר מציג רק את המיקומים השונים כאפשרויות שניתן לבחור עבור התצוגה המקדימה.

שלבים:

כל מיקומי POS Pro

  1. ממנהל Shopify, עבור אל Point of Sale > הגדרות.

  2. במקטע התאמה אישית, לחץ על קבלות מודפסות כדי לפתוח את עורך ה-POS.

  3. לחץ על התאם אישית את הקבלות שלך.

  4. לחץ על ערוך קוד.

  5. יש ללחוץ על קובץ הקוד שברצונך להציג בתצוגה מקדימה. הקבלה שלך תופיע בחלון העורך הימני ביותר.

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

    1. יש ללחוץ על הסמל View.
    2. מכירות שבוצעו מערוץ Point of Sale מכל המיקומים יוצגו בתיבת הדו-שיח בחירת הזמנה לתצוגה מקדימה (Choose order to preview). יש לבחור הזמנה מהרשימה, או לחפש הזמנות ומיקומים ספציפיים באמצעות סרגל החיפוש.
    3. יש ללחוץ על אישור.

  7. אופציונלי: אם מתבצעת תצוגה מקדימה לקובץ gift-card.liquid, יש ללחוץ על הסמל View ולבחור את המיקום שעבורו תרצה להציג את התבנית בתצוגה מקדימה.

כשיש מיקומים בתוכנית Lite או באיטליה

  1. ממנהל Shopify, עבור אל Point of Sale > הגדרות.

  2. במקטע התאמה אישית, לחץ על קבלות מודפסות כדי לפתוח את עורך ה-POS.

  3. בדף התאמה אישית של קבלה, לחץ על עורך קוד.

  4. יש ללחוץ על קובץ הקוד שברצונך להציג בתצוגה מקדימה. הקבלה שלך תופיע בחלון העורך הימני ביותר.

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

    1. יש ללחוץ על הסמל View.
    2. מכירות שבוצעו מערוץ Point of Sale מכל המיקומים יוצגו בתיבת הדו-שיח בחירת הזמנה לתצוגה מקדימה (Choose order to preview). יש לבחור הזמנה מהרשימה, או לחפש הזמנות ומיקומים ספציפיים באמצעות סרגל החיפוש.
    3. יש ללחוץ על אישור.

  6. אופציונלי: אם מתבצעת תצוגה מקדימה לקובץ gift-card.liquid, יש ללחוץ על הסמל View ולבחור את המיקום שעבורו תרצה להציג את התבנית בתצוגה מקדימה.