سامانه مودیان از ابتدای اجرای کامل قانون پایانههای فروشگاهی و سامانه مودیان، مهمترین زیرساخت مالیاتی ایران شده است؛ بهگونهای که امروز صدور صورتحساب الکترونیکی دیگر یک انتخاب نیست، بلکه الزام قانونی اکثر کسبوکارهاست. اما تجربه نشان داده صاحبان کسبوکار برای درک دقیق «صورتحساب الکترونیکی مودیان چه شکلی دارد؟»، «از چه فیلدهایی تشکیل میشود؟» و «چرخهٔ ارسال و تأیید آن چگونه است؟» معمولاً باید بین اسناد پراکنده، راهنماهای PDF و دفاتر آموزشی جابهجا شوند. ما در افق پلاس تصمیم گرفتیم همین تجربه را در قالب یک آزمایشگاه زنده و رایگان در اختیار شما بگذاریم: در همین صفحه فرم صورتحساب را پر میکنید، nonce واقعی میگیرید، پکت را به شبیهساز سامانه مودیان ارسال میکنید و چرخهٔ کامل وضعیت (در صف پردازش، در حال پردازش، تأییدشده) را با شمارهٔ ارجاع واقعی دنبال میکنید — بدون ثبتنام و بدون هزینه.
صورتحساب الکترونیکی مودیان چیست و چه تفاوتی با فاکتور کاغذی دارد؟
صورتحساب الکترونیکی سندی ساختاریافته است که مستقیماً از نرمافزار حسابداری شما به سامانه مودیان سازمان امور مالیاتی ارسال میشود. تفاوت اصلی با فاکتور سنتی در سه چیز است:
- ساختار استاندارد: فیلدها (شناسهٔ فروشنده، خریدار، اقلام، مالیات و…) دقیقاً طبق قالب تعریفشدهٔ سازمان باید پر شوند؛ متن آزاد جایگزین فیلد نمیشود.
- امضا و رمزنگاری: پکتِ ارسالی با امضای دیجیتال (RSA) و رمزنگاری JWE محافظت میشود تا دستکاری آن در مسیر ناممکن باشد.
- تأیید مرکزی: سازمان پکت را دریافت، اعتبارسنجی و تأیید میکند و شناسهٔ ارجاع صادر میکند؛ همان چیزی که مشتری شما میتواند برای اعتبار فاکتور استعلام کند.
نکتهٔ مهم برای حسابداران این است که صورتحساب الکترونیکی «پایانهی ثبت» است، نه جایگزین کامل اسناد داخلی؛ شما همچنان سند حسابداری خود را در دفتر کل ثبت میکنید و صورتحساب مودیان بهعنوان مدرک رسمی فروش به آن متصل میشود.
ساختار فنی پکت صورتحساب: چه چیزی ارسال میشود؟
هر صورتحساب بهصورت یک «پکت» ارسال میشود که دو بخش دارد:
| بخش | فیلدهای کلیدی | توضیح |
|---|---|---|
| header | requestTraceId، fiscalId، taxId | شناسهٔ یکتای درخواست شما و شناسهٔ مالیاتی مودی ارسالکننده |
| payload | header داخلی (inno، intyp، indati2m) | شمارهٔ صورتحساب، نوع (۱ تا ۱۳) و تاریخ میلادی |
| payload | seller / buyer | شناسهٔ ملی یا شناسهٔ مالیاتی طرفین + نام |
| payload | goods[] | اقلام: شرح، تعداد، مبلغ واحد، Discounts، اجزای مالیات (VAT) |
| payload | payments | روش تسویه (نقد/اعتباری/چک) و اطلاعات هرکدام |
دو نکته که بیشترین خطا را در ارسالهای واقعی ایجاد میکند: inno (شمارهٔ صورتحساب) باید در طول سال مالی یکتا باشد و شناسههای ۱۱ رقمی باید دقیقاً ۱۱ رقم عددی باشند — نه کمتر، نه بیشتر، و بدون کاراکتر اضافه. در آزمایشگاه همین صفحه میتوانید هر دو قاعده را عمداً بشکنید و پاسخ خطای سامانه را ببینید.
انواع صورتحساب الکترونیکی (intyp): از نوع ۱ تا نوع ۱۳
فیلد intyp نوع صورتحساب را مشخص میکند. پرکاربردترین انواع برای کسبوکارهای معمولی:
- نوع ۱ — صورتحساب فروش: رایجترین نوع؛ فروش کالا یا خدمت به مشتری.
- نوع ۲ — صورتحساب خرید: ثبت خرید از تأمینکننده؛ برای مشمولان خاص الزامی است.
- نوع ۳ و ۴ — برگشت از فروش و برگشت از خرید: اصلاح معاملات قبلی (مرجوعی).
انواع ۵ به بعد برای سناریوهای خاص (صادرات، پیمانکاری و…) تعریف شدهاند. قانون طلایی این است که نوع صورتحساب باید با ماهیت واقعی تراکنش همخوان باشد؛ استفادهٔ نادرست از intyp یکی از دلایل رد پکتها در اعتبارسنجی است.
چرخهٔ کامل ارسال: nonce، امضا، ارسال و استعلام
فرآیند ارسال صورتحساب در نسخهٔ ۲ سامانه مودیان چهار مرحله دارد که در ابزار این صفحه عملاً همه را لمس میکنید:
- دریافت nonce: یک رمز یکبارمصرف با عمر محدود (معمولاً چند دقیقه) از سامانه میگیرید. nonce همان مکانیزم ضد replay است؛ اگر پکت با nonce مصرفشده ارسال شود، درخواست رد میشود.
- ساخت و رمزنگاری پکت: صورتحساب با کلید عمومی سازمان رمزنگاری (JWE) و با کلید خصوصی شما امضا (JWS) میشود.
- ارسال و دریافت referenceNumber: سازمان پکت را میگیرد و بلافاصله شمارهٔ ارجاع میدهد — این یعنی «دریافت شد»، نه «تأیید شد».
- استعلام نتیجه: پردازش واقعی asynchronous است؛ با uid پکت استعلام میگیرید تا وضعیت به SUCCESS (تأیید با شناسهٔ تأیید) یا FAILED (با کد خطا) برسد.
در ابزار این صفحه، مراحل ۱، ۳ و ۴ کاملاً واقعی و متصل به شبیهساز مودیان هستند و مرحلهٔ ۲ (رمزنگاری سنگین RSA) برای سبکماندن ابزار عمومی، در سمت سرویس انجام میشود — در محصول اصلی افق پلاس، همهٔ مراحل با استاندارد کامل سازمان اجرا میشود.
خطاهای رایج ارسال صورتحساب و معنی کدها
شبیهساز همین صفحه خطاهای رسمیشکل سازمان را برمیگرداند؛ اینها همان چیزهایی هستند که در محیط واقعی هم خواهید دید:
| کد | معنی | راهحل معمول |
|---|---|---|
| 4101 / 4102 | nonce موجود نیست یا منقضی شده | nonce تازه بگیرید و فاصلهٔ ارسال را کم کنید |
| 4130 | توکن احراز هویت نامعتبر | توکن کارپوشه (امضای گواهی) را تازه کنید |
| 4144 / 4145 | بدنهٔ درخواست خالی یا فیلدهای نامعتبر | ساختار پکت و قواعد فیلدها را بازبینی کنید |
| 04152 | رمزگشایی JWE ناموفق | کلید عمومی سازمان را از server-information تازه بگیرید |
| 4141 / 4143 | تعداد اقلام/پکتهای بیش از حد مجاز | ارسال را به بچهای کوچکتر بشکنید |
نکتهٔ عملی برای حسابداران: قبل از نگرانی از کد خطا، همیشه اول «زنجیرهٔ nonce → ارسال → استعلام» را چک کنید؛ بیش از نیمی از «خطاهای بزرگ» صرفاً nonce منقضیشده یا استعلامِ قبل از اتمام پردازش async هستند.
اعتبارسنجی مالیاتی: چرا «تأیید» از «دریافت» مهمتر است؟
بسیاری از نرمافزارها فقط به referenceNumber بسنده میکنند و استعلام نتیجه را به عهدهٔ کاربر میگذارند. اما در عمل، صورتحساب شما ممکن است «دریافت» شود و چند ساعت بعد بهدلیل مغایرت (مثلاً شناسهٔ خریدار نامعتبر یا مبلغ مالیات نادرست) FAILED شود. رویکرد درست:
- استعلام خودکار و دورهای وضعیت همهٔ پکتهای در انتظار؛
- هشدار به کاربر در صورت FAILED شدن با نمایش دقیق کد و پیام خطا؛
- امکان اصلاح و ارسال مجدد (یا صدور برگشت) از همان جریان کار.
در افق پلاس این چرخه کاملاً خودکار است: پس از ثبت فاکتور، پکت ساخته و ارسال میشود، استعلام تا رسیدن به نتیجهٔ نهایی ادامه دارد و در داشبورد «سامانه مودیان» وضعیت هر صورتحساب با رنگ قابلفهم (سبز/زرد/قرمز) نمایش داده میشود.
نقشهٔ راه مودیان برای مشاغل: از اتصال تا گزارش
اگر تازه با سامانه مودیان آشنا شدهاید، مسیر استاندارد به این ترتیب است:
- پذیرش و دریافت شناسهٔ مالیاتی: ثبتنام در سامانه و دریافت شناسههای لازم.
- آمادهسازی اطلاعات پایه: پاکسازی کد کالا/خدمات، شناسهٔ طرفحسابها و نرخهای مالیات.
- اتصال نرمافزار: اتصال نرمافزار حسابداری به محیط آزمایشی (TEST) و تست چند صورتحساب.
- رفع مغایرتها: تطبیق شناسهها و اطلاعات با دادههای سامانه.
- تولید انبوه: فعالسازی صدور خودکار برای همهٔ فاکتورهای فروش.
- پایش مستمر: استعلام دورهای و مدیریت خطاها + اتصال به صورتوضعیت و گزارشهای پایانه.
مرحلهٔ ۳ همان جایی است که ابزار رایگان این صفحه برای شما ارزش مستقیم دارد: قبل از هر سرمایهگذاری، تجربهٔ عملی چرخهٔ ارسال را بهدست آورید.
مقایسهٔ ارسال دستی و خودکار صورتحساب
| معیار | ارسال دستی/پرتال | خودکار با نرمافزار یکپارچه |
|---|---|---|
| زمان ثبت هر فاکتور | ۵ تا ۱۵ دقیقه | چند ثانیه (خودکار پس از ثبت فروش) |
| خطای انسانی | بالا — کپی/پیست دستی | حداقل — اعتبارسنجی قبل از ارسال |
| پیگیری وضعیت | ورود دستی به پرتال | استعلام خودکار + هشدار در داشبورد |
| مغایرتگیری فروش | دورهای و وقتگیر | لحظهای روی هر صورتحساب |
| مقیاسپذیری (۱۰۰+ فاکتور روزانه) | عملاً غیرممکن | بدون محدودیت عملیاتی |
برای کسبوکاری که روزانه دهها فاکتور صادر میکند، اختلاف زمانی فوق در پایان ماه به چند روزِ کاری قابلتوجه تبدیل میشود — بدون احتساب هزینهٔ خطاها و جریمهٔ مغایرتها.
نقش هوش مصنوعی در کیفیت صورتحسابهای ارسالی
ارسال انبوه فقط وقتی ارزش دارد که کیفیت دادهها بالا باشد. افق پلاس در چند نقطه از این زنجیره هوشمندی اضافه میکند: تشخیص خودکار کد کالا/خدمت از روی شرح فارسی، هشدار پیش از ارسال برای اقلام بدون شناسهٔ معتبر، پیشنهاد نرخ صحیح مالیات بر اساس نوع کالا و طرف معامله، و آشکارسازی الگوهای مشکوک (مثلاً فاکتورهای تکراری با مبالغ مشابه) که احتمال رد شدن دستهای را بالا میبرد. این لایهٔ افق پلاس یعنی پکت شما بار اول و نه بار سوم تأیید میشود.
امنیت و محرمانگی در ارسال صورتحساب
پکت صورتحساب دادههای تجاری حساس شماست. استاندارد سازمان (TLS در ترابرد + JWE در محتوا + JWS در اصالت) بهدرستی طراحی شده، اما مسئولیت بخش دیگر با نرمافزار شماست: نگهداری امن کلیدها، عدم ثبت محتوای رمزشده در لاگها، و جداسازی محیط آزمایشی از واقعی. افق پلاس کلیدهای مودیان را رمزنگاریشده نگه میدارد، محیط TEST/PROD را کاملاً جدا مدیریت میکند و تمام رویدادهای ارسال/استعلام را در Audit-Log تغییرناپذیر ثبت میکند تا هم trace کامل داشته باشید و هم برای ممیزی آماده باشید.
از آزمایشگاه تا واقعیت: قدم بعدی شما
اگر با ابزار این صفحه چرخهٔ ارسال را درک کردید، قدم منطقی بعدی دیدن همین فرآیند «درون» نرمافزار واقعی است. تریال ۷ روزهٔ افق پلاس بدون نیاز به کارت بانکی فعال میشود؛ ۱۶ ماژول کامل (حسابداری، انبار، خزانهداری، مودیان، حقوق و…) در اختیار شماست و میتوانید صورتحسابهای واقعی خود را به محیط آزمایشی سامانه مودیان ارسال کنید، مغایرتگیری را ببینید و گزارشهای نهایی را چک کنید. اگر نمایندهٔ حسابداری هستید، همین ابزار بهترین دمو برای مشتریان شماست: نمایش چرخهٔ ارسال در ۲ دقیقه، بدون نصب چیزی.