معرفی ماژول فاکتور و پیش‌فاکتور استاندارد ایران اودولرن (نسخه ۱۹)

استانداردسازی اسناد مالی و فروش در اکوسیستم Odoo Enterprise/Community

با گسترش استفاده از سیستم‌های ERP در کسب‌وکارهای ایرانی، نیاز به خروجی‌های چاپی منطبق با استانداردهای حسابداری و ظاهری حرفه‌ای بیش از پیش احساس می‌شود. ماژول «بسته گزارش‌ساز رسمی فارسی اودولرن» با هدف رفع نواقص قالب‌های پیش‌فرض و ارائه ساختاری یکپارچه برای اسناد sale.order (پیش‌فاکتور/سفارش) و account.move (فاکتور نهایی) در نسخه ۱۹ اودو توسعه یافته است.

این ماژول با رعایت اصول راست‌چین (RTL)، فرمت‌دهی صحیح اعداد و تاریخ‌ها، و طراحی جداول استاندارد، ابزاری ضروری برای تیم‌های مالی و فروش سازمان‌ها محسوب می‌شود.

⚠️ پیش‌نیازهای حیاتی قبل از نصب

برای فعال‌سازی تبدیل تاریخ‌ها، دستور زیر را در ترمینال سرور اجرا کنید:

sudo pip3 install jdatetime

(💡 نکته: در سرورهای اوبونتو ۲۴.۰۴ به دلیل محدودیت‌های جدید پایتون، اگر با خطا مواجه شدید، از دستور sudo pip3 install jdatetime --break-system-packages استفاده کنید یا آن را در محیط مجازی (venv) اودو نصب نمایید).

۲. موتور تولید PDF wkhtmltopdf (نسخه ۰.۱۲.۶) برای جلوگیری از بهم‌ریختگی هدر، فوتر و استایل گزارش‌های PDF، حتماً نسخه 0.12.6 (ترجیحاً نسخه Patched) را نصب کنید. نصب نسخه‌های جدیدتر از طریق apt معمولاً باعث نقص در چاپ می‌شود. 🔗 دانلود مستقیم نسخه پیشنهادی و پایدار (0.12.6.1)

قبل از هرگونه اقدام برای نصب ماژول، توجه به نکته زیر الزامی است. بسیاری از مشکلات نمایش هدر، فوتر و بهم‌ریختگی صفحات در گزارش‌های اودو، ناشی از نسخه نامناسب یا نصب نادرست کتابخانه wkhtmltopdf است.

📋 ویژگی‌های فنی و عملکردی

1. ساختار کاملاً راست‌چین (RTL): اصلاح ترازبندی متون، ستون‌ها و المان‌های گرافیکی برای زبان فارسی.
2. مدیریت هوشمند فیلدها:
   • نمایش شناسه ملی، کد پستی و آدرس تفکیک‌شده (استان/شهر).
   • جداسازی شماره تماس ثابت و همراه با فرمت صحیح.
3. طراحی جداول استاندارد: استفاده از کلاس‌های Bootstrap اودو برای ایجاد خطوط جداکننده واضح، رنگ‌بندی ردیف‌ها (Zebra Striping) و تراز عمودی مناسب سلول‌ها.
4. پشتیبانی از حالت‌های مختلف سند:
   • تشخیص خودکار نوع سند (فاکتور فروش، یادداشت اعتباری، رسید).
   • امکان مخفی‌سازی اطلاعات فروشنده در حالت‌های غیررسمی (پیش‌فاکتور).
5. فرمت‌دهی پیشرفته اعداد: نمایش مبالغ با جداکننده هزارگان و مدیریت مقادیر None برای جلوگیری از خطاهای محاسباتی.

🖥️ راهنمای استفاده و تولید گزارش

پس از نصب موفقیت‌آمیز ماژول، فرآیند دریافت خروجی چاپی به شرح زیر است:

1. به منوی مربوطه (فروش یا حسابداری) مراجعه کرده و سند مورد نظر را باز کنید.
2. در نوار بالای فرم، روی دکمه چاپ (Print) کلیک نمایید.
3. از لیست باز شده، قالب «Report Invoice» یا «Sale Order Report» را انتخاب کنید.

👇 محل دقیق دکمه چاپ در رابط کاربری اودو ۱۹:

(تصویر فوق نمایی از نوار ابزار بالا و منوی کشویی Print را نشان می‌دهد)

همچنین از این ماژول در ماژول حسابداری نیز برای چاپ فاکتور می‌توانید استفاده کنید

در مسیر زیر:

سپس به منظور چاپ فاکتور:

فیلم آموزشی نحوه استفاده از ماژول Persian Invoice

📸 نمونه خروجی‌های ماژول

در ادامه، نمونه‌هایی از ظاهر نهایی اسناد تولید شده توسط این ماژول مشاهده می‌کنید:

🛠️ دستورالعمل نصب فنی

برای استقرار این ماژول در سرور اودوی خود، مراحل زیر را دنبال کنید:

1. دانلود ماژول: پس از خرید، ایمیل حاوی ماژول برای شما ارسال میگردد.
2. قرارگیری در مسیر Addons: پوشه ماژول را در دایرکتوری custom_addons سرور خود کپی نمایید.
3. به‌روزرسانی لیست: با فعال بودن حالت توسعه‌دهنده (Developer Mode)، از منوی Apps گزینه Update Apps List را اجرا کنید.
4. نصب: نام ماژول (Persian Invoice) را جستجو و اقدام به نصب نمایید.

خرید ماژول