WEB SERVİSİ ile ACENTE VE KULLANICI İŞLEMLERİ GİRİŞ... 2 a. Tanımlar... 2 b. Sınıflar ACENTE TANIM / GÜNCELLEME FONKSİYONLARI... 4 a.

Transkript

1 WEB SERVİSİ ile ACENTE VE KULLANICI İŞLEMLERİ GİRİŞ... 2 a. Tanımlar... 2 b. Sınıflar ACENTE TANIM / GÜNCELLEME FONKSİYONLARI... 4 a. Acente Tanımı Fonksiyonu... 4 b. Acente Güncelleme Fonksiyonu... 4 c. Kontroller (Acente Tanım Ve Güncelleme Fonksiyonları İçin)... 4 d. Acente Listesi Fonksiyonu KULLANICI TANIM / GÜNCELLEME FONKSİYONLARI... 6 a. Kullanıcı Tanımı Fonksiyonu... 6 b. Kullanıcı Güncelleme Fonksiyonu... 6 c. Kontroller (Kullanıcı Tanım Ve Güncelleme Fonksiyonları İçin)... 6 d. Kullanıcı Listesi EKLER... 8 a. Genel Kontrol Listesi... 8 b. Sigorta Şirket Kodları... 8 c. Acente Tür Kodları... 8 d. Acente ve Kullanıcılar İçin Durum Kodları... 9 e. İl ve İlçe Kodları

2 WEB SERVİSİ ile ACENTE VE KULLANICI İŞLEMLERİ 1. GİRİŞ Tarsim sisteminde acente ve kullanıcı tanım işlemleri yapılabilmesi amacıyla bir web servisi hazırlanmıştır. Bu web servisi ile yeni acente tanımı, mevcut acente bilgilerinin güncellenmesi, acente listesinin alınması; yeni kullanıcı tanımı, mevcut kullanıcı bilgilerinin güncellenmesi ve kullanıcı listesinin alınması işlemleri yapılabilmektedir. Web servisinin WSDL adresi aşağıda bulunmaktadır: Test Prod a. Tanımlar Web servis fonksiyonlarında kullanılan verilerin tipleriyle ilgili olarak bu dokümanda kullanılan kısaltmaların açıklamaları aşağıda bulunmaktadır: Char(X) Varchar(X) Number(X) Number(X)* Acente Sınıfı Kullanıcı Sınıfı List<Acente> List<Kullanıcı> MyException Açıklama Tam olarak X uzunluğunda alfa-numerik değer Maksimum X uzunluğunda alfa-numerik değer Maksimum X basamaklı sayısal değer. (Ondalık değeri yoktur, örnek :100000) Tam olarak X basamaklı sayısal değer.(ondalık değeri yoktur) Sınıflar isimli başlık altında açıklaması bulunmaktadır Sınıflar isimli başlık altında açıklaması bulunmaktadır Acente nesnelerinden oluşan dizi. Kullanıcı nesnelerinden oluşan dizi. Sınıflar ilgili başlık altında açıklaması bulunmaktadır b. Sınıflar ACENTE SINIFI Acente tanım / güncelleme fonksiyonları kapsamında web servisine gönderilecek olan / web servisinden geriye döndürülecek olan acente bilgilerini içeren sınıftır. Data Tipi Açıklama Şirket Kodu(*) Char(3) Sigorta şirketinin kodudur. (Şirket kodları listesi ekte bulunmaktadır) Acente Kodu(*) Varchar (10) Acente Adı Varchar (70) Kısa Adı Varchar (20) Acentenin kısa adıdır. Levha No Varchar (30) Acentenin levha kayıt numarasıdır. (Hazine tarafından üretim yapabilecek acentelere verilen numara) Acente Tür Kodu Char(1) Acente tür kodudur. (Acente tür kodlarının listesi ekler bölümünde bulunmaktadır) İl Kodu Number(2) (İl kodları, ekler bölümünde yer almaktadır) İlçe Kodu Number(2) (İlçe kodları, ekler bölümünde yer almaktadır) Adres Varchar (150) Telefon Number(10)* Örnek: Cep Telefonu Number(10)* Örnek: E-Posta Varchar(500) ; işareti ile ayrılarak birden fazla eposta bu alanda gönderilebilir 2

