InsurUp B2B API — Token Alma, Doğum Tarihi, MERNIS ve TRAMER Sorgusu

Bu doküman, bir B2B entegrasyonunun InsurUp API üzerinden erişim token'ı (access token) almasını ve bu token ile doğum tarihi sorgulama, MERNIS (kimlik sorgulama) ve TRAMER (araç/poliçe sorgulama) isteklerini nasıl yapacağını anlatır.

Özet

Konu	Cevap
Token nasıl alınır?	OAuth 2.0 `client_credentials` akışı ile (servis hesabı)
Servis hesabı mı, OAuth kullanıcı akışı mı?	Servis hesabı (client_credentials) — makineden-makineye (M2M) entegrasyon için
Doğum tarihi sorgusu	`POST /customers/external-lookup` — bireysel istekte `birthDate` verilmezse otomatik yapılır
MERNIS endpoint	`POST /customers/external-lookup`
TRAMER endpoint	`POST /customers/{CustomerId}/vehicles/external-lookup`
Gerekli OAuth scope	`core-api`

Servis hesabı nedir, nasıl oluşturulur? Servis hesabı; bir insan kullanıcı yerine yazılımın/otomasyonun API'ye erişmesini sağlayan, kullanıcı oturumu gerektirmeyen bir hesap türüdür. Bu doküman, elinizde bir servis hesabı (client_id + client_secret) olduğunu varsayar. Hesabı Agent Panel üzerinden nasıl oluşturacağınız, secret'ı nasıl saklayacağınız ve yönetim adımları için: Servis Hesabı Oluşturma ve Kullanım Kılavuzu.

Base URL'ler

Ortam	Servis	URL
Production	Kimlik doğrulama (AuthServer)	`https://auth.insurup.com`
Production	REST API (WebApi)	`https://api.insurup.com`

Not: REST istekleri hem https://api.insurup.com/... hem de https://api.insurup.com/api/... biçiminde çalışır; /api/* yolları otomatik olarak köke yönlendirilir. Bu dokümanda /api/ öneki kullanılmıştır.

Adım 1 — Servis hesabı ile access token alma

Bu adım için bir servis hesabına ait client_id (sa-... biçiminde) ve client_secret gerekir. Henüz oluşturmadıysanız, Agent Panel'den oluşturma adımları için Servis Hesabı Oluşturma ve Kullanım Kılavuzu'na bakın.

Elinizdeki client_id ve client_secret ile token endpoint'ine client_credentials isteği gönderin.

POST https://auth.insurup.com/connect/token
Content-Type: application/x-www-form-urlencoded

Gövde (form-urlencoded):

grant_type=client_credentials
client_id=sa-019f8dfa88c67bbb9bd500ae8c90f40d
client_secret={size verilen secret}
scope=core-api

cURL örneği:

curl -X POST "https://auth.insurup.com/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=sa-019f8dfa88c67bbb9bd500ae8c90f40d" \
  -d "client_secret={SECRET}" \
  -d "scope=core-api"

Örnek yanıt:

{
  "access_token": "eyJhbGciOiJ...",
  "token_type": "Bearer",
  "expires_in": 1800,
  "scope": "core-api"
}

Önemli notlar:

Dönen access_token, sonraki tüm isteklerde Authorization: Bearer {access_token} başlığıyla kullanılır.
Access token süresi 30 dakikadır (expires_in: 1800). client_credentials akışında refresh token yoktur; token süresi dolduğunda bu adımı tekrarlayarak yeni token alın.
client_secret yalnızca servis hesabı oluşturulurken bir kez gösterilir. Kaybederseniz sıfırlanması (rotate) gerekir.
Erişim yetkisi (hangi verilere dokunabileceğiniz) servis hesabınıza tanımlı rol/izinlerle belirlenir; token isteğindeki scope her zaman core-api'dir.

Adım 2 — Doğum tarihi sorgusu (bireysel müşteri, opsiyonel)

Bireysel (T.C. vatandaşı) müşterilerde MERNIS ve TRAMER sorguları doğum tarihi gerektirir. Elinizde doğum tarihi yoksa, InsurUp bunu SBM üzerinden otomatik sorgular.

Önemli — Ayrı endpoint yoktur: Doğum tarihi sorgusu, MERNIS ile aynı endpoint üzerinden çalışır (POST /customers/external-lookup). İstek gövdesinde birthDate verilmezse, sistem arka planda önce doğum tarihi sorgusunu yapar, ardından MERNIS sorgusunu tamamlar. Tek API çağrısı, iki ardışık SBM işlemi demektir.

