🚨 خطاهای رایج در سامانه مودیان و روش رفع آن‌ها
ارسال صورتحساب الکترونیکی به سامانه مودیان برای بسیاری از شرکت‌ها و حسابداران تبدیل به دغدغه‌ای روزمره شده است.
گاهی همه چیز درست پیش می‌رود، اما در لحظه‌ی نهایی، فاکتور با خطا برمی‌گردد — خطاهایی مثل 406، 409 یا 422 که معنایشان برای بیشتر کاربران مبهم است.
در این مقاله، تمام خطاهای رایج سامانه مودیان را به زبان ساده بررسی می‌کنیم، علت دقیق آن‌ها را توضیح می‌دهیم و راه‌حل عملی برای رفع‌شان ارائه می‌دهیم تا ارسال صورتحساب‌هایت همیشه موفق باشد.
🔐 خطاهای مربوط به امضای دیجیتال و گواهی (CSR)
بخش زیادی از خطاهای ارسال صورتحساب مربوط به امضای دیجیتال است؛ همان گواهی الکترونیکی که هویت شرکت را برای سامانه مودیان تأیید می‌کند.
خطای 406 — امضای دیجیتال نامعتبر است
این خطا زمانی رخ می‌دهد که گواهی امضا منقضی شده باشد، مسیر فایل‌های .key و .crt اشتباه وارد شده باشد، یا فایل CSR با اطلاعات نادرست ساخته شده باشد.
برای رفع آن، کافی است در تنظیمات نرم‌افزار مسیر فایل‌ها را بررسی کرده و در صورت نیاز، گواهی جدید از مرکز صدور دریافت کنید.
خطای 407 — شناسه امضا با شناسه مودی هم‌خوانی ندارد
یعنی گواهی متعلق به شرکت دیگری است. تنها راه‌حل، صدور گواهی جدید با کد اقتصادی درست است.
خطای 450 — تأیید گواهی صادرکننده با خطا مواجه شد
این خطا معمولاً به دلیل شناخته‌نشدن گواهی ریشه (Root CA) در سیستم عامل یا مرورگر سرور رخ می‌دهد. کافی است گواهی ریشه را نصب کنید و سیستم را به‌روزرسانی نمایید.
📦 خطاهای مربوط به اطلاعات فاکتور
دومین گروه از خطاها مربوط به داده‌های فاکتور است؛ یعنی اطلاعاتی مثل شناسه کالا، کد اقتصادی، یا نوع صورتحساب که به‌درستی ثبت نشده‌اند.
خطای 409 — شناسه کالا یا خدمت نامعتبر است
اگر کد کالا در سامانه جامع تجارت ثبت نشده یا اشتباه تایپ شده باشد، این خطا نمایش داده می‌شود.
در مالی‌یار می‌توانید از بخش «جستجوی شناسه کالا» استفاده کنید تا کد معتبر را پیدا و جایگزین نمایید.
خطای 410 — کد اقتصادی خریدار اشتباه است
در صورتی رخ می‌دهد که خریدار در سامانه مودیان ثبت نشده باشد یا کد اقتصادی اشتباه وارد شده باشد.
در این حالت از شناسه ملی برای اشخاص حقیقی یا کد اقتصادی صحیح برای اشخاص حقوقی استفاده کنید.
خطای 411 — نوع صورتحساب مشخص نشده
اگر نوع فاکتور (نوع اول، دوم یا سوم) در هنگام ثبت تعیین نشده باشد، سامانه آن را نمی‌پذیرد. در بخش صدور فاکتور نوع صورتحساب را انتخاب کنید.
خطای 412 — مالیات و عوارض نادرست است
زمانی رخ می‌دهد که نرخ مالیات با گروه کالای مربوطه هم‌خوانی ندارد. کافی است نرخ‌های مالیات و عوارض را در بخش گروه کالا اصلاح کنید.
خطای 422 — ساختار فایل نادرست است
یکی از خطاهای رایج و گمراه‌کننده. یعنی ساختار JSON فاکتور با استاندارد سازمان مالیاتی متفاوت است.
برای رفع آن، ماژول مودیان را به آخرین نسخه به‌روزرسانی کنید تا قالب جدید فاکتورها به‌طور خودکار اعمال شود.
خطای 423 — تاریخ فاکتور معتبر نیست
اگر تاریخ قبل از شروع رسمی سامانه یا مربوط به آینده باشد، سامانه فاکتور را رد می‌کند. تاریخ را مطابق تقویم رسمی شمسی تنظیم کنید.
خطای 424 — شماره فاکتور تکراری است
یعنی قبلاً فاکتوری با همان شماره ارسال شده. باید از شماره جدید استفاده کنید یا نسخه قبلی را ابطال نمایید.
💰 خطاهای مربوط به محاسبات مبلغ و مالیات
برخی خطاها نه از داده‌ها، بلکه از محاسبات داخلی فاکتور ناشی می‌شوند. این خطاها معمولاً زمانی اتفاق می‌افتند که مقادیر تخفیف، مالیات یا مبلغ کل به‌درستی جمع نشده باشند.
خطای 430 — جمع مبالغ فاکتور نادرست است
یعنی مجموع ردیف‌ها با مبلغ کل فاکتور یکی نیست. معمولاً در اثر ویرایش دستی فاکتور یا وارد کردن اشتباه تخفیف رخ می‌دهد. جمع نهایی را بررسی کنید.
خطای 431 — تخفیف منفی یا نامعتبر است
تخفیف همیشه باید عدد مثبت باشد. اگر مقدار منفی ثبت شود، سامانه آن را رد می‌کند.
خطای 432 — نرخ مالیات صفر برای کالای مشمول
اگر کالایی مشمول مالیات باشد اما نرخ مالیات آن صفر ثبت شود، سامانه خطا می‌دهد. نرخ استاندارد مالیات (9٪) را اعمال کنید.
خطای 434 — مالیات بیش از حد مجاز است
اگر مالیات یا عوارض بیشتر از مقدار قانونی محاسبه شود، فاکتور رد می‌شود. نرخ مالیات را با فرمول استاندارد بررسی کنید.
🌐 خطاهای ارتباطی و API سامانه مودیان
گاهی هیچ ایرادی در فاکتور نیست، اما باز هم فاکتور ارسال نمی‌شود. این خطاها معمولاً به ارتباط شبکه یا نسخه API مربوط هستند.
خطای 500 — خطای داخلی سامانه
در این حالت سامانه مودیان موقتاً در دسترس نیست. چند دقیقه صبر کنید و ارسال را تکرار نمایید.
خطای 502 و 503 — سرور در دسترس نیست
این خطاها هنگام ترافیک زیاد یا به‌روزرسانی سامانه ظاهر می‌شوند. نیازی به اصلاح فاکتور نیست؛ فقط مجدداً تلاش کنید.
خطای 504 — زمان پاسخ‌گویی سرور تمام شده
اگر اینترنت ضعیف باشد یا پاسخ سامانه دیر برسد، این خطا نمایش داده می‌شود. اتصال اینترنت را بررسی کنید و ارسال را دوباره انجام دهید.
خطای 505 — نسخه قدیمی API
یعنی سامانه مودیان نسخه جدیدی منتشر کرده است. باید نرم‌افزار خود را به‌روزرسانی کنید تا با API جدید هماهنگ شود.
🧠 چطور از بروز خطا جلوگیری کنیم؟
پیشگیری از خطا همیشه آسان‌تر از رفع آن است. برای ارسال موفق صورتحساب‌ها، به چند نکته کلیدی توجه کنید:
-
قبل از ارسال گروهی فاکتورها، از گزینه‌ی پیش‌نمایش ارسال استفاده کنید.
-
فایل گواهی امضا و کلید خصوصی را از مسیر ثابت و امن بارگذاری کنید.
-
اطلاعات پایه شرکت (کد اقتصادی، شناسه ملی، نوع فعالیت) را با دقت ثبت کنید.
-
نرم‌افزار مالی‌یار را همیشه به‌روز نگه دارید تا با آخرین تغییرات سامانه هماهنگ باشد.
-
صورتحساب‌های ردشده را از بخش گزارش مغایرت بررسی و اصلاح کنید.
✅ جمع‌بندی
بیشتر خطاهای سامانه مودیان ناشی از خطای انسانی یا تنظیمات اشتباه در نرم‌افزار هستند، نه ایراد سیستم سازمان مالیاتی.
با ابزارهای هوشمندی مثل مالی‌یار، تمام این خطاها قبل از ارسال شناسایی می‌شوند و می‌توانید با خیال راحت صورتحساب‌ها را ارسال کنید.
اگر تا امروز ارسال فاکتور برایتان یک چالش بوده، وقتش رسیده که با یک نرم‌افزار مطمئن و دقیق، این کار را به یک فرایند ساده و بدون دردسر تبدیل کنید.