3 Web Adresi Varchar(50) Kapanış Tarihi Char(10) DD/MM/YYYY formatında gönderilmelidir.örnek: 13/01/2013 Durum Char(1) Acente aktif ise A, pasif ise P Acente Limit Tutarı Number(22) Acente için limit tanımı yoksa -1, varsa limit değeridir. (Acentenin yapabileceği üretim tutarıdır). Pasiflik Neden Number(3) Güncelleme veya kayıt için gönderilemez, sadece Tarsim tarafından belirlenir. 100 ise eğitimsizlik nedeniyle pasiftir. (*) Anahtar değer içerisinde yer alır. KULLANICI SINIFI Kullanıcı işlemleri kapsamında web servisine gönderilecek olan / web servisinden geriye döndürülecek olan kullanıcı bilgilerini içeren sınıftır. Data Tipi Açıklama Şirket Kodu* Char(3) Sigorta şirketinin kodudur. (Şirket kodları listesi ekte bulunmaktadır) Acente Kodu* Varchar (10) Kullanıcı Kodu* Varchar (12) Kullanıcının sisteme girişte kullanacağı kullanıcı kodudur. Kullanıcı Şifre Varchar (12) Kullanıcının sisteme girişte kullanacağı şifredir. Şifre belirlenirken uyulması gereken kurallar, kontroller bölümünde yer almaktadır. TC kimlik numarası Number(11)* Kullanıcının Türkiye Cumhuriyeti Kimlik Numarası dır. Adı Varchar (20) Güncelleme veya kayıt için gönderilemez. Kullanıcının adıdır. TC kimlik numarasına göre Tarsim tarafından TRAMER den sorgulanarak belirlenir. Soyadı Varchar (30) Güncelleme veya kayıt için gönderilemez. Kullanıcının soyadıdır. TC kimlik numarasına göre Tarsim tarafından TRAMER den sorgulanarak belirlenir. Kayıt No Varchar (30) Hazine tarafından üretim yapabilecek kullanıcılara verilen numaradır. Aktif Mi Char(1) Kullanıcı aktif ise A, pasif ise P Pasiflik Neden Number(3) Güncelleme veya kayıt için gönderilemez, sadece Tarsim tarafından belirlenir. 100 ise eğitimsizlik nedeniyle pasiftir. Geçerlilik Tarihi Char(10) Kullanıcı kodunun hangi tarihe kadar geçerli olacağı bilgisidir. DD/MM/YYYY formatında gönderilmelidir.örnek: 13/01/2013 Telefon Number(10)* Örnek: Cep Telefonu Number(10)* Örnek: E-Posta Varchar(100) ; işareti ile ayrılarak birden fazla eposta bu alanda gönderilebilir (*) Anahtar değer içerisinde yer alır. MYEXCEPTION SINIFI İşlemler sırasında kural dışı bir durum ortaya çıkarsa veya hatalı işlem yapılırsa web servisi tarafından fırlatılacak olan exception sınıfıdır. Web servisinden bir hata fırlatıldığında hata ile ilgili açıklama/açıklamalar, web servisinden dönen mesaj içerisindeki faultstring alanında bulunacaktır. Sistem tarafından kontrollü olarak fırlatılan hataların listesi dokümanın ilerleyen bölümlerinde belirtilmiştir. 3

4 2. ACENTE TANIM / GÜNCELLEME FONKSİYONLARI a. Acente Tanımı Fonksiyonu ACENTE TANIMI Yeni acente tanımı için kullanılan fonksiyondur. İşlem yapan kullanıcı bilgileri ve kaydı yapılacak olan acente bilgileri web servisine gönderilir. Tanımlanan acentenin bilgileri web servisinden geriye dönerse işlem başarılı olarak tamamlanmış anlamına gelir. Eğer web servisi tarafından hata fırlatılmışsa hata mesajında hatanın nedeni görülebilir. Acente Acente Sınıfı Kaydı yapılacak olan acentenin bilgileridir. Acente Acente Sınıfı İşlem başarılı bir şekilde sonuçlanırsa, kaydı yapılan acentenin bilgileri geriye döndürülür. b. Acente Güncelleme Fonksiyonu ACENTE GÜNCELLEME Var olan bir acentenin bilgilerinin güncellenmesi için kullanılan fonksiyondur. İşlem yapan kullanıcı bilgileri ve güncellemesi yapılacak olan acente bilgileri web servisine gönderilir, güncellenen acentenin bilgileri web servisinden geriye dönerse işlem başarılı olarak tamamlanmış anlamına gelir. Eğer web servisi tarafından hata fırlatılmışsa hata mesajında hatanın nedeni görülebilir. Acente Acente Sınıfı Güncellemesi yapılacak olan acentenin yeni bilgileridir. Acente Acente Sınıfı İşlem başarılı bir şekilde sonuçlanırsa, güncellemesi yapılan acentenin bilgileri geriye döndürülür. 4 c. Kontroller (Acente Tanım Ve Güncelleme Fonksiyonları İçin) ORTAK KONTROLLER (Kayıt ve Güncelleme Fonksiyonu İçin Ortak Kontroller) Şirket Kodu zorunludur Şirket Kodu ekli listede bulunan şirket kodlarından birisi olmalıdır Sigorta şirketi kullanıcıları sadece kendi şirketleri adına acente tanımı yapabilir Acente Kodu zorunludur Acente Adı zorunludur Kısa adı zorunludur Levha No zorunludur Acente Türü zorunludur Acente Türü ekte yer alan değerlerden birisi olmalıdır. İl Kodu zorunludur. İl Kodu, ekte yer alan il kodlarından birisi olabilir.

