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