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