Poliçe Belgesi

GET /api/v1/insurance/policies/{policyId}/document kesilmiş bir poliçenin belgesini PDF olarak döner.

• Belge Lunixi'de saklanmaz. Her istekte sağlayıcıdan alınır ve olduğu gibi size iletilir.
• Sigorta birim başınadır; her sepet kalemi için ayrı poliçe ve ayrı belge vardır. policyId değerini siparişin policies[] dizisinden alırsınız: Sipariş nesnesi.

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

İstek

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/policies/<policyId>/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 police.pdf

Yanıt

Başarılı yanıt 200 döner ve gövde PDF dosyasının kendisidir; JSON zarfı yoktur.

Hata yanıtları diğer uçlardaki gibi JSON hata zarfıdır. Yanıtın Content-Type başlığına bakarak PDF'i hatadan ayırın.

Belge ne zaman alınabilir

Belge, poliçe yürürlükteyken alınabilir: poliçenin policyStatus değeri ISSUED ya da CANCEL_PENDING olmalıdır. Bakılan, siparişin değil o poliçenin (policies[].policyStatus) durumudur.

Poliçe yürürlükteyse belgeyi documentStatus değerinden bağımsız olarak isteyebilirsiniz. Sağlayıcı belgeyi o an veremezse aşağıdaki gibi 503 döner.

Sağlayıcıya ulaşılamazsa

Sağlayıcı belgeyi o an veremezse 503 insurance.document.unavailable döner (details.retryable: true).

• Poliçe geçerli kalır; poliçenin ve siparişin durumu değişmez.
• İsteği bir süre sonra tekrar edin. Tekrarlar arasında beklemeyi artırın.

Makbuz: GET /api/v1/insurance/policies/{policyId}/receipt

Bağlantınızdaki ürün makbuz sunuyorsa bu uç poliçenin prim makbuzunu PDF olarak döner.

• Kurallar poliçe belgesiyle aynıdır: makbuz Lunixi'de saklanmaz, her istekte sağlayıcıdan alınır ve yalnızca poliçe yürürlükteyken alınabilir (Belge ne zaman alınabilir).
• Yanıt başlıkları aynıdır; dosya adı <policyId>-receipt.pdf olur.
• Ürün makbuz sunmuyorsa 412 insurance.document.not_supported döner. Tekrar denemek sonucu değiştirmez; poliçe belgesi bundan etkilenmez.
• Sağlayıcı makbuzu o an veremezse poliçe belgesindeki gibi 503 insurance.document.unavailable döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/policies/<policyId>/receipt"
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 makbuz.pdf

Sertifika: GET /api/v1/insurance/policies/{policyId}/certificate

Bağlantınızdaki ürün poliçe için bir sertifika veriyorsa bu uç sertifikayı PDF olarak döner. Örneğin MOTOR_GREEN_CARD poliçesinin Yeşil Kart sertifikası bu uçtan alınır.

• Kurallar poliçe belgesiyle aynıdır: sertifika Lunixi'de saklanmaz, her istekte sağlayıcıdan alınır ve yalnızca poliçe yürürlükteyken alınabilir (Belge ne zaman alınabilir).
• Yanıt başlıkları aynıdır; dosya adı <policyId>-certificate.pdf olur.
• Ürün sertifika vermiyorsa 412 insurance.document.not_supported döner. Tekrar denemek sonucu değiştirmez; poliçe belgesi ve makbuz bundan etkilenmez.
• Sağlayıcı sertifikayı o an veremezse poliçe belgesindeki gibi 503 insurance.document.unavailable döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/policies/<policyId>/certificate"
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 sertifika.pdf

Hatalar

Ortak kodlar: Akışlar › Yanıt ve hatalar.

İlgili

• Sipariş ve Ödeme Bağlama: policies[] ve belge durumu
• Kavramlar ve Durumlar: belge ekseni