راهنمای جامع اتصال به سامانه مودیان از طریق شرکت معتمد کیسان در وبیتو
اجرای قانون پایانههای فروشگاهی و سامانه مودیان مالیاتی، بزرگترین تحول نظام مالیاتی ایران در دهه اخیر است. بر اساس این قانون، تمامی شرکتها، کسبوکارهای ثبتشده و صاحبان فروشگاههای اینترنتی موظفاند فاکتورهای فروش خود را با فرمت استاندارد و حاوی شماره منحصربهفرد مالیاتی ۲۲ رقمی (TaxID) به سرورهای سازمان امور مالیاتی کشور (tp.tax.gov.ir) ارسال نمایند؛ در غیر این صورت، با جریمه عدم صدور صورتحساب (۱۰ درصد مبلغ فروش بدون بخشودگی) و محرومیت از معافیتهای مالیاتی مواجه خواهند شد.
به دلیل پیچیدگیهای فنی سرسامآور اتصال مستقیم (الزام به تهیه توکن سختافزاری امضای دیجیتال، تولید گواهی CSR، کلید خصوصی نامتقارن RSA، رمزنگاری AES بستهها و قطعیهای مکرر سرورهای دارایی)، سازمان امور مالیاتی شرکتهای معتمد ارائهدهنده خدمات مالیاتی (TSP - نوع اول) را به عنوان بازوی رسمی معرفی کرده است.
شرکت دادهپردازی کیسان (keysuntsp.com) معتبرترین و باثباتترین شرکت معتمد نوع اول در ایران است. پلاگین رسمی وبیتو، کلیه فاکتورهای فروش را بدون نیاز به کلید خصوصی یا توکن، با امضای رسمی کیسان به سامانه مودیان مخابره میکند.
۱. مقایسه: ارسال مستقیم به دارایی در برابر ارسال از طریق معتمد کیسان
| ویژگی و چالشها | ارسال مستقیم به سامانه مودیان | ارسال از طریق شرکت معتمد کیسان در وبیتو |
|---|---|---|
| نیاز به توکن سختافزاری یا کلید خصوصی RSA | الزامی و دارای هزینه بالا | بینیاز (امضا با مهر سازمانی معتمد کیسان) |
| تولید شماره مالیاتی ۲۲ رقمی با الگوریتم ورهوف | کدنویسی پیچیده ریاضی توسط پذیرنده | محاسبه و تولید خودکار ۱۰۰٪ در وبیتو |
| مدیریت قطعیهای مداوم سرورهای مالیاتی | شکست فاکتور و نیاز به ایجاد صفهای سنگین | صفبندی خودکار و تلاش مجدد توسط کیسان |
| پیگیری و رفع خطاهای فاکتور | رد نامشخص با کدهای خطای پیچیده دارایی | ارائه توضیحات دقیق فارسی علت رد فاکتور |
| پشتیبانی فنی و تلفنی | بدون پشتیبانی اختصاصی دارایی | پشتیبانی تلفنی و سازمانی کیسان (۰۲۱۹۱۰۰۹۶۱۰) |
۲. ساختار و فرمول شماره ۲۲ رقمی مالیاتی (TaxID)
یکی از افتخارات فنی ماژول وبیتو، پیادهسازی دقیق الگوریتم رسمی سازمان مالیاتی در کلاس moadian-tax-id.util.ts است:
$$\text{TaxID (۲۲ رقم)} = \underbrace{\text{A12BC3}}{\text{شناسه حافظه (۶)}} + \underbrace{\text{20716}}{\text{روز ژولینی (۵)}} + \underbrace{\text{0000000101}}{\text{سریال فاکتور (۱۰)}} + \underbrace{\text{5}}{\text{چکسام ورهوف (۱)}}$$
- شناسه حافظه مالیاتی (۶ کاراکتر): کد الفبانومریک اختصاصی که در کارپوشه سازمان مالیاتی به شما داده میشود.
- روز ژولینی (۵ رقم): تعداد روزهای سپریشده از مبدا تقویم ژولینی تا روز صدور فاکتور.
- شماره سریال داخلی صورتحساب (۱۰ رقم): شماره ترتیبی فاکتور که برای هر فاکتور متمایز است.
- رقم کنترلی الگوریتم ورهوف (۱ رقم): بر اساس محاسبات گروه دووجهی تعویض $D_5$ برای جلوگیری از هرگونه جعل یا اشتباه تایپی در بارکد مالیاتی.
۳. تفاوت الگوی اول (B2B) و الگوی دوم (B2C) در وبیتو
- صورتحساب نوع اول (الگوی فروش تجاری B2B):
- مناسب برای فروش به شرکتها، اشخاص حقوقی و همکاران تجاری.
- نیازمند ثبت کامل مشخصات خریدار: شناسه ملی/کد اقتصادی (
tinb)، کدپستی ۱۰ رقمی (bpc) و نام شرکت. - خریدار میتواند ارزش افزوده پرداختی را در کارپوشه خود به عنوان اعتبار مالیاتی منظور کند.
- صورتحساب نوع دوم (فروش به مصرفکننده نهایی B2C):
- مناسب برای فروشگاههای اینترنتی خردهفروشی عمومی.
- نیازی به ثبت کدپستی یا کداقتصادی خریدار نیست.
۴. مراحل دریافت و اتصال درگاه کیسان
- وارد کارپوشه ملی خود در
my.tax.gov.irشوید. - به بخش عضویت در سامانه مودیان و پایانههای فروشگاهی بروید.
- در تب شرکتهای معتمد، گزینه ارسال توسط شرکتهای معتمد با کلید معتمد را تایید و شرکت دادهپردازی کیسان را برگزینید.
- شناسه یکتای حافظه مالیاتی ۶ رقمی را از کارپوشه کپی کنید.
- به وبسایت کیسان (
keysuntsp.com) رفته، ثبتنام کنید و کلید اختصاصی API Key را دریافت نمایید. - وارد پنل وبیتو > پلاگینها > Moadian Kaysan شده و تنظیمات را وارد و ذخیره کنید:
| فیلد تنظیم در وبیتو | توضیحات | نمونه مقدار |
|---|---|---|
| Kaysan API Key | کلید امنیتی وبسرویس کیسان | kys_live_apikey_9988 |
| Fiscal Memory ID | شناسه ۶ کاراکتری حافظه مالیاتی صادرشده از دارایی | A12BC3 |
| Seller Economic Code | شناسه ملی یا کد اقتصادی ۱۱ یا ۱۴ رقمی فروشگاه | 14001234567 |
| Default Invoice Pattern | الگوی ۱ (فروش B2B) یا ۲ (مصرفکننده نهایی B2C) | 2 |
| Default Commodity Code | شناسه عمومی ۱۳ رقمی کالا و خدمت در دارایی | 2720000114913 |
۵. جدول کدهای خطای رایج سامانه مودیان و نحوه رفع آنها
| پیام خطای بازگشتی | علت خطا | نحوه رفع در وبیتو |
|---|---|---|
شناسه کالا/خدمت نامعتبر است | کد ۱۳ رقمی کالا در سامانه stuffid.tax.gov.ir تعریف نشده است | شناسه عمومی معتبر 2720000114913 را در تنظیمات وارد کنید. |
کد پستی خریدار با آدرس ثبتشده مغایرت دارد | کدپستی ثبتشده در فاکتور نوع اول در پایگاه پست یافت نشد | اطلاعات آدرس و کدپستی مشتری را در جزئیات فاکتور تصحیح کنید. |
مبلغ مالیات ارزش افزوده با نرخ مغایرت دارد | مغایرت در مبالغ ریالی ارزش افزوده ۱۰٪ | وبیتو به صورت اتوماتیک مبلغ را با دقت ریالی گرد میکند. |
شماره منحصربهفرد مالیاتی تکراری است | فاکتوری با همین شماره قبلاً در کارپوشه ثبت شده است | شماره سریال فاکتور باید افزایشی باشد که وبیتو آن را مدیریت میکند. |
۶. پرسشهای متداول (FAQ)
س: آیا فروشگاههای با فروش کم هم ملزم به ارسال فاکتور به سامانه مودیان هستند؟
ج: بله؛ طبق فراخوانهای قانونی سازمان امور مالیاتی، کلیه اشخاص حقوقی و همچنین اشخاص حقیقی که مجموع فروش سالانه آنها از حد نصاب ماده ۱۴ مکرر عبور کند، موظف به صدور صورتحساب الکترونیکی هستند.
س: در صورت ابطال یا مرجوعی کالا توسط خریدار چه اتفاقی میافتد؟
ج: وبیتو به صورت اتوماتیک با فراخوانی متد صورتحساب ابطالی (ins: 3) با ارجاع به TaxID فاکتور اولیه، صورتحساب ابطالی را به کیسان ارسال کرده و بدهی ارزش افزوده آن فاکتور در کارپوشه شما کسر میگردد.