این ماژول چه کاری انجام می‌دهد؟
در بیشتر شرکت‌هایی که حقوق را در Odoo محاسبه می‌کنند، لیست بیمه ماهانه هنوز جداگانه در نرم‌افزار «لیست دیسکت» تأمین اجتماعی دوباره تایپ می‌شود. این دوباره‌کاری هر ماه وقت می‌گیرد. ممکن است در روز کارکرد، دستمزد یا حق بیمه با فیش حقوقی مغایرت پیش بیاید و اشکالاتی مثل کد ملی نامعتبر یا شماره بیمه خالی تازه موقع ارسال پیدا شوند.
لیست بیمه تأمین اجتماعی اودوکده ستون‌های لیست را مستقیم از فیش‌های حقوقی تأییدشده و پرداخت‌شده همان ماه محاسبه می‌کند و فایل‌های DSKKAR00 و DSKWOR00 را می‌سازد. پیش از ارسال، اشکالات داده و مغایرت حق بیمه کسرشده در فیش را نشان می‌دهد. بعد از ارسال، لیست را با شماره پیگیری قفل می‌کند و سابقه بیمه هر کارمند را نگه می‌دارد. اگر از حسابداری Odoo استفاده می‌کنید، سند بدهی حق بیمه به سازمان تأمین هم از روی همان لیست صادر می‌شود.
این ماژول به اپ حقوق و دستمزد Odoo (hr_payroll) وابسته است که فقط در Odoo Enterprise وجود دارد. پکیج شامل دو ماژول است: لیست بیمه (odookade_insurance) و سند حسابداری حق بیمه (odookade_insurance_account).
قابلیت‌ها
ساخت فایل‌های لیست بیمه
با انتخاب سال و ماه شمسی و کارگاه، فایل‌های DSKKAR00 و DSKWOR00 در یک ZIP ساخته می‌شوند. فایل DBF با کدپیج cp1256 و تبدیل «ی» و «ک» به معادل عربی نوشته می‌شود. یک خروجی TXT (UTF-8) هم برای بررسی داده‌ها در دسترس است.
محاسبه روز کارکرد، دستمزد و حق بیمه
روز کارکرد فقط از روزهای پرداختی فیش شمرده می‌شود. حق بیمه سهم بیمه‌شده، کارفرما، بیکاری و مشاغل سخت بر مبنای کمترِ جمع مشمول و سقف محاسبه می‌شود. هر قانون حقوق با فیلد «Tamin Classification» ستون خودش را در لیست مشخص می‌کند.
پارامترهای سالانه و مشاغل سخت
حداقل دستمزد، سقف مشمول بیمه و نرخ مشاغل سخت و زیان‌آور برای هر سال ثبت می‌شوند و پارامتر معتبر ماه لیست خودکار انتخاب می‌شود. سمت‌های شغلی سخت و زیان‌آور علامت می‌خورند و حق بیمه اضافی آن‌ها در لیست می‌آید.
لیست پیمانکاری و لیست جزئی
برای هر لیست می‌توانید ردیف پیمان، نرخ پورسانتاژ و شماره لیست تعیین کنید و فقط بخشی از کارکنان کارگاه را گزارش دهید.
مغایرت‌گیری و کنترل کیفیت داده
حق بیمه کسرشده در فیش با سهم بیمه‌شده در لیست مقایسه می‌شود. کد ملی نامعتبر یا تکراری، شماره بیمه یا تاریخ‌های خالی، دستمزد کمتر از حداقل و کارکنانی که فیش دارند ولی به کارگاهی وصل نیستند، پیش از ارسال گزارش می‌شوند.
چاپ PDF و خروجی اکسل
لیست بیمه به‌صورت PDF فارسی روی کاغذ A4 افقی چاپ می‌شود؛ با سربرگ کارگاه، جدول بیمه‌شدگان، جمع‌ها و محل امضا. همراه با تولید لیست، فایل اکسل راست‌به‌چپ با ستون‌های فارسی هم ساخته می‌شود.
ثبت ارسال و قفل لیست
بعد از ارسال به تأمین، با ثبت شماره پیگیری، لیست قفل می‌شود و دیگر تولید مجدد، بازگشت یا حذف نمی‌شود. فقط مدیر منابع انسانی می‌تواند قفل را باز کند و این کار در تاریخچه لیست ثبت می‌شود.
سابقه بیمه کارکنان
هر لیست برای هر بیمه‌شده یک ردیف ثابت نگه می‌دارد. سابقه ماه‌به‌ماه روزها، دستمزد و حق بیمه در منوی جداگانه و روی فرم هر کارمند در دسترس است.
سند حسابداری حق بیمه
با ماژول همراه odookade_insurance_account، روی هر لیست یک سند پیش‌نویس بدهی حق بیمه با حساب‌هایی که روی کارگاه تعیین کرده‌اید ساخته می‌شود؛ به تاریخ آخرین روز ماه شمسی.
تصاویر محیط ماژول
نصب و راه‌اندازی
- کتابخانه‌های پایتون
dbfوjdatetimeرا در همان محیط پایتونی نصب کنید که Odoo با آن اجرا می‌شود. - پوشه‌های
odookade_insuranceوodookade_insurance_account(بسته متناسب با Odoo 19 یا Odoo 20) را در مسیر افزونه‌ها قرار دهید. اپ حقوق و دستمزد (Payroll) باید نصب باشد. - فهرست برنامه‌ها را به‌روزرسانی و ماژول Odookade Insurance را نصب کنید.
- اگر حسابداری Odoo نصب باشد، ماژول سند حسابداری خودکار نصب می‌شود. روی پایگاه داده‌ای که نسخه قبلی ماژول لیست بیمه را داشته، آن را دستی نصب کنید.
pip install dbf jdatetime
odoo-bin -d your_db -i odookade_insurance
odoo-bin -d your_db -i odookade_insurance_accountتنظیمات بعد از نصب
- پارامترهای سالانه: در Tamin Insurance › Configuration › Yearly Parameters حداقل دستمزد ماهانه، سقف مشمول بیمه و نرخ مشاغل سخت سال جاری را وارد کنید.
- کارگاه: در Tamin Insurance › Configuration › Workshops کارگاه را با کد کارگاه، نام کارفرما و نرخ‌ها بسازید. نرخ‌های پیش‌فرض ۷٪ سهم بیمه‌شده، ۲۰٪ کارفرما و ۳٪ بیکاری است.
- کارکنان: در فرم هر کارمند، تب Social Security (Tamin)، کارگاه را انتخاب و شماره بیمه، کد ملی و مشخصات را تکمیل کنید.
- سمت‌های شغلی: برای هر سمت «Tamin Job Code» را وارد کنید و در صورت لزوم «Hard & Hazardous Job» را بزنید.
- قوانین حقوق: در قوانین حقوق و دستمزد، فیلد «Tamin Classification» را برای ردیف‌های دستمزد، مزایا و کسر بیمه کارمند تعیین کنید.
- حسابداری (اختیاری): در فرم کارگاه، تب Accounting، دفتر روزنامه، طرف‌حساب سازمان تأمین، حساب پرداختنی و حساب هزینه سهم کارفرما را تعیین کنید.
ماژول هیچ عدد قانونی (حداقل دستمزد، سقف، نرخ مشاغل سخت) را از پیش ندارد تا با تغییر مصوبات، عدد قدیمی بی‌صدا در لیست نیاید. اگر روی کارگاه «Monthly Insurable Ceiling» وارد شود، بر سقف پارامترهای سالانه اولویت دارد.
آموزش استفاده
تهیه لیست بیمه ماهانه
- به Tamin Insurance › Insurance Lists بروید و New را بزنید.
- «Year (Jalali)» و «Month» را وارد و «Workshop» را انتخاب کنید. در صورت نیاز «List Number»، «Output Format» و «Cap worked days at 30» را تنظیم کنید.
- دکمه Generate (تولید) را بزنید تا فایل ZIP لیست ساخته شود.
- تب‌های Insured Persons (بیمه‌شدگان)، Reconciliation (مغایرت‌گیری) و Validation (اعتبارسنجی) را بررسی کنید. اگر داده‌ای را اصلاح کردید، Re-generate را بزنید.
- با Print نسخه PDF و با Download Excel فایل اکسل را بگیرید.
نتیجه: فایل‌های DSKKAR00 و DSKWOR00، فایل اکسل و نسخه چاپی لیست، همراه با جمع حق بیمه‌های قابل پرداخت.
ثبت ارسال به تأمین و قفل لیست
- فایل DBF را در سامانه تأمین اجتماعی ارسال کنید (این مرحله خارج از Odoo است).
- در بخش «Submission to Tamin» فرم لیست، «Tamin Tracking Number» و در صورت نیاز «Submission Date» را وارد کنید.
- دکمه Mark as Submitted (ثبت ارسال به تأمین) را بزنید و پیام را تأیید کنید.
- اگر بعداً اشتباهی پیدا شد، مدیر منابع انسانی با دکمه Unlock (باز کردن قفل) لیست را برای اصلاح باز می‌کند.
لیست پیمانکاری یا لیست جزئی
- برای همان ماه و کارگاه، لیست جدیدی با «List Number» متفاوت (مثلاً 02) بسازید.
- در بخش «Contractor / Partial List»، «Contract Row» و «Percentage Rate» را وارد کنید و کارکنان را در «Only These Employees» انتخاب کنید.
- Generate را بزنید.
نتیجه: لیستی جدا فقط برای کارکنان انتخاب‌شده، با ردیف پیمان و نرخ پورسانتاژ در فایل.
صدور سند حسابداری حق بیمه
- لیست تولیدشده یا ارسال‌شده را از Tamin Insurance › Insurance Lists باز کنید.
- دکمه Create Journal Entry (ایجاد سند حسابداری) را بزنید.
- سند پیش‌نویس را بررسی و در حسابداری تأیید کنید.
| ردیف سند | بدهکار | بستانکار |
|---|---|---|
| هزینه سهم کارفرما | ✓ | |
| هزینه بیمه بیکاری | ✓ | |
| هزینه مشاغل سخت و زیان‌آور | ✓ | |
| سهم بیمه‌شده کسرشده (اختیاری) | ✓ | |
| حساب پرداختنی سازمان تأمین | ✓ |
تا وقتی برای لیست سند فعالی وجود دارد، لیست دوباره تولید یا به پیش‌نویس برگردانده نمی‌شود. برای اصلاح، اول سند را از دکمه آماری «Journal Entry» باز کنید و لغو یا حذف کنید.
مشاهده سابقه بیمه کارمند
- به Tamin Insurance › Insurance History بروید، یا روی فرم کارمند دکمه Insurance را بزنید.
- سابقه را بر اساس کارمند، کارگاه، سال یا ماه گروه‌بندی کنید یا از نمای Pivot استفاده کنید.
نکات و محدودیت‌ها
برای اینکه حق بیمه کسرشده در فیش با لیست مقایسه شود، قانون حقوقی که سهم بیمه کارمند را کسر می‌کند باید طبقه‌بندی «Employee Premium Deduction (control)» داشته باشد. حد مجاز مغایرت را با «Reconciliation Tolerance» روی کارگاه تعیین کنید.
- ردیف‌های هر لیست ثابت ذخیره می‌شوند؛ تغییر بعدی اطلاعات کارمند، لیست‌های ماه‌های قبل را عوض نمی‌کند.
- کارمندی که فیش دارد ولی به کارگاهی وصل نیست، در هشدارها نام برده می‌شود تا از لیست جا نماند.
- اگر حقوق و دستمزد سهم بیمه کارگر را مستقیم به حساب پرداختنی تأمین می‌برد، فیلد «Employee Share Withheld» کارگاه را خالی بگذارید تا این مبلغ دو بار ثبت نشود.
- دسترسی: افسر منابع انسانی لیست را می‌سازد، تولید می‌کند و ثبت ارسال می‌زند. حذف لیست و باز کردن قفل با مدیر منابع انسانی است. دکمه‌های حسابداری فقط برای کاربران دارای دسترسی حسابداری نمایش داده می‌شوند.
کارهایی که این ماژول انجام نمی‌دهد:
- فایل را مستقیم به سامانه تأمین اجتماعی ارسال نمی‌کند؛ ارسال دستی است.
- سند پرداخت به سازمان تأمین را ثبت نمی‌کند؛ فقط سند بدهی حق بیمه را می‌سازد. حساب تحلیلی (مرکز هزینه) روی ردیف‌های سند ثبت نمی‌شود.
- فقط لیست عادی تولید می‌شود (نوع لیست در فایل همیشه «عادی» است).
- کارگاه هر کارمند در لحظه تولید لیست خوانده می‌شود؛ جابه‌جایی کارگاه در میانه ماه جدا گزارش نمی‌شود.
- فقط فیش‌های تأییدشده و پرداخت‌شده خوانده می‌شوند. سال شمسی باید بین ۱۳۰۰ و ۱۴۹۹ باشد.
سازگاری و پیش‌نیازها
| مورد | جزئیات |
|---|---|
| نسخه‌های Odoo | Odoo 19 و Odoo 20 |
| نسخه Odoo | Enterprise (به دلیل وابستگی به حقوق و دستمزد) |
| ماژول‌های لازم | hr، hr_payroll، mail، web؛ برای سند حسابداری: account |
| کتابخانه‌های پایتون | dbf، jdatetime |
| چندشرکتی | پشتیبانی می‌شود (کارگاه، لیست و پارامتر به تفکیک شرکت) |
| مجوز | LGPL-3 |
| نسخه ماژول‌ها | لیست بیمه 2.0.0، سند حسابداری 1.0.0 |
تغییرات نسخه‌ها
- 2.0.0: پارامترهای سالانه و مشاغل سخت و زیان‌آور؛ لیست پیمانکاری و جزئی؛ مغایرت‌گیری حق بیمه کسرشده؛ هشدار حداقل دستمزد و کارکنان بدون کارگاه؛ ثبت ارسال با شماره پیگیری و قفل لیست؛ چاپ PDF؛ خروجی اکسل؛ سابقه بیمه؛ تاریخچه تغییرات روی لیست؛ ماژول سند حسابداری حق بیمه (1.0.0).
پرسش‌های متداول
با نسخه Community اودو کار می‌کند؟
خیر. ماژول به حقوق و دستمزد Odoo (hr_payroll) وابسته است که بخشی از Odoo Enterprise است.
خروجی را می‌شود در نرم‌افزار لیست دیسکت تأمین باز کرد؟
فایل DBF با ساختار فیلدهای DSKKAR و DSKWOR و کدپیج cp1256 ساخته می‌شود که فرمت لیست دیسکت است. پیشنهاد می‌کنیم اولین فایل را پیش از ارسال در نرم‌افزار لیست دیسکت آزمایش کنید.
روزهای مرخصی بدون حقوق در لیست حساب می‌شوند؟
خیر. فقط روزهایی شمرده می‌شوند که در فیش حقوقی «پرداختی» هستند.
سقف و حداقل دستمزد هر سال را باید خودمان وارد کنیم؟
بله، در منوی Yearly Parameters. ماژول هیچ عدد قانونی از پیش ندارد.
اگر بعد از ارسال اشتباهی پیدا شد چه کنیم؟
مدیر منابع انسانی با دکمه «Unlock» قفل لیست را باز می‌کند، سپس لیست اصلاح و دوباره تولید می‌شود. این کار در تاریخچه لیست ثبت می‌شود.
برای یک کارگاه می‌شود چند لیست در یک ماه ساخت؟
بله. برای لیست پیمانکاری یا جزئی، شماره لیست متفاوت، ردیف پیمان، نرخ پورسانتاژ و کارکنان موردنظر را تعیین کنید.
سند حسابداری حق بیمه هم صادر می‌کند؟
بله، با ماژول odookade_insurance_account که داخل همین پکیج است. اگر حسابداری Odoo نصب باشد خودکار نصب می‌شود.
اگر حسابداری اودو نداشته باشیم پکیج کار می‌کند؟
بله. ماژول لیست بیمه بدون حسابداری کامل کار می‌کند و فقط ماژول سند حسابداری نصب نمی‌شود.
سهم کارگر دو بار در حساب‌ها ثبت نمی‌شود؟
خیر. سهم کارگر فقط وقتی در سند می‌آید که حساب «Employee Share Withheld» روی کارگاه تعیین شده باشد.
مشخصات
| نسخه Odoo | 19.0, 20.0 |