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

الخطوات:

جميع مواقع POS Pro

من واجهة مسؤول Shopify، انتقل إلى نقطة البيع > الإعدادات.
في قسم التخصيص، انقر على الإيصالات المطبوعة لفتح محرّر POS.
انقر على أيقونة في الشريط الجانبي الأيسر.
انقر على تعديل التعليمات البرمجية.
في مربع حوار تعديل التعليمات البرمجية للإيصالات المطبوعة، عدّل التعليمات البرمجية التي تريد تغييرها.
انقر على حفظ.
اختياري: لمواصلة تعديل المزيد من صفحات Shopify POS باستخدام محرر POS، ارجع في نافذة متصفحك.

مع مواقع Lite أو إيطاليا

من واجهة مسؤول Shopify، انتقل إلى نقطة البيع > الإعدادات.
في قسم التخصيص، انقر على الإيصالات المطبوعة لفتح محرّر POS.
في صفحة تخصيص الإيصال، انقر على محرر التعليمات البرمجية.

استخدام ملفات مخصصة في قالب إيصالك

يمكنك استخدام ملفات، مثل أصول الصور، التي ترفعها إلى واجهة مسؤول Shopify لتخصيص إيصالاتك المطبوعة.

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

الخطوات:

من واجهة مسؤول Shopify، انتقل إلى المحتوى > الملفات.
بجانب الملف الذي تريد تضمينه في التعليمات البرمجية للإيصال المطبوع، انقر على لنسخ الرابط.
انتقل إلى محرر التعليمات البرمجية.
قم بتضمين رابط الأصل في قالبك.

إعادة ضبط قالب الإيصال على الإعداد الافتراضي

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

الخطوات:

جميع مواقع POS Pro

من واجهة مسؤول Shopify، انتقل إلى نقطة البيع > الإعدادات.
في قسم التخصيص، انقر على الإيصالات المطبوعة لفتح محرّر POS.
انقر على تخصيص إيصالاتك.
انقر على تعديل التعليمات البرمجية.
انقر على ملف التعليمات البرمجية الذي تريد إعادة ضبطه.
انقر على أيقونة .
في مربع حوار إعادة ضبط الملف على الإعداد الافتراضي، انقر على إعادة ضبط.

مع مواقع Lite أو إيطاليا

من واجهة مسؤول Shopify، انتقل إلى نقطة البيع > الإعدادات.
في قسم التخصيص، انقر على الإيصالات المطبوعة لفتح محرّر POS.
في صفحة تخصيص الإيصال، انقر على محرر التعليمات البرمجية.
انقر على ملف التعليمات البرمجية الذي تريد إعادة ضبطه.
انقر على أيقونة .
في مربع حوار إعادة ضبط الملف على الإعداد الافتراضي، انقر على إعادة ضبط.

متغيرات 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.
{% end %}

معاينة تغييرات التعليمات البرمجية في محرر التعليمات البرمجية

يمكنك معاينة التغييرات على إيصالاتك المطبوعة في محرر التعليمات البرمجية لـ POS في مسؤول Shopify.

بناءً على ملف Liquid المُحدَّد، تُبرز نافذة المعاينة تصميم الإيصال أو قسم الإيصال الذي يتأثر بالملف. حسب الإعداد الافتراضي، تعرض نافذة المعاينة محتوى أحدث طلب POS لديك. يمكنك تحديد طلب معين لاستخدامه كمحتوى إيصالك في نافذة المعاينة لجميع ملفات Liquid باستثناء ملف gift-card.liquid، الذي يعرض المواقع المختلفة فقط كخيارات معاينة قابلة للتحديد.

الخطوات:

جميع مواقع POS Pro

من واجهة مسؤول Shopify، انتقل إلى نقطة البيع > الإعدادات.
في قسم التخصيص، انقر على الإيصالات المطبوعة لفتح محرّر POS.
انقر على تخصيص إيصالاتك.
انقر على تعديل التعليمات البرمجية.
انقر على ملف التعليمات البرمجية الذي تريد معاينته. يُعرض إيصالك في نافذة المحرر الموجودة في أقصى اليمين.
اختياري: لتحديد طلب معين لاستخدامه كمحتوى إيصالك في نافذة المعاينة، نفّذ الإجراءات التالية:
1. انقر على أيقونة .
2. تُعرض عمليات البيع التي تتم من قناة Point of Sale من جميع المواقع في مربع الحوار اختيار طلب لمعاينته. حدّد طلبًا من القائمة، أو ابحث عن طلبات ومواقع معينة باستخدام شريط البحث.
3. انقر على تأكيد.
اختياري: إذا كنت تعاين ملف gift-card.liquid، فانقر على أيقونة وحدّد الموقع الذي تريد معاينة القالب له.

مع مواقع Lite أو إيطاليا

من واجهة مسؤول Shopify، انتقل إلى نقطة البيع > الإعدادات.
في قسم التخصيص، انقر على الإيصالات المطبوعة لفتح محرّر POS.
في صفحة تخصيص الإيصال، انقر على محرر التعليمات البرمجية.
انقر على ملف التعليمات البرمجية الذي تريد معاينته. يُعرض إيصالك في نافذة المحرر الموجودة في أقصى اليمين.
اختياري: لتحديد طلب معين لاستخدامه كمحتوى إيصالك في نافذة المعاينة، نفّذ الإجراءات التالية:
1. انقر على أيقونة .
2. تُعرض عمليات البيع التي تتم من قناة Point of Sale من جميع المواقع في مربع الحوار اختيار طلب لمعاينته. حدّد طلبًا من القائمة، أو ابحث عن طلبات ومواقع معينة باستخدام شريط البحث.
3. انقر على تأكيد.
اختياري: إذا كنت تعاين ملف gift-card.liquid، فانقر على أيقونة وحدّد الموقع الذي تريد معاينة القالب له.