POST https://api.insurup.com/api/customers/external-lookup
Authorization: Bearer {access_token}
Content-Type: application/json

Ne zaman gerekir?

Durum	Doğum tarihi sorgusu
Bireysel müşteri, `birthDate` bilinmiyor	Otomatik yapılır (istekte `birthDate` göndermeyin)
Bireysel müşteri, `birthDate` biliniyor	Atlanır (istekte `birthDate` gönderin)
Yabancı müşteri	Otomatik sorgu yok — `birthDate` istekte zorunlu
Kurumsal müşteri	Doğum tarihi sorgusu yok

İstek (yalnızca TCKN ile)

Alan	Tip	Zorunlu	Açıklama
`$type`	string	Evet	`"individual"` olmalı
`identityNumber`	number	Evet	11 haneli TCKN
`birthDate`	string (`YYYY-MM-DD`)	Hayır	Göndermeyin — sistem SBM'den otomatik sorgular

{
  "$type": "individual",
  "identityNumber": 11111111111
}

Örnek yanıt

Yanıt, MERNIS alanlarının yanı sıra sorgulanan doğum tarihini de içerir:

{
  "$type": "individual",
  "fullName": "Ada Lovelace",
  "gender": "FEMALE",
  "birthDate": "1985-05-12",
  "email": "ada@example.com",
  "phoneNumber": { "number": "5321234567", "countryCode": 90 },
  "maritalStatus": "MARRIED",
  "city": { "value": "34", "text": "İstanbul" },
  "district": { "value": "1234", "text": "Kadıköy" }
}

İpucu: Yalnızca doğum tarihine ihtiyacınız varsa bu isteği gönderip yanıttaki birthDate alanını kullanabilirsiniz. Müşteri oluştururken veya TRAMER sorgusundan önce doğum tarihini edinmek için uygundur.

cURL örneği:

curl -X POST "https://api.insurup.com/api/customers/external-lookup" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"$type":"individual","identityNumber":11111111111}'

Önemli notlar:

Doğum tarihi sorgusu yalnızca bireysel (T.C. vatandaşı) müşteriler için geçerlidir.
SBM'de kayıt bulunamazsa veya sorgu başarısız olursa istek hata döner; MERNIS adımına geçilmez.
birthDate değerini biliyorsanız isteğe ekleyin — otomatik sorgu atlanır, doğrudan MERNIS çalışır (bkz. Adım 3).

Adım 3 — MERNIS sorgusu (kimlik doğrulama / ön dolum)

MERNIS sorgusu, TCKN (veya VKN/YKN) üzerinden kişi/kurum bilgilerini getirir. Bu endpoint bir müşteri oluşturmaz; sorgu sonucunu döner, isterseniz müşteri oluştururken kullanırsınız.

Adım 2 ile ilişki: Bireysel müşteride birthDate verilmezse Adım 2'deki otomatik doğum tarihi sorgusu bu adımın parçası olarak çalışır. Aşağıdaki istek, doğum tarihi bilindiğinde veya kurumsal/yabancı müşteri için kullanılır.

POST https://api.insurup.com/api/customers/external-lookup
Authorization: Bearer {access_token}
Content-Type: application/json

İstek gövdesi, müşteri tipine göre $type alanı ile ayrışır: individual (bireysel), company (kurumsal), foreign (yabancı).

Bireysel (T.C. vatandaşı)

Alan	Tip	Zorunlu	Açıklama
`$type`	string	Evet	`"individual"` olmalı
`identityNumber`	number	Evet	11 haneli TCKN
`birthDate`	string (`YYYY-MM-DD`)	Hayır	Verilmezse Adım 2'deki otomatik sorgu devreye girer

{
  "$type": "individual",
  "identityNumber": 11111111111,
  "birthDate": "1985-05-12"
}

Kurumsal

Alan	Tip	Zorunlu	Açıklama
`$type`	string	Evet	`"company"` olmalı
`taxNumber`	string	Evet	Vergi No (VKN)

{
  "$type": "company",
  "taxNumber": "1234567890"
}

Yabancı

Alan	Tip	Zorunlu	Açıklama
`$type`	string	Evet	`"foreign"` olmalı
`identityNumber`	string	Evet	Yabancı kimlik no / pasaport
`birthDate`	string (`YYYY-MM-DD`)	Evet	Zorunlu — otomatik sorgu yapılmaz

