עזרה
התחברות

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

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

בדף זה

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

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

הגבלות גישה

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

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

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

שפות קוד

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

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

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

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

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

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

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

שלבים:

כל מיקומי POS Pro

  1. מתוך ה-Shopify Admin שלך, עבור אל ערוצי מכירות > נקודת מכירה.

  2. במקטע התאמה אישית של החוויה בחנות, לחץ על עריכה עבור קבלות.

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

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

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

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

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

עם מיקומים ב-Lite/איטליה/צרפת

  1. מתוך ה-Shopify Admin שלך, עבור אל ערוצי מכירות > נקודת מכירה.

  2. במקטע התאמה אישית של החוויה בחנות, לחץ על עריכה עבור קבלות.

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

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

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

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

שלבים:

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

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

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

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

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

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

משתני 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 Admin ובדף סטטוס ההזמנה. לדוגמה, "#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 Admin ובדף סטטוס ההזמנה. לדוגמה, "#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.
{% endif %}

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

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

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

שלבים:

כל מיקומי POS Pro

  1. מתוך ה-Shopify Admin שלך, עבור אל ערוצי מכירות > נקודת מכירה.

  2. במקטע התאמה אישית של החוויה בחנות, לחץ על עריכה עבור קבלות.

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

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

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

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

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

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

עם מיקומים ב-Lite/איטליה/צרפת

  1. מתוך ה-Shopify Admin שלך, עבור אל ערוצי מכירות > נקודת מכירה.

  2. במקטע התאמה אישית של החוויה בחנות, לחץ על עריכה עבור קבלות.

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

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

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

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

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