استعلام تسهیلات و اعتبارسنجی

گزارش اعتباری (مرحله ۲) — دریافت نتیجه

<!--seo-open-->

سرویس «گزارش اعتباری (مرحله ۲) — دریافت نتیجه» (SMS/OTP) در دسته تسهیلات و اعتبارسنجی فینوتک؛ نسخه پیامکی برای فراخوانی با تایید کاربر. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. فراخوانی با تایید پیامکی کاربر (authorization_sms) انجام می‌شود. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

<!--/seo-open-->

با assessmentId دریافتی از ثبت درخواست JSON یا ثبت درخواست PDF وضعیت پردازش و در صورت آماده بودن، گزارش برگردانده می‌شود.

تا وقتی status برابر IN_PROGRESS است، فیلدهای خروجی گزارش وجود ندارد. چند ثانیه بعد دوباره استعلام کنید.

اگر گزارش ذخیره‌شده ناقص باشد، دوباره از ابتدا گرفته می‌شود و پاسخ pending برمی‌گردد.

نوع خروجی (json یا pdf) در مرحله ثبت درخواست انتخاب و ذخیره می‌شود؛ این سرویس همان مقدار را می‌خواند. وقتی DONE است:

  • json — بدنه گزارش در data
  • pdf — فقط fileName و contentBase64 (بدون data)

Scope: credit:assessment-inquiry:get<br />

Grant type: authorization_sms

برای فراخوانی این سرویس پس از دریافت اجازه دسترسی از کاربر، با توکن Authorization SMS فراخوانی کنید.

وضعیت‌ها

  • IN_PROGRESS — در حال تهیه گزارش؛ progress و stage را ببینید
  • DONE — گزارش آماده است
  • FAILED — خطا؛ HTTP 422
get/credit/v2/clients/{clientId}/assessmentInquiry

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/credit/v2/clients/{clientId}/assessmentInquiry
  • Auth: HTTP bearer

Path parameters

clientIdstring required

Query parameters

trackIdstring
assessmentIdstring required

شناسه گزارش دریافتی از مرحله ثبت درخواست

Response

در حال پردازش یا گزارش آماده

responseCodestring required

کد پاسخ فینوتک

trackIdstring

کد پیگیری؛ اگر ارسال شده باشد همان مقدار و در غیر این صورت یک رشته تصادفی

assessmentIdstring required

شناسه گزارش

status'IN_PROGRESS' | 'DONE' required

IN_PROGRESS یعنی گزارش هنوز آماده نیست؛ دوباره استعلام کنید. DONE یعنی گزارش کامل در data است.

stage'CREATED' | 'ACCESS_INQUIRY' | 'MAIN_SUBMIT' | 'MAIN_POLL' | 'BOUNCED_CHEQUE' | 'SCORE_SUBMIT' | 'SCORE_POLL' | 'HISTORY_SUBMIT' | 'HISTORY_POLL' | 'TAX_FETCH' | 'CHEQUE_BASE_SUBMIT' | 'CHEQUE_BASE_POLL' | 'DONE' | 'FAILED'

مرحله فعلی (فقط وقتی status برابر IN_PROGRESS است)

progressinteger

درصد پیشرفت تقریبی (فقط در IN_PROGRESS)

level'base' | 'standard' | 'advance'

سطح گزارش

outputType'json' | 'pdf'

نوع خروجی ذخیره‌شده در مرحله ثبت درخواست؛ json یا pdf (فقط در DONE)

fileNamestring

نام فایل PDF (فقط وقتی status برابر DONE و outputType برابر pdf است)

contentBase64string

محتوای PDF به‌صورت Base64 (فقط وقتی status برابر DONE و outputType برابر pdf است؛ بدون data)

Example response

{
  "responseCode": "FN-CTFH-20003900000",
  "assessmentId": "8f3c1a2e-4b90-4d11-9c2a-1a2b3c4d5e6f",
  "progress": 65,
  "fileName": "FinnotechAssessmentReport-6780026883-1405-06-17.pdf"
}

Changes

No recorded changes to this operation across all 1 revision of this API.