مستندات اتصال به nptak-tax

فعلاً درخواست صورتحساب یا اطلاعات محرمانه به این دامنه ارسال نکنید. نمونه‌های این صفحه برای بررسی قرارداد هستند.

هر نرم‌افزار حسابداری یک توکن مستقل دریافت می‌کند. توکن فقط به همان شریک و مجوزهای تأییدشدهٔ او تعلق دارد. شناسه پروفایل به‌تنهایی مجوز دسترسی ایجاد نمی‌کند.

Authorization: Bearer <partner-token>

یک مؤدی می‌تواند به چند نرم‌افزار حسابداری مجوز بدهد. پروفایل‌ها و دسترسی هر شریک مستقل می‌ماند؛ شماره‌گذاری حافظه مالیاتی میان نویسندگان مجاز باید هماهنگ باشد.

این بخش مستقیماً از فایل OpenAPI تولیدشدهٔ هسته خوانده می‌شود و فقط مسیرهای پیاده‌سازی‌شده را نشان می‌دهد. نمایش یک مسیر در قرارداد به معنی فعال بودن آن روی این دامنه نیست.

https://tax.didis.ir/api/v1

قرارداد نهایی ارسال پس از تکمیل صف پایدار و تطبیق قواعد هر الگو منتشر می‌شود. نمونه زیر فقط شکل کلی تبادل را توضیح می‌دهد و یک صورتحساب معتبر مالیاتی نیست.

1. انتخاب پروفایل مؤدیاطلاعات ثابت از پروفایل و نسخه مشخص آن خوانده می‌شود.
2. دریافت رسید داخلیپس از ذخیره پایدار، شناسه دسته و درخواست‌های آن بازگردانده می‌شود.
3. پردازش در صفسامانه اعتبارسنجی، ارسال و استعلام را با محدودیت منابع و مجوزها انجام می‌دهد.
4. پیگیری وضعیتنرم‌افزار نتیجه ثبت‌شدهٔ هر درخواست را با شناسه داخلی دریافت می‌کند.

POST /api/v1/submissions
Idempotency-Key: erp-example-001

{
  "profile_id": "prf_example",
  "documents": [
    {
      "external_id": "sale-example",
      "operation": "original",
      "invoice": { "…": "…" }
    }
  ]
}

HTTP/1.1 202 Accepted

{
  "submission_id": "sub_example",
  "profile_id": "prf_example",
  "profile_revision_id": "prv_example",
  "items": [
    {
      "request_id": "req_example",
      "state": "queued"
    }
  ]
}

رسید 202 یعنی درخواست در سامانه ما به‌طور پایدار پذیرفته شده است. تأیید ثبت در سامانه مؤدیان، وضعیت جداگانه‌ای است.

اصل، اصلاح، ابطال و برگشت از فروش در دامنه محصول قرار دارند. عملیات اصلاحی یک سند مرتبط جدید می‌سازد؛ اطلاعات صورتحساب ثبت‌شده در جای خود بازنویسی نمی‌شود.

کدهای ماشینی انگلیسی و توضیحات کاربر فارسی هستند. شناسه همبستگی پاسخ برای پیگیری خطا استفاده می‌شود. قطع ارتباط به‌تنهایی ثابت نمی‌کند که ارسال به مؤدیان انجام نشده؛ بازیابی نتیجه پیش از تصمیم به ارسال مجدد لازم است.

مبالغ و تعدادها در قرارداد مالی به‌صورت رشتهٔ ده‌دهی با واحد صریح مشخص می‌شوند؛ زمان API با UTC و پسوند Z ارائه می‌شود. نمایش تاریخ شمسی و منطقه زمانی تهران در رابط فارسی انجام خواهد شد.

زمان فعال‌سازی پذیرش واقعی با عبور از آزمون‌های یکپارچگی، بازیابی و تطبیق مشخص می‌شود. تاریخ قطعی برای این مرحله هنوز اعلام نشده است.