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: Supernova Ticaret ve Yazılım 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. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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. < < > > & & ' ' " " Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 Name Address1 Address2 Address3 Plaka numarası Ad Soyad Adres Satırı 1 Adres Satırı 2 Adres Satırı 3 Hatalar Hata Kodu 1 2 3 995 998 Hata Mesajı Kullanıcı adı yada şifre hatalı Şirket aktif değil Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış Gönderilen XML'de hatalar var. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 SIdentityNumber PlateCountryCode SIdentityCountryCode SıdentityCode IdentityNumber1 IdentityCountryCode1 IdentityCode1 IdentityNumber2 IdentityCountryCode2 IdentityCode2 IdentityNumber3 IdentityCountryCode3 IdentityCode3 IdentityNumber4 IdentityCountryCode4 IdentityCode4 IdentityNumber5 IdentityCountryCode5 IdentityCode5 IdentityNumber6 IdentityCountryCode6 IdentityCode6 Araç Plaka Numarası Poliçe sahibi Kimlik/MŞE No Araç Plakası Ülke Kodu (EK – 1 A) Sigortalı Ülke Kodu (EK – 1 A) Sigortalı kimlik kodu (EK – 1 H) 1.Sürücü Kimlik Numarası 1.Sürücü Ülke Kodu (EK – 1 A) 1.Sürücü kimlik Kodu (EK – 1 H) 2.Sürücü Kimlik 2.Sürücü Ülke Kodu (EK – 1 A) 2.Sürücü kimlik Kodu (EK – 1 H) 3.Sürücü Kimlik Numarası 3.Sürücü Ülke Kodu (EK – 1 A) 3.Sürücü kimlik Kodu (EK – 1 H) 4. Sürücü Kimlik Numarası 4.Sürücü Ülke Kodu (EK – 1 A) 4.Sürücü kimlik Kodu (EK – 1 H) 5. Sürücü Kimlik Numarası 5.Sürücü Ülke Kodu (EK – 1 A) 5.Sürücü kimlik Kodu (EK – 1 H) 6. Sürücü Kimlik Numarası 6.Sürücü Ülke Kodu (EK – 1 A) 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 Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 1 2 3 995 998 Hata Mesajı Kullanıcı adı yada şifre hatalı Şirket aktif değil Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış Gönderilen XML'de hatalar var. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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ı Araç Plaka Numarası PlateNumber Name Sigortalı Adı Surname Sigortalı Soyadı IdentityCode Sigortalı Kimlik Türü IdentityNo Sigortalı Kimlik No Address1 Sigortalı Adres Satırı Address2 Sigortalı Adres Satırı Address3 Sigortalı Adres Satırı CountryCode Sigortalı Ülke Kodu Policy “Geçerli Poliçe” veya “Poliçe bulunamadı” açıklama Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 8 Hatalar Hata Kodu 1 Hata Mesajı Kullanıcı adı ve/veya şifre yanlış girilmiştir. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 - Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 - Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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ı FirmCode ProductCode AgencyCode Veri Tipi varchar(3) varchar(2) varchar(10) Açıklaması Şirket Kodu Ürün Kodu (EK – 1 D) Acente Kodu PolicyNumber varchar(20) Poliçe No TecditNumber varchar(2) Tecdit No FileNo varchar(15) Dosya Numarası RequestNo varchar(2) Talep Numarası DriverPlateCountryCode DriverPlateNumber AccidentDate AccidentLocation InformingDate DriverCountryCode DriverIdentityCode DriverIdentityNo DriverName DriverSurname ClaimantCountryCode ClaimantIdentityCode varchar(3) varchar(50) date varchar(40) datetime varchar(5) varchar(3) varchar(50) varchar(50) varchar(50) varchar(5) varchar(3) Sigortalı Araç Ülke Kodu (EK – 1 A) Sigortalı Araç Plaka No Kaza Tarihi (ör. 2009-05-28) Kaza Yeri İhbar Tarihi (ör. 2009-05-28 12:00:00) Sürücü Kimlik Ülke Kodu (EK – 1 A) Sürücü Kimlik Türü (EK – 1 H) Sürücü Kimlik No Sürücü Adı Sürücü Soyadı Talep Sahibi Ülke Kodu (EK – 1 A) Talep Sahibi Kimlik Türü (EK – 1 H) Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 12 ClaimantIdentityNo ClaimantName ClaimantSurname AppealDate varchar(50) varchar(50) varchar(50) date ClaimantPlateCountryCode ClaimantPlateNumber DamageReason varchar(10) varchar(50) varchar(15) Talep Sahibi Kimlik No Talep Sahibi Adı Talep Sahibi Soyadı Talep Sahibinin Şirkete Müracaat Tarihi (ör. 200905-28) Talep Sahibi Araç Ülke Kodu (EK – 1 A) Talep Sahibi Araç Plaka No Hasar Nedeni EstimatedDamage decimal(18, 2) Tahmini Hasar Tutarı PaidAmount CloseDate DamageStatusCode decimal(18, 2) date varchar(10) Ödenen Hasar Tutarı Dosya Kapanış Tarihi (ör. 2009-05-28) 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) Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 13 Hatalar Hata Kodu 1 2 3 995 998 997 997 997 997 997 997 997 997 997 99 997 98 Hata Mesajı Kullanıcı adı yada şifre hatalı Şirket aktif değil Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış Gönderilen XML'de hatalar var. Gönderdiğiniz XML'deki FirmCode ile giriş yaptığınız kullanıcı adı ve şifre ile girdiğiniz şirketin kodu uyuşmuyor. Gönderilen XML'de FirmCode boş olamaz. Gönderilen XML'de ProductCode boş olamaz. Gönderilen XML'de AgencyCode boş olamaz. Gönderilen XML'de PolicyNumber boş olamaz. Gönderilen XML'de TecditNumber boş olamaz. Gönderilen XML'de FileNo boş olamaz. Gönderilen XML'de RequestNo boş olamaz. XML'de göndermiş olduğunuz DamageStatusCode KKSBM tarafından tanımlanmamış. Gönderdiğiniz XML'de bazı alanlar eksik yada fazladır. Gönderdiğiniz XML'de FirmCode, ProductCode, AgencyCode, PolicyNumber,TecditNumber, FileNo, RequestNo boş olamaz. Gönderdiğiniz Hasarın bağlı olduğu bir poliçe sisteme daha önceden kaydedilmemiş. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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ı FirmCode ProductCode AgencyCode PolicyNumber TecditNumber ZeylCode ZeylNo Veri Tipi varchar(3) varchar(2) varchar(10) varchar(20) varchar(2) varchar(1) varchar(15) Açıklaması Şirket Kodu Ürün Kodu (EK – 1 D) Acente Kodu Poliçe No Tecdit No Zeyil Tipi (EK – 1 C) Zeyil No Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 15 PolicyType PolicyOwnerCountryCode PolicyOwnerIdentityCode PolicyOwnerIdentityNo PolicyOwnerName PolicyOwnerSurname PolicyOwnerBirthDate AddressLine1 AddressLine2 AddressLine3 PlateCountryCode PlateNumber Brand Model ChassisNumber EngineNumber EnginePower ProductionYear Capacity CarType UsingStyle TariffCode ArrangeDate numeric(18, 0) varchar(3) varchar(2) varchar(15) varchar(50) varchar(30) date varchar(50) varchar(50) varchar(50) varchar(3) varchar(15) varchar(30) varchar(30) varchar(30) varchar(30) numeric(18, 0) numeric(18, 0) numeric(18, 0) varchar(15) varchar(15) varchar(5) date Poliçe Tipi (EK – 1 G) Sigortalı Ülke Kodu (EK – 1 A) Sigortalı Kimlik Türü (EK – 1 H) Sigortalı Kimlik No Sigortalı Adı Sigortalı Soyadı Sigortalı Doğum Yılı (ör. 2009-05-28) Sigortalı Adres Satırı 1 Sigortalı Adres Satırı 2 Sigortalı Adres Satırı 3 Araç Plaka Ülke Kodu Araç Plaka Numarası Araç Marka (ör. TOYOTA) Araç Model (ör. COROLLA) Araç Şasi No Araç Motor No Araç Motor Gücü Araç İmal Yılı Araç Koltuk Sayısı Araç Cinsi (SALON, KAMYON, VAN vs.) Araç Kullanım Tarzı (ÖZEL, TİCARİ, AMBULANS vs.) Araç Tarife Kodu (CX1, CZ300, CY1 vs.) (EK – 1 B) Tanzim Tarihi (ör. 2009-05-28) StartDate EndDate Material Corporal CurrencyCode PublicValue AuthorizedDrivers CountryCode1 IdentityCode1 IdentityNo1 Name1 Surname1 BirthDate1 datetime Date decimal(18,2) decimal(18,2) varchar(3) decimal(18, 2) varchar(1) varchar(3) varchar(2) varchar(15) varchar(50) varchar(50) date DriverLicenceNo1 DriverLicenceGivenDate1 DriverLicenceType1 varchar(15) date varchar(1) CountryCode2 IdentityCode2 IdentityNo2 Name2 Surname2 BirthDate2 DriverLicenceNo2 DriverLicenceGivenDate2 DriverLicenceType2 varchar(3) varchar(2) varchar(15) varchar(50) varchar(50) date varchar(15) date varchar(1) Başlama Tarihi (ör. 2009-05-28 12:00:00) Bitiş Tarihi (ör. 2009-05-28) Maddi Hasar Limiti Bedeni Hasar Limiti Poliçe Para Birimi Sigorta Bedeli / Araç Bedeli Yetkili Sürücü (A:Any driver, N:Named driver) Yetkili Sürücü-1 Ülke Kodu (EK – 1 A) Yetkili Sürücü-1 Kimlik Türü Kodu (EK – 1 H) Yetkili Sürücü-1 Kimlik No Yetkili Sürücü-1 Adı Yetkili Sürücü-1 Soyadı Yetkili Sürücü-1 Doğum Tarihi Yılı(ör. 2009-05-28) Yetkili Sürücü-1 Ehliyet No Yetkili Sürücü-1 Ehliyetini Aldığı Tarih(ör. 2009-05-28) Yetkili Sürücü-1 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) Yetkili Sürücü-2 Ülke Kodu (EK – 1 A) Yetkili Sürücü-2 Kimlik Türü Kodu (EK – 1 H) Yetkili Sürücü-2 Kimlik No Yetkili Sürücü-2 Adı Yetkili Sürücü-2 Soyadı Yetkili Sürücü-2 Doğum Yılı(ör. 2009-05-28) Yetkili Sürücü-2 Ehliyet No Yetkili Sürücü-2 Ehliyetini Aldığı Yıl(ör. 2009-05-28) Yetkili Sürücü-2 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) Yetkili Sürücü-3 Ülke Kodu (EK – 1 A) Yetkili Sürücü-3 Kimlik Türü Kodu (EK – 1 H) Yetkili Sürücü-3 Kimlik No CountryCode3 varchar(3) IdentityCode3 varchar(2) IdentityNo3 varchar(15) Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 16 Name3 Surname3 BirthDate3 DriverLicenceNo3 DriverLicenceGivenDate3 DriverLicenceType3 varchar(50) varchar(50) date varchar(15) date varchar(1) CountryCode4 IdentityCode4 IdentityNo4 Name4 Surname4 BirthDate4 DriverLicenceNo4 DriverLicenceGivenDate4 DriverLicenceType4 varchar(3) varchar(3) varchar(15) varchar(50) varchar(50) date varchar(15) Date varchar(1) CountryCode5 IdentityCode5 IdentityNo5 Name5 Surname5 BirthDate5 DriverLicenceNo5 DriverLicenceGivenDate5 DriverLicenceType5 varchar(3) varchar(3) varchar(15) varchar(50) varchar(50) date varchar(15) date varchar(1) CountryCode6 IdentityCode6 IdentityNo6 Name6 Surname6 BirthDate6 DriverLicenceNo6 DriverLicenceGivenDate6 DriverLicenceType6 varchar(3) varchar(3) varchar(15) varchar(50) varchar(50) date varchar(15) Date varchar(1) InsurancePremium decimal(18,2) Yetkili Sürücü-3 Adı Yetkili Sürücü-3 Soyadı Yetkili Sürücü-3 Doğum Yılı(ör. 2009-05-28) Yetkili Sürücü-3 Ehliyet No Yetkili Sürücü-3 Ehliyetini Aldığı Yıl(ör. 2009-05-28) Yetkili Sürücü-3 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) Yetkili Sürücü-4 Ülke Kodu (EK – 1 A) Yetkili Sürücü-4 Kimlik Türü Kodu (EK – 1 H) Yetkili Sürücü-4 Kimlik No Yetkili Sürücü-4 Adı Yetkili Sürücü-4 Soyadı Yetkili Sürücü-4 Doğum Yılı(ör. 2009-05-28) Yetkili Sürücü-4 Ehliyet No Yetkili Sürücü-4 Ehliyetini Aldığı Yıl(ör. 2009-05-28) Yetkili Sürücü-4 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) Yetkili Sürücü-5 Ülke Kodu (EK – 1 A) Yetkili Sürücü-5 Kimlik Türü Kodu (EK – 1 H) Yetkili Sürücü-5 Kimlik No Yetkili Sürücü-5 Adı Yetkili Sürücü-5 Soyadı Yetkili Sürücü-5 Doğum Yılı(ör. 2009-05-28) Yetkili Sürücü-5 Ehliyet No Yetkili Sürücü-5 Ehliyetini Aldığı Yıl(ör. 2009-05-28) Yetkili Sürücü-5 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) Yetkili Sürücü-6 Ülke Kodu (EK – 1 A) Yetkili Sürücü-6 Kimlik Türü Kodu (EK – 1 H) Yetkili Sürücü-6 Kimlik No Yetkili Sürücü-6 Adı Yetkili Sürücü-6 Soyadı Yetkili Sürücü-6 Doğum Yılı(ör. 2009-05-28) Yetkili Sürücü-6 Ehliyet No Yetkili Sürücü-6 Ehliyetini Aldığı Yıl(ör. 2009-05-28) Yetkili Sürücü-6 Ehliyet Tipi (O:Öğrenci Ehliyeti, N:Normal Ehliyet) 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 Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 1 2 3 995 996 996 996 996 998 997 997 997 997 997 997 997 997 Hata Mesajı Kullanıcı adı yada şifre hatalı Şirket aktif değil Bu IP adresi ile web servisine bağlanmaya yetkiniz yoktur. Yetkisiz. Girdiğiniz kullanıcı adı ve şifre ile herhangi bir şirket tanımlanmamış Ayni poliçeye birden fazla P gelemez. P yada T zeyili olmayan poliçeye V,R,X,Y zeyili gelemez. İptali olan bir poliçeye iptal zeyilinden sonra ancak Y zeyili (Yürürlüğe Alma Zeyili) gelebilir İptali olmayan bir poliçeye Y zeyili gelemez. Y ancak X'den sonra gelebilir. Gönderilen XML'de hatalar var. (Hata mesajı) Gönderilen XML'de ProductCode KKSBM tarafından tanımlanmamış. Gönderilen XML'de ProductCode boş olamaz. Gönderilen XML'de AgencyCode boş olamaz. Gönderilen XML'de PolicyNumber boş olamaz. Gönderilen XML'de TecditNumber boş olamaz. Gönderilen XML'de ZeylCode KKSBM tarafından tanımlanmamış. Gönderilen XML'de ZeylCode boş olamaz. Gönderilen XML'de ZeylNo boş olamaz. Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 18 997 997 997 997 997 997 997 997 997 997 997 997 997 997 997 996 99 997 995 Gönderilen XML'de PolicyType rakam olmak zorunda veya 0 olmamalı. Gönderilen XML'de ProductionYear 4 karakterden oluşmalıdır. Gönderilen XML'de TariffCode KKSBM tarafından tanımlanmamıştır. Gönderilen XML'de ArrangeDate boş olmamalı veya formatı hatalıdır. Tarih formatı yyyy-MM-dd şeklinde olmalıdır. Gönderilen XML'de StartDate boş olmamalı veya formatı hatalıdır. Tarih formatı yyyy-MM-dd şeklinde olmalıdır. Gönderilen XML'de EndDate boş olmamalı veya formatı hatalıdır. Tarih formatı yyyy-MM-dd şeklinde olmalıdır. Gönderdiğiniz XML'de CurrencyCode olmalı ve KKSBM tarafından tanımlanmış olmalıdır. Gönderilen XML'de InsuarencePremium boş olamaz. Gönderilen XML'de AssistantFees boş olamaz. Gönderilen XML'de OtherFees boş olamaz. Gönderilen XML'de BasePriceValue boş olamaz. Gönderilen XML'de CCRateValue boş olamaz. Gönderilen XML'de DamageRate Value boş olamaz. Gönderilen XML'de AgeRateValue Value boş olamaz. Gönderilen XML'de DamagelessRateValue Value boş olamaz. İptali olan bir poliçeye iptal zeyilinden sonra ancak Y zeyili (Yürürlüğe Alma Zeyili) gelebilir Gönderdiğiniz XML'de bazı alanlar eksik yada fazladır. Gönderdiğiniz XML'de FirmCode, ProductCode, AgencyCode, PolicyNumber, TecditNumber, ZeylCode, ZeylNo boş olamaz Bu poliçenin zeyilleri arasında ayni zeyil numarasına sahip zeyil daha önce kaydedilmiş Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 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 1 Hata Mesajı Kullanıcı adı yada şifre hatalı Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 20 Ek-1 Kodlar A. Ülke 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 B. Araç Tarife Kodları 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İ Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 21 70 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 91 92 93 94 96 182 204 212 216 220 224 228 232 236 240 244 247 248 252 257 260 264 268 272 276 ARNAVUTLUK UKRANYA BEYAZ RUSYA MOLDAVYA RUSYA FEDERASYONU GÜRCİSTAN ERMENİSTAN AZERBEYCAN-MAHÇIVAN KAZAKİSTAN TÜRKMENİSTAN ÖZBEKİSTAN TACİKİSTAN KIRGIZİSTAN ÇEÇEN CUMHURİYETİ DAĞİSTAN CUMHURİYETİ TATARİSTAN YAKUTİSTAN SLOVENYA HIRVATİSTAN BOSNA-HERSEK SIRBİSTAN MAKEDONYA COOK ADALARI FAS TUNUS LİBYA MISIR SUDAN MORİTANYA MALİ BURKİNA FASO NİDER ÇAT CAPE SENEGAL GAMBİYA GİNE BİSSAU GİNE SIERRA LEONE LİBERYA FİL DİŞİ SAHİLLERİ 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 Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 22 280 284 288 302 306 310 311 314 318 322 324 328 329 330 334 338 342 346 350 352 355 357 366 370 372 373 375 377 378 382 386 389 390 391 393 395 400 404 406 408 412 TOGO BENİN NİJERYA KAMERUN MERKEZİ AFRİKA CUMHURİYETİ EKVADOR GİNESİ SAOTOME PRA GABON KONGO ZAİRE RUANDA BURUNDİ ST. HELENA VE BAĞLANTILARI ANGOLA ETİYOPYA CİBUTİ SOMALİ KENYA UGANDA TANZANYA SEYŞEL ADALARI VE BAĞLANTILARI İNGİLİZ HİNT OK. TOPRAKLARI MOZAMBİK MADAGASKAR RUNION MAOURİTES KOMORO ADALARI MAYOTTE ZAMBİYA ZİMBAVVE MALAVİ NAMİBYA GÜNEY AFRİKA CUMHURİYETİ BOSTVANA SWEZILAND LESOTHO AMERİKA BİRLEŞİK DEVLETLERİ KANADA GRÖNLAND ST. PIERRE VE MIKUELON 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 PASAPORT NUMARASI ULUSLARARASI İŞLETMELER – UŞ KKTC VK YK YŞ VAKIFLAR – KKTC YEREL KURULUŞLAR – KKTC YABANCI ŞİRKETLER - KKTC Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 23 413 416 421 424 428 432 436 442 446 448 449 452 453 454 456 457 458 459 460 461 462 463 464 465 467 469 472 473 474 478 480 484 488 492 493 496 500 504 508 512 516 520 BERMUDA GUATEMALA BELİZE HONDURAS EL SALVADOR NİKARAGUA KOSTA RİKA PANAMA ANGUILA KÜBA ST. CRISTOPHER VE NEVİS HAİTİ BAHAMA TURKS VE CAİCOS ADASI DOMİNİK CUMHURİYETİ ABD VIRGIN ADALARI GUADELUP ANTIGUA VE BERMUDA DOMİNİKA İNGİLİZ VIRGIN ADALARI MARTİNİK CEYMAN ADALARI JAMAİKA ST. LUCİA ST. VİNGENT BARBADOS TRİNİDAD VE TABAGO GRENADA ARUBA HOLLANDA ANTİLLERİ KOLOMBİYA VENEZULLA GUYANA SURİNAM MONAKO FRANSIZ GUYANASI EKVADOR PERU BREZİLYA ŞİLİ BOLİVYA PARAGUAY Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 24 524 528 529 600 601 604 608 612 616 624 625 628 632 636 640 644 647 648 649 652 656 660 662 664 666 667 669 672 675 676 680 684 690 696 700 701 703 706 708 716 720 724 URUGUAY ARJANTİN FALKLAND ADALARI GÜNEY KIBRIS RUM KESİMİ KKTC LÜBNAN SURİYE IRAK İRAN İSRAİL GAZZE ÜRDÜN SUUDİ ARABİSTAN KUVEYT BAHREYN KATAR BİRLEŞİK ARAP EMİRLİKLERİ DUBAİ UMMAN KUZEY YEMEN GÜNEY YEMEN AFGANİSTAN PAKİSTAN HİNDİSTAN BANGLADEŞ MALDİV ADALARI SRİ LANKA NEPAL BHUTAN BURMA TAYLAND LAOS VIETNAM KAMBOÇYA ENDONEZYA MALEZYA BRUNEİ SINGAPUR FİLİPİNLER MOĞOLİSTAN ÇİN HALK CUMHURİYETİ KUZEY KORE DEMOKRATİK Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com 25 728 732 736 740 743 800 801 802 803 804 806 807 808 809 811 812 813 814 815 816 817 819 HALK CUM. GÜNEY KORE CUMHURİYETİ JAPONYA TAYVAN HONGKONG MAKAO AVUSTURALYA PAPUA YENİ GİNE AVUSTURALYA OKYANUSU NAURU YENİ ZELANDA SOLOMON ADALARI TUVALU AMERİKAN OKYANUSYASI YENİ KALEDONYA VE BAĞLANTILARI WALLACE VE TUNA ADALARI KİRİBATİ PİTCAİRN YENİ ZELANDA OKYANUSU FİJİ VANUATU TONGA BATI SAMAO Ülke Kodları Supernova Ticaret ve Yazılım Baykal Mahallesi, Bayraktar Yolu No:23/A Gazimağusa Kıbrıs E-Mail: [email protected] Web:www.supernova2.com
© Copyright 2024 Paperzz