5 İlçe Kodu zorunludur. İlçe Kodu, ekli listede yer alan ve seçilen ile bağlı olan ilçe kodlarından birisi olabilir Adres zorunludur Telefon numarası zorunludur. Örnek: Telefon numarası 10 karakter uzunluğunda, başında 0 olmamalıdır. Alan kodu başta olmalıdır. E-Posta adresi zorunludur E-Posta adresi düzgün olmalıdır: Eposta adresi içerisinde boşluk olmamalıdır. Birden fazla eposta ; ile ayrılabilir; her bir Eposta adresinde bir işareti işaretinin solunda ve sağında kelime olmalıdır, sağ parçada en az 1 adet. karakteri olmalıdır. Türkçe ye has olan karakterler kullanılamaz(ı,i,ğ,ğ,ü,ü,ş,ş,ç,ç,ö,ö) Limit değeri boş olamaz, limit tanımlanmayacak acenteler için değer -1 gönderilmelidir. Durum Kodu zorunludur Durum Kodu ekte yer alan durum kodlarından birisi olabilir. SADECE KAYIT SIRASINDA YAPILAN KONTROLLER Girilen acente kodunun, ilgili şirket kodu için sistemde kaydı varsa, işleme izin verilmez. SADECE GÜNCELLEME SIRASINDA YAPILAN KONTROLLER Acente mevcut durumu pasifse ve yeni durumu aktif ise (acente aktifleştiriliyorsa) ve, acentenin mevcut pasiflik nedeni Eğitimsizlik Nedeniyle Pasif ise, ve acente türü Standart Acente ise ve, acentenin en az bir aktif aktif kullanıcısı yoksa işleme izin verilmez. Hata mesajı : Aktifleştirdiğiniz acentenin, eğitim almış ve aktif olan kullanıcısı yoktur. Ek bilgi: Acente pasif hale getiriliyorsa, acenteye bağlı olan tüm kullanıcılar pasif hale getirilir. (Pasiflik nedeni: Acente pasif durumda ) d. Acente Listesi Fonksiyonu ACENTE LİSTESİ Şirkete ait olan tüm acentelerin listesinin alınabilmesi amacıyla kullanılır. İşlem yapan kullanıcı bilgileri ve acente listesi alınacak olan şirketin kodu web servisine gönderilir. (Sigorta şirketi kullanıcıları için işlem yapan kullanıcının şirketi ile, listesi alınacak şirketin kodu aynı olmalıdır). Web servisinden geriye acente listesi dönerse işlem başarılı olarak tamamlanmış anlamına gelir. Eğer web servisi tarafından hata fırlatılmışsa hata mesajında hatanın nedeni görülebilir. Şirket Kodu Char(3) Acente listesi alınacak olan şirket kodudur. Acente Listesi List<Acente> İşlem başarılı bir şekilde sonuçlanırsa, kullanıcı şirketine bağlı tüm acentelerin listesi sonuç olarak geriye döndürülür. 5

