خطاهای سامانه مودیان | لیست ارورها، علت و روش رفع خطاها
صدور و ارسال صورتحساب الکترونیکی در سامانه مؤدیان به صحت اطلاعات صورتحساب، تنظیمات حافظه مالیاتی، امضای دیجیتال و ارتباط با سرویس‌های سامانه وابسته است. اگر هرکدام از این مراحل با مشکل مواجه شود، ممکن است صورتحساب رد شود یا نتیجه ارسال آن به‌درستی مشخص نباشد.
در این راهنما، خطاهای سامانه مؤدیان را همراه با علت بروز و روش رفع هرکدام بررسی می‌کنیم. همچنین، وضعیت‌هایی مانند در حال پردازش، عدم دریافت پاسخ و ارسال ناموفق صورتحساب را توضیح می‌دهیم تا بدانید در هر شرایط چه اقدامی انجام دهید و چگونه پیش از ارسال مجدد، از ثبت ناخواسته صورتحساب تکراری جلوگیری کنید.
انواع خطاهای سامانه مودیان و علت بروز آن‌ها
خطاهای سامانه مودیان معمولاً زمانی رخ می‌دهند که اطلاعات ارسالی با الزامات سامانه مطابقت نداشته باشد یا در فرآیند ارتباط، احراز هویت، امضای دیجیتال و پردازش صورتحساب مشکلی ایجاد شود. بخشی از این خطاها به اشتباه در ثبت اطلاعات مربوط است و برخی دیگر می‌توانند ناشی از مشکلات فنی، تنظیمات نرم‌افزار واسط یا وضعیت سرویس سامانه باشند.
مهم‌ترین دسته‌های خطا عبارت‌اند از:
- خطاهای اطلاعات هویتی و اقتصادی: مربوط به کد اقتصادی، شناسه ملی و اطلاعات خریدار یا فروشنده.
- خطاهای شماره مالیاتی و سریال صورتحساب: ناشی از نامعتبر بودن قالب شماره، تکراری بودن اطلاعات یا رعایت‌نشدن الزامات شماره مالیاتی.
- خطاهای شناسه یکتا و حافظه مالیاتی: مرتبط با شناسه حافظه مالیاتی، تنظیمات آن یا اطلاعات مورد استفاده برای ارسال صورتحساب.
- خطاهای امضا و احراز هویت: مانند
Invalid Tokenکه می‌توانند به اعتبار امضا، گواهی یا اطلاعات احراز هویت مربوط باشند. - خطاهای شناسه کالا و خدمت: مربوط به شناسه، واحد اندازه‌گیری یا اطلاعات ثبت‌شده برای اقلام صورتحساب.
- خطاهای مبلغ و مالیات: شامل مغایرت مبلغ‌ها، تعداد، نرخ مالیات بر ارزش افزوده و محاسبات اقلام صورتحساب.
- خطاهای تاریخ، الگو و صورتحساب‌های ارجاعی: مربوط به تاریخ صدور، نوع یا الگوی صورتحساب و اطلاعات صورتحساب مرجع.
- خطاهای ارسال و پردازش: مانند
TIMEOUTوIN_PROGRESSیا وضعیت‌هایی که نتیجه نهایی ارسال را هنوز مشخص نمی‌کنند.
جدول جامع خطاهای سامانه مؤدیان؛ کد خطا، علت و روش رفع
۱. خطاهای اطلاعات هویتی و اقتصادی خریدار و فروشنده
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| خطای کد اقتصادی فروشنده | کد اقتصادی فروشنده معتبر نیست یا با قالب مورد انتظار تطبیق ندارد. | اطلاعات اقتصادی فروشنده را با پرونده مالیاتی و اطلاعات ثبت‌شده در سامانه تطبیق دهید. |
| قالب شماره اقتصادی فروشنده نامعتبر است. | مقدار شماره اقتصادی با الگوی تعیین‌شده در سامانه مطابقت ندارد. | نوع شخص و قالب شناسه اقتصادی را بررسی کنید و مقدار را مطابق مستندات همان فیلد ثبت کنید. |
| شماره اقتصادی فروشنده با اطلاعات سامانه مطابقت ندارد. | اطلاعات واردشده با پرونده مالیاتی فروشنده مغایرت دارد. | شماره اقتصادی را از روی اطلاعات معتبر پرونده مالیاتی بررسی و اصلاح کنید. |
| شماره اقتصادی فروشنده خالی است. | فیلد شماره اقتصادی فروشنده تکمیل نشده است. | فیلد مربوط را مطابق الزامات صورتحساب تکمیل کنید. |
| قالب شناسه خریدار نامعتبر است. | شناسه ملی، شماره اقتصادی یا شناسه مربوط به نوع شخص خریدار با الگوی فیلد مطابقت ندارد. | نوع شخص خریدار و شناسه موردنیاز را بررسی و مقدار صحیح را وارد کنید. |
| قالب شماره اقتصادی خریدار نامعتبر است. | شماره اقتصادی واردشده با قالب مورد انتظار سامانه مطابقت ندارد. | نوع شخص خریدار و قالب معتبر شماره اقتصادی را با مستندات رسمی تطبیق دهید. |
| شماره اقتصادی خریدار با اطلاعات سامانه مطابقت ندارد. | شماره اقتصادی با اطلاعات ثبت‌شده خریدار در سامانه مغایرت دارد. | اطلاعات خریدار و پرونده مالیاتی او را بررسی کنید. قالب دقیق شناسه موردنیاز این کد باید با مستندات رسمی تطبیق داده شود. |
| شناسه خریدار خالی است. | شناسه موردنیاز خریدار وارد نشده است. | شناسه معتبر خریدار را متناسب با نوع صورتحساب و شخص وارد کنید. |
| شماره اقتصادی خریدار خالی است. | فیلد شماره اقتصادی خریدار تکمیل نشده است. | بررسی کنید شماره اقتصادی در این نوع صورتحساب الزامی است یا خیر و در صورت الزام، آن را تکمیل کنید. |
| قالب کد پستی خریدار نامعتبر است. | کد پستی دارای نویسه غیرمجاز یا قالب نادرست است. | کد پستی را فقط با ارقام و مطابق قالب موردنیاز ثبت کنید. |
| کد پستی خریدار باید ۱۰ رقم باشد. | تعداد ارقام کد پستی صحیح نیست. | کد پستی معتبر ۱۰ رقمی را وارد کنید. |
| کد پستی خریدار الزامی است. | کد پستی در صورتحسابی که به آن نیاز دارد ثبت نشده است. | نوع صورتحساب و نوع خریدار را بررسی و در صورت الزام، کد پستی را تکمیل کنید. |
| قالب کد شعبه خریدار نامعتبر است. | کد شعبه با قالب مورد انتظار مطابقت ندارد. | کد شعبه را طبق قالب اعلام‌شده در مستندات وارد کنید؛ اگر شعبه‌ای وجود ندارد، الزامات فیلد را بررسی کنید. |
| قالب کد شعبه فروشنده نامعتبر است. | کد شعبه با الگوی تعیین‌شده مطابقت ندارد. | کد شعبه را مطابق قالب موردنیاز وارد کنید؛ در صورت نداشتن شعبه، از ثبت مقدار ساختگی خودداری کنید. |
| شماره گذرنامه خریدار خالی است. | اطلاعات گذرنامه خریدار خارجی در فیلد مربوط ثبت نشده است. | در صورتی که برای نوع شخص و صورتحساب الزامی است، شماره گذرنامه معتبر را وارد کنید. |
نکته: درباره قالب شناسه اقتصادی اشخاص حقیقی و حقوقی، صرفاً بر اساس تعداد ارقام تصمیم نگیرید؛ الزامات هر فیلد ممکن است متفاوت باشد. پیش از انتشار باید با نسخه معتبر مستندات سامانه تطبیق داده شوند.
۲. خطاهای شماره مالیاتی و سریال صورتحساب
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| قالب سریال صورتحساب نامعتبر است. | سریال صورتحساب با الگوی تعریف‌شده برای این فیلد مطابقت ندارد. | طول و نویسه‌های سریال را بررسی کنید. الگوی ارائه‌شده برای این کد، ۱۰ نویسه هگزادسیمال را مشخص می‌کند؛ بنابراین آن را بدون تطبیق با مستندات، صرفاً «۱۰ رقم عددی» در نظر نگیرید. |
| قالب شماره مالیاتی صورتحساب نامعتبر است. | شماره مالیاتی با الگوی مورد انتظار سامانه مطابقت ندارد. | ابتدا وضعیت صورتحساب را در کارپوشه مؤدیان بررسی کنید. اگر ثبت شده است، شماره مالیاتی آن را با نرم‌افزار تطبیق دهید؛ اگر ثبت نشده، سریال و ساختار شماره مالیاتی را بررسی و اصلاح کنید. |
| شماره مالیاتی صورتحساب با اطلاعات سامانه مطابقت ندارد. | شماره مالیاتی ارسال‌شده با اطلاعات موجود در سامانه مغایرت دارد یا شماره موردنظر قبلاً ثبت شده است. | ابتدا صورتحساب و وضعیت آن را در کارپوشه بررسی کنید. سپس شماره مالیاتی و سریال را تطبیق دهید و از تولید شماره تکراری جلوگیری کنید. |
| صورتحساب تکراری تشخیص داده شده است. | صورتحسابی با شناسه یا مشخصات تکراری ارسال شده یا ارسال قبلی دوباره انجام شده است. | پیش از ارسال مجدد، کارپوشه و وضعیت صورتحساب قبلی را بررسی کنید. اگر صورتحساب ثبت شده است، آن را دوباره ارسال نکنید. |
نکته مهم: در صورت مشاهده خطای شماره مالیاتی یا پیام تکراری، ابتدا بررسی کنید صورتحساب در کارپوشه ثبت شده است یا خیر. تغییر سریال یا ارسال مجدد بدون بررسی وضعیت قبلی ممکن است باعث سردرگمی و ایجاد رکوردهای تکراری شود.
۳. خطاهای شناسه یکتا و حافظه مالیاتی
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| شناسه یکتا یا کلید خصوصی مؤدی نادرست است. | شناسه یکتا اشتباه است یا کلید خصوصی با کلید عمومی ثبت‌شده تطابق ندارد. | شناسه یکتا، کلید خصوصی نرم‌افزار و کلید عمومی ثبت‌شده در کارپوشه را بررسی کنید. در صورت غیرفعال بودن شناسه، وضعیت آن را در کارپوشه بررسی و طبق فرایند رسمی فعال‌سازی اقدام کنید. |
| شناسه یکتا یا کلیدهای مرتبط معتبر نیستند. | تنظیمات شناسه یکتا یا جفت کلیدهای رمزنگاری با اطلاعات ثبت‌شده تطابق ندارد. | شناسه یکتا و ارتباط کلید عمومی و خصوصی را بررسی کنید. در صورت تداوم خطا، جزئیات خطا و وضعیت شناسه را استعلام کنید. |
| مجاز به ارسال بسته برای این شناسه یکتای حافظه مالیاتی نیستید. | شناسه یکتا فعال نیست یا روش ثبت و مالکیت آن با فرستنده بسته مطابقت ندارد. | در کارپوشه، بخش عضویت و شناسه‌های یکتا، روش ثبت و وضعیت شناسه را بررسی کنید. اگر اخیراً اطلاعات پرونده تغییر کرده است، زمان اعمال تغییرات را نیز در نظر بگیرید. |
| قرارداد شناسه یکتا و شرکت معتمد پیدا نشد. | شناسه یکتا با روش ارسال انتخاب‌شده یا اطلاعات شرکت معتمد مطابقت ندارد. | در کارپوشه، روش دریافت شناسه یکتا را بررسی کنید. اگر شناسه از طریق شرکت معتمد دریافت شده است، از شناسه و تنظیمات متناسب با همان روش استفاده کنید. |
| مجوز ارسال برای شناسه یکتا وجود ندارد. | شناسه یکتا ممکن است به نام مؤدی یا شرکت معتمد دیگری ثبت شده باشد یا وضعیت آن اجازه ارسال ندهد. | مالکیت، وضعیت فعال و روش دریافت شناسه یکتا را در کارپوشه بررسی کنید و تنظیمات نرم‌افزار را با آن تطبیق دهید. |
۴. خطاهای امضا و احراز هویت
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| امضای بسته صحیح نیست. | امضای تولیدشده برای بسته معتبر نیست یا کلیدهای مورد استفاده با تنظیمات ثبت‌شده مطابقت ندارند. | اعتبار گواهی، کلید عمومی و خصوصی، شناسه یکتا و تنظیمات امضای نرم‌افزار را بررسی کنید. |
| امضای دیجیتال معتبر نیست. | امضای بسته با کلید مورد انتظار یا گواهی مربوط مطابقت ندارد. | گواهی دیجیتال، جفت کلید عمومی و خصوصی و روش امضای بسته را بررسی کنید. در صورت تغییر کلیدها، تنظیمات نرم‌افزار و اطلاعات ثبت‌شده را مطابق مستندات به‌روزرسانی کنید. |
| توکن احراز هویت نامعتبر است. | توکن نامعتبر یا منقضی شده است یا اطلاعات احراز هویت به‌درستی تنظیم نشده‌اند. | توکن و تنظیمات اتصال را بررسی کنید و در صورت نیاز، توکن جدید را از مسیر معتبر و طبق مستندات سرویس دریافت کنید. |
تفاوت مهم: خطای امضای دیجیتال به اعتبار امضا و کلیدها مربوط است؛ اما خطای احراز هویت به اعتبار توکن اتصال مربوط می‌شود.
۵. خطاهای شناسه کالا و خدمت
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| شناسه کالا یا خدمت با اطلاعات سامانه مطابقت ندارد. | شناسه ثبت‌شده معتبر نیست یا اطلاعات آن با مشخصات قلم صورتحساب مطابقت ندارد. | شناسه را در مرجع رسمی شناسه کالا و خدمت بررسی کنید. نرخ مالیات و سایر ویژگی‌های مرتبط را نیز تطبیق دهید. در صورتحساب اصلاحی، محدودیت‌های تغییر اطلاعات نسبت به صورتحساب اصلی را رعایت کنید. |
| قالب شناسه کالا یا خدمت نامعتبر است. | شناسه با الگوی تعیین‌شده برای فیلد مطابقت ندارد. | تعداد ارقام و صحت شناسه را بررسی کنید. مطابق الگوی ارائه‌شده برای این کد، شناسه باید ۱۳ رقمی باشد؛ پیش از تعمیم این قاعده به همه الگوها، مستندات همان فیلد را بررسی کنید. |
| واحد اندازه‌گیری نامعتبر است. | واحد واردشده جزو مقادیر مجاز سامانه نیست. | واحد اندازه‌گیری را با فهرست مقادیر مجاز و واحد متناسب با کالا یا خدمت تطبیق دهید. |
| قالب شرح کالا یا خدمت نامعتبر است. | شرح کالا یا خدمت از قواعد تعریف‌شده برای فیلد پیروی نمی‌کند. | متن شرح را بررسی و نویسه‌های نامعتبر را حذف کنید. طبق اطلاعات ارائه‌شده، طول شرح نباید از ۴۰۰ نویسه بیشتر باشد. |
| طول شرح کالا یا خدمت بیش از حد مجاز است. | شرح یک قلم کالا یا خدمت از حداکثر طول مجاز عبور کرده است. | شرح را کوتاه کنید و اطلاعات ضروری کالا یا خدمت را در محدوده مجاز نگه دارید. |
| صورتحساب باید حداقل یک قلم کالا داشته باشد. | هیچ قلم کالایی در صورتحساب ثبت نشده است. | اقلام موردنیاز را اضافه کنید. در الگوهای خاص مانند بارنامه، بررسی کنید شناسه کالاهای حمل‌شده در فیلد مربوط درج شده باشد. |
۶. خطاهای مبلغ و مالیات
۶-۱. خطاهای مالیات بر ارزش افزوده
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| نرخ مالیات بر ارزش افزوده با اطلاعات سامانه مطابقت ندارد. | نرخ ثبت‌شده با اطلاعات کالا یا خدمت مطابقت ندارد. | شناسه کالا، وضعیت مشمولیت و نرخ مالیات را بررسی کنید. |
| مبلغ مالیات بر ارزش افزوده از نظر محاسباتی معتبر نیست. | مبلغ مالیات با نرخ یا مأخذ محاسبه سازگار نیست. | نرخ، مأخذ محاسبه و مبلغ مالیات را مجدداً بررسی کنید. |
| مجموع مالیات بر ارزش افزوده معتبر نیست. | مجموع مالیات اقلام با محاسبات صورتحساب مطابقت ندارد. | مالیات هر قلم و مجموع آن‌ها را کنترل کنید. |
۶-2. خطاهای پرداخت و تسویه
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| روش تسویه انتخاب نشده است. | روش پرداخت در صورتحساب مشخص نشده است. | روش تسویه متناسب با معامله را انتخاب کنید. |
| مبلغ پرداختی نقدی نامعتبر است. | مبلغ نقدی با روش تسویه یا مبلغ صورتحساب سازگار نیست. | مبلغ نقدی و مبلغ قابل پرداخت را بررسی کنید. |
| مبلغ پرداختی نسیه نامعتبر است. | مبلغ نسیه با اطلاعات تسویه مطابقت ندارد. | مبلغ نسیه و روش تسویه را کنترل کنید. |
| جمع مبالغ نقدی و نسیه با مبلغ مورد انتظار مطابقت ندارد. | مجموع مبالغ تسویه با مبلغ مبنای صورتحساب سازگار نیست. | مبالغ نقدی و نسیه و مبلغ مبنای محاسبه را تطبیق دهید. |
۶-3.خطاهای الگوهای خاص مالی و ارزی
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| نوع ارز نامعتبر است. | ارز انتخاب‌شده جزو مقادیر مجاز الگو نیست. | نوع ارز را با مقادیر مجاز الگوی مربوط تطبیق دهید. |
| مأخذ مالیات بر ارزش افزوده در الگوی فروش ارز نامعتبر است. | مأخذ مالیات با قواعد محاسبه در این الگو مطابقت ندارد. | مأخذ محاسبه و اجزای مشمول مالیات را بررسی کنید. |
| مجموع ارزش ارزی نامعتبر است. | ارزش ارزی با نرخ تبدیل یا ارزش ریالی سازگار نیست. | ارزش ارزی، نرخ تبدیل و ارزش ریالی را کنترل کنید. |
۷. خطاهای تاریخ، الگوی صورتحساب و صورتحساب‌های ارجاعی
۷-۱. خطاهای تاریخ و نوع صورتحساب
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| تاریخ و زمان صدور صورتحساب نامعتبر است. | تاریخ یا زمان ثبت‌شده با الزامات زمانی سامانه مؤدیان مطابقت ندارد. | تاریخ و زمان صدور را بررسی کنید. از تاریخ صدور صورتحساب الکترونیکی تا ارسال و ثبت آن در سامانه مؤدیان، حداکثر ۱۲ روز فرصت وجود دارد. |
| تاریخ پرداخت صورتحساب نامعتبر است. | تاریخ پرداخت با اطلاعات صورتحساب یا وضعیت تسویه سازگار نیست. | تاریخ پرداخت و وضعیت تسویه را بررسی کنید. |
| نوع صورتحساب انتخاب نشده یا نامعتبر است. | نوع صورتحساب خالی است یا با شرایط معامله مطابقت ندارد. | نوع صحیح صورتحساب را انتخاب کنید. |
| الگوی صورتحساب انتخاب نشده یا نامعتبر است. | الگوی انتخابی با نوع معامله سازگار نیست. | الگوی متناسب با معامله را انتخاب و فیلدهای الزامی را تکمیل کنید. |
۷-۲. خطاهای صورتحساب‌های ارجاعی
| شرح خطا | علت بروز | روش رفع خطا |
|---|---|---|
| شماره مالیاتی صورتحساب مرجع نامعتبر است. | شماره مرجع نادرست است یا صورتحساب در سامانه پیدا نمی‌شود. | شماره مالیاتی و ثبت صورتحساب مرجع در کارپوشه را بررسی کنید. |
| شماره مالیاتی صورتحساب مرجع وارد نشده است. | فیلد مرجع در صورتحساب ارجاعی خالی است. | شماره مالیاتی صورتحساب اصلی را وارد کنید. |
| فروشنده صورتحساب با فروشنده صورتحساب مرجع مطابقت ندارد. | اطلاعات فروشنده در دو صورتحساب متفاوت است. | مشخصات فروشنده را در هر دو صورتحساب تطبیق دهید. |
| شناسه یکتای قرارداد نامعتبر یا ثبت‌نشده است. | شناسه قرارداد با اطلاعات سامانه مطابقت ندارد. | شناسه قرارداد و وضعیت ثبت آن را بررسی کنید. |
نکته: در صورتحساب اصلاحی یا برگشت از فروش، شماره مرجع باید به صورتحساب معتبر مربوط باشد. پیش از صدور مجدد، وضعیت صورتحساب اصلی را بررسی کنید.
۸. خطاهای ارسال و پردازش صورتحساب
| شرح خطا یا وضعیت | علت بروز | روش رفع خطا |
|---|---|---|
| مهلت انتظار برای دریافت پاسخ پایان یافته است. | سرویس در زمان مورد انتظار پاسخ نداده یا ارتباط دچار تأخیر شده است. | پیش از ارسال مجدد، وضعیت صورتحساب را از مسیر استعلام یا کارپوشه بررسی کنید. اگر نتیجه نامشخص است، طبق مستندات سرویس دوباره وضعیت را استعلام کنید. |
| درخواست در حال پردازش است. | سامانه هنوز نتیجه نهایی پردازش را اعلام نکرده است. | تا مشخص شدن نتیجه، از ارسال دوباره همان صورتحساب خودداری کنید و وضعیت درخواست را مجدداً بررسی کنید. |
| نتیجه درخواست هنوز نهایی نشده است. | درخواست در صف پردازش قرار دارد یا پاسخ نهایی دریافت نشده است. | وضعیت را از مسیر معتبر پیگیری کنید و قبل از روشن شدن نتیجه، ارسال تکراری انجام ندهید. |
| عملیات ارسال یا پردازش ناموفق بوده است. | عملیات در مرحله‌ای از ارسال یا پردازش با خطا مواجه شده است. | متن کامل خطا و مرحله وقوع آن را بررسی کنید. پس از رفع علت و اطمینان از وضعیت صورتحساب، مطابق پاسخ سرویس اقدام کنید. |
| رکورد یا درخواست موردنظر پیدا نشده است. | شناسه استعلام نادرست است، رکورد در مسیر موردنظر وجود ندارد یا هنوز قابل بازیابی نیست. | شناسه درخواست و مسیر استعلام را بررسی کنید. نبودن رکورد در یک استعلام به‌تنهایی اثبات نمی‌کند که صورتحساب در هیچ مرحله‌ای ثبت نشده است. |
این جدول برای تشخیص سریع خطا طراحی شده است؛ در ادامه، مهم‌ترین موارد را با جزئیات بیشتری بررسی می‌کنیم.
وضعیت‌های استعلام صورتحساب چه معنایی دارند؟
همه وضعیت‌هایی که هنگام ارسال صورتحساب مشاهده می‌کنید الزاماً «خطا» نیستند. بعضی از آن‌ها نشان می‌دهند صورتحساب هنوز در حال پردازش است.
| وضعیت | معنی |
|---|---|
| SUCCESS | صورتحساب با موفقیت در کارپوشه درج شده و خطایی ندارد. ممکن است صورتحساب هشدار داشته باشد که هنگام استعلام، هشدارها نمایش داده می‌شوند. |
| FAILED | صورتحساب دارای خطا است و جزئیات خطا هنگام استعلام قابل مشاهده است. |
| IN_PROGRESS (Pending) | صورتحساب هنوز اعتبارسنجی نشده و در صف پردازش سامانه قرار دارد. |
| TIMEOUT | پردازش صورتحساب بیش از حد معمول طول کشیده و هنوز نتیجه نهایی آن مشخص نشده است. |
| NOT_FOUND | شماره پیگیری یا شناسه درخواست در بازه زمانی استعلام‌شده یافت نشده و امکان ارائه نتیجه وجود ندارد. |
نکته: مشاهده وضعیت‌هایی مانند IN_PROGRESS یا TIMEOUT به این معنی نیست که باید بلافاصله صورتحساب را دوباره ارسال کنید. ابتدا وضعیت درخواست قبلی را استعلام کنید؛ زیرا ممکن است صورتحساب در سمت سامانه دریافت شده باشد و ارسال مجدد آن باعث ایجاد <خطای صورتحساب تکراری> شود.
خطای Invalid Signature (امضای بسته صحیح نیست) در سامانه مودیان چیست؟
خطای Invalid Signature یا پیام «امضای بسته صحیح نمی‌باشد» به این معناست که امضای دیجیتال صورتحساب یا بسته ارسالی توسط سامانه مودیان معتبر تشخیص داده نشده است. طبق تجربه پشتیبانی، این خطا معمولاً به گواهی دیجیتال، کلید خصوصی یا تنظیمات فرآیند امضا مربوط می شود.
علت خطای Invalid Signature چیست؟
- مشکل در گواهی دیجیتال یا منقضی شدن آن
- استفاده از کلید خصوصی اشتباه یا ناهماهنگ با گواهی
- تنظیم نادرست اطلاعات امضا در نرم‌افزار
- نیاز به صدور مجدد کلید امضا در کارپوشه
چگونه خطای Invalid Signature را رفع کنیم؟
- ابتدا منوی اطلاعات شرکت را ذخیره کرده و صورتحساب را مجدداً ارسال کنید (ترجیحاً توسط پشتیبان یا مسئول فنی نرم‌افزار انجام شود).
- اگر خطا همچنان تکرار شد، در کارپوشه سامانه مودیان کلید عمومی را مجدداً بارگذاری کنید تا کلید امضای جدید صادر شود.
- کلید امضای جدید را در نرم‌افزار واسط، بخش حافظه مالیاتی، جایگزین کلید قبلی کنید.
- اعتبار گواهی دیجیتال و تطابق آن با کلید خصوصی را بررسی کنید.
- صورتحساب را مجدداً اعتبارسنجی و برای ارسال دوباره اقدام کنید.
خطای Invalid Token در سامانه مودیان چیست؟
Token یک مقدار امنیتی است که برای احراز هویت نرم‌افزار واسط و برقراری ارتباط آن با سامانه مودیان استفاده می‌شود. خطای Invalid Token زمانی رخ می‌دهد که Token ارائه‌شده هنگام ارسال صورتحساب، توسط سامانه معتبر شناخته نشود.
علت خطای Invalid Token
- منقضی شدن Token
- دریافت یا ثبت نادرست Token در نرم‌افزار
- تغییر اطلاعات احراز هویت مؤدی
- تنظیمات نادرست اتصال نرم‌افزار به سامانه
- عدم به‌روزرسانی Token پس از تغییرات کارپوشه
روش رفع Invalid Token
ابتدا اطلاعات احراز هویت و تنظیمات اتصال نرم‌افزار را بررسی کنید. اگر Token معتبر نیست یا منقضی شده، Token جدید را از کارپوشه سامانه مودیان دریافت و در نرم‌افزار واسط ثبت کنید. سپس صحت اتصال را بررسی و ارسال صورتحساب را دوباره انجام دهید.
اگر پیش از مشاهده این خطا، درخواست ارسال شده اما پاسخ قطعی دریافت نکرده‌اید، ابتدا وضعیت درخواست قبلی را از طریق استعلام یا جست‌وجو در کارپوشه بررسی کنید.
خطای Duplicate Invoice در سامانه مودیان چیست؟
خطای Duplicate Invoice به این معناست که سامانه، صورتحساب ارسالی را تکراری تشخیص داده است. این اتفاق معمولاً زمانی رخ می‌دهد که صورتحساب پیش‌تر ارسال یا در کارپوشه ثبت شده باشد.
یکی از سناریوهای رایج، دریافت نکردن پاسخ قطعی پس از ارسال اولیه است؛ برای مثال ممکن است درخواست در وضعیت IN\_PROGRESS یا TIMEOUT قرار گرفته باشد و کاربر تصور کند صورتحساب اصلاً ارسال نشده است. ارسال دوباره بدون بررسی وضعیت قبلی، دقیقاً همین خطا را ایجاد می‌کند.
برای رفع Duplicate Invoice چه کنیم؟
- شماره مالیاتی صورتحساب ناموفق را از نرم افزار واسط خود کپی کنید.
- در کارپوشه، بخش فروش داخلی، از طریق کاربرگ جست‌وجو با شماره مالیاتی، صورتحساب را جست‌وجو کنید.
- مشخص کنید آیا صورتحساب قبلاً با موفقیت ثبت شده یا خیر.
- اگر ثبت شده بود، وضعیت آن را در نرم‌افزار به «ارسال شده» تغییر دهید و از ارسال مجدد آن خودداری کنید.
- اگر ثبت نشده بود، قفل صورتحساب را باز کرده، ساعت صدور را یک ساعت جلوتر ببرید و صورتحساب را دوباره ارسال کنید.
نکته: در خطای Duplicate Invoice، قبل از ایجاد یا ارسال دوباره صورتحساب، ابتدا وضعیت نسخه قبلی را مشخص کنید.
خطای «شماره مالیاتی صورتحساب با اطلاعات سامانه منطبق نیست»
این خطا زمانی نمایش داده می‌شود که شماره مالیاتی صورتحساب ارسالی با اطلاعات ثبت‌شده در سامانه مودیان مطابقت نداشته باشد. معمولاً این خطا با نمایش یک علامت قفل کنار ردیف صورتحساب همراه است که نشان‌دهنده احتمال بالای ثبت قبلی صورتحساب در کارپوشه سازمان امور مالیاتی است.
روش رفع خطای شماره مالیاتی صورتحساب
- شماره مالیاتی صورتحساب ناموفق را از تکس‌پنل کپی کنید.
- در کارپوشه، بخش فروش داخلی، از طریق کاربرگ جست‌وجو با شماره مالیاتی، صورتحساب را جست‌وجو کنید.
- اگر صورتحساب ثبت شده بود، وضعیت آن را در نرم‌افزار به «ارسال شده» تغییر دهید.
- اگر ثبت نشده بود، قفل صورتحساب را باز کرده، ساعت صدور را یک ساعت جلوتر ببرید و صورتحساب را مجدداً ارسال کنید.
توصیه می‌شود این مرحله، به‌ویژه باز کردن قفل و تغییر ساعت، توسط پشتیبان یا مسئول فنی نرم‌افزار انجام شود.
خطای «شماره مالیاتی صورتحساب مرجع با اطلاعات سامانه منطبق نیست»
این خطا در صورتحساب‌های ارجاعی مانند اصلاحی، ابطالی و برگشت از فروش رخ می‌دهد:
- اگر صورتحساب مرجع، صورتحساب اصلی باشد، یعنی آن صورتحساب وضعیت ابطال‌شده دارد (قبلاً برای آن صورتحساب ارجاعی صادر شده است).
- اگر صورتحساب مرجع، صورتحساب اصلاحی یا برگشت از فروش باشد، یعنی آن صورتحساب مرجع در کارپوشه هنوز وضعیت تایید‌شده ندارد.
روش رفع:
- اگر مرجع، صورتحساب اصلی بود: بررسی کنید که آیا قبلاً برای آن صورتحساب ارجاعی صادر شده یا نه؛ اگر ابطالی صادر شده، باید یک صورتحساب کاملاً جدید صادر کنید.
- اگر مرجع، اصلاحی یا برگشت از فروش بود: مرجع صورتحساب ناموفق باید آخرین صورتحساب ارجاعی ثبت‌شده باشد، نه صورتحساب اصلی یا نسخه‌های میانی.
خطای شناسه یکتا و حافظه مالیاتی چیست؟
خطای «شما مجاز به ارسال بسته به این شناسه یکتا نیستید»
این خطا نشان می‌دهد امکان ارسال بسته با شناسه یکتای حافظه مالیاتی انتخاب‌شده وجود ندارد.
علت: رایج‌ترین دلیل این است که شناسه یکتا در کارپوشه، به نام یک شرکت معتمد دیگر (غیر از مؤدی فعلی) ثبت شده است.
روش رفع: شناسه یکتا را هم در کارپوشه سامانه مودیان و هم در نرم‌افزار واسط، بخش حافظه مالیاتی، بررسی و ویرایش کنید تا با شرکت صحیح مطابقت داشته باشد. پس از اصلاح، ارسال صورتحساب را دوباره بررسی کنید.
خطاهای شماره اقتصادی و شناسه ملی در سامانه مودیان
خطاهای مربوط به شماره اقتصادی و شناسه ملی، معمولاً ناشی از عدم رعایت فرمت صحیح بر اساس نوع شخص (حقیقی، حقوقی یا مشارکت مدنی) است.
خطای شماره اقتصادی خریدار / فروشنده
| نوع شخص | فرمت شماره اقتصادی |
|---|---|
| حقوقی | همان شناسه ملی، ۱۱ رقمی |
| حقیقی | ۱۴ رقمی |
| مشارکت مدنی | ۱۱ رقمی و با عدد ۶ شروع می‌شود (شناسه ملی و شماره اقتصادی یکسان است) |
روش رفع: نوع شخص (خریدار یا فروشنده) را مشخص کرده و شماره اقتصادی را مطابق جدول بالا اصلاح کنید.
خطای الگوی شناسه ملی خریدار
این خطا زمانی رخ می‌دهد که مقدار واردشده در فیلد شناسه ملی/شناسه مشارکت مدنی/کد فراگیر خریدار، الگوی مورد نیاز سامانه را رعایت نکرده باشد.
| نوع شخص | فرمت شناسه ملی |
|---|---|
| حقوقی | ۱۱ رقمی، با عدد ۱ شروع می‌شود |
| حقیقی | ۱۰ رقمی |
| مشارکت مدنی | همان شماره اقتصادی ۱۱ رقمی (با شروع ۶) در فیلد شناسه ملی وارد می‌شود |
خطاهای شناسه کالا و خدمت در سامانه مودیان
برای صدور صورتحساب الکترونیکی، شناسه کالا یا خدمت باید معتبر و متناسب با نوع کالا یا خدمت باشد.
علت خطای شناسه کالا و خدمت
- ورود اشتباه شناسه
- استفاده از شناسه نامعتبر یا منقضی‌شده
- جابه‌جایی شناسه چند کالا با یکدیگر
- عدم تطابق شناسه با نرخ مالیات تعریف‌شده برای آن کالا
روش رفع خطای شناسه کالا و خدمت
ابتدا شناسه درج‌شده در صورتحساب را بررسی کنید. سپس از معتبر بودن آن و تطابق با کالا یا خدمت موردنظر مطمئن شوید. در صورت وجود مغایرت، اطلاعات صورتحساب را اصلاح کرده و پس از اعتبارسنجی مجدد، صورتحساب را ارسال کنید.
خطاهای مالیات بر ارزش افزوده در صورتحساب
خطای «مبلغ مالیات بر ارزش افزوده از لحاظ قواعد محاسباتی و منطقی معتبر نیست»
این خطا دو علت رایج دارد:
- مؤدی مشمول فراخوان ارزش افزوده است، اما در سایت ارزش افزوده ثبت‌نام نکرده و گروه مشمولیت خود را تعیین نکرده است.
- مؤدی مشمول فراخوان ارزش افزوده نیست، اما نرخ مالیات کالا به‌جای صفر، مقدار دیگری ثبت شده است.
روش رفع خطای مالیات بر ارزش افزوده
- اگر مشمول فراخوان ارزش افزوده هستید: در سایت ارزش افزوده ثبت‌نام کرده و گروه مشمولیت را مشخص کنید.
- پس از ۲۴ تا ۷۲ ساعت (زمان لازم برای تایید تغییرات از سوی سازمان امور مالیاتی)، صورتحساب را دوباره ارسال کنید.
- اگر مشمول فراخوان نیستید: در منوی اطلاعات شرکت، گزینه «مشمول فراخوان ارزش افزوده نمی‌باشد» را فعال و ذخیره کنید.
خطای نرخ مالیات بر ارزش افزوده در یک ردیف مشخص
نرخ مالیات ثبت‌شده برای یکی از ردیف‌های صورتحساب صحیح نیست. نرخ درست را جایگزین کرده و صورتحساب را مجدداً ارسال کنید.
قبل از ارسال مجدد صورتحساب چه چیزهایی را بررسی کنیم؟
یکی از مهم‌ترین نکات هنگام مواجهه با خطا، ارسال نکردن فوری صورتحساب بدون بررسی وضعیت قبلی است.
قبل از ارسال مجدد، موارد زیر را کنترل کنید:
- وضعیت صورتحساب قبلی: بررسی کنید که صورتحساب قبلاً ثبت نشده باشد.
- شماره مالیاتی: شماره مالیاتی صورتحساب را با اطلاعات سامانه تطبیق دهید.
- گواهی و امضای دیجیتال: اعتبار گواهی و صحت تنظیمات امضا را بررسی کنید.
- Token و احراز هویت: در صورت مشاهده خطاهای احراز هویت، اعتبار Token را بررسی کنید.
- شناسه یکتای حافظه مالیاتی: شناسه یکتا را با اطلاعات کارپوشه تطبیق دهید.
- شماره اقتصادی و شناسه ملی: اطلاعات خریدار و فروشنده را کنترل کنید.
- شناسه کالا و خدمت: از صحیح و معتبر بودن شناسه هر کالا یا خدمت مطمئن شوید.
- مبلغ و مالیات: مبلغ، نرخ و محاسبات مالیات بر ارزش افزوده را بررسی کنید.
- تاریخ و نوع صورتحساب: تاریخ صدور و الگوی انتخاب‌شده را با اطلاعات معامله تطبیق دهید.
جمع‌بندی
خطاهای سامانه مودیان دلایل مختلفی دارند و رفع آن‌ها به نوع خطا و وضعیت صورتحساب بستگی دارد. بنابراین، ابتدا باید علت خطا و وضعیت صورتحساب بررسی و سپس اطلاعات مربوطه اصلاح شود. در وضعیت‌هایی مانند در حال پردازش و پاسخی یافت نشد، نیز قبل از ارسال مجدد، وضعیت قبلی صورتحساب را بررسی کنید تا با خطای صورتحساب تکراری مواجه نشوید.
استفاده از یک نرم‌افزار واسط مناسب نیز می‌تواند فرآیند ارسال، پیگیری و مدیریت صورتحساب‌های الکترونیکی را ساده‌تر کند. تکس‌پنل برای مدیریت ارسال صورتحساب به سامانه مودیان طراحی شده است. برای آشنایی بیشتر، می‌توانید راهنمای «تکس پنل چیست؟» را مطالعه کنید.
سوالات متداول درباره خطاهای سامانه مودیان
1.خطای Invalid Signature در سامانه مودیان یعنی چه؟
یعنی امضای دیجیتال صورتحساب یا بسته ارسالی توسط سامانه مودیان معتبر شناخته نشده است. راهکار: بررسی گواهی دیجیتال، کلید خصوصی و در صورت نیاز، بارگذاری مجدد کلید عمومی در کارپوشه برای صدور کلید امضای جدید.
2.خطای Invalid Token چگونه رفع می‌شود؟
با بررسی اعتبار Token و تنظیمات اتصال نرم‌افزار واسط. اگر Token منقضی شده باشد، باید Token جدید از کارپوشه سامانه مودیان دریافت و در نرم‌افزار ثبت شود.
3.خطای Duplicate Invoice در سامانه مودیان به چه معناست؟
یعنی سامانه، صورتحساب ارسالی را تکراری تشخیص داده است. برای رفع آن، شماره مالیاتی صورتحساب باید در کارپوشه (بخش فروش داخلی) جست‌وجو و وضعیت آن بررسی شود؛ در صورت ثبت قبلی، وضعیت در نرم‌افزار به «ارسال شده» تغییر می‌کند.
4.بعد از دریافت پیام Timeout، آیا باید صورتحساب را دوباره ارسال کرد؟
خیر. باید ابتدا وضعیت درخواست قبلی استعلام گرفته شود، زیرا ممکن است صورتحساب در سامانه ثبت شده باشد و ارسال دوباره باعث بروز خطای Duplicate Invoice شود.
5.چگونه از بروز خطاهای سامانه مودیان جلوگیری کنیم؟
با کنترل پیش از ارسال صورتحساب: اعتبار گواهی دیجیتال و Token، صحت شماره اقتصادی و شناسه ملی خریدار و فروشنده، اعتبار شناسه کالا و خدمت، درستی نرخ و مبلغ مالیات بر ارزش افزوده، و بررسی وضعیت صورتحساب قبل از هر ارسال مجدد.