Sigorta Teklifi & Poliçe

Not

“Sigorta” iki farklı mekanizmayı ifade eder ve bunlar birbirinden ayrıdır: tazminat süreci partner:sigorta panelinden, dosya kaynaklı olarak yürür; kasko/trafik teklifi ise harici bir sigorta fiyat API’sinden otomatik çekilir ve platform marjı eklenir. Bu sayfa kasko/trafik + poliçe akışını anlatır; tazminat sigorta süreci için bkz. Tazminat Dosyaları.

Kasko/trafik teklif akışı

1. POST /sigorta/teklif-talepleri — { tip: 'kasko'|'trafik', aracId } ile harici sağlayıcıya sorgu atılır. Dönen her şirket teklifine platform marjı (%3–5) eklenir. Sağlayıcıya erişilemezse 503 SIGORTA_API_ERISILEMEDI döner ve müşteriye “şu an teklif alınamıyor” gösterilir — ham fiyat yoksa marj da eklenmez.
2. GET /sigorta/teklif-talepleri/:id — karşılaştırmalı teklif listesi (saglayiciAdi, gosterilenFiyat, sonaErmeZamani). Ham fiyat ve platform marjı müşteriye dönmez, yalnızca admin raporlarında görünür.
3. POST /sigorta/teklifler/:id/kabul — “kabul + öde” tek adımdır; poliçe ancak sağlayıcı ödemeyi teyit edince aktif olur. Teklif süresi dolmuşsa 410 TEKLIF_SURESI_DOLDU döner ve müşteri yeniden teklif talebi açar.
4. GET /policeler / GET /policeler/:id/belge — poliçe listesi ve PDF indirme linki (presigned, 900 sn geçerli).

Şirket araçları

Şirkete ait araç için kasko/trafik teklifi almayı, teklifi kabul edip ödemeyi ve poliçe PDF’ini indirmeyi şirketin herhangi bir üyesi yapabilir — yönetici şartı yoktur. Bu, araçlardaki PATCH/DELETE deseninden bilinçli olarak farklıdır: sigorta ihtiyacı anlık olduğu için aracın başındaki kişi işlemi tamamlayabilmelidir.

Tazminat sigorta süreci (partner tarafı)

Sigorta şirketi partneri kendisine düşen tazminat işlerini görür ve durum geçirir: incelemeye-al → teklif-ver (tutar zorunlu, dosya durumu sigorta_teklif_ilettiye senkronlanır) → onayla / reddet. GET /partner/policeler yalnızca raporlama amaçlıdır — poliçe oluşturma ucu yoktur, poliçe müşteri kabulüyle otomatik oluşur.