API استعلام پرونده مالیاتی
پرونده‌های مالیاتی یک شخص یا شرکت را با کد ملی یا شناسهٔ ملی برمی‌گرداند: نام پرونده، کد اقتصادی، وضعیت و مرحلهٔ ثبتنام.
این سرویس چه میکند
استعلام پرونده مالیاتی یک شمارش و یک فهرست برمی‌گرداند. count تعداد پرونده‌هاست و هر ردیف tax_records چهار چیز دارد: نام پرونده، کد اقتصادی، وضعیت ثبتنام و مرحلهٔ ثبتنام. ورودی یک فیلد است، nationalCode، که هم کد ملی دهرقمی شخص را می‌پذیرد و هم شناسهٔ ملی یازدهرقمی شرکت را.
پرکاربردترین خروجی آن کد اقتصادی است. نرم‌افزار حسابداری یا فروشی که برای خریدار حقوقی صورت‌حساب صادر میکند، کد اقتصادی او را لازم دارد، و پرسیدنش از مشتری هم کند است و هم پر از غلط تایپی. یک فراخوان با شناسهٔ ملی، همان را از پرونده می‌آورد.
یک شناسه، چند پرونده
یک کد ملی ممکن است بیش از یک پرونده داشته باشد و هر پرونده نام، کد اقتصادی و وضعیت خودش را دارد. اگر محصول شما فقط یک کد اقتصادی برای هر مشتری نگه می‌دارد، انتخاب میان ردیف‌ها را به کاربر بسپارید، نه به ترتیب آرایه.
آنچه این استعلام نمی‌کند
بدهی مالیاتی، مبلغ مالیات، اظهارنامه‌ها و سابقهٔ پرداخت در پاسخ نیستند. وضعیت ثبت‌نامِ تکمیل‌شده یعنی پرونده تشکیل شده است، نه اینکه مؤدی بدهی ندارد یا اظهارنامه‌اش را به‌موقع داده است.
نکته پیاده‌سازی
وقتی پرونده‌ای ثبت نیست، count صفر است و tax_records در پاسخ نمی‌آید. این جواب معتبر و دارای هزینه است، نه شکست فراخوان. برای تأمین‌کننده‌ای که می‌گوید با کد اقتصادی صورت‌حساب صادر میکند، همین صفر خودش یک یافته است.
economic_code را رشته نگه دارید، نه عدد؛ تبدیل به عدد، صفرهای ابتدایی احتمالی را از بین می‌برد.
کجا به کار می‌آید
- تکمیل خودکار کد اقتصادی در صدور صورت‌حسابفروشنده شناسهٔ ملی خریدار را وارد میکند و کد اقتصادی از پرونده پر میشود، بی تایپ و بی غلط.
- بررسی تأمین‌کننده پیش از قرارداد خریدپیش از اولین سفارش، وضعیت ثبتنام مالیاتی تأمین‌کننده دیده میشود، نه وقتی صورت‌حسابش رد شد.
- پذیرش فروشنده در بازارگاه بین‌کسب‌وکاریفروشنده‌ای که پروندهٔ مالیاتی ندارد، پیش از فعال‌شدن فروشگاه به تکمیل ثبتنام راهنمایی میشود.
ورودی و خروجی
ورودی
nationalCodestringکد ملی یا شناسهٔ ملیشخص حقیقی: کد ملی دهرقمی. شخص حقوقی: شناسهٔ ملی یازدهرقمی شرکت.نمونهٔ بدنهٔ درخواست
{
"nationalCode": "0013542419"
}قیمت و شرط پرداخت
هر فراخوان ۴٬۳۰۰ تومان
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
- ثبتنام در احرازینو و ساخت حساب کسب‌وکار رایگان است و همهٔ مبلغ شارژ صرف استعلام‌های خودتان میشود.
- استعلام زیادی دارید؟ برای تخفیف و تعرفهٔ اختصاصی با پشتیبانی در تماس باشید.
- می‌خواهید پیش از شارژ آزمایش کنید؟ درخواست شارژ آزمایشی ثبت کنید تا برایتان اضافه کنیم.
پرسش‌های متداول
بدهی مالیاتی را هم نشان میدهد؟
نه. فقط پروندهها، کد اقتصادی و وضعیت و مرحلهٔ ثبتنام برمیگردد.
برای شخص حقیقی هم کار میکند؟
بله. کد ملی دهرقمی را در همان فیلد nationalCode بفرستید؛ شناسهٔ ملی یازدهرقمی هم در همان فیلد پذیرفته میشود.
اگر پرونده‌ای ثبت نباشد هزینه دارد؟
بله. count صفر یک نتیجهٔ معتبر است. فقط برای ورودی نامعتبر و اختلال سامانه مبلغی کسر نمی‌شود.
چرا چند ردیف برگشته است؟
چون یک شناسه ممکن است بیش از یک پروندهٔ مالیاتی داشته باشد و هر پرونده کد اقتصادی خودش را دارد.