استعلام مکنا

کاربرد کسب‌وکاری (نسخه Client Credential بدون رضایت پیامکی): با وارد کردن کد ملی، مانده و سوابق مکنا (کد مکنا، مانده ایران/بانک و تاریخ‌ها) برگردانده…

مستندات فنی

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

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

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

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

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

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

مزایای استعلام مکنا

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

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

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

جریان کار استعلام مکنا

  • ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ credit:macna-inquiry:get توکن Client Credential بگیرید.
  • ۲. ارسال کد ملی — کد ملی شخص را همراه یک trackId یکتا در درخواست بفرستید.
  • ۳. خواندن پاسخ — کد مکنا، مانده‌های ثبت‌شده و تاریخ‌های مرتبط را از پاسخ بردارید.
  • ۴. اعمال قاعده کسب‌وکاری — نتیجه را در قاعده‌های اعتباری خود بنشانید و پرونده را تایید، رد یا به بررسی کارشناس ارسال کنید.
  • ۵. ثبت نتیجه در پرونده — پاسخ و شناسه پیگیری را برای ممیزی و بازبینی‌های بعدی ذخیره کنید.

نحوه شروع استعلام مکنا

این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی می‌شود. اسکوپ مورد نیاز: credit:macna-inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیاده‌سازی استفاده کنید.

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

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

سوالات متداول استعلام مکنا

«استعلام مکنا» چیست؟

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

چه ورودی‌ای لازم دارد؟

تنها کد ملی شخص. شرح دقیق ورودی و خروجی در مستندات فنی آمده است.

تفاوت این سرویس با استعلام تسهیلات چیست؟

استعلام تسهیلات تسهیلات جاری مشتری را برمی‌گرداند، در حالی که این سرویس مانده و سوابق مکنا را می‌دهد؛ در پرونده اعتباری معمولاً کنار هم استفاده می‌شوند.

آیا برای اشخاص حقوقی هم قابل استفاده است؟

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

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

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

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

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

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

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

مستندات فنی استعلام مکنا

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

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