Kavramlar ve Durumlar

Bu sayfadaki kavramlar ve durumlar Checkout Form yolunda da API yolunda da aynıdır.

Temel kavramlar

Kavram	Anlamı
Sigorta tipi	Lunixi'nin sağlayıcıdan bağımsız sigorta kodu. Örnek: `TICKET_CANCELLATION` (bilet iptal). Yayınlanmış bir tip kodu değişmez. Her tipin bir şeması vardır; şemanın sürümü `schemaVersion` ile belirtilir.
Seçenek	Bir teklifte alıcıya sunulan somut sigorta: sağlayıcının adı ve logosu, prim, teminat özeti ve şartlar.
Teklif	Belirli bir sepet ve sigortalı bilgisi için verilen fiyat. Teklifin bir geçerlilik süresi vardır. Sepet değişirse teklif geçersiz olur ve yeni teklif alınır.
Seçim	Checkout Form'da alıcının seçtiği teklif ve verdiği onay. Ödeme gönderilirken seçim yeniden doğrulanır. Sigorta hiçbir zaman önceden seçili gelmez. API yolunda siparişi doğrudan teklif üzerinden oluşturursunuz.
Sipariş	Seçilen teklifin satın alınması. Prim tahsilatı, poliçe, iade ve belge süreçleri sipariş üzerinden izlenir. Ödemeyi Lunixi ile alıyorsanız prim kaleminin kimliği sipariş kimliğidir.
Poliçe	Sağlayıcının kestiği sigorta. Sigorta birim başınadır: sepetteki her birim ayrı sigortalanır, bu yüzden bir siparişte birden fazla poliçe olabilir. Poliçe numarası, poliçe belgesinde yazan numaradır.
Prim	Alıcının sigorta için ödediği tutar.
Sağlayıcı bağlantısı	Anlaştığınız sağlayıcıyla aranızdaki anlaşmanın Lunixi'deki karşılığı. Hangi sağlayıcının kullanılacağını isteklerinizle değil, bağlantılarınızla belirlersiniz.
Tahsilat biçimi	Primi kimin tahsil ettiği. Sağlayıcınızla anlaşmanız belirler; bağlantınızda her ürün için siz belirtirsiniz.

Kimlikler

Lunixi kimlikleri önekli ve opaktır. Önek, kimliğin türünü gösterir.

Önek	Kimlik	Biçim
`insq_`	Teklif	`insq_` + 32 onaltılık hane
`inss_`	Seçim	`inss_` + 32 onaltılık hane
`inso_`	Sipariş	`inso_` + 32 onaltılık hane
`insp_`	Poliçe	`insp_` + 32 onaltılık hane
`inspay_`	Sağlayıcının prim çekimi denemesi	`inspay_` + 32 onaltılık hane
`insclm_`	Hasar kaydı	`insclm_` + 32 onaltılık hane
`insl_`	Talep	`insl_` + 32 onaltılık hane

Kimlikleri olduğu gibi saklayın ve aynen geri gönderin; içeriklerine anlam yüklemeyin.
Bir türün beklendiği yerde başka türün kimliği kabul edilmez. Örneğin teklif kimliği beklenen yerde gönderilen sipariş kimliği, var olmayan bir kimlik gibi ele alınır.
Yanıtlarda yalnızca Lunixi kimlikleri döner. Sağlayıcının kendi referansları yanıtlara girmez.

Sipariş durumları

Bir siparişin durumu dört bağımsız eksenle izlenir: tahsilat, poliçe, iade ve belge. Eksenler birbirinin bilgisini silmez. Örneğin prim tahsil edildiği hâlde poliçe kesilemediyse tahsilat COLLECTED, poliçe FAILED_FINAL, iade REQUIRED olarak kalır.

Tahsilat

Değer	Anlamı
`NOT_STARTED`	Tahsilat henüz başlamadı.
`PENDING`	Tahsilat sürüyor.
`ACTION_REQUIRED`	Tahsilatın tamamlanması için alıcının bir adım atması gerekiyor.
`COLLECTED`	Prim tahsil edildi.
`FAILED`	Prim tahsil edilemedi.
`UNKNOWN`	Tahsilatın sonucu henüz kesinleşmedi. Sonuç doğrulanana kadar kayıt bu durumda kalır.

Poliçe