{
  "$type": "foreign",
  "identityNumber": "99123456789",
  "birthDate": "1990-01-15"
}

Örnek yanıt (bireysel)

{
  "$type": "individual",
  "fullName": "Ada Lovelace",
  "gender": "FEMALE",
  "email": "ada@example.com",
  "phoneNumber": { "number": "5321234567", "countryCode": 90 },
  "maritalStatus": "MARRIED",
  "birthDate": "1985-05-12",
  "city": { "value": "34", "text": "İstanbul" },
  "district": { "value": "1234", "text": "Kadıköy" }
}

cURL örneği:

curl -X POST "https://api.insurup.com/api/customers/external-lookup" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"$type":"individual","identityNumber":11111111111,"birthDate":"1985-05-12"}'

Yanıt enum değerleri (MERNIS)

$type, gender ve maritalStatus alanları string enum'dur. Aşağıdaki değerler birebir API yanıtında döner.

`$type`

Değer	Açıklama
`"individual"`	Bireysel müşteri (T.C. vatandaşı)
`"company"`	Kurumsal müşteri
`"foreign"`	Yabancı müşteri

`gender`

Değer	Açıklama
`"UNKNOWN"`	Bilinmiyor
`"MALE"`	Erkek
`"FEMALE"`	Kadın
`"OTHER"`	Diğer

`maritalStatus`

Değer	Açıklama
`"UNKNOWN"`	Bilinmiyor
`"SINGLE"`	Bekâr
`"MARRIED"`	Evli

Adım 4 — Müşteriyi oluşturma / bulma (CustomerId edinme)

TRAMER sorgusu bir CustomerId gerektirir. Bu yüzden önce müşteri sistemde olmalı; yoksa oluşturursunuz, varsa bulursunuz. Akış şöyledir: müşteriyi oluşturur (POST /customers) veya mevcut kaydı bulur (GET /customers/{TCKN|VKN}), dönen id (GUID) değerini alırsınız; ardından bu id'yi TRAMER isteğinin URL'sinde {CustomerId} olarak kullanırsınız. Yani CustomerId, müşteri kaydı ile araç/TRAMER sorgusunu birbirine bağlayan referanstır.

Doğum tarihi zorunluluğu: Bireysel ve yabancı müşterilerde TRAMER sorgusu için müşteri kaydında doğum tarihi bulunmalıdır. Kayıt oluştururken doğum tarihini bilmiyorsanız Adım 2'yi kullanın veya "fillMissingFields": true ile otomatik doldurmayı tercih edin.

4a — Müşteri oluşturma

POST https://api.insurup.com/api/customers
Authorization: Bearer {access_token}
Content-Type: application/json

İstek gövdesi, MERNIS'te olduğu gibi $type ile ayrışır (individual / company / foreign).

Bireysel:

{
  "$type": "individual",
  "identityNumber": "11111111111",
  "birthDate": "1985-05-12",
  "fullName": "Ada Lovelace"
}

Kurumsal:

{
  "$type": "company",
  "title": "ÖRNEK LTD. ŞTİ.",
  "taxNumber": "1234567890"
}

İpucu — fillMissingFields: İstek gövdesine "fillMissingFields": true eklerseniz, sistem müşteri oluştururken eksik alanları MERNIS/SBM'den otomatik doldurur. Doğum tarihi dahil eksik alanlar bu yolla tamamlanabilir; Adım 2 veya 3'ü ayrıca çağırmadan tek istekte hem oluşturma hem ön dolum yapabilirsiniz.

Yanıt — CustomerId burada döner (HTTP 201):

{
  "id": "019f1234-5678-7abc-def0-123456789abc"
}

Bu id, bir sonraki adımda TRAMER isteğinin URL'sinde {CustomerId} olarak kullanılır.

Not — Aynı TCKN/VKN zaten varsa: POST /customers mevcut müşteriyi döndürmez; duplicate hatası verir. Müşterinin zaten var olma ihtimali varsa önce 4b ile bulun, yoksa oluşturun.

cURL örneği:

curl -X POST "https://api.insurup.com/api/customers" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"$type":"individual","identityNumber":"11111111111","birthDate":"1985-05-12"}'

4b — Mevcut müşteriyi bulma

Müşteri zaten kayıtlıysa, GUID / TCKN / VKN ile tekil olarak çekip id'yi alabilirsiniz:

