خطاهای سامانه مودیان | لیست ارورها، علت و روش رفع خطاها

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

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

انواع خطاهای سامانه مودیان و علت بروز آن‌ها

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

مهم‌ترین دسته‌های خطا عبارت‌اند از:

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

جدول جامع خطاهای سامانه مؤدیان؛ کد خطا، علت و روش رفع

۱. خطاهای اطلاعات هویتی و اقتصادی خریدار و فروشنده

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

۲. خطاهای شماره مالیاتی و سریال صورتحساب

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

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

۴. خطاهای امضا و احراز هویت

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

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

۶. خطاهای مبلغ و مالیات

۶-۱. خطاهای مالیات بر ارزش افزوده

۶-2. خطاهای پرداخت و تسویه

۶-3.خطاهای الگوهای خاص مالی و ارزی

۷. خطاهای تاریخ، الگوی صورتحساب و صورتحساب‌های ارجاعی

۷-۱. خطاهای تاریخ و نوع صورتحساب

۷-۲. خطاهای صورتحساب‌های ارجاعی

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

۸. خطاهای ارسال و پردازش صورتحساب

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

وضعیت‌های استعلام صورتحساب چه معنایی دارند؟

همه وضعیت‌هایی که هنگام ارسال صورتحساب مشاهده می‌کنید الزاماً «خطا» نیستند. بعضی از آن‌ها نشان می‌دهند صورتحساب هنوز در حال پردازش است.

نکته: مشاهده وضعیت‌هایی مانند IN_PROGRESS یا TIMEOUT به این معنی نیست که باید بلافاصله صورتحساب را دوباره ارسال کنید. ابتدا وضعیت درخواست قبلی را استعلام کنید؛ زیرا ممکن است صورتحساب در سمت سامانه دریافت شده باشد و ارسال مجدد آن باعث ایجاد <خطای صورتحساب تکراری> شود.

خطای Invalid Signature (امضای بسته صحیح نیست) در سامانه مودیان چیست؟

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

علت خطای Invalid Signature چیست؟

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

چگونه خطای Invalid Signature را رفع کنیم؟

1. ابتدا منوی اطلاعات شرکت را ذخیره کرده و صورتحساب را مجدداً ارسال کنید (ترجیحاً توسط پشتیبان یا مسئول فنی نرم‌افزار انجام شود).
2. اگر خطا همچنان تکرار شد، در کارپوشه سامانه مودیان کلید عمومی را مجدداً بارگذاری کنید تا کلید امضای جدید صادر شود.
3. کلید امضای جدید را در نرم‌افزار واسط، بخش حافظه مالیاتی، جایگزین کلید قبلی کنید.
4. اعتبار گواهی دیجیتال و تطابق آن با کلید خصوصی را بررسی کنید.
5. صورتحساب را مجدداً اعتبارسنجی و برای ارسال دوباره اقدام کنید.

خطای Invalid Token در سامانه مودیان چیست؟

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

علت خطای Invalid Token

• منقضی شدن Token
• دریافت یا ثبت نادرست Token در نرم‌افزار
• تغییر اطلاعات احراز هویت مؤدی
• تنظیمات نادرست اتصال نرم‌افزار به سامانه
• عدم به‌روزرسانی Token پس از تغییرات کارپوشه

روش رفع Invalid Token

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

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

خطای Duplicate Invoice در سامانه مودیان چیست؟

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

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

برای رفع Duplicate Invoice چه کنیم؟

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

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

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

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

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

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

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

خطای «شماره مالیاتی صورتحساب مرجع با اطلاعات سامانه منطبق نیست»

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

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

روش رفع:

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

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

خطای «شما مجاز به ارسال بسته به این شناسه یکتا نیستید»

این خطا نشان می‌دهد امکان ارسال بسته با شناسه یکتای حافظه مالیاتی انتخاب‌شده وجود ندارد.

علت: رایج‌ترین دلیل این است که شناسه یکتا در کارپوشه، به نام یک شرکت معتمد دیگر (غیر از مؤدی فعلی) ثبت شده است.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

خطای «مبلغ مالیات بر ارزش افزوده از لحاظ قواعد محاسباتی و منطقی معتبر نیست»

این خطا دو علت رایج دارد:

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

روش رفع خطای مالیات بر ارزش افزوده

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

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

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

قبل از ارسال مجدد صورتحساب چه چیزهایی را بررسی کنیم؟

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

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

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

جمع‌بندی

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

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

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

1.خطای Invalid Signature در سامانه مودیان یعنی چه؟

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

2.خطای Invalid Token چگونه رفع می‌شود؟

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

3.خطای Duplicate Invoice در سامانه مودیان به چه معناست؟

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

4.بعد از دریافت پیام Timeout، آیا باید صورتحساب را دوباره ارسال کرد؟

خیر. باید ابتدا وضعیت درخواست قبلی استعلام گرفته شود، زیرا ممکن است صورتحساب در سامانه ثبت شده باشد و ارسال دوباره باعث بروز خطای Duplicate Invoice شود.

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

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