11 KiB
مستند فرانتاند API گزارش PDF پرونده
هدف API
این API دادهی ساختیافتهی لازم برای تولید PDF پرونده در پنل بیمهگر را برمیگرداند.
خروجی آن ترکیبی از اطلاعات پروندهی تقصیر (blame) و پروندهی خسارت (claim) است و طوری طراحی شده که فرانتاند بدون وابستگی به مدلهای داخلی بکاند، فقط با sections و fields بتواند PDF را رندر کند.
آدرس API
GET /expert-insurer/files/:publicId/report
پارامتر مسیر
publicId: شناسه عمومی پرونده
ساختار کلی پاسخ
{
"title": "گزارش پرونده بیمه گر",
"publicId": "RPT832-00406",
"requestNo": "BL-RPT832-000406",
"sections": []
}
فیلدهای سطح بالا
title
عنوان کلی گزارش.
publicId
شناسه عمومی پرونده.
requestNo
شماره درخواست، اگر در دادههای پرونده موجود باشد.
sections
آرایهای از سکشنهای گزارش.
هر سکشن یک عنوان دارد و شامل تعدادی ردیف اطلاعات (fields) است.
ساختار هر سکشن
{
"title": "زمانبندی پرونده",
"fields": [
{
"label": "تاریخ و ساعت ثبت پرونده",
"value": "1405/06/02 07:02"
}
]
}
title
عنوان فارسی سکشن، آمادهی نمایش در PDF.
fields
لیست ردیفهای اطلاعاتی همان سکشن.
ساختار هر فیلد
{
"label": "شماره بیمهنامه",
"value": "POL-12345"
}
label
عنوان فارسی فیلد.
value
مقدار فیلد. برای نمایش مستقیم در PDF استفاده میشود.
سکشنهای ممکن در پاسخ
سکشنها معمولاً با ترتیب زیر برمیگردند، ولی فرانتاند بهتر است بهجای تکیه بر ایندکس آرایه، سکشن را با title پیدا کند:
زمانبندی پروندهمالک خودروی زیان دیدهمالک خودروی مقصرراننده خودروی زیان دیدهبیمه شخص ثالث زیاندیدهبیمه بدنه زیاندیدهبیمه شخص ثالث مقصربیمه بدنه مقصراطلاعات خودروی زیاندیدهاطلاعات خودروی مقصراظهارات و اقرار زیاندیدهاظهارات و اقرار مقصرکدهای فناوراننتیجه ارزیابیگزارش حادثه
نکته:
- بعضی سکشنها بسته به نوع پرونده ممکن است وجود نداشته باشند.
- در پروندههای بدنه (
CAR_BODY) اگر طرفین عملاً یک نفر باشند، سکشنهای مربوط به مقصر ممکن است حذف شوند. - در پروندههای شخص ثالث (
THIRD_PARTY) انتظار میرود اطلاعات هر دو طرف بهصورت تفکیکشده برگردد.
توضیح سکشنها
1) زمانبندی پرونده
برای نمایش زمانهای مهم پرونده.
فیلدهای مهم:
تاریخ و ساعت ثبت پروندهتاریخ و ساعت ثبت نتیجه ارزیابی
نکته:
- این تاریخها در بکاند فرمت شدهاند و آمادهی نمایش هستند.
2) مالک خودروی زیان دیده
اطلاعات مالک یا صاحب خودروی زیاندیده.
فیلدهای رایج:
نامشماره تلفنکد ملیتاریخ تولدشماره شبا
نکته:
شماره شبامعمولاً برای زیاندیده مهم است و ممکن است فقط در همین سکشن وجود داشته باشد.
3) مالک خودروی مقصر
اطلاعات مالک خودروی مقصر.
فیلدهای رایج:
نامشماره تلفنکد ملیتاریخ تولد
نکته:
- این سکشن مخصوص پروندههای شخص ثالث اهمیت دارد تا اطلاعات مالک هر دو طرف در PDF موجود باشد.
4) راننده خودروی زیان دیده
اگر راننده با مالک/بیمهگذار متفاوت باشد، این سکشن برمیگردد.
فیلدهای رایج:
نامنوع گواهینامهتاریخ گواهینامهشماره تلفنکد ملیتاریخ تولدشماره گواهینامه
نکته:
- اگر راننده و مالک یکی باشند، این سکشن ممکن است وجود نداشته باشد.
5) بیمه شخص ثالث زیاندیده
اطلاعات بیمه شخص ثالث طرف زیاندیده.
فیلدهای رایج:
شماره بیمهنامهشرکت بیمهتاریخ شروع بیمهنامهتاریخ پایان بیمهنامهسقف تعهد مالیپوششها
6) بیمه بدنه زیاندیده
اطلاعات بیمه بدنهی طرف زیاندیده.
فیلدهای رایج:
شماره بیمهنامهشرکت بیمهتاریخ شروع بیمهنامهتاریخ پایان بیمهنامهپوششها
7) بیمه شخص ثالث مقصر
اطلاعات بیمه شخص ثالث طرف مقصر.
فیلدهای رایج:
شماره بیمهنامهشرکت بیمهتاریخ شروع بیمهنامهتاریخ پایان بیمهنامهسقف تعهد مالیپوششها
8) بیمه بدنه مقصر
اطلاعات بیمه بدنهی طرف مقصر.
فیلدهای رایج:
شماره بیمهنامهشرکت بیمهتاریخ شروع بیمهنامهتاریخ پایان بیمهنامهپوششها
9) اطلاعات خودروی زیاندیده
جزئیات خودروی زیاندیده.
فیلدها میتوانند شامل موارد زیر باشند:
خودرو / پلاکخودرو / نام خودروخودرو / مدل خودروخودرو / نوع خودروVINشماره موتورشماره شاسیرنگ اصلیرنگ فرعیسیستمتیپکاربریظرفیتتعداد سیلندر
نکته:
- بسته به منبع داده، ممکن است بعضی فیلدها با برچسبهای نزدیک به هم ولی از دو منبع مختلف برگردند.
10) اطلاعات خودروی مقصر
جزئیات خودروی طرف مقصر.
فیلدها مشابه سکشن خودروی زیاندیده هستند.
11) اظهارات و اقرار زیاندیده
اطلاعات مربوط به اظهارات طرف زیاندیده.
فیلدهای رایج:
نقش طرفنامادعای خسارتپذیرش نظر کارشناستوضیحات طرف
نکته:
- معمولاً
اقرار به تقصیربرای زیاندیده نمایش داده نمیشود.
12) اظهارات و اقرار مقصر
اطلاعات مربوط به اظهارات طرف مقصر.
فیلدهای رایج:
نقش طرفناماقرار به تقصیرپذیرش نظر کارشناستوضیحات طرف
نکته:
- معمولاً
ادعای خسارتبرای مقصر نمایش داده نمیشود.
13) کدهای فناوران
کدها و شناسههای فنی مرتبط با پرونده در فناوران.
فیلدهای ممکن:
شماره پرونده فناورانکد پرونده فناورانکد کیس خسارت فناورانکد کارشناسی فناورانکد بیمهنامه فناورانکد راننده فناورانکد نوع خودرو فناورانکد شرکت بیمه فناوران
14) نتیجه ارزیابی
اطلاعات نتیجهی ارزیابی کارشناس خسارت.
فیلدهای مهم:
نتیجه ارزیابیکارشناس ارزیابتاریخ و ساعت ثبت ارزیابیپاسخ / توضیحات کارشناس
15) گزارش حادثه
خلاصهی اطلاعات حادثه، وضعیت پرونده و برخی خروجیهای کارشناسی.
فیلدهای رایج:
تاریخ حادثهساعت حادثهکارشناس(ان)موقعیت (عرض و طول جغرافیایی)وضعیت آب و هواوضعیت جادهوضعیت نوروضعیت مقصروضعیت خسارتنظر کارشناس مقصرنحوه برخوردعلت حادثهنوع حادثهتوضیحات طرف
نکات مهم برای فرانتاند
1) فقط بر اساس sections و fields رندر کنید
ساختار اصلی خروجی این است:
response.sections[].title
response.sections[].fields[].label
response.sections[].fields[].value
2) به ایندکس سکشنها وابسته نشوید
ممکن است بعضی سکشنها در بعضی پروندهها وجود نداشته باشند.
بهتر است سکشن را با title پیدا کنید.
3) نبودن بعضی سکشنها طبیعی است
مثلاً:
راننده خودروی زیان دیده- سکشنهای مربوط به مقصر در بعضی پروندههای بدنه
- بعضی دادههای فناوران
4) مقدار - یعنی دادهای برای نمایش وجود نداشته
اگر سکشنی دادهی واقعی نداشته باشد، ممکن است فقط این مقدار را داشته باشد:
{
"label": "اطلاعات",
"value": "-"
}
5) برچسبها فارسی و آمادهی نمایش هستند
فیلدهای title و label نیازی به ترجمهی مجدد در فرانتاند ندارند.
نمونهی سادهی رندر در فرانتاند
for (const section of response.sections) {
renderSectionTitle(section.title)
for (const field of section.fields) {
renderRow(field.label, field.value ?? "-")
}
}
خلاصه
این API برای تولید PDF پرونده، دادهها را بهصورت کامل و تفکیکشده برمیگرداند، از جمله:
- زمانبندی پرونده
- اطلاعات مالک زیاندیده
- اطلاعات مالک مقصر
- اطلاعات راننده در صورت متفاوت بودن
- بیمهنامههای تفکیکشدهی ثالث و بدنه برای هر طرف
- اطلاعات خودرو برای هر دو طرف
- اظهارات و اقرار هر دو طرف
- کدهای فناوران
- نتیجه ارزیابی و توضیحات کارشناس
- گزارش حادثه