Veri Biçimleri

Sigorta istekleri hangi sağlayıcıyla çalışırsanız çalışın aynı biçimleri kullanır. Sağlayıcının kendi biçimine çeviri Lunixi tarafında yapılır; siz yalnızca bu sayfadaki biçimleri gönderirsiniz.

Genel kurallar

• Alan adları İngilizce ve camelCase'dir; enum değerleri UPPER_SNAKE_CASE'dir (TICKET_CANCELLATION, FLIGHT).
• Değer yoksa alan hiç gönderilmez. Boş metin, null yerine geçen bir metin ya da "yok" gibi yer tutucu değerler kabul edilmez.
• Sayısal kod enum yerine kullanılmaz; enum değerleri metindir.
• Bu sayfadaki bütün değerler örnektir.

Tutar

Tutarlar kuruş cinsinden tamsayıdır.

• Tutar güvenli tamsayı aralığında olmalıdır (en fazla 2⁵³ − 1).
• Her tutar alanının kendi alt sınırı vardır; örneğin bilet tutarı (priceAmount) en az 1'dir.

Para birimi

ISO 4217 üç harfli kod: TRY, USD, EUR, GBP.

Zaman damgası

ISO 8601, saat dilimi zorunlu.

• Biçim: YYYY-MM-DDTHH:MM, isteğe bağlı saniye (:SS) ve saniye kesri (en fazla 6 hane), ardından Z ya da ±HH:MM.
• Tarih ve saat ayırıcısı T'dir.
• Takvimde olmayan gün (30 Şubat) ve 24:00 gibi saatler kabul edilmez.
• Saat dilimi olmayan bir zaman damgası ayrı bir nedenle reddedilir; böylece neyi düzeltmeniz gerektiğini bilirsiniz.

Tarih

ISO 8601 YYYY-MM-DD; takvimde var olan bir gün. Örnek: 1990-01-31.

Doğum tarihi gibi alanlar gelecekte bir tarih olamaz.

Telefon

E.164: +, ülke kodu ve numara; toplam 8-15 hane, ülke kodu 0 ile başlamaz.

E-posta

Tek @, boşluksuz; alan adında en az bir nokta; en fazla 180 karakter. Adresin teslim edilebilir olup olmadığı kontrol edilmez.

Kimlik numarası

Kişi kimliği iki alanla gönderilir: identityType ve identityNumber. Biri gönderilirse diğeri de zorunludur.

Hangi kimlik türünün kabul edildiği tipe ve kişinin rolüne göre değişir; tipin şemasında yazılıdır (Sigorta Tipleri).

Kontrol haneleri:

• TCKN: 10. hane = ((1., 3., 5., 7. ve 9. hanelerin toplamı × 7) − (2., 4., 6. ve 8. hanelerin toplamı)) mod 10. 11. hane = ilk 10 hanenin toplamı mod 10.
• VKN: İlk 9 hanenin her biri için, hane konumu i (1'den başlar) olmak üzere t = (hane + 10 − i) mod 10; t = 9 ise v = 9, değilse v = (t × 2^(10 − i)) mod 9. Son hane = (10 − (Σv mod 10)) mod 10.

Testlerde gerçek bir kişinin kimlik numarasını kullanmayın.

Kodlar

Referans kodları (ilçe, marka, model, araç tipi, ürün kategorisi) Lunixi'nin kendi kodlarıdır; sağlayıcının kimlikleri kabul edilmez. Geçerli kodlar referans uçlarından alınır: Sigorta Tipleri › Referans kodları. Biçimi doğru ama tanınmayan bir kod, teklif sırasında açık bir hatayla reddedilir.

IMEI

Cep telefonunun IMEI'si: 15 hane, son hane Luhn kontrol hanesidir.

IMEI kişisel veridir; sepet kaleminin insuranceContext alanında gönderilmez. Testlerde gerçek bir cihazın IMEI'sini kullanmayın.

Araç plakası

Türkiye plakası, boşluksuz ve büyük harfle: il kodu (01-81), harf grubu ve sayı grubu. Harfler Latin A-Z'dir.

Yabancı plaka yalnızca yabancı plakalı araç senaryosunu kabul eden tipte gönderilir (registrationScenario: FOREIGN_PLATE): boşluksuz, büyük Latin harf ve rakam, 2-15 karakter. Ayraçları (boşluk, tire) gönderilmeden önce kaldırın. Henüz tescil edilmemiş araçta plaka gönderilmez; plaka il kodu (plateCityCode, 01-81) gönderilir. Diğer tiplerde yalnızca Türkiye plakası kabul edilir. Plaka kişisel veridir; sepet kaleminin insuranceContext alanında gönderilmez.

Araç belgeleri ve kimlikleri

Araç alanlarının adları ve biçimleri bütün araç tiplerinde aynıdır. Bir tipin hangi araç alanını istediği tipin şemasında yazılıdır (Sigorta Tipleri).

Ruhsat, şasi numarası, motor numarası, montaj kodu ve sürücünün kimlik numarası kişisel veri sayılır; sepet kaleminin insuranceContext alanında gönderilmez. Testlerde gerçek bir aracın belgelerini kullanmayın.

Konut adresi ve bina

Konut tiplerinde adres tek alandır: uavtAddressCode.

Kodu adres zincirinden adım adım bulabilirsiniz: Sigorta Tipleri › UAVT adres zinciri. UAVT adres kodu ve adres zincirinin kodları kişisel veri sayılır; sepet kaleminin insuranceContext alanında gönderilmez. Testlerde gerçek bir konutun adres kodunu kullanmayın.

Model yılı

JSON sayısı, 1950 ile içinde bulunulan yılın bir sonrası arasında. "2022" gibi metin kabul edilmez.

Metin

• Baştaki ve sondaki boşluk temizlenir; metin Unicode NFC'ye çevrilir. Uzunluk sınırı temizlenmiş metne uygulanır.
• Boş metin kabul edilmez.
• Tek satırlık alanlarda satır sonu dahil kontrol karakterleri kabul edilmez.
• "yok" gibi yer tutucu değerler kabul edilmez (büyük-küçük harf fark etmez). Değer yoksa alanı göndermeyin.
• Her metin alanının en fazla uzunluğu tipin şemasında yazılıdır.

Kimlik önekleri

Lunixi kimlikleri önekli ve opaktır. Biçim: önek + 32 küçük harf onaltılık hane.

• Kimliği olduğu gibi saklayın ve aynen geri gönderin; içeriğine anlam yüklemeyin.
• Önek türü ayırır: teklif kimliği beklenen yerde gönderilen sipariş kimliği, var olmayan bir kimlik gibi ele alınır.

Sepet kalemi sigorta alanları

Hangi sigortanın sunulacağı, ödeme isteğindeki sepet kalemlerinin sigorta alanlarından çözülür. Alanlar, kurallar, kalem türü sözlüğü ve insuranceContext anahtarları Sepet Kalemleri sayfasındadır. Bu alanlardaki zaman damgası, tarih ve kodlar bu sayfadaki biçimlere uyar.

Sepet kaleminin sigorta ön verisi (insuranceData) de bu sayfadaki biçimleri kullanır: IMEI, plaka, kimlik numarası ve diğer kişisel alanlar insuranceContext'te gönderilmez, insuranceData'da gönderilebilir. Biçime uymayan ön veri ödemeyi durdurmaz; o kalemin ön verisi kullanılmaz: Sepet Kalemleri › Sigorta ön verisi.