المساعدة
تسجيل الدخول

محرر أكواد الإيصالات المطبوعة لـ 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 الخاصة بك لا تستخدم POS Pro أو موجودة في إيطاليا أو فرنسا.

الخطوات:

جميع مواقع POS Pro

  1. من مسؤول Shopify، انتقل إلى قنوات المبيعات > نقطة البيع (Point of Sale).

  2. في قسم تخصيص التجربة داخل المتجر، انقر على تعديل لـ الإيصالات.

  3. انقر على أيقونة الأقسام في الشريط الجانبي الأيسر.

  4. انقر على تعديل التعليمات البرمجية.

  5. في مربع حوار تعديل التعليمات البرمجية للإيصالات المطبوعة، قم بتعديل التعليمات البرمجية التي تريد تغييرها.

  6. انقر على حفظ.

  7. اختياري: لمواصلة تعديل المزيد من صفحات Shopify POS باستخدام محرر POS، ارجع للخلف في نافذة متصفحك.

مع مواقع Lite/إيطاليا/فرنسا

  1. من مسؤول Shopify، انتقل إلى قنوات المبيعات > نقطة البيع (Point of Sale).

  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 وصفحة حالة الطلب. على سبيل المثال، "#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
 قيمة منطقية تشير إلى ما إذا كانت عملية الإرجاع قد أُنشئت كـ إرجاع غير مؤكّد (Unverified Return). 
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.

ارجع إلى قسم عوامل التصفية من مرجع Liquid لقوالب Shopify للحصول على تفاصيل حول كيفية استخدام عوامل تصفية Liquid.

تتوفّر عوامل التصفية التالية في محرر تعليمات الإيصال البرمجية:

وصف عوامل تصفية الإيصال
الخاصيةالوصف
t
 يترجم التسميات المُعرَّفة مسبقًا إلى اللغة المُعيَّنة لموقعك. 
money
 ينسّق السعر بـ عملة موقعك. 
escape
 يتجاوز الأحرف الخاصة في HTML، مثل <> و' و&، ويحوّل الأحرف إلى تسلسلات تجاوز. 
barcode
 ينشئ ملف SVG لباركود أحادي الأبعاد. 
qrcode
 ينشئ ملف SVG لباركود ثنائي الأبعاد.

مثال على تخصيص التعليمات البرمجية لقالب الإيصال المطبوع

يمكنك استخدام 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، انتقل إلى قنوات المبيعات > نقطة البيع (Point of Sale).

  2. في قسم تخصيص التجربة داخل المتجر، انقر على تعديل لـ الإيصالات.

  3. انقر على تخصيص إيصالاتك.

  4. انقر على تعديل التعليمات البرمجية.

  5. انقر على ملف التعليمات البرمجية الذي تريد معاينته. يُعرض إيصالك في نافذة المحرر الموجودة في أقصى اليمين.

  6. اختياري: لتحديد طلب معين لاستخدامه كمحتوى إيصالك في نافذة المعاينة، نفّذ الإجراءات التالية:

    1. انقر على أيقونة View.
    2. تُعرض عمليات البيع التي تتم من قناة Point of Sale من جميع المواقع في مربع الحوار اختيار طلب لمعاينته. حدّد طلبًا من القائمة، أو ابحث عن طلبات ومواقع معينة باستخدام شريط البحث.
    3. انقر على تأكيد.

  7. اختياري: إذا كنت تعاين ملف gift-card.liquid، فانقر على أيقونة View وحدّد الموقع الذي تريد معاينة القالب له.

مع مواقع Lite/إيطاليا/فرنسا

  1. من مسؤول Shopify، انتقل إلى قنوات المبيعات > نقطة البيع (Point of Sale).

  2. في قسم تخصيص التجربة داخل المتجر، انقر على تعديل لـ الإيصالات.

  3. في صفحة تخصيص الإيصال، انقر على محرر التعليمات البرمجية.

  4. انقر على ملف التعليمات البرمجية الذي تريد معاينته. يُعرض إيصالك في نافذة المحرر الموجودة في أقصى اليمين.

  5. اختياري: لتحديد طلب معين لاستخدامه كمحتوى إيصالك في نافذة المعاينة، نفّذ الإجراءات التالية:

    1. انقر على أيقونة View.
    2. تُعرض عمليات البيع التي تتم من قناة Point of Sale من جميع المواقع في مربع الحوار اختيار طلب لمعاينته. حدّد طلبًا من القائمة، أو ابحث عن طلبات ومواقع معينة باستخدام شريط البحث.
    3. انقر على تأكيد.

  6. اختياري: إذا كنت تعاين ملف gift-card.liquid، فانقر على أيقونة View وحدّد الموقع الذي تريد معاينة القالب له.