استعلام پیامکی بدهی مالیاتی

کاربرد کسب‌وکاری (نسخه با تایید پیامکی کاربر): این سرویس با دریافت کد ملی، لیست بدهی‌های مالیاتی مرتبط را برمی‌گرداند.

مستندات فنی

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

استعلام پیامکی بدهی مالیاتی چه مشکلی را حل می‌کند؟

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

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

کاربردهای استعلام پیامکی بدهی مالیاتی

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

مزایای استعلام پیامکی بدهی مالیاتی

  • رضایت صریح و قابل اثبات کاربر — دسترسی با تایید پیامکی خود شخص صادر می‌شود و هر فراخوانی به همان توکن گره می‌خورد.
  • حذف انتظار برای مدرک کاغذی — پرونده مشتری در همان نشست پیش می‌رود، نه چند روز بعد.
  • داده ساخت‌یافته برای تصمیم خودکار — پاسخ JSON است و به‌سادگی به قواعد اعتبارسنجی شما وصل می‌شود.
  • قابل استفاده برای مشتری غایب — نیازی به حضور فیزیکی یا مراجعه مشتری نیست.
  • نسخه بدون پیامک هم موجود است — اگر جریان کاری شما رضایت را از مسیر دیگری می‌گیرد، استعلام بدهی مالیاتی با Client Credential در دسترس است.

چه چیزی از استعلام پیامکی بدهی مالیاتی دریافت می‌کنید؟

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

جریان کار استعلام پیامکی بدهی مالیاتی

  • ۱. درخواست احراز هویت — با اسکوپ kyc:sms-tax-Inquiry:get مرحله درخواست احراز هویت را فراخوانی کنید تا پیامک تایید برای کاربر برود.
  • ۲. تایید کد یکبار مصرف — کد دریافتی کاربر را در مرحله تایید احراز هویت بفرستید.
  • ۳. گرفتن توکن پیامکی — با کد بازگشتی، توکن را در مرحله درخواست توکن بگیرید.
  • ۴. فراخوانی استعلام — کد ملی را با همان توکن ارسال کنید و فهرست بدهی‌های مالیاتی را بگیرید.
  • ۵. ثبت نتیجه در پرونده — پاسخ و شناسه پیگیری را برای ممیزی و بازبینی بعدی ذخیره کنید.

نحوه شروع استعلام پیامکی بدهی مالیاتی

این سرویس با رویکرد Authorization SMS (با تایید پیامکی کاربر) فراخوانی می‌شود. اسکوپ مورد نیاز: kyc:sms-tax-Inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیاده‌سازی استفاده کنید.

محدودیت‌ها و نکات استعلام پیامکی بدهی مالیاتی

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

سوالات متداول استعلام پیامکی بدهی مالیاتی

استعلام پیامکی بدهی مالیاتی چیست؟

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

تفاوت این سرویس با نسخه Client Credential چیست؟

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

برای فراخوانی چه اسکوپی لازم است؟

اسکوپ kyc:sms-tax-Inquiry:get باید در مرحله درخواست احراز هویت درخواست شود و در توکن صادرشده وجود داشته باشد.

آیا می‌توانم برای چند مشتری با یک توکن استعلام بگیرم؟

نه. هر توکن پیامکی به کاربری تعلق دارد که تایید را انجام داده است؛ برای هر مشتری جریان تایید از ابتدا اجرا می‌شود.

مستندات فنی این سرویس کجاست؟

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

چه نوع احراز هویتی لازم است؟

Grant type: authorization_sms. جزئیات در راهنمای توکن.

آیا رضایت پیامکی کاربر لازم است؟

بله. این سرویس با رویکرد Authorization SMS و پس از تایید پیامکی کاربر فراخوانی می‌شود.

مستندات فنی استعلام پیامکی بدهی مالیاتی

مشاهده مستندات فنی «استعلام پیامکی بدهی مالیاتی» — endpoint، پارامترها، نمونه درخواست و پاسخ.

سرویس‌های مرتبط با استعلام پیامکی بدهی مالیاتی