6 3. KULLANICI TANIM / GÜNCELLEME FONKSİYONLARI a. Kullanıcı Tanımı Fonksiyonu KULLANICI TANIMI Yeni bir kullanıcı tanımı yapılması amacıyla kullanılır. İşlem yapan kullanıcı bilgileri ve kaydı yapılacak olan kullanıcının bilgileri web servisine gönderilir. Tanımlanan kullanıcının bilgileri web servisinden geriye dönerse işlem başarılı olarak tamamlanmış anlamına gelir. Eğer web servisi tarafından hata fırlatılmışsa hata mesajında hatanın nedeni görülebilir. Kullanıcı Kullanıcı Sınıfı Kaydı yapılacak olan kullanıcı bilgileridir. Kullanıcı Kullanıcı Sınıfı İşlem başarılı bir şekilde sonuçlanırsa, kaydı yapılan kullanıcının bilgileri geriye döndürülür. b. Kullanıcı Güncelleme Fonksiyonu KULLANICI GÜNCELLEME Var olan bir kullanıcının bilgilerinin güncellenmesi amacıyla kullanılır. İşlem yapan kullanıcı bilgileri ve güncellemesi yapılacak olan kullanıcının en güncel bilgileri gönderilir. Eğer güncellenecek kullanıcının şifresi değiştirilmek istenmiyorsa, güncellenecek kullanıcı için şifre boş olarak gönderilebilir. Güncellenen kullanıcının bilgileri web servisinden geriye dönerse işlem başarılı olarak tamamlanmış anlamına gelir. Eğer web servisi tarafından hata fırlatılmışsa hata mesajında hatanın nedeni bulunmaktadır. Kullanıcı Kullanıcı Sınıfı Güncellemesi yapılacak olan kullanıcının yeni bilgileridir. Kullanıcı Kullanıcı Sınıfı İşlem başarılı bir şekilde sonuçlanırsa, güncellemesi yapılan kullanıcının bilgileri geriye döndürülür. 6 c. Kontroller (Kullanıcı Tanım Ve Güncelleme Fonksiyonları İçin) ORTAK KONTROLLER (Kayıt ve Güncelleme) Şirket Kodu zorunludur Şirket Kodu ekli listede bulunan şirket kodlarından birisi olmalıdır Sigorta şirketi kullanıcıları sadece kendi şirketleri adına acente tanımı yapabilir Acente Kodu zorunludur Kullanıcı Kodu zorunludur Kullanıcı Şifre zorunludur. Şifre en az 6, en çok 12 karakter olabilir.

7 Şifre noktalama işareti içermemelidir. Şifre en az 1 alfabetik karakter içermelidir Şifre en az 1 numerik karakter içermelidir Aktif Mi bilgisi zorunludur Aktif Mi bilgisi, ekte yer alan aktiflik kodlarından birisi olabilir. TC Kimlik No zorunludur Geçerlilik Tarihi Zorunludur Telefon numarası zorunludur. Örnek: Telefon numarası 10 karakter uzunluğunda, başında 0 olmamalıdır. Alan kodu başta olmalıdır. Cep telefonu numarası zorunludur. Örnek: Cep telefonu numarası 10 karakter uzunluğunda, başında 0 olmamalıdır. Operatör kodu başta olmalıdır. Eposta zorunludur E-Posta adresi düzgün olmalıdır: Eposta adresi içerisinde boşluk olmamalıdır. Birden fazla eposta ; ile ayrılabilir; her bir Eposta adresinde bir işareti işaretinin solunda ve sağında kelime olmalıdır, sağ parçada en az 1 adet. karakteri olmalıdır. Türkçe ye has olan karakterler kullanılamaz(ı,i,ğ,ğ,ü,ü,ş,ş,ç,ç,ö,ö) SADECE KAYIT İŞLEMİ SIRASINDA YAPILAN KONTROLLER Aynı şirket içerisinde, kullanıcının TC Kimlik numarasına sahip olan aktif veya eğitimsizlik nedeniyle pasif başka bir kullanıcı olamaz. (Hata mesajı içerisinde hangi acente hangi kullanıcı kodlarının aktif, ya da eğitimsizlik nedeniyle pasif olduğu yer alır) Kullanıcı kodu, şirket ve acente bazında tekil olmalıdır. (Aynı kullanıcı kodu aynı şirket ve acente içerisinde iki kez kullanılamaz) Pasif acenteye kullanıcı eklenemez. (Pasiflik nedeni Eğitimsizlik Nedeniyle ise eklenebilir.) SADECE GÜNCELLEME İŞLEMİ SIRASINDA YAPILAN KONTROLLER Kullanıcı aktifleştiriliyorsa veya kullanıcının mernis numarası değiştiriliyorsa şu kontrol tekrar yapılır: (Aynı şirket içerisinde, kullanıcının TC Kimlik numarasına sahip olan aktif veya eğitimsizlik nedeniyle pasif başka bir kullanıcı olamaz ) Kullanıcı aktifleştiriliyorsa ve kullanıcının mevcut durumu eğitimsizlik nedeniyle pasif ise, ve kullanıcının acentesinin turu Standart Acente ise, ve TC kimlik numarasına ait olan eğitim kaydı yoksa işleme izin verilmez. Aktifleştirdiğiniz kullanıcının T.C. Kimlik Numarasına Ait Bir Eğitim Kaydı Bulunamadı. d. Kullanıcı Listesi KULLANICI LİSTESİ Şirkete ait olan tüm kullanıcıların listesinin alınabilmesi amacıyla kullanılır. İşlem yapan kullanıcı bilgileri ve kullanıcı listesi alınacak olan şirketin ve acentenin kodu gönderilir. (Sigorta şirketleri kullanıcıları için işlem yapan kullanıcının şirketi ile, listesi alınacak acentenin şirketinin kodu aynı olmalıdır). Web servisinden geriye kullanıcı listesi dönerse işlem başarılı olarak tamamlanmış anlamına gelir. Eğer web servisi tarafından hata fırlatılmışsa hata mesajında hatanın nedeni bulunmaktadır Şirket Kodu Varchar (3) Kullanıcı listesi alınacak olan şirketin kodudur Acente Kodu Varchar (12) Kullanıcı listesi alınacak olan acentenin kodudur. İşlem Şirket Kod Varchar(3) İşlemi yapan kişinin sigorta şirket kodudur. Kullanıcı Listesi List<Kullanıcı> İşlem başarılı bir şekilde sonuçlanırsa, kullanıcı şirketine bağlı tüm kullanıcıların listesi sonuç olarak geriye döndürülür. 7