GET https://api.insurup.com/api/customers/{CustomerId|TCKN|VKN}
Authorization: Bearer {access_token}

{CustomerId} yerine müşterinin GUID'i, 11 haneli TCKN'si veya VKN'si verilebilir.

Adım 5 — TRAMER sorgusu (araç / poliçe sorgusu)

Elinizde Adım 4'ten gelen CustomerId ile artık TRAMER sorgusu yapabilirsiniz. TRAMER; plaka (ve varsa ruhsat seri no) üzerinden aracın model, poliçe ve TRAMER bilgilerini getirir.

Önemli — Müşteri kaydı zorunludur: TRAMER sorgusu, kimlik bilgilerini (bireysel için TCKN + doğum tarihi, kurumsal için VKN) request gövdesinden değil, URL'deki {CustomerId} ile bağlı sistemdeki müşteri kaydından okur. Bu nedenle sorgudan önce müşterinin sistemde kayıtlı olması gerekir (bkz. Adım 4). Bireysel/yabancı müşteride doğum tarihi, kurumsalda VKN kayıtlı değilse sorgu hata verir.

POST https://api.insurup.com/api/customers/{CustomerId}/vehicles/external-lookup
Authorization: Bearer {access_token}
Content-Type: application/json

İstek gövdesi:

Alan	Tip	Zorunlu	Açıklama
`plate`	object	Evet	`{ "city": 1–81, "code": "ABC123" }`
`plate.city`	number	Evet	İl plaka kodu (1–81)
`plate.code`	string	Evet	Plakanın harf+rakam kısmı
`documentSerial`	object	Hayır	Verilmezse sistem ruhsat seri no'yu sorgular
`documentSerial.code`	string	(verilirse)	2 harf (örn. `"AB"`)
`documentSerial.number`	string	(verilirse)	6 hane (örn. `"123456"`)

{
  "plate": {
    "city": 34,
    "code": "ABC123"
  },
  "documentSerial": {
    "code": "AB",
    "number": "123456"
  }
}

Örnek yanıt

{
  "registrationDate": "2020-03-15",
  "firstRegistrationDate": "2020-03-20",
  "plate": { "city": 34, "code": "ABC123" },
  "documentSerial": { "code": "AB", "number": "123456" },
  "model": {
    "year": 2020,
    "brand": { "value": "100", "text": "TOYOTA" },
    "type": { "value": "200", "text": "COROLLA 1.6" }
  },
  "chassis": "CHASSIS123",
  "chassisIsMasked": false,
  "engine": "ENGINE123",
  "engineIsMasked": false,
  "fuelType": "GASOLINE",
  "price": 150000,
  "currency": "TURKISH_LIRA",
  "kaskoOldPolicy": {
    "insuranceCompanyPolicyNumber": "12345678",
    "insuranceCompanyRenewalNumber": 0,
    "insuranceCompanyReference": "001",
    "agentNumber": "AG123",
    "endDate": "2026-03-15"
  },
  "trafikOldPolicy": null,
  "utilizationStyle": "PRIVATE_CAR",
  "seatNumber": 5
}

Yanıt hakkında notlar:

chassisIsMasked / engineIsMasked true ise ilgili değer maskelenmiştir (örn. "W***8"); bu maskeli değeri kaydetmeyin.
model yerine partialModel dönebilir (model yılı maskeliyse yalnızca marka/tip gelir).

cURL örneği:

curl -X POST "https://api.insurup.com/api/customers/019f1234-5678-7abc-def0-123456789abc/vehicles/external-lookup" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"plate":{"city":34,"code":"ABC123"},"documentSerial":{"code":"AB","number":"123456"}}'

Yanıt enum değerleri (TRAMER)

fuelType, currency ve utilizationStyle alanları string enum'dur. Aşağıdaki değerler birebir API yanıtında döner.

`fuelType`

Değer	Açıklama
`"GASOLINE"`	Benzin
`"DIESEL"`	Dizel
`"HYBRID"`	Hibrit
`"LPG"`	LPG
`"LPG_GASOLINE"`	LPG + Benzin (çift yakıt)
`"ELECTRIC"`	Elektrik

`currency`

Değer	Açıklama
`"UNKNOWN"`	Bilinmiyor
`"TURKISH_LIRA"`	Türk Lirası (₺)
`"UNITED_STATES_DOLLAR"`	ABD Doları ($)
`"EURO"`	Euro (€)

