رایج‌ترین خطاهای سامانه مودیان را بشناسید [معرفی 16 خطای مهم و راه‌حل رفع آن‌ها]

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

رایج‌ترین خطاهای سامانه مودیان و روش رفع آن‌ ها 

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

بیشتر خطاهای سامانه مودیان در گروه‌های زیر قرار می‌گیرد، در ادامه هر بخش را مرور می‌کنیم:

• اشتباه در اطلاعات هویتی خریدار
• خطا در شناسه کالا و خدمات
• خطا در محاسبات مالیاتی
• نقص در اطلاعات حافظه مالیاتی
• اشکال در شناسه یکتا مالیاتی
• خطای امضای دیجیتال
• خطاهای توکن 
• مشکلات ارتباط با سامانه مودیان
• خطاهای استعلام وضعیت صورتحساب

بنابراین، برای رفع خطا ابتدا باید کد خطا و متن دقیق پیام سامانه را بررسی کنید؛ چون راه‌حل هر خطا متفاوت است:

این جدول برای تشخیص سریع خطا طراحی شده است؛ در ادامه، مهم‌ترین موارد را با جزئیات بیشتری بررسی می‌کنیم.

پیش از آنکه به تشریح راه‌حل‌های رفع خطاهای سامانه مودیان بپردازیم، بهتر است ابتدا با سامانه مودیان در مقاله زیر آشنا شوید:

سامانه مودیان چیست؟

خطای 404 در سامانه مودیان به چه معناست؟

کد خطا 404 در سامانه مودیان نشان‌ دهنده این است که صفحه‌ موردنظر در حال حاضر قابل دسترسی نیست. این خطا اغلب زمانی رخ می‌دهد که ترافیک وب‌سایت بالا و سرور نمی‌تواند درخواست‌ها را پردازش کند، به بیان ساده‌تر، سایت موقتاً از دسترس خارج شده است.

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

خطای 503 در سامانه مودیان به چه معناست و چگونه می توان آن را رفع کرد؟

خطای 503 معمولاً به این معناست که سرویس موردنظر سامانه در آن لحظه قادر به پاسخ‌گویی نیست. این وضعیت بیشتر به مشکلات موقت سمت سرور، ترافیک بالا یا اختلال در سامانه مودیان مربوط می‌شود.

در چنین شرایطی، ابتدا چند دقیقه صبر کنید و دوباره درخواست را ارسال کنید. اگر خطا ادامه داشت، از ارسال مکرر صورتحساب خودداری کنید و ابتدا وضعیت صورتحساب را در کارپوشه بررسی کنید که از ثبت نشدن تکراری آن مطمئن شوید.

خطای ۴۱۱۰ در سامانه مودیان به چه معناست؟

کد خطای 4110 سامانه مودیان زمانی ظاهر می‌شود که سامانه نتواند شناسه حافظه (clientId) را در توکن JWT (توکن دسترسی) پیدا و اعتبارسنجی کند. این شناسه حافظه به‌نوعی شناسه‌ اختصاصی کاربر در سامانه مودیان است و سامانه برای شناسایی و تأیید هویت کاربر به آن نیاز دارد.

برای رفع این خطا، ابتدا باید صحت امضا و گواهی امضای دیجیتال توکن JWT بررسی شود. سپس در صورت نیاز، شناسه کلاینت (clientId) را به توکن اضافه کنید. اگر این شناسه به هر دلیلی غیرفعال شده است، باید آن را مجدداً فعال کرده و بررسی کنید که توکن به درستی کار کند.

خطای 4011 سامانه مودیان چیست؟

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

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

خطای شناسه کالا در سامانه مودیان به چه معناست و چگونه می توان آن را حل کرد؟

گاهی خطای شناسه کالا در سامانه مودیان به این دلیل ایجاد می‌شود که شناسه کالا یا خدمت، اشتباه، ناقص یا خارج از فرمت مورد تأیید سامانه وارد شده است. برای رفع این مشکل، ابتدا شناسه وارد شده را در سایت stuffid بررسی کنید و مطمئن شوید که شناسه معتبر و فعال است. همچنین تعداد ارقام آن را کنترل کنید؛ شناسه کالا و خدمت باید ۱۳ رقمی باشد. اگر شناسه وارد شده با اطلاعات ثبت‌ شده در سامانه مطابقت نداشته باشد، باید شناسه صحیح را انتخاب و سپس صورتحساب را مجدداً ارسال کنید. 

