Hasar Kaydı

Kesilmiş bir poliçe için hasarı, sağlayıcı bağlantınız üzerinden sağlayıcınıza bildirirsiniz. Hasar kaydını POST /api/v1/insurance/policies/{policyId}/claims ile açarsınız; kaydın sonucunu kayıt ucundan ve webhook ile izlersiniz.

• Hasar kaydı bildirimdir. Lunixi hasarı sağlayıcınıza iletir ve iletimin sonucunu gösterir. Hasarın değerlendirilmesi (kabul, ret, ödeme) sigorta şirketindedir; değerlendirmenin sonucu kayıtta yer almaz.
• Belge Lunixi'de saklanmaz. Gönderdiğiniz belge yalnızca bu istekte işlenir ve sağlayıcınıza iletilir. Belgenin içeriği yanıtlara, istek kayıtlarına ve webhook'lara girmez.
• Kayıt poliçe başınadır. Sigorta birim başınadır; policyId değerini siparişin policies[] dizisinden alırsınız: Sipariş nesnesi.

Kimlik doğrulama ve imzalama: Akışlar › Kimlik doğrulama.

Hasar kaydı açılabilen poliçeler

Bakılan, siparişin değil o poliçenin (policies[].policyStatus) durumudur. Bir poliçede aynı anda tek bir açık kayıt bulunur: durumu PENDING, SUBMITTED ya da UNKNOWN olan kayıt açıktır. Sağlayıcıya ulaşan (SUBMITTED) bir kayıt varken aynı poliçe için ikinci kayıt açılmaz. FAILED bir kayıt yeni kayda engel değildir.

Akış

Hasar kaydı açma: POST /api/v1/insurance/policies/{policyId}/claims

Idempotency-Key zorunludur. Bkz. Tekrar ve Idempotency-Key.

Belgeler

• Belgelerin toplam boyutu, base64 çözüldükten sonra en fazla 3 MB olabilir. Sınırı aşan istek 400 VALIDATION_ERROR ya da 422 insurance.validation.invalid (field: documents, reason: too_large) döner.
• Dosya PDF olmalıdır; içeriği PDF olmayan belge 422 döner.
• Belge alıcınızın kişisel verilerini taşıyabilir. Lunixi belgeyi saklamaz ve sağlayıcıya iletir; belgenin içeriği istek kayıtlarına girmez.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/policies/<policyId>/claims"
CONTENT=$(base64 < iptal-belgesi.pdf | tr -d '\n')
BODY=$(printf '{"incidentAt":"2026-10-12T09:30:00+03:00","documents":[{"kind":"CANCELLATION_PROOF","contentType":"application/pdf","contentBase64":"%s"}]}' "$CONTENT")
printf '%s' "$BODY" > claim.json
lunixi_sign POST "$REQ_PATH" "$BODY"
 
curl -X POST "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: insurance-claim-1001" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "Digest: $DIGEST" \
  -H "X-Signature: $SIGNATURE" \
  --data-binary @claim.json

Gövde belge nedeniyle büyük olabilir; bu yüzden örnek gövdeyi dosyadan gönderir. Digest'i dosyaya yazdığınız gövdenin aynısından hesaplayın.

Yanıt

İstek tamamlandığında 201 ve data içinde hasar kaydı nesnesini döner. Sağlayıcı kaydı aldıysa status SUBMITTED, sonuç kesinleşmediyse UNKNOWN olur.

Sonuçlar

Sonuç doğrulanamazsa kayıt incelenir ve sonucu kesinleşene kadar UNKNOWN kalır.

Tekrar ve Idempotency-Key

• Hasar kaydı belgeyi sağlayıcıya aynı istekte iletir. İstek 45 saniyeye kadar sürebilir; istemcinizin zaman aşımını buna göre ayarlayın.
• Zaman aşımı ya da 5xx sonrasında yanıtı alamadıysanız isteği aynı Idempotency-Key ve aynı gövdeyle tekrarlayın. Kayıt ilk denemede açıldıysa yeni kayıt açılmaz; mevcut kayıt güncel durumuyla döner ve belge sağlayıcıya yeniden gönderilmez.
• Aynı anahtar, kaydın durumu ne olursa olsun aynı kaydı döner. FAILED bir kaydı yeniden göndermek için yeni bir anahtar üretin.
• Aynı anahtarı farklı bir istekle (başka poliçe, olay anı ya da belge) kullanırsanız 409 insurance.idempotency.conflict döner.

Hasar kaydı nesnesi

Kayıtta sağlayıcının hasar referansı ve hata kodları bulunmaz.

Durumlar

SUBMITTED ve FAILED kesin durumlardır; değişmez.

Listeleme: GET /api/v1/insurance/claims

Hasar kayıtlarınızı en yeniden eskiye, cursor tabanlı sayfalar hâlinde döner.

Yanıtta kayıtlar data.items dizisindedir; sayfalama bilgisi pageInfo alanındadır. Bozuk bir cursor 422 insurance.validation.invalid (field: cursor) döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/claims?limit=25&policyId=<policyId>"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

Okuma: GET /api/v1/insurance/claims/{claimId}

Tek bir hasar kaydını döner. Yanıtta data hasar kaydı nesnesidir. Sonucu UNKNOWN olan kaydı izlemek ya da webhook alamadığınız bir sonucu doğrulamak için bu ucu kullanın.

Sağlayıcının hasar belgesi: GET /api/v1/insurance/claims/{claimId}/document

Sağlayıcının hasar kaydı için verdiği belgeyi PDF olarak döner. Belge yalnızca kayıt SUBMITTED olduğunda alınabilir.

• Belge Lunixi'de saklanmaz. Her istekte sağlayıcıdan alınır ve olduğu gibi size iletilir.
• Başarılı yanıt 200 döner ve gövde PDF dosyasının kendisidir; JSON zarfı yoktur. Hata yanıtları JSON hata zarfıdır; ikisini yanıtın Content-Type başlığından ayırın.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/claims/<claimId>/document"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE" \
  -o hasar.pdf

Hatalar

Ortak kodlar: Akışlar › Yanıt ve hatalar. Kodların ayrıntısı: Hata Kodları › Hasar kaydı.

Durum çakışması

Alan ihlalleri

İlgili

• Sipariş ve Ödeme Bağlama: policies[] ve poliçe durumu
• Webhook Olayları: insurance.claim.submitted ve insurance.claim.failed
• Hata Kodları: hasar kaydının kodları
• Sigorta Tipleri ve Şemalar: TICKET_CANCELLATION