`utilizationStyle`

Değer	Açıklama
`"UNKNOWN"`	Bilinmeyen
`"PRIVATE_CAR"`	Özel otomobil
`"TAXI"`	Taksi
`"ROUTE_BASED_MINIBUS"`	Güzergah bazlı minibüs
`"MEDIUM_BUS"`	Orta boy otobüs
`"LARGE_BUS"`	Büyük otobüs
`"PICKUP_TRUCK"`	Pikap
`"CLOSED_BED_PICKUP"`	Kapalı kasa pikap
`"TRUCK"`	Kamyon
`"CONSTRUCTION_MACHINERY"`	İnşaat makinesi
`"TRACTOR"`	Traktör
`"TRAILER"`	Römork
`"MOTORCYCLE"`	Motosiklet
`"TANKER"`	Tanker
`"TOW_TRUCK"`	Çekici
`"MOTORIZED_CARAVAN"`	Motorlu karavan
`"TOWABLE_CARAVAN"`	Çekilebilir karavan
`"AGRICULTURAL_MACHINE_EXCLUDING_TRACTOR"`	Traktör hariç tarım makinesi
`"OPEN_BODY_TRUCK"`	Açık kasa kamyon
`"RENTAL_CAR"`	Kiralık otomobil
`"ARMORED_VEHICLE"`	Zırhlı araç
`"MINIBUS_SHARED_TAXI"`	Dolmuş
`"JEEP"`	Cip
`"JEEP_SAV"`	Cip spor aktivite aracı (SAV)
`"JEEP_SUV"`	Cip spor kullanım aracı (SUV)
`"JEEP_RENTAL"`	Kiralık cip
`"JEEP_TAXI"`	Taksi olarak kullanılan cip
`"AMBULANCE"`	Ambulans
`"FIREFIGHTER_CAR"`	İtfaiye aracı
`"HEARSE"`	Cenaze aracı
`"CHAUFFEURED_RENTAL_CAR"`	Şoförlü kiralık araç
`"OPERATIONAL_RENTAL"`	Operasyonel kiralık araç
`"PRIVATE_MINIBUS"`	Özel minibüs
`"ROUTE_MINIBUS"`	Güzergah minibüsü
`"SERVICE_MINIBUS"`	Servis minibüsü
`"COMPANY_MINIBUS"`	Şirket minibüsü
`"RENTAL_MINIBUS"`	Kiralık minibüs
`"AMBULANCE_MINIBUS"`	Ambulans minibüsü
`"MINIBUS_BROADCASTING_VEHICLE"`	Yayın minibüsü
`"MINIBUS_ARMORED_TRANSPORT"`	Zırhlı nakliye minibüsü
`"SMALL_BUS_15_35_PASSENGERS"`	15–35 yolcu kapasiteli küçük otobüs
`"SMALL_BUS_SERVICE"`	Servis için küçük otobüs
`"SMALL_BUS_CITY"`	Şehir içi küçük otobüs
`"SMALL_BUS_ROUTE"`	Güzergah için küçük otobüs
`"LARGE_BUS_36_PLUS"`	36'dan fazla yolcu kapasiteli büyük otobüs
`"DUMP_TRUCK"`	Damperli kamyon
`"REFRIGERATED_TRUCK"`	Frigorifik kamyon
`"TRUCK_WITH_CONCRETE_MIXER"`	Beton mikseri kamyonu
`"SILO_TRUCK"`	Silo kamyonu
`"TRUCK_WITH_CONCRETE_PUMP"`	Beton pompası kamyonu
`"ROCK_TRUCK"`	Kaya kamyonu
`"TRUCK_WITH_CRANE"`	Vinçli kamyon
`"HEAVY_MACHINERY"`	Ağır makineler
`"EXCAVATOR"`	Ekskavatör
`"LOADER"`	Yükleyici
`"BULLDOZER"`	Buldozer
`"SCRAPER"`	Skreyper
`"GRADER"`	Greyder
`"ROAD_ROLLER"`	Yol silindiri
`"MOBILE_CRANE"`	Mobil vinç
`"INDOOR_FORKLIFT"`	İç mekan forklift
`"OUTDOOR_FORKLIFT"`	Dış mekan forklift
`"MOBILE_COMPRESSOR"`	Mobil kompresör
`"MOBILE_PUMP"`	Mobil pompa
`"MOBILE_WELDING_MACHINE"`	Mobil kaynak makinesi
`"COMBINE_HARVESTER"`	Biçerdöver
`"TANKER_ACID_CARRIER"`	Asit taşıyıcı tanker
`"TANKER_WATER_FUEL_CARRIER"`	Su/yakıt taşıyıcı tanker
`"TANKER_EXPLOSIVE_FLAMMABLE"`	Patlayıcı/yanıcı madde taşıyıcı tanker
`"TOW_TRUCK_TRACTOR"`	Çekici traktör
`"TOW_TRUCK_TANKER"`	Tanker çekici
`"PANEL_GLASS_VAN_MINUBUS"`	Panel/camlı van kamyonet