خطای امضای توکن دسترسی صحیح نمی‌باشد

توکن یا امضای دیجیتال یک نوع شناسه‌ی امنیتی است که هویت افراد را در سامانه مودیان تصدیق می‌کند. هنگامی که مودیان هنگام ورود یا دریافت خدمات در سامانه مودیان با مشکل دریافت توکن مواجه می‌شوند، این خطا رخ می‌دهد.

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

خطاهای مرتبط با ارسال صورتحساب به سامانه مودیان

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

خطای زمان سیستم شما صحیح نیست در سامانه مودیان

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

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

خطای تاریخ میلادی در سامانه مودیان

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

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

خطای شماره مالیاتی صورتحساب با اطلاعات سامانه منطبق نیست یعنی چه؟

پیغام خطای شماره مالیاتی صورتحساب با اطلاعات سامانه منطبق نیست، زمانی در سامانه مودیان نمایش داده می‌شود که شماره مالیاتی صورتحساب ارسالی با اطلاعات موجود در سامانه مطابقت نداشته باشد. یکی از حالت‌های رایج این است که صورتحساب قبلاً به سامانه ارسال شده، اما نرم‌افزار همچنان آن را در وضعیت ارسال‌ نشده یا ناموفق نشان می‌دهد.

برای رفع خطای مقدار فیلد شماره مالیاتی صورتحساب با اطلاعات سامانه منطبق نیست، مراحل زیر را انجام دهید: 

1. شماره مالیاتی صورتحساب ناموفق را از تکس‌پنل کپی کنید.
2. در کارپوشه، بخش فروش داخلی از طریق کاربرگ جست‌وجو با شماره مالیاتی، صورتحساب را جست‌وجو کنید.
3. اگر صورتحساب ثبت شده بود، وضعیت آن را در نرم‌افزار به «ارسال شده» تغییر دهید.
4. اگر ثبت نشده بود، قفل صورتحساب را باز کرده، ساعت صدور را یک ساعت جلوتر ببرید و صورتحساب را مجدداً ارسال کنید.

توصیه می‌شود این مرحله، به‌ ویژه باز کردن قفل و تغییر ساعت، توسط پشتیبان یا مسئول فنی نرم‌افزار انجام شود.

خطای مقدار فیلد شماره مالیاتی صورتحساب مرجع با اطلاعات سامانه منطبق نیست. 

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

برای رفع خطا، مراحل زیر را انجام دهید:

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

خطای شناسه یکتا و حافظه مالیاتی چیست؟

خطای «شما مجاز به ارسال بسته به این شناسه یکتا نیستید». این خطا نشان می‌دهد امکان ارسال بسته با شناسه یکتای حافظه مالیاتی انتخاب‌شده وجود ندارد. رایج‌ترین دلیل این است که شناسه یکتا در کارپوشه، به نام یک شرکت معتمد دیگر (غیر از مؤدی فعلی) ثبت شده است. برای رفع این خطا، شناسه یکتا را هم در کارپوشه سامانه مودیان و هم در نرم‌افزار واسط، بخش حافظه مالیاتی بررسی و ویرایش کنید که با شرکت صحیح مطابقت داشته باشد. پس از اصلاح، ارسال صورتحساب را دوباره بررسی کنید.

خطاهای شماره اقتصادی و شناسه ملی در سامانه مودیان

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

خطای شماره اقتصادی خریدار / فروشنده

این خطا معمولاً به دلیل اشتباه در وارد کردن شماره اقتصادی فروشنده ایجاد می‌شود. برای اشخاص حقوقی، شناسه ملی به‌عنوان شماره اقتصادی جدید مورد استفاده قرار می‌گیرد و کدهای اقتصادی قدیمی که با 411 شروع می‌شدند، نباید به‌عنوان شماره اقتصادی جدید استفاده شوند.

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

خطای الگوی شناسه ملی خریدار