8 4. EKLER a. Genel Kontrol Listesi GENEL KONTROLLER (Tüm fonksiyonlar için) Web servisindeki tüm fonksiyonlar için ortak olan kontrollerin listesidir. Fonksiyon bazında yapılan kontroller ilgili bölümlerde belirtilmiştir. Kontroller İşlem yapan şirket kodu, işlem yapan acente kodu, işlem yapan kullanıcı kodu, işlem yapan şifre boş olamaz. İşlem yapmaya yetkiniz yok.(kullanıcının ilgili işlemi yapmaya yetkisi yok) İzinsiz ip numarası. (Tarsime bildirilen ip numaraları dışında bir ip den işlem yapılmaya çalışılıyor, doğru ip numaralı bilgisayardan işlem yapılmalı ya da ip numarası Tarsim e ıslak imzalı olarak iletilmelidir) Tanımlanamayan hata oluştu. (Tarsim ile irtibata geçilmelidir.) b. Sigorta Şirket Kodları Şirket Kodu Şirket Adı 002 EUREKO SİGORTA A.Ş. 004 AK SİGORTA A.Ş. 007 ANADOLU SİGORTA T.A.Ş. 009 ANKARA SİGORTA T.A.Ş. 011 GROUPAMA SİGORTA A.Ş. 015 HALK SİGORTA A.Ş. 017 AVİVA SİGORTA A.Ş. 018 ZURICH SİGORTA A.Ş. 025 GENERALI SİGORTA A.Ş. 026 GÜNEŞ SiGORTA A.Ş. 028 GROUPAMA SİGORTA A.Ş. 029 YAPI KREDİ SİGORTA A.Ş. 031 HÜR SİGORTA A.Ş. 035 ERGO SİGORTA A.Ş. 040 AXA SİGORTA A.Ş. 042 RAY SİGORTA A.Ş. 045 ALLIANZ SİGORTA A.Ş. 047 LIBERTY SİGORTA A.Ş. 049 SBN SİGORTA A.Ş. 050 MAPFRE GENEL SİGORTA A.Ş. 054 HDI SİGORTA A.Ş. 057 IŞIK SİGORTA A.Ş. 061 SOMPO JAPAN SİGORTA A.Ş. 092 ZİRAAT SİGORTA A.Ş. 096 KORU SİGORTA c. Acente Tür Kodları Kod Açıklama A STANDART ACENTE S SİGORTA ŞİRKETİ(MERKEZ) B BANKA R BROKER F FİSKOBİRLİK C TRAKYA BİRLİK T TARIM KREDİ KOOPERATİFİ I TARİŞ Z ZİRAAT ODASI 8

9 A P d. Acente ve Kullanıcılar İçin Durum Kodları AKTİF PASİF e. İl ve İlçe Kodları İl ve ilçe kodları, şu anda uygulamada olan parametre web servisleri ile alınabilir. 9