Skip to Content

آموزش جامع و کاربردی ماژول سامانه مودیان ایران (Odoo 19)

راهنمای جامع اتصال Odoo 19 به سامانه مودیان؛ آموزش گام‌به‌گام ارسال مستقیم فاکتور الکترونیکی
10 سپتامبر 2026 توسط
آموزش جامع و کاربردی ماژول سامانه مودیان ایران (Odoo 19)
Sina Mohammadi

مقدمه: پایان دغدغه ارسال صورتحساب‌های الکترونیکی در Odoo

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

یکی از بزرگ‌ترین چالش‌های کاربران ERP محبوب اودوو (Odoo) در ایران، عدم اتصال مستقیم این سیستم به سامانه مالیاتی و نیاز به نرم‌افزارهای واسط پرهزینه یا اکسل‌های میانی بود. اما اکنون با ماژول بومی و اختصاصی سامانه مودیان Odoo 19 (l10n_ir_taxpayer)، می‌توانید فاکتورهای فروش خود را با یک کلیک، با بالاترین استاندارد رمزنگاری و بدون هیچ‌گونه واسطه‌ای مستقیماً از داخل اودوو به سامانه امور مالیاتی ارسال نمایید.

چرا اتصال مستقیم Odoo به سامانه مودیان اهمیت دارد؟

  1. حذف نرم‌افزارهای واسط و شرکت‌های معتمد: عدم نیاز به پرداخت هزینه‌های شارژ ماهانه یا سالانه بابت هر فاکتور به شرکت‌های TSP.
  2. امنیت حداکثری و محرمانگی داده‌ها: امضای دیجیتال و رمزنگاری با کلیدهای اختصاصی شرکت در سرور خودتان انجام شده و هیچ داده‌ای در سرور ثالث ذخیره نمی‌شود.
  3. صرفه‌جویی در زمان و جلوگیری از خطای انسانی: حذف کامل خروجی اکسل و ورود دستی فاکتورها.
  4. تولید خودکار شماره ۲۲ رقمی مالیاتی (Tax ID): محاسبه آنی شماره منحصر‌به‌فرد مالیاتی طبق فرمول استاندارد سازمان امور مالیاتی.
  5. استعلام خودکار و هوشمند وضعیت فاکتورها: پیگیری وضعیت تایید یا رد فاکتورها از طریق زمان‌بندی‌های خودکار (Cron Jobs).

پیش‌نیازهای شروع کار: قبل از راه‌اندازی چه چیزهایی نیاز داریم؟

پیش از ورود به تنظیمات اودوو، باید پیش‌نیازهای زیر را از کارپوشه مالیاتی دریافت کرده باشید:

  1. کلید خصوصی (Private Key): فایل کلید امنیتی با فرمت .pem که توسط خودتان تولید شده است.
  2. شناسه یکتای حافظه مالیاتی (Fiscal ID): کد ۶ کاراکتری که پس از بارگذاری فایل CSR در درگاه my.tax.gov.ir دریافت کرده‌اید.
  3. کد اقتصادی شرکت: شماره اقتصادی ۱۲ یا ۱۴ رقمی پرونده مالیاتی.
  4. شناسه کالا و خدمات (SSTID): کدهای ۱۳ رقمی عمومی یا اختصاصی محصولات از سامانه شناسه کالا و خدمات (stuffid.tax.gov.ir).

آموزش گام‌به‌گام راه‌اندازی و استفاده از ماژول

گام اول: پیکربندی و ورود کلیدها در اودوو

پس از نصب ماژول، آیکون برنامه «سامانه مودیان» در صفحه اصلی برنامه‌های اودوو و همچنین در منوی حسابداری ← سامانه مودیان ← تنظیمات نمایان می‌شود.

  1. وارد فرم تنظیمات شرکت شوید.
  2. شناسه حافظه مالیاتی (۶ کاراکتر)، حالت مودی (Self-TSP) و محیط (عملیاتی یا آزمایشی) را تعیین کنید.
  3. متن کلید خصوصی (Private Key) را در کادر مربوطه قرار دهید.
  4. دکمه «🔐 تست اتصال و دریافت توکن» را بزنید تا وضعیت اتصال به رنگ سبز درآید.

📸 

(تصویر فرم تنظیمات شرکت با شناسه حافظه و تیک سبز تست اتصال)

گام دوم: تکمیل مشخصات مالیاتی مشتریان (طرف‌های حساب)

در فرم هر مشتری، تب جدیدی با عنوان «سامانه مودیان» اضافه شده است:

  • نوع خریدار: انتخاب بین اشخاص حقوقی، اشخاص حقیقی، مصرف‌کننده نهایی یا خریدار خارجی.
  • کد اقتصادی / شناسه ملی / کد ملی: متناسب با نوع خریدار فیلدهای الزامی را پر کنید.
  • کد پستی ۱۰ رقمی: برای اعتبارسنجی نشانی خریدار.

