1 Kuzey Kıbrıs Sigorta Bilgi Merkezi API Klavuzu Yayınlanma Tarihi: Aralık 19, 2014 Son Güncellenme Tarihi: Şubat 13, 2015 Yazan: Web: http://www.supernova2.com Versiyon: 1.2 Özet Bu doküman KKTC Sigorta ve Reasürans Şirketler Birliği bünyesinde kurulmuş olan Sigorta Bilgi Merkezi'nin; Sigorta Bilgi Merkezi ile Hasarsızlık İndirimi ve Zamlı Prim Uygulaması Tüzüklerinin icrası için gerekli olan xml servislerinin nasıl kullanılacağı ile ilgili bilgiler içermektedir.
2 WSDL Sayfası Yukarıda listenmiş olan tüm metodların kullanımı bu dokümanda detaylı bir şekilde anlatılmıştır. Temel API Bilgileri 1. KKSBM her sigorta şirketinin bir yada daha fazla IP adresini tanımlamıştır. Sorgulama yapabilmeniz için öncelikle KKSBM ye IP adreslerinizi tanımlatmanız gerekmektedir. 2. Tüm servislere http://kksbm.org/service.asmx adresinden erişebilirsiniz. 3. Xml string i içinde dönen resultcode tagı işlemin doğru gerçekleşip gerçekleşmediğini belirtir. Dönen cevapta eğer resultcode 1 ise işlem doğru bir şekilde gerçekleşmiş demektir. Eğer 0 ise işlemi gerçekleştirirken bir hata oluşmuş demektir. Bu durumda ilgili metod için hazırlanan hata kodu ve tablosuna bakınız. 4. Tüm tarih bilgilerini 2009-05-28 (yıl-ay-gün) formatında gönderiniz. Tarih bilgileri içinde saat varsa 2009-05-28 10:20:00 formatında gönderiniz. 5. LoadPolicyInformation ve LoadDamageInformation web servislerini kullanarak poliçe yada hasar yüklerken rakamsal olması gereken alanlara rakam gönderme zorunluluğu vardır. Boş gönderdiğiniz takdirde ilgili hata kodunu alırsınız. Bu sebepten boş yerine 0 (sıfır) gönderiniz.
3 6. Yazılım tüm metod parametrelerinde valid (geçerli) xml stringleri kabul eder. Xml string içerisinde özel karakterlerler var ise bu karakterler aşağıdaki tablodaki gibi değiştirilmelidir. < < > > & ' & ' " "
4 GetCarAddressInfo Metodu Gönderdiğiniz plaka bilgilerine göre adres bilgilerini döndürür. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları UserName (Gerekli) : Sigorta Şirketi için özel olarak web servislere erişim için KKSBM tarafından verilen kullanıcı adı Password (Gerekli) : Üstte verilmiş olan kullanıcı adına tahsis edilmiş şifre VehiclePlate (Gerekli) : Sorgulama yapmak istediğiniz plaka numarası Doğrulama Bu metodu çağırmak için çift doğrulama gerekmektedir. Doğrulama kullanıcı adı ve şifre ile yapılmaktadır. Ayrıca IP adresine göre doğrulamada yapılmaktadır. Dönüş Tipi String Yanıt <?xml version="1.0" encoding="utf-8"?> <root ResultCode="1"> <ErrorInfo Code="0" Message="" /> <CarAddressInfo PlateNumber="AB111" Name="AD SOYAD " Address1="XXX SOK" Address2="NO.6,6" Address3="KARAKOL / GAZİMAĞUSA" /> </root> Yanıt Açıklaması PlateNumber Plaka numarası Name Ad Soyad Address1 Adres Satırı 1 Address2 Adres Satırı 2 Address3 Adres Satırı 3 Hatalar Hata Kodu Hata Mesajı 1 Kullanıcı adı yada şifre hatalı 2 Şirket aktif değil 3 Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. 995 Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış 998 Gönderilen XML'de hatalar var.
5 GetDamageInformation Metodu Gönderdiğiniz kimlik yada plaka bilgilerine göre hasarları döndürür. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları UserName (Gerekli) : Sigorta Şirketi için özel olarak web servislere erişim için KKSBM tarafından verilen kullanıcı adı Password (Gerekli) : Üstte verilmiş olan kullanıcı adına tahsis edilmiş şifre InfoXml (Gerekli) : Sorgulama yapmak istediğiniz plaka yada kimlik bilgileri ve gerekli diğer bilgiler <root><info PlateNumber="ab123" PlateCountryCode="601" SIdentityCountryCode="601" SIdentityCode="KN" SIdentityNumber="223344" IdentityNumber1="" IdentityCountryCode1="" IdentityCode1="" IdentityNumber2="" IdentityCountryCode2="" IdentityCode2="" IdentityNumber3="" IdentityCountryCode3="" IdentityCode3="" IdentityNumber4="" IdentityCountryCode4="" IdentityCode4="" IdentityNumber5="" IdentityCountryCode5="" IdentityCode5="" IdentityNumber6="" IdentityCountryCode6="" IdentityCode6="" /></root> PlateNumber Araç Plaka Numarası SIdentityNumber Poliçe sahibi Kimlik/MŞE No PlateCountryCode Araç Plakası Ülke Kodu (EK 1 A) SIdentityCountryCode Sigortalı Ülke Kodu (EK 1 A) SıdentityCode Sigortalı kimlik kodu (EK 1 H) IdentityNumber1 1.Sürücü Kimlik Numarası IdentityCountryCode1 1.Sürücü Ülke Kodu (EK 1 A) IdentityCode1 1.Sürücü kimlik Kodu (EK 1 H) IdentityNumber2 2.Sürücü Kimlik IdentityCountryCode2 2.Sürücü Ülke Kodu (EK 1 A) IdentityCode2 2.Sürücü kimlik Kodu (EK 1 H) IdentityNumber3 3.Sürücü Kimlik Numarası IdentityCountryCode3 3.Sürücü Ülke Kodu (EK 1 A) IdentityCode3 3.Sürücü kimlik Kodu (EK 1 H) IdentityNumber4 4. Sürücü Kimlik Numarası IdentityCountryCode4 4.Sürücü Ülke Kodu (EK 1 A) IdentityCode4 4.Sürücü kimlik Kodu (EK 1 H) IdentityNumber5 5. Sürücü Kimlik Numarası IdentityCountryCode5 5.Sürücü Ülke Kodu (EK 1 A) IdentityCode5 5.Sürücü kimlik Kodu (EK 1 H) IdentityNumber6 6. Sürücü Kimlik Numarası IdentityCountryCode6 6.Sürücü Ülke Kodu (EK 1 A) IdentityCode6 6.Sürücü kimlik Kodu (EK 1 H) Doğrulama Bu metodu çağırmak için çift doğrulama gerekmektedir. Doğrulama kullanıcı adı ve şifre ile yapılmaktadır. Ayrıca IP adresine göre doğrulamada yapılmaktadır. Dönüş Tipi String
6 Yanıt <root ResultCode="1"> <Damages> <Damage Policy="ab123" TotalDamageCount="1" TotalDamageCost="1156" DamageRate="20" DamagelessRate="0" /> <Damage Policy="" TotalDamageCount="0" TotalDamageCost="0" DamageRate="0" DamagelessRate="0" /> <Damage Policy="" TotalDamageCount="0" TotalDamageCost="0" DamageRate="0" DamagelessRate="0" /> <Damage Policy="" TotalDamageCount="0" TotalDamageCost="0" DamageRate="0" DamagelessRate="0" /> <Damage Policy="" TotalDamageCount="0" TotalDamageCost="0" DamageRate="0" DamagelessRate="0" /> <Damage Policy="" TotalDamageCount="0" TotalDamageCost="0" DamageRate="0" DamagelessRate="0" /> <Damage Policy="" TotalDamageCount="0" TotalDamageCost="0" DamageRate="0" DamagelessRate="0" /> </Damages> </root> Yanıt Açıklaması Policy TotalDamageCount TotalDamageCost DamageRate DamagelessRate Plaka No veya Sürücü KKNo Toplam Hasar Adeti Toplam Hasar Tutarı Hasar Zam Oranı Hasarsızlık İndirim Oranı Hatalar Hata Kodu Hata Mesajı 1 Kullanıcı adı yada şifre hatalı 2 Şirket aktif değil 3 Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. 995 Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış 998 Gönderilen XML'de hatalar var.
7 GetInfoInsuredPeople Metodu Gönderdiğiniz plaka bilgisine göre o plakanın aktif son poliçe bilgilerini döndürür. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları UserName (Gerekli) : Sigorta Şirketi için özel olarak web servislere erişim için KKSBM tarafından verilen kullanıcı adı Password (Gerekli) : Üstte verilmiş olan kullanıcı adına tahsis edilmiş şifre VehiclePlate(Gerekli) : Sorgulama yapmak istediğiniz plaka bilgisi Doğrulama Bu metod doğrulama gerektirmektedir. Doğrulama kullanıcı adı ve şifre ile yapılmaktadır. Dönüş Tipi String Örnek Yanıt <root ResultCode="1"> <PolicyInfo PlateNumber="AB123" Name="AHMET MEHMET" IdentityCode="KN" IdentityNo="223344" Address1="GÜLVER SOK" Address2="NO.9/5" Address3="BAYKAL / GAZİMAĞUSA" /> </root> Yanıt Açıklaması PlateNumber Araç Plaka Numarası Name Surname IdentityCode IdentityNo Sigortalı Adı Sigortalı Soyadı Sigortalı Kimlik Türü Sigortalı Kimlik No Address1 Address2 Address3 CountryCode Policy Sigortalı Adres Satırı Sigortalı Adres Satırı Sigortalı Adres Satırı Sigortalı Ülke Kodu Geçerli Poliçe veya Poliçe bulunamadı açıklama
8 Hatalar Hata Kodu Hata Mesajı 1 Kullanıcı adı ve/veya şifre yanlış girilmiştir.
9 isalive Metodu Kuzey Kıbrıs Sigorta Bilgi Merkezi uygulama sunucusunun çalışır olup olmadığı ile ilgili bilgileri döndürür. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları Servise herhangi bir parametre gönderilmez Doğrulama Bu metod doğrulama gerektirmemektedir. Dönüş Tipi Boolean Örnek Yanıt <boolean>true</boolean> Yanıt Açıklaması Dönen cevap true ise sunucu düzgün bir şekilde çalışmaktadır. Dönen cevap false ise uygulama sunucusunda bir arıza var demektir. Hatalar -
10 isdbconnalive Metodu Kuzey Kıbrıs Sigorta Bilgi Merkezi veritabanı sunucusunun çalışır olup olmadı ile ilgili bilgileri döndürür. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları - Doğrulama Bu metod doğrulama gerektirmemektedir. Dönüş Tipi String Örnek Yanıt <string>1</string> Yanıt Açıklaması Dönen cevap 1 ise veritabanı sunucusu düzgün bir şekilde çalışmaktadır. Dönen cevap 0 ise veritabanı sunucusunda bir arıza var demektir. Hatalar -
11 LoadDamageInformation Metodu Hasar bilgilerini Kuzey Kıbrıs Sigorta Bilgi Merkezi veritabanına kaydetmeyi sağlar. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları UserName (Gerekli) : Sigorta Şirketi için özel olarak web servislere erişim için KKSBM tarafından verilen kullanıcı adı Password (Gerekli) : Üstte verilmiş olan kullanıcı adına tahsis edilmiş şifre DamageXml (Gerekli) : Yüklemek istediğiniz hasar bilgileri içeren xml string DamageXml Yapısı <root> <DamageInfo FirmCode="003" ProductCode="15" AgencyCode="MRK" PolicyNumber="0000004" TecditNumber="01" FileNo="0004496" RequestNo="01" DriverPlateCountryCode="601" DriverPlateNumber="AB123" AccidentDate="2014-10-10" AccidentLocation="" InformingDate="2014-10-10 00:00:00" DriverCountryCode="601" DriverIdentityCode="KN" DriverIdentityNo="223344" DriverName="CEYHUN" DriverSurname="GÜÇVER" ClaimantCountryCode="601" ClaimantIdentityCode="KN" ClaimantIdentityNo="223344" ClaimantName="AHMET MEHMET" ClaimantSurname="" AppealDate="2014-10-13 00:00:00" ClaimantPlateCountryCode="601" ClaimantPlateNumber="ab123" DamageReason="(YOK)" EstimatedDamage="1000.00" PaidAmount="0.00" CloseDate="" DamageStatusCode="MU" /> </root> Açıklama Tablo Kolon Adı Veri Tipi Açıklaması FirmCode varchar(3) Şirket Kodu ProductCode varchar(2) Ürün Kodu (EK 1 D) AgencyCode varchar(10) Acente Kodu PolicyNumber varchar(20) Poliçe No TecditNumber varchar(2) Tecdit No FileNo varchar(15) Dosya Numarası RequestNo varchar(2) Talep Numarası DriverPlateCountryCode varchar(3) Sigortalı Araç Ülke Kodu (EK 1 A) DriverPlateNumber varchar(50) Sigortalı Araç Plaka No AccidentDate date Kaza Tarihi (ör. 2009-05-28) AccidentLocation varchar(40) Kaza Yeri InformingDate datetime İhbar Tarihi (ör. 2009-05-28 12:00:00) DriverCountryCode varchar(5) Sürücü Kimlik Ülke Kodu (EK 1 A) DriverIdentityCode varchar(3) Sürücü Kimlik Türü (EK 1 H) DriverIdentityNo varchar(50) Sürücü Kimlik No DriverName varchar(50) Sürücü Adı DriverSurname varchar(50) Sürücü Soyadı ClaimantCountryCode varchar(5) Talep Sahibi Ülke Kodu (EK 1 A) ClaimantIdentityCode varchar(3) Talep Sahibi Kimlik Türü (EK 1 H)
12 ClaimantIdentityNo varchar(50) Talep Sahibi Kimlik No ClaimantName varchar(50) Talep Sahibi Adı ClaimantSurname varchar(50) Talep Sahibi Soyadı AppealDate date Talep Sahibinin Şirkete Müracaat Tarihi (ör. 2009-05-28) ClaimantPlateCountryCode varchar(10) Talep Sahibi Araç Ülke Kodu (EK 1 A) ClaimantPlateNumber varchar(50) Talep Sahibi Araç Plaka No DamageReason varchar(15) Hasar Nedeni EstimatedDamage decimal(18, 2) Tahmini Hasar Tutarı PaidAmount decimal(18, 2) Ödenen Hasar Tutarı CloseDate date Dosya Kapanış Tarihi (ör. 2009-05-28) DamageStatusCode varchar(10) Hasar Dosya Durumu (EK 1 F) Doğrulama Bu metodda çift doğrulama gerektirmektedir. Doğrulama kullanıcı adı ve şifre ile yapılmaktadır. Ayrıca IP adresine göre doğrulamada yapılmaktadır. Dönüş Tipi String Örnek Yanıt <string> <root ResultCode="1"> <DamageLoadResult InsertedDamageCount="0" UpdatedDamageCount="1" SuspectedDamageCount="0" SuspectedErrorCode="0" /> </root> </string> Yanıt Açıklaması InsertedDamageCount UpdatedDamageCount SuspectedDamageCount SuspectedErrorCode InsertedDamageCount Eklenen Hasar Sayısı Güncellenen Hasar Sayısı Şüpheli Hasar Sayısı Silinen Şüpheli Hasar Sayısı Şüpheliye Düşme Hata Kodu (Boş ise hata yok)
13 Hatalar Hata Kodu Hata Mesajı 1 Kullanıcı adı yada şifre hatalı 2 Şirket aktif değil 3 Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. 995 Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış 998 Gönderilen XML'de hatalar var. 997 Gönderdiğiniz XML'deki FirmCode ile giriş yaptığınız kullanıcı adı ve şifre ile girdiğiniz şirketin kodu uyuşmuyor. 997 Gönderilen XML'de FirmCode boş olamaz. 997 Gönderilen XML'de ProductCode boş olamaz. 997 Gönderilen XML'de AgencyCode boş olamaz. 997 Gönderilen XML'de PolicyNumber boş olamaz. 997 Gönderilen XML'de TecditNumber boş olamaz. 997 Gönderilen XML'de FileNo boş olamaz. 997 Gönderilen XML'de RequestNo boş olamaz. 997 XML'de göndermiş olduğunuz DamageStatusCode KKSBM tarafından tanımlanmamış. 99 Gönderdiğiniz XML'de bazı alanlar eksik yada fazladır. 997 Gönderdiğiniz XML'de FirmCode, ProductCode, AgencyCode, PolicyNumber,TecditNumber, FileNo, RequestNo boş olamaz. 98 Gönderdiğiniz Hasarın bağlı olduğu bir poliçe sisteme daha önceden kaydedilmemiş.
14 LoadPolicyInformation Metodu Poliçe bilgilerini Kuzey Kıbrıs Sigorta Bilgi Merkezi veritabanına kaydetmeyi sağlar. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları UserName (Gerekli) : Sigorta Şirketi için özel olarak web servislere erişim için KKSBM tarafından verilen kullanıcı adı Password (Gerekli) : Üstte verilmiş olan kullanıcı adına tahsis edilmiş şifre PolicyXml (Gerekli) : Yüklemek istediğiniz poliçe bilgilerini içeren xml string PolicyXml Yapısı <root><policyinfo FirmCode="003" ProductCode="15" AgencyCode="MRK" PolicyNumber="0000003" TecditNumber="01" ZeylCode="P" ZeylNo="000" PolicyOwnerCountryCode="601" PolicyOwnerIdentityCode="KN" PolicyOwnerIdentityNo="223344" PolicyOwnerName="AHMET MEHMET" PolicyOwnerSurname="" PolicyOwnerBirthDate="1985-05-16" AddressLine1="APARTMAN SOK" AddressLine2="NO.2/5" AddressLine3="KARAKOL / GAZİMAĞUSA" PlateCountryCode="601" PlateNumber="AB123" Brand="RENAULT" Model="MEGANE II CC" ChassisNumber="AAA111BBB" EngineNumber="CCC111DDD" EnginePower="1461" ProductionYear="2008" Capacity="5" CarType="SALON" UsingStyle="ÖZEL" TariffCode="CX1" ArrangeDate="2014-10-10" StartDate="2014-10-10 09:10:00" EndDate="2015-10-09" Material="50000" Corporal="5000000" CurrencyCode="TL" PublicValue="0" AuthorizedDrivers="A" CountryCode1="" IdentityCode1="" IdentityNo1="" Name1="" Surname1="" BirthDate1="" DriverLicenceNo1="" DriverLicenceGivenDate1="" DriverLicenceType1="" CountryCode2="" IdentityCode2="" IdentityNo2="" Name2="" Surname2="" BirthDate2="" DriverLicenceNo2="" DriverLicenceGivenDate2="" DriverLicenceType2="" CountryCode3="" IdentityCode3="" IdentityNo3="" Name3="" Surname3="" BirthDate3="" DriverLicenceNo3="" DriverLicenceGivenDate3="" DriverLicenceType3="" CountryCode4="" IdentityCode4="" IdentityNo4="" Name4="" Surname4="" BirthDate4="" DriverLicenceNo4="" DriverLicenceGivenDate4="" DriverLicenceType4="" CountryCode5="" IdentityCode5="" IdentityNo5="" Name5="" Surname5="" BirthDate5="" DriverLicenceNo5="" DriverLicenceGivenDate5="" DriverLicenceType5="" CountryCode6="" IdentityCode6="" IdentityNo6="" Name6="" Surname6="" BirthDate6="" DriverLicenceNo6="" DriverLicenceGivenDate6="" DriverLicenceType6="" InsurancePremium="262.04" AssistantFees="0.00" OtherFees="0.00" IsTender="" BasePriceValue="150.00" CCRateValue="7.41" DamageRateValue="29.63" AgeRateValue="75.00" DamagelessRateValue="0.00" PolicyType="1" /></root> Açıklama Tablo Kolon Adı Veri Tipi Açıklaması FirmCode varchar(3) Şirket Kodu ProductCode varchar(2) Ürün Kodu (EK 1 D) AgencyCode varchar(10) Acente Kodu PolicyNumber varchar(20) Poliçe No TecditNumber varchar(2) Tecdit No ZeylCode varchar(1) Zeyil Tipi (EK 1 C) ZeylNo varchar(15) Zeyil No
15 PolicyType numeric(18, 0) Poliçe Tipi (EK 1 G) PolicyOwnerCountryCode varchar(3) Sigortalı Ülke Kodu (EK 1 A) PolicyOwnerIdentityCode varchar(2) Sigortalı Kimlik Türü (EK 1 H) PolicyOwnerIdentityNo varchar(15) Sigortalı Kimlik No PolicyOwnerName varchar(50) Sigortalı Adı PolicyOwnerSurname varchar(30) Sigortalı Soyadı PolicyOwnerBirthDate date Sigortalı Doğum Yılı (ör. 2009-05-28) AddressLine1 varchar(50) Sigortalı Adres Satırı 1 AddressLine2 varchar(50) Sigortalı Adres Satırı 2 AddressLine3 varchar(50) Sigortalı Adres Satırı 3 PlateCountryCode varchar(3) Araç Plaka Ülke Kodu PlateNumber varchar(15) Araç Plaka Numarası Brand varchar(30) Araç Marka (ör. TOYOTA) Model varchar(30) Araç Model (ör. COROLLA) ChassisNumber varchar(30) Araç Şasi No EngineNumber varchar(30) Araç Motor No EnginePower numeric(18, 0) Araç Motor Gücü ProductionYear numeric(18, 0) Araç İmal Yılı Capacity numeric(18, 0) Araç Koltuk Sayısı CarType varchar(15) Araç Cinsi (SALON, KAMYON, VAN vs.) UsingStyle varchar(15) Araç Kullanım Tarzı (ÖZEL, TİCARİ, AMBULANS vs.) TariffCode varchar(5) Araç Tarife Kodu (CX1, CZ300, CY1 vs.) (EK 1 B) ArrangeDate date Tanzim Tarihi (ör. 2009-05-28) StartDate datetime Başlama Tarihi (ör. 2009-05-28 12:00:00) EndDate Date Bitiş Tarihi (ör. 2009-05-28) Material decimal(18,2) Maddi Hasar Limiti Corporal decimal(18,2) Bedeni Hasar Limiti CurrencyCode varchar(3) Poliçe Para Birimi PublicValue decimal(18, 2) Sigorta Bedeli / Araç Bedeli AuthorizedDrivers varchar(1) Yetkili Sürücü (A:Any driver, N:Named driver) CountryCode1 varchar(3) Yetkili Sürücü-1 Ülke Kodu (EK 1 A) IdentityCode1 varchar(2) Yetkili Sürücü-1 Kimlik Türü Kodu (EK 1 H) IdentityNo1 varchar(15) Yetkili Sürücü-1 Kimlik No Name1 varchar(50) Yetkili Sürücü-1 Adı Surname1 varchar(50) Yetkili Sürücü-1 Soyadı BirthDate1 date Yetkili Sürücü-1 Doğum Tarihi Yılı(ör. 2009-05-28) DriverLicenceNo1 varchar(15) Yetkili Sürücü-1 Ehliyet No DriverLicenceGivenDate1 date Yetkili Sürücü-1 Ehliyetini Aldığı Tarih(ör. 2009-05-28) DriverLicenceType1 varchar(1) Yetkili Sürücü-1 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) CountryCode2 varchar(3) Yetkili Sürücü-2 Ülke Kodu (EK 1 A) IdentityCode2 varchar(2) Yetkili Sürücü-2 Kimlik Türü Kodu (EK 1 H) IdentityNo2 varchar(15) Yetkili Sürücü-2 Kimlik No Name2 varchar(50) Yetkili Sürücü-2 Adı Surname2 varchar(50) Yetkili Sürücü-2 Soyadı BirthDate2 date Yetkili Sürücü-2 Doğum Yılı(ör. 2009-05-28) DriverLicenceNo2 varchar(15) Yetkili Sürücü-2 Ehliyet No DriverLicenceGivenDate2 date Yetkili Sürücü-2 Ehliyetini Aldığı Yıl(ör. 2009-05-28) DriverLicenceType2 varchar(1) Yetkili Sürücü-2 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) CountryCode3 varchar(3) Yetkili Sürücü-3 Ülke Kodu (EK 1 A) IdentityCode3 varchar(2) Yetkili Sürücü-3 Kimlik Türü Kodu (EK 1 H) IdentityNo3 varchar(15) Yetkili Sürücü-3 Kimlik No
16 Name3 varchar(50) Yetkili Sürücü-3 Adı Surname3 varchar(50) Yetkili Sürücü-3 Soyadı BirthDate3 date Yetkili Sürücü-3 Doğum Yılı(ör. 2009-05-28) DriverLicenceNo3 varchar(15) Yetkili Sürücü-3 Ehliyet No DriverLicenceGivenDate3 date Yetkili Sürücü-3 Ehliyetini Aldığı Yıl(ör. 2009-05-28) DriverLicenceType3 varchar(1) Yetkili Sürücü-3 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) CountryCode4 varchar(3) Yetkili Sürücü-4 Ülke Kodu (EK 1 A) IdentityCode4 varchar(3) Yetkili Sürücü-4 Kimlik Türü Kodu (EK 1 H) IdentityNo4 varchar(15) Yetkili Sürücü-4 Kimlik No Name4 varchar(50) Yetkili Sürücü-4 Adı Surname4 varchar(50) Yetkili Sürücü-4 Soyadı BirthDate4 date Yetkili Sürücü-4 Doğum Yılı(ör. 2009-05-28) DriverLicenceNo4 varchar(15) Yetkili Sürücü-4 Ehliyet No DriverLicenceGivenDate4 Date Yetkili Sürücü-4 Ehliyetini Aldığı Yıl(ör. 2009-05-28) DriverLicenceType4 varchar(1) Yetkili Sürücü-4 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) CountryCode5 varchar(3) Yetkili Sürücü-5 Ülke Kodu (EK 1 A) IdentityCode5 varchar(3) Yetkili Sürücü-5 Kimlik Türü Kodu (EK 1 H) IdentityNo5 varchar(15) Yetkili Sürücü-5 Kimlik No Name5 varchar(50) Yetkili Sürücü-5 Adı Surname5 varchar(50) Yetkili Sürücü-5 Soyadı BirthDate5 date Yetkili Sürücü-5 Doğum Yılı(ör. 2009-05-28) DriverLicenceNo5 varchar(15) Yetkili Sürücü-5 Ehliyet No DriverLicenceGivenDate5 date Yetkili Sürücü-5 Ehliyetini Aldığı Yıl(ör. 2009-05-28) DriverLicenceType5 varchar(1) Yetkili Sürücü-5 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) CountryCode6 varchar(3) Yetkili Sürücü-6 Ülke Kodu (EK 1 A) IdentityCode6 varchar(3) Yetkili Sürücü-6 Kimlik Türü Kodu (EK 1 H) IdentityNo6 varchar(15) Yetkili Sürücü-6 Kimlik No Name6 varchar(50) Yetkili Sürücü-6 Adı Surname6 varchar(50) Yetkili Sürücü-6 Soyadı BirthDate6 date Yetkili Sürücü-6 Doğum Yılı(ör. 2009-05-28) DriverLicenceNo6 varchar(15) Yetkili Sürücü-6 Ehliyet No DriverLicenceGivenDate6 Date Yetkili Sürücü-6 Ehliyetini Aldığı Yıl(ör. 2009-05-28) DriverLicenceType6 varchar(1) Yetkili Sürücü-6 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) InsurancePremium decimal(18,2) Sigorta Primi AssistantFees decimal(18,2) Assistan Hizmetleri Ücreti OtherFees decimal(18,2) Diğer Ücretler IsTender bit İhale ise 0 değil ise 1 BasePriceValue decimal(18,2) Baz Fiyat CCRateValue decimal(18,2) CC Zammı DamageRateValue decimal(18,2) Hasar Zammı AgeRateValue decimal(18,2) Yaş Zammı DamagelessRateValue decimal(18,2) Hasarsızlık İndirimi
17 Doğrulama Bu metodda çift doğrulama gerektirmektedir. Doğrulama kullanıcı adı ve şifre ile yapılmaktadır. Ayrıca IP adresine göre doğrulamada yapılmaktadır. Dönüş Tipi String Örnek Yanıt <root ResultCode="1"> <PolicyLoadResult InsertedPolicyCount="0" UpdatedPolicyCount="1" SuspectedPolicyCount="0" DeletedSuspectedPolicyCount="0" SuspectedErrorCode="0" /> </root> Yanıt Açıklaması InsertedPolicyCount UpdatedPolicyCount SuspectedPolicyCount DeletedSuspectedPolicyCount SuspectedErrorCode Eklenen Poliçe Sayısı Güncellenen Poliçe Sayısı Şüpheli Hasar Sayısı Silinen Şüpheli Hasar Sayısı Şüpheliye Düşme Hata Kodu (Boş ise hata yok) Hatalar Hata Kodu Hata Mesajı 1 Kullanıcı adı yada şifre hatalı 2 Şirket aktif değil 3 Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. 995 Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış 996 Ayni poliçeye birden fazla P gelemez. 996 P yada T zeyili olmayan poliçeye V,R,X,Y zeyili gelemez. 996 İptali olan bir poliçeye iptal zeyilinden sonra ancak Y zeyili (Yürürlüğe Alma Zeyili) gelebilir 996 İptali olmayan bir poliçeye Y zeyili gelemez. Y ancak X'den sonra gelebilir. 998 Gönderilen XML'de hatalar var. (Hata mesajı) 997 Gönderilen XML'de ProductCode KKSBM tarafından tanımlanmamış. 997 Gönderilen XML'de ProductCode boş olamaz. 997 Gönderilen XML'de AgencyCode boş olamaz. 997 Gönderilen XML'de PolicyNumber boş olamaz. 997 Gönderilen XML'de TecditNumber boş olamaz. 997 Gönderilen XML'de ZeylCode KKSBM tarafından tanımlanmamış. 997 Gönderilen XML'de ZeylCode boş olamaz. 997 Gönderilen XML'de ZeylNo boş olamaz.
18 997 Gönderilen XML'de PolicyType rakam olmak zorunda veya 0 olmamalı. 997 Gönderilen XML'de ProductionYear 4 karakterden oluşmalıdır. 997 Gönderilen XML'de TariffCode KKSBM tarafından tanımlanmamıştır. 997 Gönderilen XML'de ArrangeDate boş olmamalı veya formatı hatalıdır. Tarih formatı yyyy-mm-dd şeklinde olmalıdır. 997 Gönderilen XML'de StartDate boş olmamalı veya formatı hatalıdır. Tarih formatı yyyy-mm-dd şeklinde olmalıdır. 997 Gönderilen XML'de EndDate boş olmamalı veya formatı hatalıdır. Tarih formatı yyyy-mm-dd şeklinde olmalıdır. 997 Gönderdiğiniz XML'de CurrencyCode olmalı ve KKSBM tarafından tanımlanmış olmalıdır. 997 Gönderilen XML'de InsuarencePremium boş olamaz. 997 Gönderilen XML'de AssistantFees boş olamaz. 997 Gönderilen XML'de OtherFees boş olamaz. 997 Gönderilen XML'de BasePriceValue boş olamaz. 997 Gönderilen XML'de CCRateValue boş olamaz. 997 Gönderilen XML'de DamageRate Value boş olamaz. 997 Gönderilen XML'de AgeRateValue Value boş olamaz. 997 Gönderilen XML'de DamagelessRateValue Value boş olamaz. 996 İptali olan bir poliçeye iptal zeyilinden sonra ancak Y zeyili (Yürürlüğe Alma Zeyili) gelebilir 99 Gönderdiğiniz XML'de bazı alanlar eksik yada fazladır. 997 Gönderdiğiniz XML'de FirmCode, ProductCode, AgencyCode, PolicyNumber, TecditNumber, ZeylCode, ZeylNo boş olamaz 995 Bu poliçenin zeyilleri arasında ayni zeyil numarasına sahip zeyil daha önce kaydedilmiş
19 getversion Metodu Kuzey Kıbrıs Sigorta Bilgi Merkezi yazılımının sürüm numarasını döndürür. Servise Gönderilmesi Gereken Parametreler ve Açıklamaları Servise herhangi bir parametre gönderilmez Sistem Yöneticisine Uyarı Şu anda okuduğunuz dokümantasyonun versiyon numarası ile bu servisten dönen changetext içindeki numaranın ayni Doğrulama Bu metod doğrulama gerektirmektedir. Doğrulama kullanıcı adı ve şifre ile yapılmaktadır. Dönüş Tipi Boolean Örnek Yanıt <root ResultCode="1"> <ErrorInfo Code="0" Message="" /> <changelog> <change changetext="1.0" /> </changelog> </root> Yanıt Açıklaması changetext tagı içerisinde yazılımın versiyon numarası döndürülür. Hatalar Hata Kodu Hata Mesajı 1 Kullanıcı adı yada şifre hatalı
20 Ek-1 Kodlar A. Ülke Kodları B. Araç Tarife Kodları Kod Açıklama 1 FRANSA 2 BELÇİKA 3 HOLLANDA 4 ALMANYA 5 İTALYA 6 BİRLEŞİK KRALLIK 7 İRLANDA 8 DANİMARKA 9 YUNANİSTAN 10 PORTEKİZ 11 İSPANYA 12 LÜKSEMBURG 21 KANARYA ADALARI 22 CEUTA VE MELILLA 24 İZLANDA 25 FAROE ADALARI 28 NORVEÇ 30 İSVEÇ 32 FİNLANDİYA 36 İSVİÇRE 38 AVUSTURYA 43 ANDORRA 44 CEBELİTARIK 45 VATİKAN 46 MALTA 48 YUGOSLAVYA 52 TÜRKİYE 53 ESTONYA 54 LETONYA 55 LİTVANYA 60 POLONYA 62 ÇEK CUMHURİYETİ 63 SLOVAKYA 64 MACARİSTAN 66 ROMANYA 68 BULGARİSTAN Tarife Kodu CX1 CY1 CY70 CZ26 CZ300 CZ301 CZ312 CZ400 CZ406 CZ600 CZ605 CZ801 CZ802 CZ803 CZ804 CZ805 CZ9 Tarife Adı Salon Araç Motosiklet Kiralık Motosiklet Şoför Okulları Van / Kamyonet Kamyon Trailer Taksiler Kiralık Araçlar Otobüs / Minibüs (Ticari olarak çalışanlar) Otobüs / Minibüs (Police sahibinin işyeri için çalışanlar) Özel Tip Araçlar Tarımsal Araçlar Ambulans ve Cenaze Araçları Vinçler İtfaiye Araçları Motor Trade C. Zeyil Kodları Listesi Kod Açıklama P YENİ POLİÇE R İADE PRİMLİ ZEYİL T TECDİT İLAVE PRİMLİ VEYA SIFIR V PRİMLİ ZEYİL X İPTAL ZEYİLİ Y YÜRÜRLÜĞE ALMA ZEYİLİ
21 70 ARNAVUTLUK 72 UKRANYA 73 BEYAZ RUSYA 74 MOLDAVYA 75 RUSYA FEDERASYONU 76 GÜRCİSTAN 77 ERMENİSTAN 78 AZERBEYCAN-MAHÇIVAN 79 KAZAKİSTAN 80 TÜRKMENİSTAN 81 ÖZBEKİSTAN 82 TACİKİSTAN 83 KIRGIZİSTAN 84 ÇEÇEN CUMHURİYETİ 85 DAĞİSTAN CUMHURİYETİ 86 TATARİSTAN 87 YAKUTİSTAN 91 SLOVENYA 92 HIRVATİSTAN 93 BOSNA-HERSEK 94 SIRBİSTAN 96 MAKEDONYA 182 COOK ADALARI 204 FAS 212 TUNUS 216 LİBYA 220 MISIR 224 SUDAN 228 MORİTANYA 232 MALİ 236 BURKİNA FASO 240 NİDER 244 ÇAT 247 CAPE 248 SENEGAL 252 GAMBİYA 257 GİNE BİSSAU 260 GİNE 264 SIERRA LEONE 268 LİBERYA 272 FİL DİŞİ SAHİLLERİ 276 GANA D. Ürün Kodları Listesi Kod Açıklama 15 TRAFİK 16 KISMİ KASKO 17 KASKO E. Para Birimleri Listesi Kod Açıklama EUR EURO STG STERLİN TL TÜRK LİRASI F. Hasar Durum Kodları Listesi Kod Açıklama IP DOSYA İPTAL DOSYA ÖDEME YAPILIP KP KAPATILDI DOSYADA MUALLAK VAR VE MU ÖDEME YAPILMAMIŞ VE KAPATILMAMIŞ TAKİPSİZLİK NEDENİ İLE NE KAPATILDI ÖDEME YAPILMIŞ VE RÜCUSU OD HAYIR RD DOSYA RED EDİLDİ ÖDEME YAPILMIŞ VE RÜCUSU RU EVET G. Poliçe Tipleri Listesi Kod Ad 1 NORMAL POLİÇE 2 İHALE 3 SINIR KAPISI
22 280 TOGO 284 BENİN 288 NİJERYA 302 KAMERUN 306 MERKEZİ AFRİKA CUMHURİYETİ 310 EKVADOR GİNESİ 311 SAOTOME PRA 314 GABON 318 KONGO 322 ZAİRE 324 RUANDA 328 BURUNDİ 329 ST. HELENA VE BAĞLANTILARI 330 ANGOLA 334 ETİYOPYA 338 CİBUTİ 342 SOMALİ 346 KENYA 350 UGANDA 352 TANZANYA SEYŞEL ADALARI VE 355 BAĞLANTILARI 357 İNGİLİZ HİNT OK. TOPRAKLARI 366 MOZAMBİK 370 MADAGASKAR 372 RUNION 373 MAOURİTES 375 KOMORO ADALARI 377 MAYOTTE 378 ZAMBİYA 382 ZİMBAVVE 386 MALAVİ 389 NAMİBYA 390 GÜNEY AFRİKA CUMHURİYETİ 391 BOSTVANA 393 SWEZILAND 395 LESOTHO 400 AMERİKA BİRLEŞİK DEVLETLERİ 404 KANADA 406 GRÖNLAND 408 ST. PIERRE VE MIKUELON 412 MEKSİKA H. Kimlik türleri Kod Ad JV JOINT VENTURE KN KİMLİK KARTI NUMARASI KOOPERATİF ŞİRKETLERİ - KKTC KP MŞ MAHALLİ ŞİRKETLER - KKTC P ORTAKLIKLAR KKTC PN UŞ VK YK YŞ PASAPORT NUMARASI ULUSLARARASI İŞLETMELER KKTC VAKIFLAR KKTC YEREL KURULUŞLAR KKTC YABANCI ŞİRKETLER - KKTC
23 413 BERMUDA 416 GUATEMALA 421 BELİZE 424 HONDURAS 428 EL SALVADOR 432 NİKARAGUA 436 KOSTA RİKA 442 PANAMA 446 ANGUILA 448 KÜBA 449 ST. CRISTOPHER VE NEVİS 452 HAİTİ 453 BAHAMA 454 TURKS VE CAİCOS ADASI 456 DOMİNİK CUMHURİYETİ 457 ABD VIRGIN ADALARI 458 GUADELUP 459 ANTIGUA VE BERMUDA 460 DOMİNİKA 461 İNGİLİZ VIRGIN ADALARI 462 MARTİNİK 463 CEYMAN ADALARI 464 JAMAİKA 465 ST. LUCİA 467 ST. VİNGENT 469 BARBADOS 472 TRİNİDAD VE TABAGO 473 GRENADA 474 ARUBA 478 HOLLANDA ANTİLLERİ 480 KOLOMBİYA 484 VENEZULLA 488 GUYANA 492 SURİNAM 493 MONAKO 496 FRANSIZ GUYANASI 500 EKVADOR 504 PERU 508 BREZİLYA 512 ŞİLİ 516 BOLİVYA 520 PARAGUAY
24 524 URUGUAY 528 ARJANTİN 529 FALKLAND ADALARI 600 GÜNEY KIBRIS RUM KESİMİ 601 KKTC 604 LÜBNAN 608 SURİYE 612 IRAK 616 İRAN 624 İSRAİL 625 GAZZE 628 ÜRDÜN 632 SUUDİ ARABİSTAN 636 KUVEYT 640 BAHREYN 644 KATAR 647 BİRLEŞİK ARAP EMİRLİKLERİ 648 DUBAİ 649 UMMAN 652 KUZEY YEMEN 656 GÜNEY YEMEN 660 AFGANİSTAN 662 PAKİSTAN 664 HİNDİSTAN 666 BANGLADEŞ 667 MALDİV ADALARI 669 SRİ LANKA 672 NEPAL 675 BHUTAN 676 BURMA 680 TAYLAND 684 LAOS 690 VIETNAM 696 KAMBOÇYA 700 ENDONEZYA 701 MALEZYA 703 BRUNEİ 706 SINGAPUR 708 FİLİPİNLER 716 MOĞOLİSTAN 720 ÇİN HALK CUMHURİYETİ 724 KUZEY KORE DEMOKRATİK
25 HALK CUM. 728 GÜNEY KORE CUMHURİYETİ 732 JAPONYA 736 TAYVAN 740 HONGKONG 743 MAKAO 800 AVUSTURALYA 801 PAPUA YENİ GİNE 802 AVUSTURALYA OKYANUSU 803 NAURU 804 YENİ ZELANDA 806 SOLOMON ADALARI 807 TUVALU 808 AMERİKAN OKYANUSYASI YENİ KALEDONYA VE 809 BAĞLANTILARI 811 WALLACE VE TUNA ADALARI 812 KİRİBATİ 813 PİTCAİRN 814 YENİ ZELANDA OKYANUSU 815 FİJİ 816 VANUATU 817 TONGA 819 BATI SAMAO Ülke Kodları