###GET /credit/v2/clients/{clientId}/users/{user}/sms/sayadChequeInquiry * **شرح: ** این سرویس با دریافت شماره چک صیادی و اطلاعات دریافت کننده ی چک ،امکان استعلام چک را فراهم می نماید. * **اسکوپ: ** ```credit:sms-sayady-cheque-inquiry:get``` * **رویکرد: ** ```AUTHORIZATION_SMS``` * **<a href="ResponsecodesCredit.pdf"> دانلود مستندات ریسپانس کد ها</a> ** ```````````````` {address}/credit/v2/clients/{clientId}/users/{user}/sms/sayadChequeInquiry?sayadId={sayadId}&idCode={idCode}&shahabId={shahabId}&idType={idType}&trackId={trackId} ```````````````` <div class="sandboxaddress sandbox" id="sandbox" style="float:right" style="display: none" > https://sandboxapi.finnotech.ir <b> :address </b> </div> <div class="production-address production" style="float:right" style="display: block"> https://apibeta.finnotech.ir <b> :address </b> </div> #### Headers مقادیر زیر باید در هدر قرار بگیرد ```````````````` Authorization : Bearer {Token} ```````````````` * برای فراخوانی این سرویس لازم است پس از دریافت اجازه ی دسترسی از کاربر، با توکن Authorization SMS سرویس را فراخوانی نمایید. #### URI Parameters * **clientId:**شناسه کلاینت * **user :** (اجباری) کد ملی کاربر که میخواهید اطلاعات آن را دریافت کنید و باید رشته عددی به طول ۱۰ رقم باشد #### Query Parameters * **trackId:** اختیاری (string) &#x202b; کد پیگیری، رشته ای اختیاری با طول حداکثر ۴۰ کاراکتر شامل حرف و عدد. در صورت ارسال trackId، فراخوانی سرویس خود را با همین مقدار استعلام و پیگیری کنید.(در گزارش فراخوانی سرویس ها با همین رشته نتیجه را ببینید). در صورتیکه که این فیلد را ارسال نکنید یک رشته UUID برای این فراخوانی در نظر گرفته میشود و در پاسخ فراخوانی برگردانده میشود. * example: ```getUserinfo876543``` * **idCode:** اختیاری (string) &#x202b; کد شناسایی . مشتری حقیقی کد ملی (اختیاری)٬ مشتری حقوقی شناسه ملی شرکت(اجباری) * example : ```0050000039``` * **shahabId:** اختیاری (string) &#x202b;کد شهاب * example: ```1234567890123456``` * **idType:** اجباری (string) &#x202b; نوع کد شناسایی با ملاحظات: مشتری حقیقی ۱ ٬ مشتری حقوقی ۲ * example: ```1``` * **sayadId:** اجباری (string) &#x202b; شناسه صیاد چک * example: ```0000000000000000``` ####Results Format ##### Successful result format (status code 200) ```````````````` { "trackId": "7113b244-3c01-44f1-b395-e3ab464cfeaa", "result": { "message": "استعلام چک با موفقیت انجام شد", "referenceId": "25161234064321", "sayadId": "0000000000000000", "branchCode": "5502227", "bankCode": "57", "amount": 100000, "dueDate": "14001027", "description": "تست ", "serialNo": "283331", "seriesNo": "9999", "fromIban": "IR550770000000104272127001", "reason": "POSA", "currency": 1, "chequeStatus": 1, "chequeType": 1, "chequeMedia": 1, "blockStatus": 0, "guaranteeStatus": 1, "locked": 0, "holders": [ { "idCode": "0050000039", "idType": 1, "name": "چارلز بوکوفسکی" } ], "signers": [ { "name": "آلبرکامو", "legalStamp": 0 } ], "lockerBankCode": "", "lockerBranchCode": "", "issueDate": "14001025143237" }, "status": "DONE" } ```````````````` * **result:** آبجکتی از پاسخ سرویس شامل: * **message:** پیغام مبنی بر ستعلام چک * **referenceId:** کد رهگیری * **holders:** لیست دارندگان چک * **legalStamp:** آیا این امضا به معنای مهر حقوقی میماند یا خیر * 0: نمیباشد * 1: میباشد * **lockerBankCode:** بانک مسدود کننده * **lockerBranchCode:** شعبه بانک مسدود کننده * **issueDate:** تاریخ ثبت * **signers:** لیست امضاکنندگان * **sayadId:** شناسه صیاد چک * **serialNo:** شماره سریال چک * **fromIban:** کد شبا حساب عهده * **reason:** * POSA: واریز حقوق * IOSP: امور بیمه خدمات * HIPA: امور درمانی * ISAP: امور سرمایه گذاری و بورس * FXAP: امور ارزی در چارچوب ضوابط و مقررات * DRPA: پرداخت قرض و تادیه دیون * RTAP: امور بازنشستگی * MPTP: معاملات اموال منقول * IMPT: معاملات اموال غیر منقول * LMAP: مدیریت نقدینگی * CDAP: عوارض گمرکی * TCAP: تسویه مالیاتی * GEAC: سایر خدمات دولتی * LRPA: تسهیلات و تعهدات * CCPA: تودیع وثیقه * GPAC: هزینه عمومی و امور روزمره * CPAC: کمک‌های خیریه * GPPC: خرید کالا * SPAC: خرید خدمات * **amount:** مبلغ چک * **description:** شرح چک * **dueDate:** تاریخ خورشیدی سررسید چک * **currency:** نوع ارز چک * **bankCode:** کد بانک عهده * **chequeStatus:** * 1: صادر شده * 2: نقد شده * 3: باطل شده * 4: برگشت خورده * 5: بخشی برگشت خورده * 6: در انتظار امضا ضامن * 7: در انتظار تایید گیرنده در کشیدن چک * 8: در انتظار تاییده گیرنده در انتقال چک * **chequeType:** نوع چک * 1: عادی * 2: بانکی (چک تضمینی) * 3: رمزدار * 4: چک موردی * **chequeMedia:** * 1: چک کاغذی * 2: چک دیجیتال * **guaranteeStatus:** وضعیت ضمانت چک * **locked:** * 0: نقد کردن بر روی چک وجود ندارد * 1: چک lock است * **blockStatus:** * 0: چک مسدود نشده است * 1: مسدود موقت * 2: مسدود دائم * 3: چک رفع مسدودی شده * **status: ** وضعیت فراخوانی سرویس * DONE: فراخوانی موفق سرویس * FAILED: فراخوانی ناموفق سرویس * **trackId: ** کد پیگیری، اگر ارسال شده باشد همان مقدار و در غیر اینصورت یک رشته تصادفی تولید و برگردانده میشود * **error:** جزییات خطا (در صورت بروز خطا) #### UnSuccessful result format در اینجا میتوانید لیست خطاهای سرویس ها را مشاهده کنید [لیست خطاها](generic-errors.html)