📸 

(تصویر فیلدهای نوع خریدار، شناسه ملی و کد اقتصادی در تب سامانه مودیان)

گام سوم: تخصیص شناسه کالا و خدمات (SSTID) به محصولات

در فرم کالاها و خدمات، وارد تب «سامانه مودیان» شوید و شناسه ۱۳ رقمی مصوب سازمان امور مالیاتی و واحد اندازه‌گیری را ثبت کنید. این کار را می‌توانید به صورت گروهی نیز انجام دهید.

📸 

(تصویر فیلد شناسه ۱۳ رقمی SSTID و واحد سنجش در فرم محصول)

گام چهارم: صدور فاکتور و ارسال به سامانه مودیان

فرآیند صدور صورتحساب به سادگی فاکتورهای همیشگی اودوو است:

  1. فاکتور فروش را ایجاد و اقلام آن را اضافه کنید.
  2. دکمه «تأیید (Confirm)» فاکتور را بزنید.
  3. در بالای فرم فاکتور، دکمه «📤 ارسال به سامانه مودیان» فعال می‌شود.
  4. با کلیک روی دکمه، ویزارد هوشمند پیش‌بررسی باز می‌شود؛ ماژول تمام اقلام، شناسه‌ها و مبالغ را بررسی می‌کند تا از عدم وجود خطا مطمئن شود.
  5. دکمه «ارسال» را بزنید.

📸

(تصویر ویزارد بررسی و تایید ارسال فاکتور الکترونیکی)

گام پنجم: مشاهده شماره مالیاتی و رهگیری در داشبورد

بلافاصله پس از ارسال:

  • شماره منحصر‌به‌فرد مالیاتی (Tax ID) ۲۲ رقمی روی فاکتور درج می‌شود.
  • شماره پیگیری (Reference Number) ثبت شده و پکت در وضعیت در انتظار یا تایید شده قرار می‌گیرد.
  • در منوی داشبورد مودیان می‌توانید وضعیت کلیه فاکتورها را روی برد کانبان مدیریت کنید.

📸

(تصویر برد کانبان با ستون‌های در صف، تایید شده، در انتظار و رد شده)

امکانات ویژه و پیشرفته ماژول

قابلیت توضیح کاربردی
فاکتورهای اصلاحی و ابطالی صدور صورتحساب اصلاحی (موضوع ۲)، ابطالی (موضوع ۳) و برگشت از فروش (موضوع ۴) با پیوند خودکار به شماره مالیاتی مرجع فاکتور اصلی.
بانک ترجمه خطاهای مالیاتی نمایش خطاهای بازگشتی از سمت سازمان مالیاتی با نام فارسی، شرح دقیق و راهکار رفع مشکل.
پشتیبانی کامل از چندشرکتی تعریف شناسه‌های حافظه و کلیدهای مجزا برای هر شرکت روی یک دیتابیس مشترک با تفکیک کامل داده‌ها.
ارسال گروهی و صف هوشمند قابلیت قرارگیری فاکتورها در صف ارسال پس‌زمینه بدون کندی عملکرد سیستم.


پرسش‌های متداول (FAQ)

۱. آیا این ماژول بر روی نسخه Community و Enterprise کار می‌کند؟

بله، ماژول به گونه‌ای استاندارد توسعه یافته که بر روی هر دو نسخه Community و Enterprise در Odoo 19 سازگار است.

۲. آیا برای استفاده از این ماژول نیاز به خرید اشتراک از شرکت‌های معتمد مالیاتی داریم؟

خیر، این ماژول از متد ارتباط مستقیم (Self-TSP) استفاده می‌کند و نیازی به پرداخت هزینه اشتراک به شرکت‌های معتمد مالیاتی ندارید؛ هرچند از روش ارسال با شرکت معتمد نیز پشتیبانی می‌کند.

۳. اگر در زمان ارسال، اینترنت قطع باشد چه اتفاقی می‌افتد؟

ماژول مجهز به سیستم صف (Queue) است؛ فاکتور در صف قرار می‌گیرد و به محض برقراری مجدد ارتباط، سیستم به صورت خودکار عملیات ارسال را با مکانیزم بازتلاش (Retry) انجام می‌دهد.

جمع‌بندی و دریافت ماژول

یکپارچه‌سازی فرآیند صدور فاکتور با سامانه مودیان در نرم‌افزار جامع سازمانی Odoo، نه‌تنها از جریمه‌های مالیاتی ناشی از تاخیر در ارسال صورتحساب‌ها جلوگیری می‌کند، بلکه شفافیت و سرعت عملیات مالی شرکت شما را چند برابر خواهد کرد.

 خرید ودانلود ماژول سامانه مودیان