این خطا زمانی رخ می‌دهد که مقدار وارد شده در فیلد شناسه ملی/شناسه مشارکت مدنی/کد فراگیر خریدار، الگوی مورد نیاز سامانه را رعایت نکرده باشد.

خطاهای شناسه کالا و خدمت در سامانه مودیان

برای صدور صورتحساب الکترونیکی، شناسه کالا یا خدمت باید معتبر و متناسب با نوع کالا یا خدمت باشد. علت خطای شناسه کالا و خدمت به شرح زیر است:

• ورود اشتباه شناسه
• استفاده از شناسه نامعتبر یا منقضی‌ شده
• جابه‌جایی شناسه چند کالا با یکدیگر
• عدم تطابق شناسه با نرخ مالیات تعریف‌ شده برای آن کالا

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

خطاهای مالیات بر ارزش افزوده در صورتحساب

خطای «مبلغ مالیات بر ارزش افزوده از لحاظ قواعد محاسباتی و منطقی معتبر نیست»، معمولاً زمانی اتفاق می‌افتد که مودی مشمول فراخوان ارزش افزوده است، اما در سایت ارزش افزوده ثبت‌نام نکرده و گروه مشمولیت خود را تعیین نکرده است. همچنین، مودی مشمول فراخوان ارزش افزوده نیست، اما نرخ مالیات کالا به‌جای صفر، مقدار دیگری ثبت شده است.

برای رفع خطای مالیات بر ارزش افزوده در صورتحساب مراحل زیر را انجام دهید:

1. اگر مشمول فراخوان ارزش افزوده هستید: در سایت ارزش افزوده ثبت‌نام کرده و گروه مشمولیت را مشخص کنید.
2. پس از ۲۴ تا ۷۲ ساعت (زمان لازم برای تایید تغییرات از سوی سازمان امور مالیاتی)، صورتحساب را دوباره ارسال کنید.
3. اگر مشمول فراخوان نیستید: در منوی اطلاعات شرکت، گزینه «مشمول فراخوان ارزش افزوده نمی‌باشد» را فعال و ذخیره کنید.

خطای نرخ مالیات بر ارزش افزوده در یک ردیف مشخص

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

خطای احراز هویت در سامانه مودیان

خطای احراز هویت در سامانه مودیان زمانی رخ می‌دهد که اطلاعات مورد استفاده برای شناسایی مؤدی یا دسترسی به سرویس ارسال صورتحساب معتبر نباشد. این خطا می‌تواند به Token، گواهی امضای دیجیتال، اطلاعات احراز هویت یا تنظیمات اتصال نرم‌افزار مربوط باشد.

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

چطور از تکرار خطاهای سامانه مودیان جلوگیری کنیم؟

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

کنترل اطلاعات قبل از ارسال

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

انتخاب الگوی مناسب صورتحساب

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

استعلام وضعیت بعد از ارسال

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

استفاده از ابزار معتبر برای ارسال صورتحساب

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

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

اگر به‌ دنبال ورود به پروژه‌های پردرآمد بازار حسابداری و کسب اعتماد مدیران مالی هستید، گذراندن دوره حسابداری مالیاتی گامی ضروری در مسیر شغلی شماست. این دوره تخصصی با تمرکز بر مهارت‌های عملیاتی نظیر کار با سامانه‌های مالیاتی، تهیه لوایح اعتراضی و بهینه‌سازی مالیات مشاغل و اشخاص حقوقی طراحی شده تا پس از پایان دوره، با اطمینان خاطر مسئولیت پرونده‌های مالیاتی پیچیده را به عهده بگیرید.

جمع‌بندی

خطاهای سامانه مودیان در بسیاری از موارد به دلیل ثبت نادرست اطلاعات، مغایرت شماره مالیاتی، شناسه کالا، تاریخ صورتحساب، اطلاعات خریدار و فروشنده یا مشکلات احراز هویت ایجاد می‌شوند. برای رفع خطا، ابتدا متن دقیق پیام و وضعیت صورتحساب را بررسی کنید و سپس همان بخش را اصلاح کنید. شما تاکنون با چه خطاهایی در سامانه مودیان روبرو شده‌اید؟ نظرات خود را در کامنت‌ها با ما به اشتراک بگذارید.

سوالات متداول