مرجع متغيرات قسيمة التعبئة

يتم عرض قسائم التعبئة الخاصة بك باستخدام Liquid، وهي لغة قوالب تم إنشاؤها بواسطة Shopify.

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

في هذه الصفحة

متغيرات المتجر

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

وصف لمتغيرات متجر Liquid التي يمكنك استخدامها في قوالب قسائم التعبئة
المتغير	الوصف
shop.name	اسم متجرك.
shop.email	عنوان البريد الإلكتروني لمتجرك.
shop.domain	نطاق متجرك.

متغيرات عنوان المتجر

استخدم المتغيرات الموجودة في هذا الجدول لإضافة عنوان متجرك إلى قسيمة التعبئة. يمكنك العثور على تفاصيل عنوانك وتعديلها في قسم موقع الشحن في صفحة الشحن والتوصيل بمسؤول Shopify.

وصف لمتغيرات عنوان متجر Liquid التي يمكنك استخدامها في قوالب قسائم التعبئة
المتغير	الوصف
shop_address.address1	عنوان متجرك.
shop_address.address2	رقم الشقة أو الجناح لمتجرك.
shop_address.company	اسم شركتك.
shop_address.city	المدينة التي يقع بها متجرك
shop_address.province_code	كود الولاية أو المقاطعة لمتجرك. على سبيل المثال، كود المقاطعة لأونتاريو هو ON.
shop_address.province	ولاية أو مقاطعة متجرك
shop_address.zip	الرمز البريدي لمتجرك.
shop_address.country_code	كود البلد لمتجرك. على سبيل المثال، كود البلد لكندا هو CA.
shop_address.country	بلد متجرك.
shop_address.summary	عنوان متجرك بالكامل.

متغيرات الطلب

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

وصف لمتغيرات طلب Liquid التي يمكنك استخدامها في قوالب قسائم التعبئة
المتغير	الوصف
order.order_number	رقم الطلب بدون أي بادئات أو لواحق. على سبيل المثال، `1004`.
order.name	رقم الطلب بما في ذلك أي بادئات أو لواحق محددة في صفحة إعدادات عام بمسؤول Shopify. على سبيل المثال، `#1004`.
order.note	الملاحظة المرتبطة بالطلب، إن وجدت.
order.created_at	التاريخ والوقت الذي تم فيه إنشاء الطلب. على سبيل المثال، `2009-05-30T17:43:51+02:00`. استخدم عامل تصفية التاريخ لتغيير التنسيق.

متغيرات العميل

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

وصف لمتغيرات عميل Liquid التي يمكنك استخدامها في قوالب قسائم التعبئة
المتغير	الوصف
customer.first_name	الاسم الأول للعميل.
customer.last_name	اسم العائلة للعميل.
customer.name	الاسم الكامل للعميل.
customer.email	البريد الإلكتروني للعميل.

متغيرات عنوان الشحن وعنوان إرسال الفواتير للعميل

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

وصف لمتغيرات عنوان عميل Liquid التي يمكنك استخدامها في قوالب قسائم التعبئة
المتغير	الوصف
shipping_address.address1 billing_address.address1	عنوان العميل.
shipping_address.address2 billing_address.address2	رقم الشقة أو الجناح للعميل.
shipping_address.first_name billing_address.first_name	الاسم الأول للعميل.
shipping_address.last_name billing_address.last_name	اسم العائلة للعميل.
shipping_address.name billing_address.name	الاسم الكامل للعميل.
shipping_address.phone billing_address.phone	رقم هاتف العميل.
shipping_address.company billing_address.company	اسم شركة العميل لعنوان الشحن.
shipping_address.city billing_address.city	مدينة العميل.
shipping_address.province_code billing_address.province_code	رمز ولاية أو مقاطعة العميل. على سبيل المثال، رمز المقاطعة لأونتاريو هو ON.
shipping_address.province billing_address.province	ولاية أو مقاطعة العميل.
shipping_address.zip billing_address.zip	الرمز البريدي للعميل.
shipping_address.country_code billing_address.country_code	رمز بلد عميلك. على سبيل المثال، رمز البلد لكندا هو CA.
shipping_address.country billing_address.country	بلد العميل.
shipping_address.summary billing_address.summary	عنوان عميلك الكامل.