Önerilen uçtan uca akış

1) POST /connect/token                                              → access token al (scope: core-api)
2) POST /api/customers/external-lookup (yalnızca TCKN)              → (opsiyonel) doğum tarihi otomatik sorgulanır
3) POST /api/customers/external-lookup                              → (opsiyonel) MERNIS ile kimlik bilgisi ön dolum
4) GET  /api/customers/{TCKN|VKN}                                   → müşteri var mı? Varsa CustomerId'yi al
5) (müşteri yoksa) POST /api/customers                             → müşteri oluştur (doğum tarihi dahil), CustomerId al
6) POST /api/customers/{CustomerId}/vehicles/external-lookup        → TRAMER (plaka + ruhsat seri no) sorgusu

Kısayol: Adım 2–3 yerine POST /customers isteğine "fillMissingFields": true ekleyerek doğum tarihi ve MERNIS alanlarını tek adımda doldurabilirsiniz.

Yetkilendirme ve hata durumları

Durum	Açıklama
`401 Unauthorized`	Token yok, geçersiz veya süresi dolmuş. Adım 1'i tekrarlayın.
`403 Forbidden`	Servis hesabınızın bu işlem için rol/izni yok.
Doğum tarihi bulunamadı	Bireysel MERNIS isteğinde TCKN geçersiz veya SBM'de kayıt yok. TCKN'yi doğrulayın.
Kimlik bilgisi eksik	TRAMER için müşterinin doğum tarihi (bireysel/yabancı) veya VKN (kurumsal) kayıtlı değilse sorgu hata verir; müşteri kaydını tamamlayın (Adım 2 veya `fillMissingFields`).

Özet​

Base URL'ler​

Adım 1 — Servis hesabı ile access token alma​

Adım 2 — Doğum tarihi sorgusu (bireysel müşteri, opsiyonel)​

Ne zaman gerekir?​

İstek (yalnızca TCKN ile)​

Örnek yanıt​

Adım 3 — MERNIS sorgusu (kimlik doğrulama / ön dolum)​

Bireysel (T.C. vatandaşı)​

Kurumsal​

Yabancı​

Örnek yanıt (bireysel)​

Yanıt enum değerleri (MERNIS)​

$type​

gender​

maritalStatus​

Adım 4 — Müşteriyi oluşturma / bulma (CustomerId edinme)​

4a — Müşteri oluşturma​

4b — Mevcut müşteriyi bulma​

Adım 5 — TRAMER sorgusu (araç / poliçe sorgusu)​

Örnek yanıt​

Yanıt enum değerleri (TRAMER)​

fuelType​

currency​

utilizationStyle​

Önerilen uçtan uca akış​

Yetkilendirme ve hata durumları​

Özet

Base URL'ler

Adım 1 — Servis hesabı ile access token alma

Adım 2 — Doğum tarihi sorgusu (bireysel müşteri, opsiyonel)

Ne zaman gerekir?

İstek (yalnızca TCKN ile)

Örnek yanıt

Adım 3 — MERNIS sorgusu (kimlik doğrulama / ön dolum)

Bireysel (T.C. vatandaşı)

Kurumsal

Yabancı

Örnek yanıt (bireysel)

Yanıt enum değerleri (MERNIS)

`$type`

`gender`

`maritalStatus`

Adım 4 — Müşteriyi oluşturma / bulma (CustomerId edinme)

4a — Müşteri oluşturma

4b — Mevcut müşteriyi bulma

Adım 5 — TRAMER sorgusu (araç / poliçe sorgusu)

Örnek yanıt

Yanıt enum değerleri (TRAMER)

`fuelType`

`currency`

`utilizationStyle`

Önerilen uçtan uca akış

Yetkilendirme ve hata durumları