مرجع بيانات الإيصال

تُعرَض قوالب HTML بلا منطق وقوالب XML الحرارية في WCPOS من حمولة بيانات الإيصال القياسية نفسها. استخدم مسارات Mustache النقطية مثل {{order.number}} و{{store.name}} و{{totals.total_display}}. تُعرَض المصفوفات باستخدام الأقسام:

{{#lines}}
  {{name}} x {{qty}} — {{line_total_display}}
{{/lines}}

يُنتَج العقد القياسي بواسطة منشئ بيانات الإيصال في WCPOS على الخادم ويُنسَخ بواسطة عارض الإيصالات في وضع عدم الاتصال داخل التطبيق. تُفتح الإيصالات فورًا من البيانات المحلية، ثم تُحدَّث باستجابة الخادم عند توفرها، لذا يجب أن تستخدم القوالب المخصّصة الحقول أدناه بدلًا من دوال طلبات PHP.

تضيف بيانات الإيصال v1.1 حقولًا مسجَّلة للسعر الاعتيادي وسعر البيع قبل القسيمة وقيمة التوفير لكل بند منتج. كما توفّر إجماليات توفير على مستوى الطلب، بما فيها قيمة إجمالي ما تم توفيره التي تجمع التوفير مقابل السعر الاعتيادي مع خصومات WooCommerce دون تغيير إجماليات الطلب أو التقارير.

الإيصال، مُخطَّطًا

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

COFFEE MONSTER

12 Roast Lane, Portland OR

VAT: US-998877

---

إيصال رقم 104213 يوليو 2026

أمين الصندوق: Adaالعميل: Nia

---

2 × Espresso Beans29.00

34.00 · توفير −5.00

1 × Ceramic Mug18.00

1 × Croissant5.75

---

المجموع الفرعي52.75

قسيمة SUMMER10−5.28

تغليف الهدايا2.50

الشحن10.00

الإجمالي59.97

إجمالي ما تم توفيره10.28

---

بطاقة59.97

---

شكرًا لشرائك!

ترويسة المتجر

store.name · store.address_lines · store.tax_ids · store.logo

الطلب والأشخاص

order.number · order.created · cashier.name · customer.name

بنود المنتجات

lines[] · line_savings · savings_in_discounts

كتلة الإجماليات

totals.* · discounts[] · fees[] · shipping[] · totals.total_saved

المدفوعات

payments[]

التذييل

store.personal_notes · store.policies_and_conditions · i18n.thank_you_purchase

وصفات شائعة

معظم تعديلات القوالب هي واحدة من هذه الثلاث. تعرض كل بطاقة النتيجة المطبوعة أولًا، ثم الترميز الدقيق — انسخه إلى أي قالب HTML بلا منطق أو قالب XML حراري. وتعرض البطاقة الثالثة طلبًا قديمًا سابقًا للإصدار 1.9 بدلًا من الطلب النموذجي أعلاه.

2 × Espresso Beans29.00

34.00 · توفير −5.00

شطب السعر الاعتيادي

{{#lines}}
{{#line_savings}}
  <s>{{line_regular_total_display}}</s>
  {{i18n.savings}}: -{{line_savings_display}}
{{/line_savings}}
{{/lines}}

يخفي حارس القسم كل شيء في الطلبات التي لا تحمل سجل أسعار مسجَّلًا.

الإجمالي59.97

إجمالي ما تم توفيره10.28

إضافة صف إجمالي ما تم توفيره

{{#totals.total_saved_complete}}
{{#totals.total_saved}}
  {{i18n.total_saved}}:
  {{totals.total_saved_display}}
{{/totals.total_saved}}
{{/totals.total_saved_complete}}

حارسان: يختفي الصف عندما يكون سجل الأسعار ناقصًا أو عندما لا يتحقق أي توفير.

1 × Espresso Beans14.50

17.00 خصم −2.50

إعادة طباعة طلب سابق للإصدار 1.9 بأمان

{{#lines}}
{{#line_savings}}
  {{^savings_in_discounts}}
    {{i18n.savings}}: -{{line_savings_display}}
  {{/savings_in_discounts}}
{{/line_savings}}
{{/lines}}

الطلبات القديمة تحمل التوفير داخل الخصم — وهذا يمنع طباعته مرتين.

قواعد العرض

حقول العملة

تُحفظ حقول المبالغ الرقمية كأرقام، ويضيف العارض حقول _display المتوافقة مع الإعدادات المحلية لمخرجات القالب:

الحقل الرقمي	حقل العرض
totals.total	totals.total_display
lines[].line_total	lines[].line_total_display
payments[].amount	payments[].amount_display
tax_summary[].tax_amount	tax_summary[].tax_amount_display

يُفضَّل استخدام حقول _display عند طباعة الإيصالات. تُستخدم الحقول الرقمية فقط للأقسام الشرطية أو المخرجات القابلة للقراءة آليًا.

الحقول المتوافقة مع عرض الضريبة

تتوفّر لعدة حقول صيغ شاملة وحصرية للضريبة بالإضافة إلى قيمة عرض مُيسَّرة. تتبع قيمة العرض المُيسَّرة إعداد عرض ضريبة السلة في المتجر.

الحقل المُيسَّر	الحقل الشامل للضريبة	الحقل الحصري للضريبة
lines[].regular_price	lines[].regular_price_incl	lines[].regular_price_excl
lines[].selling_price	lines[].selling_price_incl	lines[].selling_price_excl
lines[].unit_savings	lines[].unit_savings_incl	lines[].unit_savings_excl
lines[].line_regular_total	lines[].line_regular_total_incl	lines[].line_regular_total_excl
lines[].line_selling_total	lines[].line_selling_total_incl	lines[].line_selling_total_excl
lines[].line_savings	lines[].line_savings_incl	lines[].line_savings_excl
lines[].unit_price	lines[].unit_price_incl	lines[].unit_price_excl
lines[].unit_subtotal	lines[].unit_subtotal_incl	lines[].unit_subtotal_excl
lines[].line_subtotal	lines[].line_subtotal_incl	lines[].line_subtotal_excl
lines[].discounts	lines[].discounts_incl	lines[].discounts_excl
lines[].line_total	lines[].line_total_incl	lines[].line_total_excl
fees[].total	fees[].total_incl	fees[].total_excl
shipping[].total	shipping[].total_incl	shipping[].total_excl
discounts[].total	discounts[].total_incl	discounts[].total_excl
totals.subtotal	totals.subtotal_incl	totals.subtotal_excl
totals.discount_total	totals.discount_total_incl	totals.discount_total_excl
totals.sale_savings_total	totals.sale_savings_total_incl	totals.sale_savings_total_excl
totals.total_saved	totals.total_saved_incl	totals.total_saved_excl
totals.total	totals.total_incl	totals.total_excl

كائنات التاريخ

حقول التاريخ هي كائنات بعدة صيغ منسّقة مسبقًا. يتيح ذلك تجنّب تنسيق التاريخ داخل Mustache.

الحقل	الوصف
datetime، date، time	سلاسل التاريخ/الوقت الافتراضية
datetime_short، datetime_long، datetime_full	صيغ مُجمَّعة مراعية للإعدادات المحلية
date_short, date_long, date_full	تنسيقات التاريخ فقط حسب الإعدادات المحلية
date_ymd, date_dmy, date_mdy	تنسيقات التاريخ بترتيب ثابت
weekday_short, weekday_long	أسماء الأيام
day, month, month_short, month_long, year	أجزاء التاريخ الفردية

كائنات التاريخ المتاحة: order.created وorder.paid وorder.completed وorder.printed وrefunds[].date. يُحدَّث order.printed في وقت العرض، وهو مفيد لإعادة الطباعة.

الأقسام الرئيسية

القسم	النوع	الوصف
order	كائن	هوية الطلب وحالته وتواريخه وملاحظاته ومعلومات رابط الدفع
store	كائن	هوية المتجر وعنوانه وبيانات الاتصال والأرقام الضريبية والشعار وساعات العمل ونص التذييل
cashier	كائن	المستخدم الذي عالج الطلب
customer	كائن	الاسم المعروض للعميل والعناوين والأرقام الضريبية
lines	array	بنود المنتجات
fees	array	صفوف الرسوم
shipping	array	صفوف الشحن
discounts	array	صفوف القسائم/الخصومات
totals	object	إجماليات الطلب، وإجماليات الدفع، وملخص الاسترداد، وعدد العناصر
tax	object	علامات وضع عرض الضريبة لحراسة الأقسام
tax_summary	array	صفوف ملخص الضريبة حسب المعدل
has_tax_summary	boolean	حارس مختصر لـ tax_summary
payments	array	صفوف المدفوعات
refunds	array	سجلات الاسترداد المطبّقة على الطلب
fiscal	object	حقول اللقطة المالية التي تملؤها تكاملات الضرائب
presentation_hints	object	تلميحات التنسيق والعرض
i18n	object	تسميات مترجمة للقوالب المضمّنة والمخصّصة

كيف ترتبط الأسعار ببعضها

يحمل بند المنتج الواحد عدة أسعار، وتصبح التسميات مفهومة بمجرد رؤيتها على المبالغ نفسها. هذا هو بند الإسبريسو من الطلب النموذجي — منتج بسعر 17.00 دولارًا معروض بـ 14.50 دولارًا، مع قسيمة بنسبة 10% فوق ذلك:

Espresso Beans — وحدة واحدة (الطلب يحتوي على وحدتين)

13.05 مدفوعة

1.45

2.50

0السعر الاعتيادي 17.00

ما يدفعه العميلunit_price → 13.05 · line_total → 26.10

خصم القسيمة (SUMMER10)lines[].discounts → 2.90 on this line

التوفير مقابل السعر الاعتياديunit_savings → 2.50 · line_savings → 5.00

توفير العروض عبر الطلبtotals.sale_savings_total = 5.00

جميع خصومات القسائم عبر الطلبtotals.discount_total = 5.28

التوفير + الخصومات، بعد إزالة التداخل القديمtotals.total_saved = 10.28

توفير العروض وخصومات القسائم شيئان مختلفان: فتوفير العروض يقارن سعر البيع بالسعر الاعتيادي المسجَّل، بينما discounts هي حسابات القسائم الخاصة بـ WooCommerce. ولا تتضمّن إجماليات طلبات WooCommerce وتقاريرها سوى جزء القسائم — ولهذا يوجد total_saved بوصفه الرقم الوحيد الموجَّه للعميل الذي يجمع الاثنين.

مرجع الحقول

مرجع الحقول الكامل مجمّع حسب القسم أدناه. كل شيء مطوي افتراضيًا — وسّع المجموعة التي تحتاجها.

order — الهوية والحالة والتواريخ

order

الحقل	النوع	مثال / وصف
order.id	number	1234
order.number	string	رقم الطلب الظاهر للعميل، مثل "10045"
order.currency	string	رمز العملة وفق معيار ISO، مثل "USD"
order.customer_note	string	ملاحظة العميل/الطلب
order.wc_status	string	رمز حالة WooCommerce الأصلي، مثل "processing"
order.status_label	string	تسمية الحالة المترجمة، بما في ذلك الحالات المخصّصة
order.created_via	string	المصدر/القناة، مثل "woocommerce-pos"
order.needs_payment	boolean	ما إذا كان يجب عرض قسم الدفع
order.payment_url	string	رابط دفع الطلب عند توفّره
order.created	date object	تاريخ إنشاء الطلب
order.paid	date object	تاريخ الدفع، سلاسل نصية فارغة عند عدم الدفع
order.completed	date object	تاريخ الإكمال، سلاسل نصية فارغة عند عدم الإكمال
order.printed	date object	الطابع الزمني للطباعة/إعادة الطباعة عند العرض

store — الهوية والعنوان والاتصال وساعات العمل

store

الحقل	النوع	مثال / وصف
store.id	number	معرّف المتجر، أو المعرّف السابق للمتاجر المحذوفة
store.name	string	اسم المتجر المعروض
store.address.address_1	string	سطر العنوان 1
store.address.address_2	string	سطر الجناح/الوحدة
store.address.city	string	المدينة/المنطقة المحلية
store.address.state	string	الولاية/المنطقة
store.address.postcode	string	الرمز البريدي
store.address.country	string	رمز الدولة بتنسيق ISO
store.address_lines	array	أسطر العنوان المنسّقة مسبقًا؛ يُوصى باستخدامها في معظم القوالب
store.tax_ids	array	معرّفات الضريبة المنظّمة للنشاط التجاري؛ كرّر عبر هذه المصفوفة بدلًا من استخدام معرّف ضريبي واحد
store.phone	string	هاتف المتجر
store.email	string	البريد الإلكتروني للمتجر
store.logo	string/null	عنوان URL لشعار المتجر أو معرّف URI للبيانات
store.opening_hours	string/null	نص مختصر لساعات العمل
store.opening_hours_vertical	string/null	كتلة ساعات العمل متعددة الأسطر
store.opening_hours_inline	string/null	نص ساعات العمل مفصول بفواصل
store.opening_hours_notes	string/null	ملاحظات نصية حرة حول ساعات العمل
store.personal_notes	string/null	ملاحظة شخصية / تذييل الإيصال
store.policies_and_conditions	string/null	نص الاسترجاع أو الإرجاع أو الشروط
store.footer_imprint	string/null	البصمة القانونية في التذييل

كائنات المعرّف الضريبي

يحتوي store.tax_ids وcustomer.tax_ids على كائنات بالبنية نفسها:

الحقل	النوع	الوصف
type	string	معرّف مثل eu_vat أو de_steuernummer أو au_abn أو br_cpf أو us_ein أو other
value	string	قيمة المعرّف الضريبي المراد طباعتها
country	string/null	رمز الدولة وفق معيار ISO عند توفّره
label	string/null	تسمية العرض المحلية، تُحَلّ قبل العرض

مثال:

{{#store.tax_ids}}
  {{label}}: {{value}}
{{/store.tax_ids}}

cashier — المستخدم الذي عالج الطلب

cashier

الحقل	النوع	مثال / وصف
cashier.id	number	معرّف مستخدم WordPress، 0 عندما يكون غير معروف
cashier.name	string	الاسم المعروض للصراف

customer — الاسم والعناوين والأرقام الضريبية

customer

الحقل	النوع	مثال / وصف
customer.id	number/null	معرّف العميل، أو null للزوار
customer.name	string	الاسم المعروض للعميل، أو تسمية الزائر
customer.billing_address.*	object	حقول عنوان الفوترة في WooCommerce
customer.shipping_address.*	object	حقول عنوان الشحن في WooCommerce
customer.tax_ids	array	معرّفات الضريبة المنظّمة للعميل المأخوذة كلقطة من الطلب

تشمل مفاتيح العنوان الشائعة first_name وlast_name وcompany وaddress_1 وaddress_2 وcity وstate وpostcode وcountry وemail وphone.

lines — بنود المنتجات

lines

كرّر باستخدام {{#lines}}...{{/lines}}. القيم النموذجية هي بند الإسبريسو من الطلب النموذجي.

يأتي كل حقل مالي في صورة زوج: الرقم (استخدمه في حراس {{#…}} — إذ يخفي الصفر وnull القسم، ولا يملك الحقل ذو القيمة null توأمًا بامتداد _display أصلًا) وسلسلة _display الخاصة به (استخدمها للطباعة). أما الحقول الموسومة بـ incl/excl فتأتي أيضًا بصيغتَي _incl و_excl، ولكل منهما _display خاص بها.

keystring

مفتاح البند الثابت / معرّف عنصر الطلب.

key"412"

skustring

رمز SKU للمنتج.

sku"ESP-500"

namestring

اسم العرض للمنتج أو البند.

name"Espresso Beans"

qtynumber

الكمية المباعة.

qty2

qty_refundednumber

الكمية المستردة لهذا البند.

qty_refunded0

regular_pricenumbermoneynullableincl/excl

سعر الوحدة الاعتيادي المسجَّل. يكون null في الطلبات التي لا تحمل سجل أسعار من نقطة البيع — ضعه داخل قسم.

regular_price17

regular_price_display"$17.00"

selling_pricenumbermoneynullableincl/excl

سعر الوحدة المعروض قبل القسائم — وهو سعر نقطة البيع المسجَّل عند توفره، وإلا فيُشتق من المجموع الفرعي المخزَّن للبند.

selling_price14.5

selling_price_display"$14.50"

unit_savingsnumbermoneynullableincl/excl

الاعتيادي ناقص سعر البيع، مع تقييد الحد الأدنى بالصفر. والصفر قيمة خاطئة منطقيًا، لذا تخفي الصفوف المحروسة نفسها.

unit_savings2.5

unit_savings_display"$2.50"

line_regular_totalnumbermoneynullableincl/excl

السعر الاعتيادي المسجَّل مضروبًا في الكمية.

line_regular_total34

line_regular_total_display"$34.00"

line_selling_totalnumbermoneynullableincl/excl

سعر البيع قبل القسائم مضروبًا في الكمية.

line_selling_total29

line_selling_total_display"$29.00"

line_savingsnumbermoneynullableincl/excl

إجمالي التوفير من السعر الاعتيادي إلى سعر البيع لهذا البند.

line_savings5

line_savings_display"$5.00"

savings_in_discountsboolean

تكون صحيحة في الطلبات السابقة للإصدار 1.9.0 التي يوجد توفيرها بالفعل داخل discounts — وهي علامة منع الاحتساب المزدوج.

savings_in_discountsfalse

unit_subtotalnumbermoneyincl/excl

قيمة الوحدة قبل الخصم في WooCommerce. لا تستخدمها بوصفها السعر الاعتيادي.

unit_subtotal14.5

unit_subtotal_display"$14.50"

unit_pricenumbermoneyincl/excl

قيمة الوحدة النهائية بعد خصومات WooCommerce.

unit_price13.05

unit_price_display"$13.05"

line_subtotalnumbermoneyincl/excl

المجموع الفرعي للبند قبل الخصم في WooCommerce.

line_subtotal29

line_subtotal_display"$29.00"

discountsnumbermoneyincl/excl

خصم البند الأصلي في WooCommerce كقيمة موجبة — قسائم فقط في الطلبات الحالية.

discounts2.9

discounts_display"$2.90"

line_totalnumbermoneyincl/excl

إجمالي البند النهائي بعد القسائم — وهو ما يُطبع في عمود المبلغ.

line_total26.1

line_total_display"$26.10"

total_refundednumbermoney

إجمالي المبلغ المسترد لهذا البند كقيمة موجبة.

total_refunded0

total_refunded_display"$0.00"

taxesarray

صفوف الضريبة حسب المعدل لهذا البند.

—

metaarray

بيانات وصفية لعنصر الطلب كأزواج {key, value}.

—

attributesarray

سمات المنتج/المتغيّر كأزواج {key, value}.

—

عرض السعر الاعتيادي والتوفير

لتخطيط قائم على سعر الوحدة، اعرض السعر الاعتيادي المسجَّل وسعر البيع والتوفير هكذا:

{{#lines}}
  {{#unit_savings}}
    <span style="text-decoration: line-through;">{{regular_price_display}}</span>
    <span>{{selling_price_display}}</span>
    <span>{{i18n.savings}}: -{{unit_savings_display}}</span>
  {{/unit_savings}}
{{/lines}}

استخدم حقول إجمالي البند عندما تكون الكمية مهمة:

{{#lines}}
  {{#line_savings}}
    <span style="text-decoration: line-through;">{{line_regular_total_display}}</span>
    <span>{{i18n.savings}}: -{{line_savings_display}}</span>
  {{/line_savings}}
{{/lines}}

إن selling_price هو السعر قبل القسائم. استخدم unit_price أو line_total للمبلغ النهائي بعد خصومات WooCommerce.

إعادة طباعة طلبات أُنشئت قبل الإصدار 1.9.0

قد تتضمّن طلبات WCPOS الأقدم بالفعل التخفيض من السعر الاعتيادي إلى سعر البيع داخل discounts. فإذا كان قالبك المخصّص يطبع توفير البند وخصم البند معًا، فاستخدم savings_in_discounts لتجنّب عرض التخفيض نفسه مرتين:

{{#lines}}
  {{#line_savings}}
    <span style="text-decoration: line-through;">{{line_regular_total_display}}</span>
    {{^savings_in_discounts}}
      <span>{{i18n.savings}}: -{{line_savings_display}}</span>
    {{/savings_in_discounts}}
  {{/line_savings}}
  {{#discounts}}
    <span>{{i18n.discount}}: -{{discounts_display}}</span>
  {{/discounts}}
{{/lines}}

وإذا كان القالب لا يطبع صف discounts على مستوى البند، فاستمر في عرض line_savings حتى عندما تكون savings_in_discounts صحيحة. وتتعامل القوالب المضمّنة مع هذا التمييز تلقائيًا.

الرسوم والشحن

الرسوم والشحن

كرّر باستخدام {{#fees}}...{{/fees}} و{{#shipping}}...{{/shipping}}.

الحقل	النوع	الوصف
label	string	تسمية الرسوم أو اسم طريقة الشحن
method_id	string	معرّف طريقة الشحن (للشحن فقط)
total / _incl / _excl	number	الإجماليات المعروضة، والشاملة، والحصرية للضريبة
taxes	array	صفوف الضرائب حسب المعدل
meta	array	أزواج بيانات وصفية بصيغة {key, value}

الصيغ المنسّقة: total_display وtotal_incl_display وtotal_excl_display.

discounts — صفوف القسائم/الخصومات

discounts

كرّر باستخدام {{#discounts}}...{{/discounts}}.

الحقل	النوع	الوصف
label	string	وصف القسيمة أو الرمز كقيمة بديلة
code	string	رمز القسيمة
total / _incl / _excl	number	مبلغ الخصم كقيمة موجبة

الصيغ المنسّقة: total_display وtotal_incl_display وtotal_excl_display. أضف علامة السالب الخاصة بك في القالب إذا أردت عرض الخصومات كصفوف سالبة.

totals — إجماليات الطلب والدفع والاسترداد والعناصر

totals

القيم النموذجية مأخوذة من الطلب النموذجي، الذي تلقّى لاحقًا استردادًا جزئيًا بقيمة 7.25 دولارًا.

تتبع الحقول المالية التزاوج نفسه المتّبع في بنود المنتجات: رقم مجرّد للحراس وسلسلة _display للطباعة، مع صيغتَي _incl/_excl حيثما وُسمت بذلك.

subtotalnumbermoneyincl/excl

المجموع الفرعي للطلب قبل الخصومات.

subtotal52.75

subtotal_display"$52.75"

discount_totalnumbermoneyincl/excl

إجمالي خصم الطلب كقيمة موجبة — قسائم فقط في الطلبات الحالية.

discount_total5.28

discount_total_display"$5.28"

sale_savings_totalnumbermoneynullableincl/excl

إجمالي التوفير المسجَّل من السعر الاعتيادي إلى سعر البيع عبر بنود المنتجات، بما في ذلك عروض الكتالوج وتغييرات الأسعار عند نقطة البيع.

sale_savings_total5

sale_savings_total_display"$5.00"

total_savednumbermoneynullableincl/excl

خصومات WooCommerce والتوفير مقابل السعر الاعتيادي مجتمعَين، بعد إزالة التداخل القديم. وهو الرقم الوحيد الموجَّه للعميل لكل ما تم توفيره.

total_saved10.28

total_saved_display"$10.28"

total_saved_completeboolean

ما إذا كان لدى الإيصال بيانات أسعار مسجَّلة كافية لحساب إجماليات التوفير الكاملة.

total_saved_completetrue

tax_totalnumbermoney

إجمالي مبلغ الضريبة.

tax_total0

tax_total_display"$0.00"

totalnumbermoneyincl/excl

المجموع الإجمالي للطلب.

total59.97

total_display"$59.97"

paid_totalnumbermoney

المبلغ المدفوع/المُطبَّق.

paid_total59.97

paid_total_display"$59.97"

change_totalnumbermoney

الباقي المُعاد للعميل.

change_total0

change_total_display"$0.00"

refund_totalnumbermoney

إجمالي المبلغ المسترد كقيمة موجبة.

refund_total7.25

refund_total_display"$7.25"

net_totalnumbermoney

الإجمالي ناقص المبالغ المستردة، مع تقييد الحد الأدنى بالصفر.

net_total52.72

net_total_display"$52.72"

total_qtynumber

مجموع كميات بنود الطلب.

total_qty4

line_countnumber

عدد صفوف بنود المنتجات.

line_count3

استخدم total_saved عندما تريد رقمًا واحدًا موجَّهًا للعميل لكل ما تم توفيره. ولا تحسبه بجمع discount_total وsale_savings_total داخل القالب: فالطلبات التي أُنشئت قبل الإصدار 1.9.0 قد تتضمّن بالفعل توفير سعر نقطة البيع داخل إجمالي خصم WooCommerce. أما حقل total_saved القياسي فيكتشف ذلك التداخل ويزيله.

تكون إجماليات التوفير null وتكون total_saved_complete خاطئة عندما يفتقر أي بند منتج إلى بيانات أسعار مسجَّلة كافية لإجمالي موثوق. احرس الصف بـ total_saved_complete، ثم استخدم total_saved لإخفاء القيمة الصفرية:

{{#totals.total_saved_complete}}
  {{#totals.total_saved}}
    <span>{{i18n.total_saved}}: {{totals.total_saved_display}}</span>
  {{/totals.total_saved}}
{{/totals.total_saved_complete}}

تستخدم القوالب المضمّنة التي تعرض الأسعار بنية الحراسة نفسها مع الصيغ الشاملة للضريبة (total_saved_incl وtotal_saved_incl_display)، ولا تعرض إجمالي ما تم توفيره إلا عندما تكون القيمة الكاملة أكبر من الصفر.

tax and tax_summary — حراس العرض وصفوف كل معدل

tax and tax_summary

استخدم tax لحراس وضع العرض وtax_summary لصفوف معدلات الضريبة المفصّلة.

حقل الضريبة	النوع	الوصف
tax.display	string	incl أو excl
tax.display_incl	boolean	صحيح عندما تُعرض الأسعار شاملة الضريبة
tax.display_excl	boolean	صحيح عندما تُعرض الأسعار غير شاملة الضريبة
tax.breakdown	string	hidden أو single أو itemized
tax.breakdown_hidden	boolean	صحيح عندما يجب إخفاء صفوف الضريبة
tax.breakdown_single	boolean	صحيح عندما يُفضَّل عرض إجمالي ضريبة واحد
tax.breakdown_itemized	boolean	صحيح عندما تُفضَّل صفوف كل معدل
has_tax_summary	boolean	صحيح عندما يحتوي tax_summary على صفوف

كرّر tax_summary باستخدام {{#tax_summary}}...{{/tax_summary}}.

الحقل	النوع	الوصف
code	string	معرّف/رمز معدل الضريبة
rate	number/null	النسبة المئوية للمعدل عند تحديدها
label	string	تسمية معدل الضريبة
compound	boolean	ما إذا كان المعدل مركبًا
taxable_amount_excl	number/null	الوعاء الضريبي بدون الضريبة
tax_amount	number	الضريبة المحصّلة
taxable_amount_incl	number/null	الوعاء الضريبي شاملًا الضريبة

الصيغ المنسّقة: taxable_amount_excl_display وtax_amount_display وtaxable_amount_incl_display.

payments — صفوف المدفوعات

payments

كرّر باستخدام {{#payments}}...{{/payments}}.

الحقل	النوع	الوصف
method_id	string	معرّف طريقة الدفع
method_title	string	العنوان المعروض لطريقة الدفع
amount	number	المبلغ المطبّق على الطلب
transaction_id	string	معرّف معاملة البوابة
tendered	number	المبلغ النقدي المقدَّم عند توفّره
change	number	باقي المبلغ النقدي المُعاد عند توفّره

الصيغ المنسّقة: amount_display وtendered_display وchange_display.

refunds — سجلات الاسترداد

refunds

كرّر باستخدام {{#refunds}}...{{/refunds}}. مبالغ الاسترداد هي قيم مطلقة موجبة؛ تحدّد القوالب ما إذا كان يُضاف رمز سالب أو يُعرَض قسم منفصل للأصناف المُعادة.

الحقل	النوع	الوصف
id	number	معرّف سجلّ الاسترداد
date	date object	تاريخ إنشاء الاسترداد
amount	number	إجمالي الاسترداد
subtotal	number	المجموع الفرعي للبند المسترد
tax_total	number	الضريبة المستردة
shipping_total	number	مبلغ الشحن المسترد
shipping_tax	number	ضريبة الشحن المستردة
reason	string	سبب الاسترداد
refunded_by_id	number/null	معرّف المستخدم الذي أصدر الاسترداد
refunded_by_name	string	الاسم المعروض للمستخدم الذي أصدر الاسترداد
refunded_payment	boolean	ما إذا تم استرداد الدفعة عبر البوابة
destination	string	original_method أو cash أو manual
gateway_id	string	معرّف البوابة المستخدمة للاسترداد
gateway_title	string	العنوان المعروض للبوابة
processing_mode	string	وضع المعالجة عبر المزوّد/يدوي
lines	array	صفوف المنتجات المستردة
fees	array	صفوف الرسوم المستردة
shipping	array	صفوف الشحن المستردة

تتضمّن حقول بند الاسترداد name وsku وqty وtotal وtotal_incl وtotal_excl وline_total وunit_total وtaxes. تستخدم صفوف الرسوم والشحن المستردة label وtotal وtotal_incl وtotal_excl وtaxes. تُضاف صيغ عرض للإجماليات ومبالغ الضرائب.

fiscal — لقطة التكامل المالي

fiscal

تكون الحقول المالية فارغة افتراضيًا وتملؤها التكاملات المالية أو إثراء لقطات WCPOS Pro.

الحقل	النوع	الوصف
fiscal.immutable_id	string	المعرّف المالي الثابت
fiscal.receipt_number	string	رقم الإيصال المالي
fiscal.sequence	number/null	عدّاد التسلسل
fiscal.hash	string	قيمة التجزئة/التوقيع
fiscal.qr_payload	string	حمولة رمز QR للتحقق المالي
fiscal.tax_agency_code	string	رمز الجهة الضريبية
fiscal.signed_at	string	الطابع الزمني للتوقيع المالي
fiscal.signature_excerpt	string	مقتطف التوقيع المختصر للعرض
fiscal.document_label	string	تسمية المستند، مثل فاتورة ضريبية
fiscal.is_reprint	boolean	ما إذا كان هذا العرض إعادة طباعة
fiscal.reprint_count	number	عدد مرات إعادة الطباعة
fiscal.extra_fields	array/object	قيم خاصة بالولاية القضائية

presentation_hints — تلميحات التنسيق والعرض

presentation_hints

تُستهلك هذه الحقول بشكل أساسي بواسطة المُصيِّر والمُنسِّق. وهي متاحة للقوالب عند الحاجة.

الحقل	النوع	الوصف
presentation_hints.display_tax	string	incl أو excl أو hidden أو itemized أو single
presentation_hints.prices_entered_with_tax	boolean	ما إذا كانت أسعار الكتالوج تشمل الضريبة
presentation_hints.rounding_mode	string	إعداد تقريب الضريبة في WooCommerce
presentation_hints.locale	string	الإعدادات المحلية المستخدمة للتنسيق
presentation_hints.timezone	string	المنطقة الزمنية للإيصال
presentation_hints.currency_position	string	موضع رمز العملة
presentation_hints.currency_symbol	string	رمز العملة
presentation_hints.price_thousand_separator	string	فاصل الآلاف
presentation_hints.price_decimal_separator	string	الفاصل العشري
presentation_hints.price_num_decimals	number	عدد المنازل العشرية
presentation_hints.price_display_suffix	string	لاحقة عرض السعر في WooCommerce
presentation_hints.order_barcode_type	string	نوع الباركود المستخدم في قوالب المعرض

i18n — التسميات المترجمة

i18n

استخدم تسميات i18n بدلًا من كتابة النصوص مباشرةً كلما أمكن:

{{i18n.order}} #{{order.number}}
{{i18n.cashier}}: {{cashier.name}}
{{i18n.total}}: {{totals.total_display}}

تتضمّن المفاتيح الشائعة order وdate وcashier وcustomer وitem وsku وqty وunit_price وdiscount وsubtotal وtotal وtax وpaid وtendered وchange وtax_summary وrefunded وnet_total وcustomer_note وthank_you_purchase وopening_hours، ومفاتيح تسميات المعرّف الضريبي مثل store_tax_id_label_eu_vat وcustomer_tax_id_label_other. يمكن أن تضيف الإضافات مفاتيح إضافية.