متغيرات البنود في الشحنة

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

وصف لمتغيرات بنود Liquid في الشحنة التي يمكنك استخدامها في قوالب قسائم التعبئة
المتغير	الوصف
line_items_in_shipment	قائمة بالبنود التي تنتمي معًا في شحنة واحدة. يمكن أن تكون البنود الفردية داخل حلقة برمجية (loop) باسم line_item: `{% for line_item in line_items_in_shipment %} {{ line_item.image }} {{ line_item.title }} ... {% endfor %}` جميع السمات المتاحة لـ line_item مدرجة أدناه: `line_item.image` - صورة المنتج، إن وُجدت. `line_item.title` - اسم المنتج. إذا كان المنتج يحتوي على عدة متغيرات، فسيتم تضمين اسم المتغير أيضًا. `line_item.variant_title` - اسم متغير المنتج. `line_item.vendor` - مورّد المنتج. `line_item.sku` - وحدة حفظ المخزون (SKU) للمنتج. `line_item.quantity` - الكمية الإجمالية لذلك المنتج. `line_item.shipping_quantity` - كمية ذلك المنتج التي يتم تنفيذها في الشحنة. `line_item.properties` - خصائص المنتج. `line_item.groups` - قائمة بمجموعات البنود التي ينتمي إليها المنتج، مثل الحزم أو الإضافات. تحتوي كل مجموعة على السمات التالية: `group.title` - عنوان العرض للمجموعة. `group.deliverable?` - تُرجع `true` إذا كان البند يمثل إضافة إلى منتج أصلي، أو `false` إذا كان البند جزءًا من حزمة.
includes_all_line_items_in_order	قيمة منطقية إذا كانت `true`، فسيتم تضمين جميع العناصر في الطلب ضمن الشحنة. إذا كانت `false`، فلن يتم تضمين جميع عناصر الطلب ضمن الشحنة.

الصور

يُسمح بالصور من النطاق https://cdn.myshopify.com/ فقط. تتم تصفية جميع الصور الأخرى. يمكنك تضمين أي صورة قمت برفعها إلى صفحة الملفات في مسؤول Shopify.

لإضافة صور المنتج أو الصور المصغرة إلى قسيمة التعبئة، استخدم المتغير line_item.image.

أمثلة على متغيرات قسيمة التعبئة

توضح الأمثلة التالية كيفية استخدام بعض متغيرات قسيمة التعبئة.

now

يمكنك استخدام التنسيق التالي لعرض الوقت والتاريخ الحاليين:

{{ "now" | date: "%Y-%m-%d %H:%M" }}

المُخرجات هي:

2018-09-10 14:23

line_items_in_shipment

يعرض المتغير line_items_in_shipment مصفوفة من البنود المضمّنة في الشحنة.

على سبيل المثال:

{% for line_item in line_items_in_shipment %}
  {{ line_item.title }}
  {{ line_item.variant_title }}
  ...
{% endfor %}

الحقول التي يتم إرجاعها في كل إدخال line_item هي كما يلي:

line_item.image
line_item.title
line_item.variant_title
line_item.sku
line_item.vendor
line_item.quantity
line_item.shipping_quantity
line_item.properties
line_item.groups

line_item.groups

إذا كان متجرك يستخدم حزمًا أو إضافات، فيمكنك عرض معلومات المجموعة لكل بند:

{% for group in line_item.groups %}
  {% if group.deliverable? %}
    Add-on for: {{ group.title }}
  {% else %}
    Part of: {{ group.title }}
  {% endif %}
{% endfor %}

line_item.image

يمكنك عرض صور للبنود باستخدام التنسيق التالي:

{% if line_item.image != blank %}
  {{ line_item.image | img_url: '58x58' | img_tag }}
{% endif %}

يمكنك عرض الكمية وكمية الشحن للبنود باستخدام التنسيق التالي:

{{ line_item.shipping_quantity }} of {{ line_item.quantity }}

على سبيل المثال، قد يعرض هذا:

2 of 5

includes_all_line_items_in_order

يمكنك استخدام هذا المتغير لعرض رسالة إذا كنت تشحن بعض العناصر في طلب. على سبيل المثال:

{% unless includes_all_line_items_in_order %}
  There are other items from your order not included in this shipment.
{% endunless %}