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

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

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

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

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

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

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

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

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

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

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

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

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

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

نکته: مشاهده وضعیت‌هایی مانند 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، صحت شماره اقتصادی و شناسه ملی خریدار و فروشنده، اعتبار شناسه کالا و خدمت، درستی نرخ و مبلغ مالیات بر ارزش افزوده، و بررسی وضعیت صورتحساب قبل از هر ارسال مجدد.