Değer	Anlamı
`NOT_REQUESTED`	Poliçe henüz istenmedi.
`PENDING`	Poliçe kesiliyor.
`PARTIALLY_ISSUED`	Siparişteki poliçelerin bir kısmı kesildi.
`ISSUED`	Siparişteki bütün poliçeler kesildi.
`FAILED_RETRYABLE`	Poliçe geçici bir nedenle kesilemedi; ürünün son tarihine kadar yeniden denenir.
`FAILED_FINAL`	Poliçe kesin olarak kesilemedi.
`UNKNOWN`	Poliçe isteğinin sonucu henüz kesinleşmedi.
`CANCEL_PENDING`	Poliçe için iptal istendi; sonuç bekleniyor.
`CANCELLED`	Poliçe iptal edildi.

Siparişteki birimlerin yalnız bir kısmı kesildiğinde PARTIALLY_ISSUED görünür. Eksen PENDING, FAILED_RETRYABLE ya da UNKNOWN iken aynı işlemi yeniden başlatmayın. Kesilmiş poliçe CANCEL_PENDING üzerinden iptal edilir.

İade

Değer	Anlamı
`NONE`	İade yok.
`REQUIRED`	Prim iadesi gerekiyor.
`PENDING`	Prim iadesi sürüyor.
`REFUNDED`	Prim iade edildi.
`FAILED`	Prim iadesi başarısız oldu.

Belge

Değer	Anlamı
`NOT_AVAILABLE`	Belge henüz yok.
`PENDING`	Belge hazırlanıyor.
`AVAILABLE`	Poliçe belgesi alınabilir.
`FAILED`	Belge alınamadı.

Poliçe belgesi Lunixi'de saklanmaz; her istekte sağlayıcıdan alınır. Belge alınamasa da kesilmiş poliçe geçerli kalır.

Genel durum

Panelde ve API'de siparişin bir genel durumu da gösterilir. Genel durum ayrıca saklanmaz; her okumada dört eksenden türetilir. Koşullar yukarıdan aşağıya değerlendirilir ve ilk tutan satır genel durumu verir.

Genel durum	Koşul
`REFUNDED`	İade `REFUNDED`
`CANCELLED`	Poliçe `CANCELLED`
`FAILED`	Tahsilat `FAILED` ya da poliçe `FAILED_FINAL`
`ACTION_REQUIRED`	Tahsilat `ACTION_REQUIRED`
`PROCESSING`	Tahsilat ya da poliçe şu değerlerden birinde: `PENDING`, `UNKNOWN`, `FAILED_RETRYABLE`, `CANCEL_PENDING`
`PARTIALLY_ACTIVE`	Poliçe `PARTIALLY_ISSUED`
`ACTIVE`	Poliçe `ISSUED`
`CREATED`	Yukarıdakilerin hiçbiri

Belge durumu genel durumu etkilemez: poliçe kesildiyse belge henüz hazır olmasa da sipariş ACTIVE'dir.

Genel durum özet içindir. Ne olduğunu ayrıntılı anlamanız gerektiğinde eksenlere bakın. Örneğin FAILED genel durumunun tahsilattan mı poliçeden mi geldiğini eksenler gösterir.

İşleniyor (`PROCESSING`)

Bir işin sonucu henüz kesinleşmemiştir: tahsilat ya da poliçe sürüyor, sonucu doğrulanıyor, yeniden deneniyor ya da iptal bekleniyor. Bu durumda aynı işlemi yeniden başlatmayın. Sonuç kesinleştiğinde sipariş durumu güncellenir.

İade gerekiyor

Prim tahsil edildiği hâlde poliçe kesin olarak kesilemediyse poliçe FAILED_FINAL, iade REQUIRED olur ve genel durum FAILED görünür. Bu durumda primin alıcıya iade edilmesi gerekir. İade başlatıldığında iade ekseni PENDING, tamamlandığında REFUNDED olur.

İade başlatıldıktan sonra poliçe yine de kesilirse iade geri alınmaz; poliçe için otomatik olarak iptal istenir ve poliçe CANCEL_PENDING olur.

İade başladıktan sonra poliçe yine de kesilirse iade geri alınmaz; poliçe için otomatik iptal talebi açılır.

Veri biçimleri

Veri	Biçim	Örnek
Tutar	Kuruş cinsinden tamsayı. Ondalık, metin ya da para işareti kullanılmaz.	`12500` = 125,00 TRY
Para birimi	ISO 4217	`TRY`
Zaman damgası	ISO 8601, saat dilimi zorunlu	`2025-12-23T12:50:00+03:00`
Tarih	ISO 8601 `YYYY-MM-DD`	`1990-01-31`
Boş değer	Değer yoksa alan hiç gönderilmez; boş metin ya da "yok" gibi bir değer yazılmaz.	—

Saat dilimi olmayan bir zaman damgası (2025-12-23T12:50 gibi) kabul edilmez. Tablodaki değerler örnektir.

Yalnız Sigorta Entegrasyonu Nasıl Çalışır