بخش ایجنت ام سی پی به استور فرانت اضافه شداطلاعات بیشتر ←

راهنمای جامع اتصال به سامانه مودیان مالیاتی از طریق شرکت معتمد کیسان در وبیتو

۲۹ شهریور ۱۴۰۵


راهنمای جامع اتصال به سامانه مودیان از طریق شرکت معتمد کیسان در وبیتو

اجرای قانون پایانه‌های فروشگاهی و سامانه مودیان مالیاتی، بزرگ‌ترین تحول نظام مالیاتی ایران در دهه اخیر است. بر اساس این قانون، تمامی شرکت‌ها، کسب‌وکارهای ثبت‌شده و صاحبان فروشگاه‌های اینترنتی موظف‌اند فاکتورهای فروش خود را با فرمت استاندارد و حاوی شماره منحصر‌به‌فرد مالیاتی ۲۲ رقمی (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{چک‌سام ورهوف (۱)}}$$

  1. شناسه حافظه مالیاتی (۶ کاراکتر): کد الفبانومریک اختصاصی که در کارپوشه سازمان مالیاتی به شما داده می‌شود.
  2. روز ژولینی (۵ رقم): تعداد روزهای سپری‌شده از مبدا تقویم ژولینی تا روز صدور فاکتور.
  3. شماره سریال داخلی صورتحساب (۱۰ رقم): شماره ترتیبی فاکتور که برای هر فاکتور متمایز است.
  4. رقم کنترلی الگوریتم ورهوف (۱ رقم): بر اساس محاسبات گروه دووجهی تعویض $D_5$ برای جلوگیری از هرگونه جعل یا اشتباه تایپی در بارکد مالیاتی.

۳. تفاوت الگوی اول (B2B) و الگوی دوم (B2C) در وبیتو

  • صورتحساب نوع اول (الگوی فروش تجاری B2B):
    • مناسب برای فروش به شرکت‌ها، اشخاص حقوقی و همکاران تجاری.
    • نیازمند ثبت کامل مشخصات خریدار: شناسه ملی/کد اقتصادی (tinb)، کدپستی ۱۰ رقمی (bpc) و نام شرکت.
    • خریدار می‌تواند ارزش افزوده پرداختی را در کارپوشه خود به عنوان اعتبار مالیاتی منظور کند.
  • صورتحساب نوع دوم (فروش به مصرف‌کننده نهایی B2C):
    • مناسب برای فروشگاه‌های اینترنتی خرده‌فروشی عمومی.
    • نیازی به ثبت کدپستی یا کداقتصادی خریدار نیست.

۴. مراحل دریافت و اتصال درگاه کیسان

  1. وارد کارپوشه ملی خود در my.tax.gov.ir شوید.
  2. به بخش عضویت در سامانه مودیان و پایانه‌های فروشگاهی بروید.
  3. در تب شرکت‌های معتمد، گزینه ارسال توسط شرکت‌های معتمد با کلید معتمد را تایید و شرکت داده‌پردازی کیسان را برگزینید.
  4. شناسه یکتای حافظه مالیاتی ۶ رقمی را از کارپوشه کپی کنید.
  5. به وب‌سایت کیسان (keysuntsp.com) رفته، ثبت‌نام کنید و کلید اختصاصی API Key را دریافت نمایید.
  6. وارد پنل وبیتو > پلاگین‌ها > 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 فاکتور اولیه، صورتحساب ابطالی را به کیسان ارسال کرده و بدهی ارزش افزوده آن فاکتور در کارپوشه شما کسر می‌گردد.