توثيق مخصِّص إيصالات نقطة البيع والفواتير المتقدم لأودو 19
دليل اختيار شكل الفواتير وعروض الأسعار وإيصالات نقطة البيع: الأنماط والإضافات والمعاينة وإيصالات لكل متجر وملاحظات الطباعة.
يشرح الإصدار 1.0.0حُدّث في 22 أكتوبر 2026
ابدأ من هنا
ببساطة: فواتيرك وإيصالاتك هي الجزء من عملك الذي يحتفظ به العملاء. فواتير أودو القياسية صحيحة لكنها بسيطة، وتغييرها يعني عادةً تعديل قوالب QWeb. تمنحك هذه الوحدة خيارًا من الأشكال في إعدادات الشركة: خمسة أنماط للفواتير وعروض الأسعار، وخمسة لإيصالات نقطة البيع، مع لون مميِّز وكتابة المبلغ بالحروف وخانات توقيع وباركود وملاحظات صغيرة.
نصيحة: لا يتغير شيء في بياناتك. أعد النمط إلى القياسي (أودو) فيعود كل شيء كما كان.
ماذا تحصل عليه
| المكان | ما يمكنك اختياره |
|---|---|
| الفواتير والإشعارات الدائنة (PDF) | النمط: كلاسيكي أو عصري أو بسيط أو عريض أو مضغوط أو قياسي. لون مميِّز. المبلغ كتابةً. خانات توقيع. ملاحظة تذييل. |
| عروض الأسعار وأوامر البيع (PDF) | النمط والإضافات نفسها، إن وضعت علامة «لعروض الأسعار وأوامر البيع أيضًا». |
| إيصالات نقطة البيع | النمط: مضغوط أو كلاسيكي أو عصري أو مفصّل أو قياسي. باركود الطلب. ملاحظات صغيرة. عدد الأصناف والتوفير (العصري والمفصّل). |
| نقطة بيع واحدة | نمط خاص في إعدادات تلك النقطة؛ وتستخدم الأخرى نمط الشركة. |
| الإعدادات | زر معاينة يفتح آخر فاتورة لك بالنمط المختار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | الفوترة والمبيعات ونقطة البيع (account وsale وpoint_of_sale) |
| طباعة PDF | إعداد أودو المعتاد مع wkhtmltopdf |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_receipt_styles.zip؛ فُكّه لتحصل على المجلدtaqnix_receipt_styles. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن Receipt Customizer واضغط تثبيت.
# أو من سطر الأوامر ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_receipt_styles --stop-after-init
نصيحة: أغلق جلسات نقطة البيع وأعد فتحها بعد التثبيت أو بعد تغيير نمط الإيصال: تحمّل نقطة البيع إعداداتها عند بدء التشغيل.
الإعدادات
ببساطة: افتح الإعدادات ← أنماط الإيصالات والفواتير. الإعدادات خاصة بكل شركة.
| الإعداد | ما يفعله |
|---|---|
| النمط (الفواتير) | شكل الفواتير والإشعارات الدائنة، واختياريًا عروض الأسعار وأوامر البيع. |
| اللون المميِّز | يستخدمه النمطان العصري والعريض وعبارة المبلغ كتابةً. فارغ: اللون الأساسي لتصميم مستنداتك. |
| المبلغ كتابةً | يكتب الإجمالي بالحروف تحت الإجماليات، بلغة المستند. |
| خانات التوقيع | خانتان تحت الإجماليات: توقيع المفوَّض وتوقيع العميل. |
| لعروض الأسعار وأوامر البيع أيضًا | استخدم النمط والكتابة والتوقيعات والملاحظة نفسها في مستندات المبيعات. |
| ملاحظة التذييل | نص قصير تحت المستند. يمكن ترجمته إلى كل لغة. |
| النمط (الإيصالات) | الافتراضي لكل نقطة بيع في الشركة. |
| باركود الطلب | يطبع مرجع الطلب كباركود في أسفل الإيصال. |
| ملاحظات صغيرة | تحت الإيصال، مثل سياسة الإرجاع. يمكن ترجمتها. |
أنماط الفاتورة
| النمط | الشكل | مناسب لـ |
|---|---|---|
| القياسي (أودو) | مستند أودو نفسه دون مساس. | إبقاء الأمور كما هي. |
| كلاسيكي | خط ذو زوائد وجداول مؤطرة برؤوس رمادية وعنوان بخطوط. | الأعمال الرسمية والعقود. |
| عصري | رأس جدول بلون مميِّز وخطوط خفيفة بالتناوب وإجمالي ملوّن. | معظم الشركات. |
| بسيط | بلا حدود وخطوط رفيعة وعناوين خفيفة. | الاستشارات واستوديوهات التصميم. |
| عريض | رأس جدول أسود وخطوط قوية وإجمالي كبير بلون مميِّز. | التجزئة والتجارة والقراءة السريعة. |
| مضغوط | خط أصغر وصفوف أضيق. | الفواتير الطويلة ذات الأسطر الكثيرة. |
ببساطة: يأتي الرأس بشعارك وعنوانك والتذييل من تصميم المستند في أودو (الإعدادات ← الشركات ← ضبط تصميم المستند). تغيّر الأنماط متن الفاتورة: الجدول والإجماليات والإضافات.
المبلغ كتابةً والتوقيعات وملاحظة
ببساطة: فعّل ما تحتاجه. تظهر الثلاثة تحت الإجماليات، بلغة المستند.
| الإضافة | ملاحظات |
|---|---|
| المبلغ كتابةً | يستخدم تحويل الأرقام إلى نص في أودو بلغة المستند، بما فيها العربية. وأسماء وحدات العملة (دولار، سنت) تأتي من العملة: ترجمها في المحاسبة ← الإعدادات ← العملات إن أردتها بلغة المستند. |
| خانات التوقيع | خانتان فارغتان للتوقيع باليد. مناسبة للنسخ المطبوعة. |
| ملاحظة التذييل | نص عادي. يُهرَّب فلا يمكنه أن يكسر الصفحة. ترجمها لكل لغة. |
عاين قبل أن تقرر
ببساطة: في الإعدادات، معاينة بآخر فاتورة تحفظ اختياراتك وتفتح أحدث فاتورة لك كصفحة ويب بالنمط المختار. هي المستند نفسه الذي يُصنع منه PDF، فتجرّب كل الأنماط في دقيقة دون طباعة شيء.
أنماط إيصال نقطة البيع
| النمط | الشكل |
|---|---|
| القياسي (أودو) | إيصال أودو نفسه. |
| مضغوط | خط صغير وبلا شعار وتباعد ضيق وملاحظات مخفية: طلبات أكثر لكل متر من الورق. |
| كلاسيكي | خط آلة كاتبة وشعار رمادي وخطوط متقطعة حول الإجمالي، كلفّة ماكينة الدفع الحرارية. |
| عصري | رأس متوسط وإجمالي كبير أبيض على أسود وعدد الأصناف والتوفير. |
| مفصّل | أقسام بخطوط وإجمالي أقوى وعدد الأصناف والتوفير. |
ببساطة: أُنتجت هذه الإيصالات بتشغيل جلسات نقطة بيع حقيقية ودفع طلبات حقيقية ثم تصوير الإيصال.
إضافات الإيصال ونمط لكل متجر
| الإضافة | ما تفعله |
|---|---|
| باركود الطلب | باركود Code 128 لمرجع الطلب في الأسفل، مفيد للإرجاع. |
| ملاحظات صغيرة | نصك تحت الإيصال، مترجمًا بحسب اللغة. |
| الأصناف | عدد الأصناف المباعة (العصري والمفصّل). |
| وفّرتَ | إجمالي الخصومات إن وُجدت (العصري والمفصّل). |
ببساطة: لمنح متجر شكلًا آخر افتح الإعدادات ← نقطة البيع واختر المتجر في الأعلى وعيّن نمط الإيصال في قسم الفواتير والإيصالات. اتركه فارغًا لاتباع الشركة.
ملاحظات الطباعة
| الموضوع | التفصيل |
|---|---|
| PDF الفاتورة | يصنعه أودو بـwkhtmltopdf. تستخدم الأنماط CSS بسيطًا يفهمه (دون grid أو خصائص مخصصة). |
| إيصال نقطة البيع | يُطبع كصورة للإيصال، فيبدو متطابقًا في طباعة المتصفح وطابعة الشبكة وطابعة ESC/POS. |
| عرض الورق | يحتفظ الإيصال بعرض أودو. المضغوط أفضل اختيار للفّات 58 ملم. |
| صورة الباركود | تُجلب من خادم أودو عند عرض الإيصال، فتحتاج نقطة البيع إلى اتصال لها. |
الحدود
| الحد | التفصيل |
|---|---|
| رأس المستندات وتذييلها | تتبع تصميم المستند في أودو لا الأنماط. |
| الخطوط | يستخدم PDF الخطوط المتاحة على الخادم. يستخدم الكلاسيكي خطًا ذا زوائد؛ وإن لم يوجد على الخادم يُستخدم خط افتراضي. |
| المستندات من اليمين إلى اليسار | يقرر أودو الاتجاه؛ ولا تغيّره الأنماط. |
| تصميم مخصص بالكامل | الأنماط أشكال لا محرر قوالب. لتصميم فريد وسّع قالب QWeb (الفصل 13). |
| طابعات إيصالات لها قالبها الخاص | الطابعات التي تبني الإيصال بنفسها دون صورة الإيصال لا تستخدم هذه الأنماط. |
للمطورين
ببساطة: تجاوز هذا الفصل إن كنت تستخدم الوحدة فقط.
| البند | التفاصيل |
|---|---|
| حقول الشركة | tx_invoice_style وtx_invoice_accent وtx_invoice_amount_words وtx_invoice_signatures وtx_invoice_note وtx_apply_sales وtx_receipt_style وtx_receipt_barcode وtx_receipt_note. |
| الفواتير | يُضاف الصنف tx-inv-<style> إلى متن الفاتورة ويأتي CSS من res.company._tx_invoice_css(). أضف نمطك إلى STYLE_CSS. |
| نقطة البيع | تحصل pos.config على taqnix_style_in_use؛ وتحصل OrderReceipt على txReceipt؛ ويحمل الإيصال الصنف tx-style-<style>. |
// شكلك الخاص للإيصال: أضف CSS لصنف نمط جديد
.pos-receipt.tx-style-shop {
font-family: Georgia, serif;
.pos-receipt-amount.receipt-total { border: 2px solid #000; }
}
# واخترْه بـPython (قيمة الاختيار 'shop')
env['pos.config'].browse(1).taqnix_receipt_style = 'shop'استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لم يتغير PDF الفاتورة | افحص النمط في الإعدادات وشركة الفاتورة: لكل شركة نمطها. |
| لم يتغير الإيصال | أغلق جلسة نقطة البيع وأعد فتحها لتعيد تحميل الإعداد. |
| متجر يعرض نمطًا غير نمط الشركة | لنقطة البيع تلك نمط إيصال خاص. أفرغه لاتباع الشركة. |
| المبلغ كتابةً فارغ | مكتبة تحويل الأرقام إلى نص لا تدعم اللغة أو غير موجودة على الخادم. |
| لا باركود على الإيصال | فعّل «باركود الطلب». يظهر في الإيصال النهائي فقط لا والطلب مفتوح. |
| اللون المميِّز مُتجاهَل | استخدم قيمة مثل #1f6feb. الكلاسيكي والبسيط والمضغوط لا تستخدم اللون المميِّز. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_receipt_styles. تبقى اختياراتك محفوظة. للإزالة ألغِ التثبيت من التطبيقات: تعود الفواتير وعروض الأسعار والإيصالات إلى شكل أودو القياسي.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.