سامانه مودیان

اگر فاکتورهای فروش را در مباشر ثبت می‌کنید، می‌توانید آن‌ها را از همین‌جا به سامانهٔ مودیان سازمان امور مالیاتی بفرستید و نتیجه را در ردیف فاکتور ببینید.

پیش‌نیازها#

شناسهٔ یکتای حافظهٔ مالیاتی
کد اقتصادی فروشنده
کلید خصوصی و گواهی امضا
جدول فاکتور و (در صورت وجود) جدول اقلام فاکتور

چطور کار می‌کند؟#

اتصال (برای هر پروژه): شناسهٔ حافظه، کد اقتصادی، کلید و گواهی، آدرس API و نگاشت فیلدهای جدول‌ها به مدل فاکتور را ذخیره می‌کنید. کلید خصوصی رمزنگاری می‌شود و هرگز بازگردانده نمی‌شود.
ارسال: فاکتور و اقلام پیوندی آن با مجوزهای خودتان خوانده، به مدل مودیان تبدیل، جمع و مالیات محاسبه، شماره منحصر به فرد مالیاتی ساخته، امضا و رمزنگاری و ارسال می‌شود.
نتیجه: وضعیت، شماره منحصر به فرد، شمارهٔ ارجاع و خطاها در فیلدهای نگاشت‌شده نوشته می‌شود و هر تلاش با جزئیات در گزارش ارسال‌ها می‌ماند.

وضعیت‌ها#

وضعیت	نمایش در فیلد	معنی
`SENT`	در انتظار تایید	ارسال شد، نتیجهٔ نهایی هنوز نیامده
`SUCCESS`	تایید شده	پذیرفته شد
`FAILED`	رد شده	سازمان مالیاتی رد کرد
`ERROR`	خطا در ارسال	ارسال نشد (شبکه، احراز هویت…)

برای فاکتورهای «در انتظار تایید» عمل بروزرسانی نتیجه را از سازمان مالیاتی می‌گیرد.

API#

همه‌چیز زیر /api/base/:baseId/moadian است و توکن شخصی کار می‌کند (توکن شخصی و OAuth).

روش	مسیر	کار
GET	`status`	آیا فعال و متصل است؟
GET / PUT / DELETE	`connection`	خواندن / ذخیره / حذف اتصال
POST	`connection/test`	آزمون اتصال و دریافت اطلاعات مالی
POST	`submit`	ارسال فاکتورها (`tableId`, `recordIds` تا ۵۰ مورد، به‌ترتیب)
GET	`submission`	گزارش ارسال‌ها
POST	`submission/refresh`	دریافت نتیجه

نمونهٔ بدنهٔ ذخیرهٔ اتصال:

{
  "memoryId": "A1B2C3",
  "baseUrl": "https://tp.tax.gov.ir/requestsmanager/api/v2/",
  "sellerTin": "14003778990",
  "privateKey": "-----BEGIN PRIVATE KEY-----…",
  "certificate": "-----BEGIN CERTIFICATE-----…",
  "mapping": { "currency": "IRT", "itemsTableId": "tblItems", "itemsLinkField": "اقلام" }
}