Sigorta Tipleri ve Şemalar

Sigorta tipi, Lunixi'nin sağlayıcıdan bağımsız sigorta kodudur. Teklif ve sipariş isteklerinde hangi sigortayı istediğinizi bu kodla belirtirsiniz. Hangi sağlayıcı ürününün kullanılacağını isteğiniz değil, sağlayıcı bağlantılarınız belirler.

• Yayınlanmış bir tip kodu değişmez ve silinmez. Yeni tipler kataloğa eklenir.
• Alan adları ve biçimler hangi sağlayıcıyla çalışırsanız çalışın aynıdır. Sağlayıcıya özgü alan adı kabul edilmez.
• Primi kimin tahsil ettiği tipe değil, bağlantınızdaki ürüne bağlıdır. Teklif seçeneğindeki premiumCollectedBy alanına bakın; değer PROVIDER ise primi sağlayıcınız tahsil eder: Sağlayıcı Tahsilatı.

Tip kataloğu

Sepet kalemi türü, kalemin insuranceCategory değeridir; tipin hangi sepet kalemine sunulacağı bu alandan çözülür (bkz. Sepet Kalemleri). DEVICE türünde iki ayrı tip vardır: cihaz sigortası ve onarım paketi teminatı, girdisi ve belgesi farklı iki üründür.

Sepet kalemi türü olmayan tip bir sepet kalemine bağlanmaz; yalnızca API yolunda, sepet kalemi olmadan satılır: Sepet Kalemi Olmadan Satış. "Sepet kalemi olmadan da satılır" yazan tipler iki yolla satılır: sepet kalemiyle ve API yolunda sepet kalemi olmadan. Diğer tipler yalnızca bir sepet kalemiyle sunulur.

tickets dışındaki tip nesneleri tekildir: bir teklif tek bir konaklamayı, cihazı, ürünü, aracı, seyahati, müzik aletini, etkinlik biletini, kiralamayı, tıbbi işlemi, hayvanı, dönemi ya da konutu korur; sepete bağlı teklifte bu tek bir sepet kalemidir. PERSONAL_ACCIDENT, FOREIGN_RESIDENT_HEALTH ve SUPPLEMENTARY_HEALTH teklifi tek bir kişiyi korur. INBOUND_TRAVEL_HEALTH ve ABROAD_STAY_HEALTH teklifinde bütün sigortalılar aynı poliçededir.

Talep tipleri ("Yalnızca talep") teklif vermez. Bu tiplerde teklif, tahsilat ve poliçe yoktur; alıcının bilgileri bağlantınızdaki sağlayıcıya talep olarak iletilir: Talep. Talep tipi için teklif isteği 412 insurance.type.not_available alır. Talep tiplerinin alanları talep şemasındadır.

"Talep de açılır" yazan tipler hem teklif verir hem talep alır. Teklif isteği tipin şemasıyla, talep isteği tipin talep şemasıyla gönderilir. Teklif bağlantılarınızdaki teklif veren ürüne, talep talep alan ürüne gider; ikisi ayrı ürünlerdir.

Şema sürümü (schemaVersion)

Her tipin alanları bir şemayla tanımlanır ve şema tip başına sürümlenir (schemaVersion).

• Yayınlanmış bir şema sürümü değişmez: alan kümesi ve zorunlulukları sonradan sıkılaştırılmaz.
• Kırıcı bir değişiklik yeni bir schemaVersion olarak yayınlanır; eski sürüm yanında durmaya devam eder.
• Sağlayıcının kendi ürününü güncellemesi Lunixi şemasını değiştirmez.

Sepet kaleminde ön veri

Sepet kalemiyle satılan her tipte, bu sayfadaki alanları teklif isteğinden önce sepet kaleminde de verebilirsiniz:

• Kişisel olmayan alanların bir kısmı kalemin insuranceContext'inden doldurulur. Hangi anahtarın hangi tipte hangi alanı doldurduğu: Sepet Kalemleri › Ön doldurma.
• Kişi alanları ve tip nesnesinin diğer alanları kalemin insuranceData'sıyla verilir. Alan adları ve biçimler bu sayfadakiyle aynıdır; tip nesnesi kalem için tek nesnedir (tickets dahil) ve basketItemId taşımaz: Sepet Kalemleri › Sigorta ön verisi.
• Sepette verdiğiniz alanlar teklifte zorunluluk için sayılır. Teklif isteğinde yalnızca eksikleri gönderirsiniz: Teklif › Ön veriyle teklif.

Yalnızca sepet kalemi olmadan satılan tiplerin ve talep tiplerinin alanları istekte gönderilir.

Aşamalar

Bir alanın zorunlu olup olmadığı, isteğin hangi aşamada olduğuna bağlıdır:

• Teklif bir ödemenin sepetine bağlıysa (ödeme kimliğiyle ya da Checkout Form'da), tip nesnesinde basketItemId de zorunludur; tickets gibi dizi olan tip nesnesinde her ögede.
• Sepet kalemi olmadan alınan teklifte basketItemId gönderilmez; gönderilirse istek reddedilir.
• POLICY aşamasının alanlarını da teklif isteğinde gönderin. Sipariş ve poliçe isteklerinde ayrıca alan gönderilmez; poliçe teklifin bilgileriyle kesilir. Bkz. Teklif.

Ürüne göre ek zorunlu alanlar

Bir tipin şeması, o tipi sunan bütün ürünlerin alanlarını kapsar. Bağlantılarınızdaki bir ürün, şemada isteğe bağlı olan bir alanı zorunlu tutabilir ya da bir alanı şemadakinden daha erken bir aşamada isteyebilir.

• Bu alanlar Uygunluk yanıtının fields dizisinde requiredBy ile işaretlidir.
• Ürünün teklif aşamasında istediği bir alan eksikse yalnızca o ürünün seçeneği elenir; diğer seçenekler döner: Teklif › Elenen seçenekler.
• Ürünün poliçe aşamasında istediği bir alan eksikse sipariş 422 insurance.validation.invalid ile reddedilir.

Kişi alanları (policyholder, insured[])

Kişi alanları bütün tiplerde aynıdır. Tipten tipe değişen, hangi kimlik türlerinin kabul edildiği, kaç sigortalı gönderilebildiği ve hangi alanın hangi aşamada zorunlu olduğudur. Bunlar her tipin bölümündeki kişi tablosundadır.

address:

Sağlık beyanı (heightCm, weightKg, pregnancyStatus) özel nitelikli kişisel veridir.

Kişi tablolarında "Adres (il, ilçe, satır)" yazan aşamada address ile birlikte cityCode, districtCode ve line zorunludur. "Adres (ülke, il, ilçe, satır)" yazan aşamada countryCode de zorunludur; "adres satırı" yazan aşamada address ile birlikte yalnızca line zorunludur. Tabloda adı geçmeyen kişi alanları isteğe bağlıdır.

Talep şemalarında policyholder yalnızca kimlik türü ve numarası, doğum tarihi, e-posta ve telefon taşır; diğer kişi alanları gönderilirse istek reddedilir. Bkz. Talep şemaları.

Biçimlerin ayrıntısı: Veri Biçimleri.

Referans kodları

Marka, model, araç tipi, kullanım şekli, sorumluluk limiti, ürün kategorisi, meslek, tıbbi işlem, evcil hayvan ırkı, konut türü, banka ve ilçe gibi alanlar Lunixi referans kodu taşır. Sağlayıcının kimlikleri kabul edilmez. Geçerli kodları şu uçtan alın:

GET /api/v1/insurance/reference/{kind}

Yanıtta kodlar data.items dizisindedir; her öge code, label (dil koduna göre görünen adlar, ör. tr-TR) ve parentCode taşır. Sayfalama bilgisi pageInfo alanındadır. Liste yalnızca kullanımdaki kodları döner ve bütün merchant'lar için aynıdır; araç tipine ve yılına göre süzülen marka ve model listesi ile adres zinciri bunun dışındadır.

• Kodu olduğu gibi gönderin; görünen adı (label) istekte kullanmayın.
• Biçimi doğru ama tanınmayan ya da bağlantınızın sağlayıcısında karşılığı olmayan bir kod teklifte 422 insurance.reference.unknown ile reddedilir (Hata Kodları). Tahmini ya da boş değer göndermeyin.
• Ülke kodu (COUNTRY) uyruk ve gidilecek ülke alanlarında da kullanılır. Bir ülkenin bağlantınızın sağlayıcısında karşılığı yoksa o alan da 422 insurance.reference.unknown alır.

Araç tipine ve yılına göre liste

VEHICLE_BRAND ve VEHICLE_MODEL listelerini araç tipine ve model yılına göre süzebilirsiniz: GET /api/v1/insurance/reference/VEHICLE_BRAND?vehicleTypeCode=<araç tipi kodu>&modelYear=<yıl>. Model listesinde markayı parentCode ile gönderin.

• Süzülen liste, bağlantılarınızdaki sağlayıcılardan istek anında okunur. Yalnızca bağlantılarınızın sunduğu ve Lunixi kodu olan marka ve modeller döner; bu yüzden liste hesabınıza özgüdür ve zamanla değişebilir.
• vehicleTypeCode ve modelYear birlikte gönderilir. Biri eksikse istek 422 insurance.validation.invalid (reason: required) alır. İkisi de gönderilmezse kullanımdaki bütün kodlar döner.
• Model yılı 1950 ile içinde bulunulan yılın bir sonrası arasında olmalıdır; değilse reason: invalid_model_year.
• Bu parametreler başka bir türde gönderilirse reason: not_applicable döner.
• Bağlantılarınızda süzülmüş liste sunan bir sağlayıcı yoksa 422 insurance.validation.invalid (field: kind, reason: live_reference_unavailable) döner. Araç tipi kodunun bağlantınızın sağlayıcısında karşılığı yoksa 422 insurance.reference.unknown döner.

UAVT adres zinciri

Konut tiplerinde (COMPULSORY_EARTHQUAKE, HOME_INSURANCE) konutun adresi tek bir alanla gönderilir: property.uavtAddressCode, Ulusal Adres Veri Tabanı'ndaki (UAVT) bağımsız bölümün adres kodu. UAVT adres kodu ulusal bir koddur. Alıcınız kodu biliyorsa doğrudan gönderebilirsiniz; bilmiyorsa kodu adres zincirini adım adım dolaşarak bulun. Her adımda alıcıya listeyi gösterin, seçtiği ögenin code değerini bir sonraki adımın parentCode'u olarak gönderin:

Son adımda seçilen ögenin code değeri UAVT adres kodudur; teklif isteğinde property.uavtAddressCode olarak gönderin. Zincirin diğer kodları teklife gönderilmez.

• Belde ya da köy adımından başlayarak listeler bağlantılarınızdaki sağlayıcılardan istek anında okunur ve kalıcı olarak saklanmaz. Bağlantılarınızda adres zinciri sunan bir sağlayıcı yoksa istek 422 insurance.validation.invalid (field: kind, reason: live_reference_unavailable) alır.
• Zincirin kodları ulusal adres kodlarıdır. Belde ya da köy, mahalle, cadde ya da sokak ve bina kodu 1-12 hanedir; bağımsız bölümün kodu (UAVT adres kodu) 10 hanedir. Kodlar metindir; baştaki sıfırlar korunur. Bu adımlarda biçimi bozuk bir üst kod parentCode alan yoluyla reason: invalid_reference_code alır.
• Belde ya da köy adımında ilçe kodunun bağlantınızın sağlayıcısında karşılığı yoksa istek parentCode alan yoluyla 422 insurance.reference.unknown alır.
• Bina listesi sokak koduyla birlikte binanın dış kapı numarasını (outerDoorNumber) ister. Dış kapı numarası rakamla başlar; rakam, harf, /, -, . ve boşluk içerebilir; en fazla 16 karakterdir (ör. 12, 12A, 12/1). Gönderilmezse reason: required, biçimi bozuksa reason: invalid_outer_door_number döner. Başka bir türde gönderilirse reason: not_applicable döner.
• Adres listelerinde label resmî yer adıdır; tr-TR ve en-US aynı metni taşır. Sayfalama diğer referans listeleriyle aynıdır (limit, cursor).
• Adres kişisel veridir. Zincirin kodlarını ve UAVT adres kodunu sepet kaleminin insuranceContext alanında göndermeyin.

Teklif sırasında UAVT adres kodu doğrulanır. Biçimi bozuk kod property.uavtAddressCode alan yoluyla 422 insurance.validation.invalid (reason: invalid_uavt_address_code) alır. Biçimi doğru ama UAVT'de bulunmayan kod da aynı alan yoluyla reason: unknown_uavt_address_code alır ve teklif isteği sağlayıcıya gönderilmez.

TICKET_CANCELLATION: şema sürüm 1

Otobüs, uçak ve tren biletinin iptaline karşı sigorta. Sepet kaleminde insuranceCategory: TICKET ile çözülür.

İstek gövdesindeki tipe ait alanlar üç köktür: policyholder, insured ve tip nesnesi tickets.

tickets[]

"Yalnız FLIGHT" işaretli alanlar yalnızca transportMode: FLIGHT olan bilette geçerlidir ve zorunluluk da yalnızca o zaman uygulanır. Başka bir taşıma türünde gönderilirlerse istek reddedilir.

Kişiler

policyholder içinde hiçbir kişi alanı tek başına zorunlu değildir; yalnızca identityType ile identityNumber birlikte gönderilir.

Pasaportla sigortalanan kişi

Yabancı uyruklu yolcuyu TC kimlik numarası yerine pasaportla (identityType: PASSPORT) sigortalayabilirsiniz. Pasaportlu kişide şu alanlar da gerekir:

gender ve residenceCountryCode TC kimlik numarasıyla gönderilirse alan yoluyla not_applicable alır. Bu alanlar sepet kaleminde insuranceData ile de verilebilir: Sepet Kalemleri › Sigorta ön verisi.

Örnek istek: Teklif.

HOTEL_CANCELLATION: şema sürüm 1

Otel rezervasyonunun iptaline karşı sigorta. Sepet kaleminde insuranceCategory: HOTEL ile çözülür. Tip nesnesi stay tek bir konaklamadır.

stay

Tarihler konaklama yerinin takvim günüdür.

Kişiler

Örnek

Bu sayfadaki örnekler teklif isteğinin yalnızca tipe ait alanlarını, poliçe alanlarıyla birlikte gösterir; para birimi ve sepet kaynağı için bkz. Teklif. Değerler örnektir; açılı parantez içindeki değerlerin yerine alıcınızın bilgilerini, referans kodlarının yerine referans uçlarından aldığınız kodları yazın:

{
  "insuranceType": "HOTEL_CANCELLATION",
  "policyholder": {
    "identityType": "TCKN",
    "identityNumber": "<kimlik numarası>",
    "birthDate": "<YYYY-MM-DD>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>",
    "address": {
      "cityCode": "35",
      "districtCode": "<ilçe kodu>",
      "line": "<açık adres>"
    }
  },
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>"
    }
  ],
  "stay": {
    "basketItemId": "hotel-1",
    "hotelName": "Örnek Otel",
    "checkInDate": "2025-12-23",
    "checkOutDate": "2025-12-25",
    "guestCount": 2,
    "reservationAmount": 450000,
    "cityCode": "35"
  }
}

