سرویس «استعلام بدهی مالیاتی» در دسته احراز هویت و شناخت مشتری فینوتک با گرفتن کد ملی، فهرست بدهیهای مالیاتی مرتبط با همان شخص را برمیگرداند. این نسخه با توکن Client Credential و بدون تایید پیامکی فراخوانی میشود، پس برای بررسیهای سمت سرور و بازبینیهای دورهای پرونده مناسب است.
استعلام بدهی مالیاتی چه مشکلی را حل میکند؟
وضعیت مالیاتی یکی از سیگنالهایی است که در پرونده اعتباری و قراردادی وزن دارد، اما در فرآیند سنتی تنها زمانی به دست میآید که کارشناس آن را از مشتری بخواهد: برگه استعلام کاغذی، انتظار چندروزه و تصویری که ممکن است به روز نباشد. نتیجه، فرآیندی است که در مقیاس کار نمیکند؛ بررسی تکتک پروندههای یک پرتفوی چندهزارنفری با این روش عملاً ناممکن است و تیم اعتبارسنجی مجبور میشود این سیگنال را فقط برای پروندههای بزرگ در نظر بگیرد.
این سرویس همان بررسی را به یک فراخوانی سمت سرور تبدیل میکند: کد ملی را میفرستید و فهرست بدهیهای مالیاتی مرتبط را بهصورت داده ساختیافته میگیرید. تصمیمی که این خروجی تغذیه میکند، نمره و مسیر پرونده است؛ وجود بدهی میتواند پرونده را به بررسی دقیقتر یا سقف پایینتر هدایت کند و نبود آن یکی از شرطهای عبور خودکار باشد. چون فراخوانی به حضور مشتری وابسته نیست، میتوانید آن را در پردازشهای شبانه، بازبینی دورهای و پایش پرتفوی هم اجرا کنید.
کاربردهای استعلام بدهی مالیاتی
- امتیازدهی اعتباری در مقیاس پرتفوی — وضعیت مالیاتی بهعنوان یکی از سیگنالهای ورودی موتور امتیازدهی برای مجموعهای از پروندهها محاسبه میشود.
- پایش دورهای مشتریان فعال — در پروندههای اقساطی و قراردادهای مدتدار، وضعیت مالیاتی در بازبینیهای زمانبندیشده بهروز میشود.
- بررسی طرف قرارداد و تامینکننده — در پذیرش فروشنده، پیمانکار و نماینده فروش، وضعیت مالیاتی پیش از انعقاد قرارداد سنجیده میشود.
- پروندهسازی ضامن و شخص ثالث — وضعیت ضامن هم میتواند پیش از پذیرش نقش او در قرارداد بررسی شود.
- تعیین سقف و شرایط خدمات اعتباری — نتیجه استعلام در تعیین سقف اعتبار، نرخ و وثیقه مورد نیاز بهکار میآید.
- آمادهسازی پرونده برای بررسی دستی کارشناس — پروندههایی که سیگنال مالیاتی دارند پیش از رسیدن به کارشناس علامتگذاری میشوند و زمان بررسی کوتاهتر میشود.
مزایای استعلام بدهی مالیاتی
- قابل اجرا در مقیاس — چون به حضور و تایید مشتری گره نمیخورد، در پردازشهای دستهای و زمانبندیشده هم قابل استفاده است.
- ورودی حداقلی — تنها کد ملی لازم است و هیچ مدرکی از مشتری خواسته نمیشود.
- خروجی فهرستی و قابل پردازش — فهرست بدهیهای مرتبط بهصورت داده برمیگردد و میتوانید آن را در قواعد تصمیم خود جمعبندی کنید.
- پیادهسازی کوتاه — یک فراخوانی با توکن Client Credential، بدون زنجیره مراحل تایید کاربر.
- نسخه با رضایت کاربر هم موجود است — اگر فرآیند شما باید تایید صریح خود شخص را ثبت کند، استعلام پیامکی بدهی مالیاتی همان استعلام را با رویکرد Authorization SMS انجام میدهد.
چه چیزی از استعلام بدهی مالیاتی دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام بدهی مالیاتی
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
kyc:tax-Inquiry:getتوکن Client Credential بگیرید. - ۲. ارسال کد ملی — درخواست را از سمت سرور و در صورت نیاز همراه شناسه پیگیری بفرستید.
- ۳. خواندن فهرست بدهیها — فهرست بازگشتی را بخوانید و خالی بودن یا نبودن آن را در منطق خود مدیریت کنید.
- ۴. جمعبندی در قاعده تصمیم — نتیجه را به موتور امتیازدهی یا قواعد پذیرش خود بدهید و مسیر پرونده را تعیین کنید.
- ۵. ثبت نتیجه و زمان استعلام — پاسخ، شناسه پیگیری و زمان بررسی را برای ممیزی و بازبینی بعدی ذخیره کنید.
نحوه شروع استعلام بدهی مالیاتی
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: kyc:tax-Inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام بدهی مالیاتی
- اسکوپ این سرویس حرف بزرگ دارد؛ آن را دقیقاً به شکل
kyc:tax-Inquiry:getدرخواست کنید تا صدور توکن با خطا مواجه نشود. - خروجی فهرست است، نه یک مقدار دوحالته؛ منطق خود را برای فهرست خالی، یک قلم و چند قلم بدهی جداگانه بنویسید.
- نبودن بدهی در پاسخ را بهتنهایی معیار تایید اعتباری نگیرید؛ آن را کنار سایر سیگنالهای پرونده بگذارید.
- نتیجه تصویری از همان لحظه است؛ برای تصمیمهای بعدی و پروندههای بلندمدت استعلام را تکرار کنید.
- ارسال شناسه پیگیری یکتا اختیاری است اما برای ردیابی هر فراخوانی در گزارشها و پاسخ به اعتراض مشتری توصیه میشود.
- داده مالیاتی، داده حساس مشتری است؛ دسترسی به آن را به نقشهای مرتبط محدود کنید و مدت نگهداری را مشخص کنید.
سوالات متداول استعلام بدهی مالیاتی
استعلام بدهی مالیاتی چیست؟
سرویسی است که با دریافت کد ملی، فهرست بدهیهای مالیاتی مرتبط با همان شخص را بهصورت داده ساختیافته برمیگرداند تا در اعتبارسنجی و بررسی طرف قرارداد استفاده شود.
تفاوت این سرویس با نسخه Authorization SMS چیست؟
خروجی یکی است و تفاوت در مسیر دسترسی: این نسخه بدون تایید پیامکی و از سمت سرور فراخوانی میشود و برای بازبینی انبوه و پایش دورهای مناسب است؛ اگر فرآیند شما باید رضایت خود شخص را ثبت و قابل ممیزی کند، استعلام پیامکی بدهی مالیاتی را انتخاب کنید.
خروجی چه شکلی دارد؟
فهرست بدهیهای مالیاتی مرتبط با کد ملی ارسالی. شرح دقیق خروجی در مستندات فنی آمده است.
اگر فهرست بدهی خالی باشد یعنی پرونده تایید است؟
نه. خالی بودن فهرست فقط یکی از سیگنالهای پرونده است و باید در کنار سایر بررسیهای هویتی و اعتباری تفسیر شود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام بدهی مالیاتی
مشاهده مستندات فنی «استعلام بدهی مالیاتی» — endpoint، پارامترها، نمونه درخواست و پاسخ.