Developer Reference
مستندات فنی API مودیان
راهنمای کامل پیادهسازی اتصال به سامانه مودیان مطابق سند رسمی سازمان امور مالیاتی
شناسه یکتای مالیاتی
fiscalId(6) + serial(10) + date(6)۲۲ کاراکتر - سریال hex و تاریخ شمسی
رمزگذاری
AES-256-GCM + RSA-OAEPکلید ۳۲ بایت، IV ۱۲ بایت
امضای دیجیتال
RSA-SHA256 + Normalizeنرمالسازی JSON قبل از امضا
اعتبارسنجی
Verhoeff Check Digitکد اقتصادی و شناسه ملی
API Endpoints
Base URL (Production):https://tp.tax.gov.ir/req/api/self-tsp
POST
/sync/GET_TOKENدریافت توکن احراز هویتهمگامPOST
/sync/SEND_INVOICEارسال صورتحسابغیرهمگامGET
/sync/INQUIRY_BY_UID/{uid}استعلام با شناسه بستههمگامGET
/sync/INQUIRY_BY_REFERENCE_NUMBER/{ref}استعلام با شماره مرجعهمگامGET
/sync/GET_SERVER_INFORMATIONاطلاعات و کلیدهای سرورهمگامGET
/sync/GET_SERVICE_STUFF_LISTلیست کالا و خدماتهمگامساختار JSON صورتحساب
Header (سرصورتحساب)
taxidstring(22)
indatimnumber (Unix ms)
inty1 | 2 | 3
inp1 | 2 | 3 | 4
tinsstring (کد اقتصادی)
tbillnumber (جمع کل)
Body (اقلام)
sstidstring(13)
ssttstring (شرح)
amnumber (تعداد)
feenumber (قیمت واحد)
vranumber (نرخ مالیات)
tsstamnumber (جمع قلم)
فرمولهای محاسبه
prdis = fee × am
adis = prdis - dis
vam = adis × vra / 100
tbill = tadis + tvam
دستهبندی کدهای خطا
00XXXعمومی/سیستمی
00600امضای دیجیتال
01XXXXXصورتحساب
03XXXXXکالا/خدمت
04XXXXXمالیات
05XXXXXمحاسبات
06XXXXXارجاع
قابلیتهای پیادهسازی شده در بارکد
رمزنگاری AES-256-GCM
مطابق استاندارد رسمی
امضای RSA-SHA256
با نرمالسازی JSON
تولید خودکار taxid
۲۲ کاراکتر یکتا
الگوریتم Verhoeff
اعتبارسنجی کدها
مدیریت سریال
با دیتابیس
تولید QR Code
برای استعلام
اعتبارسنجی کامل
قبل از ارسال
همه انواع فاکتور
نوع ۱، ۲، ۳
ابطال و اصلاح
الگوهای ۲، ۳، ۴
نیازی به پیادهسازی دستی نیست!
بارکد تمام این پیچیدگیها را برای شما انجام میدهد. فقط گواهی دیجیتال خود را وارد کنید.
شروع رایگان