DEVICE_INSURANCE: şema sürüm 1

Cep telefonu için sigorta poliçesi. Sepet kaleminde insuranceCategory: DEVICE ile çözülür. Tip nesnesi device tek bir cihazdır. Cihazın IMEI'si ve teminat tutarı teklif aşamasında zorunludur.

device

Kişiler

Fiyat sigortalının bilgileriyle hesaplanır; bu yüzden kişi alanları teklif aşamasında zorunludur.

Örnek

{
  "insuranceType": "DEVICE_INSURANCE",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "firstName": "<ad>",
      "lastName": "<soyad>",
      "birthDate": "<YYYY-MM-DD>",
      "gender": "FEMALE",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "address": {
        "cityCode": "34",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "device": {
    "basketItemId": "phone-1",
    "brandCode": "<marka kodu>",
    "modelCode": "<model kodu>",
    "imei": "<IMEI>",
    "sumInsuredAmount": 3500000
  }
}

DEVICE_PROTECTION: şema sürüm 1

Cep telefonunun onarım masrafını karşılayan koruma paketi. Sepet kaleminde insuranceCategory: DEVICE ile çözülür. Tip nesnesi device tek bir cihazdır. Teklif yalnızca marka ve modelle, IMEI'siz ve kişisel veri olmadan alınır.

device

IMEI, poliçeden sonra tanımlanamaz; en geç teklif isteğinde, poliçe alanlarıyla birlikte gönderin.

Kişiler

Örnek

{
  "insuranceType": "DEVICE_PROTECTION",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "address": {
        "cityCode": "06",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "device": {
    "basketItemId": "phone-1",
    "brandCode": "<marka kodu>",
    "modelCode": "<model kodu>",
    "imei": "<IMEI>"
  }
}

EXTENDED_WARRANTY: şema sürüm 1

Elektronik ve beyaz eşyanın üretici garantisi bittikten sonra 12 ya da 24 ay ek güvence. Sepet kaleminde insuranceCategory: ELECTRONICS ile çözülür. Tip nesnesi product tek bir üründür. Teklif kişisel veri olmadan alınır.

product

Ürün bedelinin üst sınırı bağlantınızdaki ürünün kuralıdır; sınırı aşan istek teklif aşamasında reddedilir. Kurumsal müşteri (vergi kimlik numarası) bu sürümde desteklenmez.

Kişiler

Örnek

{
  "insuranceType": "EXTENDED_WARRANTY",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "firstName": "<ad>",
      "lastName": "<soyad>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "address": {
        "cityCode": "16",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "product": {
    "basketItemId": "tv-1",
    "categoryCode": "<kategori kodu>",
    "brand": "Örnek Marka",
    "model": "Örnek Model 55",
    "priceAmount": 2500000,
    "warrantyMonths": 24
  }
}

ROADSIDE_ASSISTANCE: şema sürüm 1

Aracın yolda kalması hâlinde çekici ve yerinde yardım hizmeti. Sepet kaleminde insuranceCategory: VEHICLE ile çözülür. Tip nesnesi vehicle tek bir araçtır. Teklif kişisel veri ve plaka olmadan alınır.

vehicle

Bu sürüm yalnızca Türkiye plakalı araçları kabul eder.

Kişiler

Sigortalının kimliği ve doğum tarihi isteğe bağlıdır. Adres fatura adresi olarak da kullanılır.

Örnek

{
  "insuranceType": "ROADSIDE_ASSISTANCE",
  "insured": [
    {
      "firstName": "<ad>",
      "lastName": "<soyad>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "address": {
        "cityCode": "07",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "vehicle": {
    "basketItemId": "car-1",
    "brandCode": "<marka kodu>",
    "modelCode": "<model kodu>",
    "modelYear": 2022,
    "vehicleTypeCode": "<araç tipi kodu>",
    "plate": "<plaka>"
  }
}

TRAVEL_HEALTH: şema sürüm 1

Yurt içi ve yurt dışı seyahat için sağlık sigortası. Sepet kaleminde insuranceCategory: TRAVEL ile çözülür. Tip nesnesi trip tek bir seyahattir; seyahatteki bütün sigortalılar aynı poliçededir.

trip

"Yalnız INTERNATIONAL" ve "yalnız DOMESTIC" işaretli alanlar yalnızca o kapsamda geçerlidir ve zorunluluk da yalnızca o zaman uygulanır. Diğer kapsamda gönderilirlerse istek reddedilir.

Kişiler

Bağlantınızdaki ürünler seyahatin kapsamına ve sigortalıların kimlik türüne göre ayrışır. Pasaportla sigortalanan kişi için ad, soyad ve cinsiyet (gender) de gerekebilir; bu alanları elinizde varsa gönderin. İsteğe uymayan üründen teklif dönmez. Hiçbir ürün isteğe uymuyorsa (örneğin bağlantınızdaki ürünler tek bir varış ülkesi kabul ediyorsa ve birden çok ülke gönderdiyseniz) teklif 422 insurance.quote.declined ile reddedilir.

Örnek

Yurt dışı seyahat:

{
  "insuranceType": "TRAVEL_HEALTH",
  "policyholder": {
    "identityType": "TCKN",
    "identityNumber": "<kimlik numarası>",
    "birthDate": "<YYYY-MM-DD>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>"
  },
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>"
    }
  ],
  "trip": {
    "basketItemId": "tour-1",
    "scope": "INTERNATIONAL",
    "startDate": "2025-12-23",
    "endDate": "2025-12-30",
    "residenceCountryCode": "TR",
    "destinationCountryCodes": ["DE"]
  }
}

Yurt içi seyahatte destinationCountryCodes gönderilmez; poliçe için kalkış ili originCityCode gönderilir:

{
  "scope": "DOMESTIC",
  "startDate": "2025-12-23",
  "endDate": "2025-12-26",
  "residenceCountryCode": "TR",
  "originCityCode": "06"
}

MUSICAL_INSTRUMENT_PROTECTION: şema sürüm 1

Müzik aletinin ani ve beklenmedik hasarında onarım masrafını karşılayan koruma paketi. Sepet kaleminde insuranceCategory: MUSICAL_INSTRUMENT ile çözülür. Tip nesnesi instrument tek bir alettir. Teklif kişisel veri olmadan, aletin markası, modeli ve bedeliyle alınır.

instrument

• Müzik aleti kategorileri PRODUCT_CATEGORY listesindedir. Bu tipte müzik aleti kategorisi olmayan bir kod (örneğin bir elektronik ürün kategorisi) 422 insurance.reference.unknown ile reddedilir.
• Seri numarasını gönderirseniz poliçe belgesine yazılır.
• Bağlantınızdaki ürün birden çok paket sunuyorsa bir teklif isteği paket başına ayrı bir seçenek döner: Teklif › Birden çok seçenek.

Kişiler

Poliçe aşamasında kimlik türüne göre ayrıca:

• TCKN: doğum tarihi (birthDate) ya da ad ve soyad (firstName, lastName). İkisi de yoksa istek insured[0].birthDate alan yoluyla 422 insurance.validation.invalid alır. Cinsiyet (gender) isteğe bağlıdır.
• VKN: ticari unvan (companyName).

Kurumsal (VKN) poliçede bağlantınızdaki ürün iptali desteklemiyorsa iptalin sonucu insurance.policy.cancel_failed olur ve poliçe yürürlükte kalır: İptal ve Prim İadesi.

Örnek

{
  "insuranceType": "MUSICAL_INSTRUMENT_PROTECTION",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "instrument": {
    "basketItemId": "guitar-1",
    "brand": "Örnek Marka",
    "model": "Örnek Model",
    "valueAmount": 4500000,
    "categoryCode": "<kategori kodu>",
    "serialNumber": "<seri numarası>"
  }
}

Sigortalı bir kurumsa insured şöyle gönderilir:

"insured": [
  {
    "identityType": "VKN",
    "identityNumber": "<vergi kimlik numarası>",
    "companyName": "<ticari unvan>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>"
  }
]

EVENT_ACCIDENT: şema sürüm 1

Etkinlik katılımcısı için etkinlik günü geçerli ferdi kaza sigortası. Sepet kaleminde insuranceCategory: EVENT ile çözülür. Tip nesnesi event tek bir etkinlik biletidir: bir teklif tek bileti ve tek katılımcıyı korur. Fiyat katılımcının bilgileriyle hesaplanır; bu yüzden kişi alanları teklif aşamasında zorunludur.

event

• Poliçe kesildiği gün geçerlidir ve en fazla bir gün sürer. Teklifi etkinlik günü alın.
• Gün, Türkiye takvim günüdür. Geçmiş bir gün 422 insurance.validation.invalid (reason: must_not_be_past), ileri bir gün 422 insurance.quote.declined ile reddedilir.
• Gün sipariş ve tahsilat sırasında yeniden kontrol edilir. Teklif alındıktan sonra gün değiştiyse işlem insurance.quote.declined ile reddedilir; yeni teklif alın.
• Her bilet ayrı bir sepet kalemi ve ayrı bir tekliftir.

Kişiler

Uyruk (nationalityCountryCode) isteğe bağlıdır; gönderilmezse TR kabul edilir.

Örnek

{
  "insuranceType": "EVENT_ACCIDENT",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "event": {
    "basketItemId": "concert-1",
    "coverageStartDate": "<bugün, YYYY-MM-DD>"
  }
}

MICROMOBILITY_ACCIDENT: şema sürüm 1

Kiralık scooter sürücüsü için kiralama günü geçerli ferdi kaza sigortası. Sepet kaleminde insuranceCategory: MICROMOBILITY ile çözülür. Tip nesnesi rental tek bir kiralamadır: bir teklif tek kiralamayı ve tek sürücüyü korur. Fiyat sürücünün bilgileriyle hesaplanır; bu yüzden kişi alanları teklif aşamasında zorunludur.

rental

• Poliçe kesildiği gün geçerlidir ve en fazla bir gün sürer.
• Gün, Türkiye takvim günüdür. Geçmiş bir gün 422 insurance.validation.invalid (reason: must_not_be_past), ileri bir gün 422 insurance.quote.declined ile reddedilir. Günü gönderdiyseniz ve teklif alındıktan sonra gün değiştiyse sipariş insurance.quote.declined ile reddedilir.

Kişiler

Uyruk (nationalityCountryCode) isteğe bağlıdır; gönderilmezse TR kabul edilir.

Örnek

{
  "insuranceType": "MICROMOBILITY_ACCIDENT",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "rental": {
    "basketItemId": "ride-1"
  }
}

PERSONAL_ACCIDENT: şema sürüm 1

Bir kişi için yıllık ferdi kaza sigortası. Bu tip bir sepet kalemine bağlanmaz; yalnızca API yolunda, sepet kalemi olmadan satılır: Sepet Kalemi Olmadan Satış. Tip nesnesi accident sigortanın bilgileridir ve basketItemId taşımaz. Teklif kişisel veri olmadan, yalnızca başlangıç günüyle alınır.

accident

• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Meslek kodu, sipariş oluşturulurken bağlantınızın sağlayıcısındaki karşılığıyla kontrol edilir. Karşılığı olmayan kod siparişte 422 insurance.reference.unknown alır ve prim tahsil edilmez. Geçerli kodları referans ucundan alın.

Kişiler

Örnek

{
  "insuranceType": "PERSONAL_ACCIDENT",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "accident": {
    "coverageStartDate": "<YYYY-MM-DD>",
    "occupationCode": "<meslek kodu>",
    "beneficiaryName": "<lehtarın adı>"
  }
}

MEDICAL_COMPLICATION: şema sürüm 1

Sağlık turizmi kapsamında yapılan tıbbi işlemin komplikasyonuna karşı sigorta. Sepet kaleminde insuranceCategory: HEALTH ile çözülür. Tip nesnesi procedure tek bir işlemdir: bir teklif tek işlemi ve tek hastayı korur. Kişiler pasaportla sigortalanır. Fiyat sigortalının bilgileriyle hesaplanır; bu yüzden kişi ve işlem alanları teklif aşamasında zorunludur.

procedure

• Günler Türkiye takvim günüdür. Teminat dönemi dışındaki işlem günü procedure.procedureDate alan yoluyla 422 insurance.validation.invalid (reason: out_of_range) alır.
• Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Bağlantınızdaki ürün bu poliçenin iptalini desteklemiyorsa iptal isteği 412 insurance.provider.not_integrated döner.

Kişiler

Örnek

{
  "insuranceType": "MEDICAL_COMPLICATION",
  "insured": [
    {
      "identityType": "PASSPORT",
      "identityNumber": "<pasaport numarası>",
      "firstName": "<ad>",
      "lastName": "<soyad>",
      "gender": "MALE",
      "birthDate": "<YYYY-MM-DD>",
      "birthPlace": "<doğum yeri>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "procedure": {
    "basketItemId": "treatment-1",
    "procedureCoverCode": "<işlem kodu>",
    "procedureDate": "<YYYY-MM-DD>",
    "facilityName": "Örnek Hastane",
    "startDate": "<YYYY-MM-DD>",
    "endDate": "<YYYY-MM-DD>"
  }
}

PET_HEALTH: şema sürüm 1

Kedi ve köpek için sağlık sigortası. Sepet kaleminde insuranceCategory: PET ile çözülür; sepet kalemi olmadan da satılır (Sepet Kalemi Olmadan Satış). Tip nesnesi pet tek bir hayvandır. Fiyat hayvanın ve sahibinin bilgileriyle hesaplanır; bu yüzden sahibin ve hayvanın alanları teklif aşamasında zorunludur.

pet

• Irk kodlarını türün altından alın: GET /api/v1/insurance/reference/PET_BREED?parentCode=CAT. Irkı türüyle uyumlu gönderin.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Bağlantınızdaki bazı ürünler hayvanın rengini ister. petColor göndermezseniz yalnızca bu ürünlerin seçenekleri pet.petColor alan yoluyla elenir; diğer seçenekler döner: Teklif › Elenen seçenekler.
• Bağlantınızdaki ürün birden çok paket sunuyorsa bir teklif isteği paket başına ayrı bir seçenek döner: Teklif › Birden çok seçenek.

Kişiler

Örnek

{
  "insuranceType": "PET_HEALTH",
  "policyholder": {
    "identityType": "TCKN",
    "identityNumber": "<kimlik numarası>",
    "birthDate": "<YYYY-MM-DD>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>"
  },
  "pet": {
    "basketItemId": "pet-1",
    "coverageStartDate": "<YYYY-MM-DD>",
    "petName": "<hayvanın adı>",
    "petSpecies": "CAT",
    "petBreedCode": "<ırk kodu>",
    "petGender": "FEMALE",
    "petBirthDate": "<YYYY-MM-DD>",
    "petColor": "<renk>"
  }
}

Sepet kalemi olmadan alınan teklifte pet.basketItemId gönderilmez.

VEHICLE_TAG_PROTECTION: şema sürüm 1

Aracın taşıt tanıma cihazı (UTTS) için koruma: cihaz, yanlış akaryakıt dolumu ve çekme ya da kurtarma teminatları. Sepet kaleminde insuranceCategory: VEHICLE ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi vehicle tek bir aracın cihazıdır. Teklif kişisel veri ve araç kimliği olmadan, yalnızca başlangıç günüyle alınır.

vehicle

• Bu sürüm yalnızca Türkiye plakalı araçları kabul eder.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Şasi numarası ve montaj kodunun biçimi: Veri Biçimleri › Araç belgeleri ve kimlikleri.

Kişiler

Örnek

{
  "insuranceType": "VEHICLE_TAG_PROTECTION",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "vehicle": {
    "basketItemId": "car-1",
    "coverageStartDate": "<YYYY-MM-DD>",
    "plate": "<plaka>",
    "chassisNumber": "<şasi numarası>",
    "tagInstallationCode": "<montaj kodu>"
  }
}

MOTOR_GREEN_CARD: şema sürüm 1

Yeşil Kart: aracın yurt dışındaki sorumluluk sigortası. Sepet kaleminde insuranceCategory: VEHICLE ya da TRAVEL ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi vehicle tek bir aracın tek dönemidir. Fiyat sigortalının ve aracın bilgileriyle hesaplanır; bu yüzden bütün alanlar teklif aşamasında zorunludur.

vehicle

registrationDocument:

• Bu sürüm yalnızca Türkiye plakalı araçları kabul eder.
• Araç sınıfının seçtiğiniz dönem için fiyatı yoksa teklif 422 insurance.quote.declined ile reddedilir.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Poliçe kesildiğinde Yeşil Kart sertifikasını sertifika ucundan alabilirsiniz.

Kişiler

Örnek

{
  "insuranceType": "MOTOR_GREEN_CARD",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "vehicle": {
    "basketItemId": "car-1",
    "plate": "<plaka>",
    "registrationDocument": {
      "serial": "<seri kodu>",
      "number": "<ruhsat numarası>"
    },
    "registrationDate": "<YYYY-MM-DD>",
    "seatCount": 5,
    "vehicleTypeCode": "<araç sınıfı kodu>",
    "startDate": "<YYYY-MM-DD>",
    "endDate": "<YYYY-MM-DD>"
  }
}

INBOUND_TRAVEL_HEALTH: şema sürüm 1

Türkiye'ye gelen yabancı ziyaretçi için sağlık sigortası. TRAVEL_HEALTH'ten ayrı bir tiptir: tip nesnesinin adı aynıdır (trip), alanları bu şemanındır. Sepet kaleminde insuranceCategory: TRAVEL ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi trip tek bir ziyaretin tek dönemidir; bütün sigortalılar aynı poliçededir. Kişiler pasaportla sigortalanır. Fiyat kişilerin bilgileriyle hesaplanır; bu yüzden kişi alanları teklif aşamasında zorunludur.

trip

• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Uyruğun (nationalityCountryCode) bağlantınızın sağlayıcısında karşılığı yoksa teklif, kişinin alan yoluyla 422 insurance.reference.unknown alır.
• Bağlantınızdaki ürün bu poliçenin iptalini desteklemiyorsa iptal isteği 412 insurance.provider.not_integrated döner.

Kişiler

İletişim bilgileri sigorta ettirenindir; sigortalıların e-posta ve telefonu isteğe bağlıdır.

Örnek

{
  "insuranceType": "INBOUND_TRAVEL_HEALTH",
  "policyholder": {
    "identityType": "PASSPORT",
    "identityNumber": "<pasaport numarası>",
    "firstName": "<ad>",
    "lastName": "<soyad>",
    "gender": "FEMALE",
    "birthDate": "<YYYY-MM-DD>",
    "birthPlace": "<doğum yeri>",
    "nationalityCountryCode": "DE",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>",
    "address": {
      "line": "<açık adres>"
    }
  },
  "insured": [
    {
      "identityType": "PASSPORT",
      "identityNumber": "<pasaport numarası>",
      "firstName": "<ad>",
      "lastName": "<soyad>",
      "gender": "FEMALE",
      "birthDate": "<YYYY-MM-DD>",
      "birthPlace": "<doğum yeri>",
      "nationalityCountryCode": "DE",
      "address": {
        "line": "<açık adres>"
      }
    }
  ],
  "trip": {
    "basketItemId": "visit-1",
    "startDate": "<YYYY-MM-DD>",
    "endDate": "<YYYY-MM-DD>"
  }
}

FOREIGN_RESIDENT_HEALTH: şema sürüm 1

Türkiye'de ikamet eden yabancı için sağlık sigortası. Bu tip bir sepet kalemine bağlanmaz; yalnızca API yolunda, sepet kalemi olmadan satılır: Sepet Kalemi Olmadan Satış. Tip nesnesi residence ikamet dönemidir ve basketItemId taşımaz. Teklif kişisel veri olmadan, yalnızca başlangıç günüyle alınır. Kişi pasaportla sigortalanır.

residence

• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• İkamet adresi Türkiye'dedir: insured[0].address.countryCode TR olmalıdır. Başka bir ülkeyle sipariş insurance.quote.declined ile reddedilir.
• Uyruğun, adres ülkesinin, ilin ya da ilçenin bağlantınızın sağlayıcısında karşılığı yoksa sipariş, alanın yoluyla 422 insurance.reference.unknown alır ve prim tahsil edilmez.
• Bağlantınızdaki ürün bu poliçenin iptalini desteklemiyorsa iptal isteği 412 insurance.provider.not_integrated döner.

Kişiler

Örnek

{
  "insuranceType": "FOREIGN_RESIDENT_HEALTH",
  "insured": [
    {
      "identityType": "PASSPORT",
      "identityNumber": "<pasaport numarası>",
      "firstName": "<ad>",
      "lastName": "<soyad>",
      "gender": "MALE",
      "birthDate": "<YYYY-MM-DD>",
      "birthPlace": "<doğum yeri>",
      "fatherName": "<baba adı>",
      "nationalityCountryCode": "DE",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "address": {
        "countryCode": "TR",
        "cityCode": "34",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "residence": {
    "startDate": "<YYYY-MM-DD>",
    "endDate": "<YYYY-MM-DD>"
  }
}

ABROAD_STAY_HEALTH: şema sürüm 1

Yurt dışında öğrenim ya da çalışma süresince sağlık sigortası. TRAVEL_HEALTH'ten ayrı bir tiptir. Sepet kaleminde insuranceCategory: EDUCATION ya da TRAVEL ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi abroadStay tek bir dönemin tek gidiş ülkesidir; bütün sigortalılar aynı poliçededir. Kişiler TC kimlik numarasıyla sigortalanır. Fiyat kişilerin bilgileriyle hesaplanır; bu yüzden kişi alanları teklif aşamasında zorunludur.

abroadStay

• Gidilecek ülke Türkiye (TR) olamaz; teklif 422 insurance.quote.declined ile reddedilir.
• Gidilecek ülkenin, seçilen bölgede bağlantınızın sağlayıcısında karşılığı yoksa teklif abroadStay.destinationCountryCode alan yoluyla 422 insurance.reference.unknown alır.
• Sigorta ettirenin adresi Türkiye'dedir: policyholder.address.countryCode TR olmalıdır. Başka bir ülkeyle sipariş insurance.quote.declined ile reddedilir.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.

Kişiler

Sigorta ettiren kendini de sigortalatıyorsa insured[] içinde relationship: SELF ile yer alır.

Örnek

{
  "insuranceType": "ABROAD_STAY_HEALTH",
  "policyholder": {
    "identityType": "TCKN",
    "identityNumber": "<kimlik numarası>",
    "birthDate": "<YYYY-MM-DD>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>",
    "address": {
      "countryCode": "TR",
      "cityCode": "06",
      "districtCode": "<ilçe kodu>",
      "line": "<açık adres>"
    }
  },
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "relationship": "CHILD"
    }
  ],
  "abroadStay": {
    "basketItemId": "school-1",
    "startDate": "<YYYY-MM-DD>",
    "endDate": "<YYYY-MM-DD>",
    "coverageRegion": "EUROPE",
    "destinationCountryCode": "DE"
  }
}

MOTOR_THIRD_PARTY_LIABILITY: şema sürüm 1

Zorunlu trafik sigortası. Sepet kaleminde insuranceCategory: VEHICLE ile çözülür; sepet kalemi olmadan da satılır. Bu tipte talep de açılabilir: Talep şemaları. Tip nesnesi vehicle tek bir aracın tek poliçesidir. Hangi araç alanlarının gerektiğini aracın kayıt senaryosu (registrationScenario) belirler. Fiyat sigortalının ve aracın bilgileriyle hesaplanır; bu yüzden bütün alanlar teklif aşamasında zorunludur.

vehicle

Senaryo işaretli alanlar yalnızca o senaryolarda geçerlidir ve zorunluluk da yalnızca o zaman uygulanır. Başka bir senaryoda gönderilirlerse istek, alanın yoluyla 422 insurance.validation.invalid (reason: not_applicable) alır.

Kayıt senaryoları

Teklifi adım adım hazırlayın:

1. Alıcıyla aracın kayıt senaryosunu belirleyin ve registrationScenario olarak gönderin.
2. Senaryonun kimlik türüyle sigortalının bilgilerini alın. Kimlik türü senaryoya uymazsa teklif insured[0].identityType alan yoluyla 422 insurance.validation.invalid (reason: not_supported_for_registration_scenario) alır ve istek sağlayıcıya gönderilmez.
3. Senaryo RENEWAL değilse araç tipini VEHICLE_TYPE listesinden alın; modeli araç tipine ve yılına göre listeden bulun: önce VEHICLE_BRAND, ardından markanın altındaki VEHICLE_MODEL.
4. Senaryonun araç alanlarını tablodaki gibi doldurup teklifi alın.

• VKN ile sigortalıda ticari unvan (companyName) zorunludur; doğum tarihi gönderilmez. TCKN ve PASSPORT ile doğum tarihi zorunludur.
• Bu tipte teminat başlangıç günü gönderilmez; poliçenin dönemini bağlantınızdaki ürün belirler.
• NEW_REGISTRATION senaryosunda model yılı bağlantınızdaki ürünün kabul ettiği yıllardan biri değilse teklif vehicle.modelYear alan yoluyla 422 insurance.validation.invalid (reason: not_supported_by_provider) alır.
• Araç tipinin ya da modelin bağlantınızın sağlayıcısında karşılığı yoksa teklif, alanın yoluyla 422 insurance.reference.unknown alır.
• Bağlantınızdaki ürün yalnızca Türkiye cep telefonu numarası kabul ediyorsa başka bir numarayla teklif 422 insurance.quote.declined alır.
• Pasaport ya da vergi kimlik numarasıyla kesilen poliçede bağlantınızdaki ürün iptali desteklemiyorsa iptalin sonucu insurance.policy.cancel_failed olur ve poliçe yürürlükte kalır: İptal ve Prim İadesi.
• Yabancı plakanın ve motor numarasının biçimi: Veri Biçimleri.

Kişiler

Örnek

Yenileme (RENEWAL):

{
  "insuranceType": "MOTOR_THIRD_PARTY_LIABILITY",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "vehicle": {
    "basketItemId": "car-1",
    "registrationScenario": "RENEWAL",
    "plate": "<plaka>",
    "registrationDocument": {
      "serial": "<seri kodu>",
      "number": "<ruhsat numarası>"
    }
  }
}

Yeni kayıt (NEW_REGISTRATION) aracında plaka yerine plaka il kodu gönderilir:

"vehicle": {
  "basketItemId": "car-1",
  "registrationScenario": "NEW_REGISTRATION",
  "plateCityCode": "34",
  "modelCode": "<model kodu>",
  "modelYear": 2026,
  "vehicleTypeCode": "<araç tipi kodu>",
  "engineNumber": "<motor numarası>",
  "chassisNumber": "<şasi numarası>"
}

Galericinin kısa süreli poliçesinde (DEALER_SHORT_TERM) sigortalı vergi kimlik numarasıyla gönderilir:

"insured": [
  {
    "identityType": "VKN",
    "identityNumber": "<vergi kimlik numarası>",
    "companyName": "<ticari unvan>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>"
  }
]

MOTOR_COMPREHENSIVE: şema sürüm 1

Kasko. Sepet kaleminde insuranceCategory: VEHICLE ile çözülür; sepet kalemi olmadan da satılır. Bu tipte talep de açılabilir: Talep şemaları. Tip nesnesi vehicle tek bir aracın tek poliçesidir. Fiyat sigortalının ve aracın bilgileriyle hesaplanır; bu yüzden alanlar teklif aşamasında gönderilir.

Bağlantılarınızdaki ürünler farklı araç alanları ister. Şema bu alanların hepsini kapsar; şemada zorunlu olan yalnızca bütün ürünlerin istediği alanlardır. Bir ürünün istediği isteğe bağlı bir alan eksikse yalnızca o ürünün seçeneği elenir: Ürüne göre ek zorunlu alanlar.

vehicle

• Bağlantınızdaki bir ürün ruhsatı, bir başkası model yılını ve tescil tarihini isteyebilir. Yurt dışında yaşayan araç sahibine sunulan seçenekler bunlara ek olarak başlangıç ülkesini, motor ve şasi numarasını, modeli, araç tipini ve sürücünün kimlik numarasını ister. Bütün seçenekleri almak için alıcınızdan alabildiğiniz bütün araç alanlarını gönderin. Eksik alan, elenen seçenekte alan yoluyla döner (ör. vehicle.registrationDocument): Teklif › Elenen seçenekler.
• Bağlantılarınızdaki her ürün kendi seçeneğini döner; bir teklif isteğinde birden çok seçenek dönebilir: Teklif › Birden çok seçenek.
• Bu sürüm yalnızca Türkiye plakalı araçları kabul eder.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Araç tipinin, modelin ya da başlangıç ülkesinin bağlantınızın sağlayıcısında karşılığı yoksa o ürünün seçeneği alanın yoluyla insurance.reference.unknown ile elenir.
• Bağlantınızdaki ürün yalnızca Türkiye cep telefonu numarası kabul ediyorsa başka bir numarayla teklif 422 insurance.quote.declined alır.

Kişiler

Örnek

{
  "insuranceType": "MOTOR_COMPREHENSIVE",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "vehicle": {
    "basketItemId": "car-1",
    "plate": "<plaka>",
    "coverageStartDate": "<YYYY-MM-DD>",
    "registrationDocument": {
      "serial": "<seri kodu>",
      "number": "<ruhsat numarası>"
    },
    "registrationDate": "<YYYY-MM-DD>",
    "modelYear": 2022,
    "vehicleTypeCode": "<araç tipi kodu>"
  }
}

MOTOR_EXCESS_LIABILITY: şema sürüm 1

Araç için ihtiyari mali mesuliyet (İMM) sigortası. Sepet kaleminde insuranceCategory: VEHICLE ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi vehicle tek bir aracın tek poliçesidir. Fiyat sigortalının ve aracın bilgileriyle ve seçilen limitle hesaplanır; bu yüzden bütün alanlar teklif aşamasında zorunludur.

vehicle

• Limitleri GET /api/v1/insurance/reference/LIABILITY_LIMIT listesinden alın. Alıcıya görünen adı (label) gösterin, istekte kodu gönderin.
• Bu sürüm yalnızca Türkiye plakalı araçları kabul eder.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Limitin, kullanım şeklinin, araç tipinin ya da modelin bağlantınızın sağlayıcısında karşılığı yoksa teklif, alanın yoluyla 422 insurance.reference.unknown alır.
• Bağlantınızdaki ürün yalnızca Türkiye cep telefonu numarası kabul ediyorsa başka bir numarayla teklif 422 insurance.quote.declined alır.

Kişiler

Örnek

{
  "insuranceType": "MOTOR_EXCESS_LIABILITY",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "vehicle": {
    "basketItemId": "car-1",
    "plate": "<plaka>",
    "registrationDocument": {
      "serial": "<seri kodu>",
      "number": "<ruhsat numarası>"
    },
    "chassisNumber": "<şasi numarası>",
    "engineNumber": "<motor numarası>",
    "modelCode": "<model kodu>",
    "modelYear": 2022,
    "vehicleTypeCode": "<araç tipi kodu>",
    "vehicleUsageCode": "<kullanım şekli kodu>",
    "coverageStartDate": "<YYYY-MM-DD>",
    "liabilityLimitCode": "<limit kodu>"
  }
}

COMPULSORY_EARTHQUAKE: şema sürüm 1

Konut için zorunlu deprem sigortası (DASK). Sepet kaleminde insuranceCategory: HOME ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi property tek bir bağımsız bölümün (konutun) tek poliçesidir. Konutun adresi UAVT adres koduyla gönderilir: UAVT adres zinciri. Fiyat sigortalının ve konutun bilgileriyle hesaplanır; bu yüzden konut alanları teklif aşamasında zorunludur.

property

lienholder:

"Yalnız BANK" ve "yalnız FINANCE" işaretli alanlar yalnızca o kurum türünde geçerlidir ve zorunludur. Diğer türde gönderilirlerse istek reddedilir. Daini mürtehin yoksa lienholder göndermeyin.

• UAVT adres kodunun doğrulanması: UAVT adres zinciri.
• Bina alanları ham değerlerdir (yıl, kat sayısı, metrekare); aralıklara çevirmeyin. Bağlantınızdaki ürünün kabul etmediği bir değer (ör. ürünün sınırından fazla kat sayısı) alan yoluyla 422 insurance.validation.invalid (reason: not_supported_by_provider) alır.
• Gün, Türkiye takvim günüdür. Geçmiş bir başlangıç günü teklifte 422 insurance.validation.invalid (reason: must_not_be_past) alır. Sipariş oluşturulurken başlangıç günü geçmişse sipariş insurance.quote.declined ile reddedilir; yeni teklif alın.
• Banka, şube, finans kurumu ya da adresteki ilçenin bağlantınızın sağlayıcısında karşılığı yoksa istek, alanın yoluyla 422 insurance.reference.unknown alır.
• Bağlantınızdaki ürün yalnızca Türkiye cep telefonu numarası kabul ediyorsa başka bir numarayla teklif 422 insurance.quote.declined alır.

Kişiler

Örnek

{
  "insuranceType": "COMPULSORY_EARTHQUAKE",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "address": {
        "cityCode": "35",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "property": {
    "basketItemId": "home-1",
    "uavtAddressCode": "<UAVT adres kodu>",
    "coverageStartDate": "<YYYY-MM-DD>",
    "areaSqm": 120,
    "floorCount": 5,
    "constructionType": "REINFORCED_CONCRETE_STEEL",
    "constructionYear": 2005,
    "priorDamage": "NONE",
    "usage": "RESIDENTIAL"
  }
}

Konutun kredisini bir banka verdiyse lienholder şöyle gönderilir:

"lienholder": {
  "institutionType": "BANK",
  "bankCode": "<banka kodu>",
  "bankBranchCode": "<şube kodu>",
  "branchCityCode": "35"
}

HOME_INSURANCE: şema sürüm 1

Konut sigortası. Sepet kaleminde insuranceCategory: HOME ile çözülür; sepet kalemi olmadan da satılır. Tip nesnesi property tek bir bağımsız bölümün (konutun) tek poliçesidir. Konutun adresi UAVT adres koduyla gönderilir: UAVT adres zinciri. Fiyat sigortalının ve konutun bilgileriyle ve teminat bedelleriyle hesaplanır; bu yüzden bütün alanlar teklif aşamasında zorunludur.

property

lienholder alanları COMPULSORY_EARTHQUAKE ile aynıdır (yukarıda); yalnızca şubenin ili (branchCityCode) bu şemada yoktur ve gönderilirse istek reddedilir.

• Evet/hayır alanları JSON boolean'dır (true, false) ve hepsi zorunludur; "true" gibi metin kabul edilmez.
• Teminat bedeli sınırların dışındaysa teklif, alanın yoluyla 422 insurance.validation.invalid alır: üst sınırda reason: must_be_at_most_100000000, alt sınırda reason: must_be_at_least_<sınır>.
• Bağlantınızdaki ürün teminat bedellerini tam lira olarak alıyorsa kuruş içeren bir bedel alan yoluyla reason: not_supported_by_provider alır. Bedelleri tam lira olarak gönderin (100'ün katı kuruş).
• Bu sürümde teminat başlangıç günü gönderilmez; poliçenin dönemini bağlantınızdaki ürün belirler.
• UAVT adres kodunun doğrulanması: UAVT adres zinciri.
• Konut türünün, katın, bankanın, şubenin ya da finans kurumunun bağlantınızın sağlayıcısında karşılığı yoksa teklif, alanın yoluyla 422 insurance.reference.unknown alır.
• Bağlantınızdaki ürün yalnızca Türkiye cep telefonu numarası kabul ediyorsa başka bir numarayla teklif 422 insurance.quote.declined alır.

Kişiler

Örnek

{
  "insuranceType": "HOME_INSURANCE",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>"
    }
  ],
  "property": {
    "basketItemId": "home-1",
    "uavtAddressCode": "<UAVT adres kodu>",
    "areaSqm": 120,
    "constructionYear": 2005,
    "dwellingTypeCode": "<konut türü kodu>",
    "floorCode": "<kat kodu>",
    "contentsFireAmount": 50000000,
    "interiorDecorationAmount": 10000000,
    "glassBreakageAmount": 2000000,
    "vacantOverThreeMonths": false,
    "hasEarthquakePolicy": true,
    "inGatedSite": false,
    "hasAlarm": false,
    "hasCamera": false,
    "hasWindowBars": false,
    "hasFireExtinguisher": true,
    "hasSprinkler": false,
    "hasResidualCurrentDevice": true,
    "hasGasDetector": true,
    "isOwner": true,
    "includeWatercraft": false
  }
}

SUPPLEMENTARY_HEALTH: şema sürüm 1

Tamamlayıcı sağlık sigortası. Bu tip bir sepet kalemine bağlanmaz; yalnızca API yolunda, sepet kalemi olmadan satılır: Sepet Kalemi Olmadan Satış. Tip nesnesi health sigortanın bilgileridir ve basketItemId taşımaz. Bir teklif tek bir kişiyi korur; kişi TC kimlik numarasıyla sigortalanır. Sağlık beyanı (boy, kilo, hamilelik durumu) sigortalının alanlarındadır. Fiyat sigortalının bilgileriyle hesaplanır; bu yüzden kişi alanları teklif aşamasında zorunludur.

health

Sağlık beyanı

• Teklif yalnızca planType ile seçilen plan türündeki planları döner. Bağlantınızdaki ürün birden çok sigorta şirketinin planını sunuyorsa bir teklif isteği şirket ve plan başına ayrı bir seçenek döner: Teklif › Birden çok seçenek.
• pregnancyCover: true iken insured[0].pregnancyStatus zorunludur; gönderilmezse reason: required döner. Hamilelik teminatı istenmeyen teklifte pregnancyStatus gönderilirse reason: not_applicable ile reddedilir.
• Sağlık beyanı özel nitelikli kişisel veridir. Yalnızca teklif isteğinde gönderilir; hata yanıtlarında yalnızca alanın yolu döner, değeri dönmez. Testlerde gerçek bir kişinin bilgilerini kullanmayın.
• Seçeneğin anlaşmalı sağlık kurumlarını il il listeleyebilirsiniz: Teklif › Anlaşmalı kurumlar.
• Bazı seçenekler taksitli ödeme almaz. Böyle bir seçenekte installmentCount 1'den büyükse primin tahsilatı insurance.quote.declined ile reddedilir.
• Sigortalının adresi Türkiye'dedir: insured[0].address.countryCode TR olmalıdır. Başka bir ülkeyle sipariş insurance.quote.declined ile reddedilir.
• Adresteki ilin, ilçenin ya da ülkenin bağlantınızın sağlayıcısında karşılığı yoksa istek, alanın yoluyla 422 insurance.reference.unknown alır.
• Ad ve soyad gerekmez.
• Bağlantınızdaki ürün yalnızca Türkiye cep telefonu numarası kabul ediyorsa başka bir numarayla teklif 422 insurance.quote.declined alır.

Kişiler

Örnek

{
  "insuranceType": "SUPPLEMENTARY_HEALTH",
  "insured": [
    {
      "identityType": "TCKN",
      "identityNumber": "<kimlik numarası>",
      "birthDate": "<YYYY-MM-DD>",
      "email": "<e-posta>",
      "phone": "<E.164 telefon>",
      "heightCm": 170,
      "weightKg": 70,
      "address": {
        "countryCode": "TR",
        "cityCode": "06",
        "districtCode": "<ilçe kodu>",
        "line": "<açık adres>"
      }
    }
  ],
  "health": {
    "planType": "INPATIENT_OUTPATIENT"
  }
}