وثایق و تضامین ضمانت نامه

کاربرد کسب‌وکاری (نسخه Client Credential بدون رضایت پیامکی): با وارد کردن شناسه ضمانت‌نامه (guaranteeId)، فهرست وثایق و تضامین متصل به آن ضمانت‌نامه…

مستندات فنی

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

وثایق و تضامین ضمانت نامه چه مشکلی را حل می‌کند؟

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

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

کاربردهای وثایق و تضامین ضمانت نامه

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

مزایای وثایق و تضامین ضمانت نامه

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

چه چیزی از وثایق و تضامین ضمانت نامه دریافت می‌کنید؟

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

جریان کار وثایق و تضامین ضمانت نامه

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

نحوه شروع وثایق و تضامین ضمانت نامه

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

محدودیت‌ها و نکات وثایق و تضامین ضمانت نامه

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

سوالات متداول وثایق و تضامین ضمانت نامه

«وثایق و تضامین ضمانت نامه» چیست؟

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

تفاوت این سرویس با «اطلاعات ضمانت نامه» چیست؟

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

آیا می‌توانم با کد ملی، ضمانت‌نامه‌های یک شخص را بگیرم؟

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

اگر برای سند وثیقه‌ای ثبت نشده باشد چه می‌شود؟

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

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

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

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

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

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

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

مستندات فنی وثایق و تضامین ضمانت نامه

مشاهده مستندات فنی «وثایق و تضامین ضمانت نامه» — endpoint، پارامترها، نمونه درخواست و پاسخ.

سرویس‌های مرتبط با وثایق و تضامین ضمانت نامه