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

بازگشت

راهنمای کاربردی سامانه مؤدیان

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

اگر صورتحساب شما در سامانه مؤدیان پذیرفته نشده، معمولاً مشکل از یکی از چند بخش اصلی است: شماره مالیاتی، تاریخ صدور، شناسه کالا و خدمت، نرخ ارزش افزوده، اطلاعات خریدار، اطلاعات فروشنده، قرارداد، یا امضای بسته ارسالی. در این راهنما، پیام‌های استعلام مانند SUCCESS، FAILED، IN_PROGRESS، TIMEOUT و NOT_FOUND و خطاهای پرتکرار را ساده، دسته‌بندی‌شده و قابل فهم توضیح داده‌ایم.

پیام‌های استعلام لیست خطاها روش رفع خطا

خلاصه خیلی ساده

اگر وضعیت SUCCESS باشد، صورتحساب درج شده است. اگر FAILED باشد، صورتحساب خطا دارد. اگر IN_PROGRESS باشد، هنوز در صف بررسی است. اگر TIMEOUT یا NOT_FOUND باشد، باید وضعیت ارسال و شماره پیگیری دوباره بررسی شود.

بخش اول

پیام‌ها در استعلام صورتحساب سامانه مؤدیان

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

SUCCESS موفق

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

FAILED دارای خطا

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

IN_PROGRESS در حال پردازش

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

TIMEOUT اتمام زمان پردازش

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

NOT_FOUND یافت نشد

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

بخش دوم

انواع خطاهای رایج در رد صورتحساب سامانه مؤدیان

خطاهای سامانه مؤدیان معمولاً به چند گروه اصلی تقسیم می‌شوند. برای اینکه سریع‌تر مشکل را پیدا کنید، خطاها را در دسته‌های کاربردی مرتب کرده‌ایم.

خطاهای شماره مالیاتی و مرجع

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

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

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

معتبر نبودن تاریخ و زمان صدور صورتحساب از نظر قواعد.
مقدار فیلد «تاریخ و زمان صدور صورت‌حساب - میلادی» از لحاظ قواعد محاسباتی و منطقی معتبر نیست.

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

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

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

راهکار: نرخ مالیات، مبلغ قبل از مالیات، مبلغ مالیات، مبلغ کل و قواعد رندینگ را با نوع کالا یا خدمت تطبیق دهید.

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

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

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

خطاهای اطلاعات خریدار

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

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

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

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

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

خطاهای نوع، موضوع و الگوی صورتحساب

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

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

خطاهای قرارداد و امضای بسته

در مقدار فیلد «شناسه یکتا ثبت قرارداد فروشنده» الگو رعایت نشده است.
امضای بسته صحیح نیست.

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

بخش سوم

آموزش ساده رفع خطا در سامانه مؤدیان

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

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

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

فیلد مشکل‌دار را با اطلاعات سامانه تطبیق دهید

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

قواعد محاسباتی را دوباره بررسی کنید

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

اطلاعات پایه را اصلاح و دوباره ارسال کنید

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

چک‌لیست سریع

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

شماره مالیاتی صورتحساب و شماره مرجع درست است.

تاریخ و زمان صدور با قواعد سامانه هماهنگ است.

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

نرخ و مبلغ مالیات بر ارزش افزوده درست محاسبه شده است.

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

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

برای صورتحساب ارجاعی، شماره مرجع و ارتباط با صورتحساب اصلی صحیح است.

گواهی امضا و تنظیمات ارسال نرم‌افزار واسط مشکل ندارد.

نیاز به رفع سریع خطای سامانه مؤدیان دارید؟

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

مشاهده نرم‌افزار درسان