DASK Web Servisi - Türk Nippon Sigortagalaksi.turknippon.com/appservice/docs/dask.pdfDASK Web...

Nisan 2013

Türk Nippon Sigorta Pazarlama Departmanı

Mahir İz Cd. 24, Altunizade 34662, Üsküdar / İstanbul 0216 554 11 00 / [email protected]

DASK Web Servisi Sürüm 2.0

Uygulama Servisleri Teknik Dökümanlar

Emir TÜZÜL

Nisan 2013



Doküman Tarihçesi

DOKÜMAN YERİ Bu servisin güncel hali ile ilgili dökümana her zaman aşağıda belirtilen adresten ulaşılabilir.

Ayrıca kritik değişiklikler yapılması durumunda ilgili kullanıcılara doküman ve değişiklik ile ilgili bilgi

verilir.

Güncel Doküman Adresi : http://galaksi.turknippon.com/appservice/docs/dask.pdf

GÜNCELLEME TARİHÇESİ Son Güncelleme Tarihi : 27.03.2015

No Tarih Kısa Açıklama Önem

#1 10.04.2013 Doküman hazırlandı. Normal

#2 01.11.2013 Tapu bilgileri için TitleDeed parametresi eklendi. Normal

#3 04.11.2013 DASK’dan alınan uyarı mesajları için DASKWarning parametresi eklendi.

Normal

#4 17.01.2014 Tapu bağımsız bölüm numarası için “TitleDeedModel” altına “BB” parametresi eklenmiştir.

Normal

#5 27.03.2015 Sigorta ettiren için telefon alanları eklendi. Cep telefonu zorunlu hale getirildi.

Yüksek

http://galaksi.turknippon.com/appservice/docs/dask.pdf

Nisan 2013



İçindekiler Doküman Tarihçesi .................................................................................................................................. 2

1. DASK Servisi ................................................................................................................................. 5

1.1. Dokümanın Amacı ...................................................................................................................... 5

1.2. Servis Adresi ............................................................................................................................... 5

2. Web Servis İstek ve Yanıtlarında Kullanılan Elementler .................................................... 6

2.1. AuthHeader ................................................................................................................................ 6

2.2. DASKInput .................................................................................................................................. 6

InsurerType: .................................................................................................................... 7

UsageType: ...................................................................................................................... 7

BuildType: .................................................................................................................................. 7

BuildYear: ................................................................................................................................... 8

TotalFloor: .................................................................................................................................. 8

AnteriorDamage: ....................................................................................................................... 8

LossPayeeType: .......................................................................................................................... 8

2.3. CreditCardInput .......................................................................................................................... 9

CardType: ................................................................................................................................... 9

Installment: ................................................................................................................................ 9

2.4. TitleDeedModel .......................................................................................................................... 9

2.5. DASKOutput ............................................................................................................................. 10

2.6. JetSatisAddressModel .............................................................................................................. 10

2.7. ListOutput ................................................................................................................................. 11

3. DASK Servisi Fonksiyonları ..................................................................................................... 12

3.1. GetBankList ................................................................................................................................ 13

3.2. GetBankBranchList .................................................................................................................... 13

3.3. GetFinancierList ......................................................................................................................... 13

3.4. GetAddressDetail ....................................................................................................................... 13

3.5. GetCityList .................................................................................................................................. 14

3.6. GetTownList ............................................................................................................................... 14

3.7. GetMunicipalityList .................................................................................................................... 14

3.8. GetQuarterList ........................................................................................................................... 14

3.9. GetStreetList .............................................................................................................................. 15

3.10. GetBuildingList ......................................................................................................................... 15

Nisan 2013



3.11. GetSectionList .......................................................................................................................... 15

3.12. Compute ................................................................................................................................... 16

DASKInput: ............................................................................................................................................ 16

3.13. Proposal ................................................................................................................................... 19

DASKInput: ............................................................................................................................... 19

DASKOutput: ............................................................................................................................ 21

3.14. Approve .................................................................................................................................... 22

DASKInput: ............................................................................................................................... 22

DASKOutput: ............................................................................................................................ 23

3.15. ApproveNoEmu ........................................................................................................................ 24

DASKInput: ............................................................................................................................... 24

DASKOutput: ............................................................................................................................ 24

3.16. Print .......................................................................................................................................... 25

DASKInput: ............................................................................................................................... 25

DASKOutput: ............................................................................................................................ 25

4. Oluşabilecek Hatalar ................................................................................................................. 26

Nisan 2013



1. DASK Servisi

1.1. Dokümanın Amacı

Doküman DASK poliçe işlemlerinin yapılması için hazırlanan webservis fonksiyonlarının tanıtımı

ve nasıl kullanıldıklarının açıklanması amacıyla hazırlanmıştır.

1.2. Servis Adresi Web servisi ile ilgili adresler aşağıda yer almaktadır. Hazırlanacak istemci uygulamalarının

endpoint adresinin aşağıdaki End Point adresinde yazılı olan adres olarak ayarlandığına dikkat ediniz.

End Point : https://galaksi.turknippon.com/appservice/dask-v2.asmx WSDL : https://galaksi.turknippon.com/appservice/dask-v2.asmx?wsdl Disco : https://galaksi.turknippon.com/appservice/dask-v2.asmx?disco DİKKAT! Web servis adresleri https protokülü üzerinden çağırılmalıdır aksi durumda servis fonksiyonlarını

kullanamazsınız.

Nisan 2013



2. Web Servis İstek ve Yanıtlarında Kullanılan Elementler

2.1. AuthHeader

DASKInput tipi dışında giriş parametresi alan fonksiyonlarda kullanıcı doğrulaması yapmak için SOAP Header olarak kullanılır.

Field Type Description

Channel string Partaj

Username string Kullanıcı adı

Password string Parola

2.2. DASKInput

Compute, Proposal, Approve, Print fonksiyonlarında giriş parametresi olarak kullanılır. Yapılan

işleme göre zorunlu alanlar değişiklik gösterebilir.


Channel int Partaj

Username string Kullanıcı adı

TrackingCode string İşlem takip kodu

CitizenshipNumber string Sigortalı kimlik numarası

TaxNumber string Sigortalı vergi numarası

UnitNo long Sigortalı müşteri numarası

PolicyNo long Teklif/Poliçe numarası

UseCreditCard boolean Kredi kartı kullanılacak mı?

CreditCard CreditCardInput Kredi kartı bilgileri

ClientNo long Sigorta ettiren müşteri numarası

ClientCitizenshipNumber string Sigorta ettiren kimlik numarası

ClientTaxNumber string Sigorta ettiren vergi numarası

IsRenewal boolean Yenileme mi?

BeginDate dateTime Vade başlangıç tarihi

DASKPolicyNo long DASK poliçe numarası

InsurerType int Sigorta ettiren tipi

MobilePhoneNumber string Sigortalı cep telefonu

PhoneNumber string Sigortalı sabit telefonu

ClientMobilePhoneNumber string Sigorta ettiren cep telefonu

ClientPhoneNumber string Sigorta ettiren sabit telefonu

RiskAddressCode string Riziko UAVT adres kodu

TitleDeed TitleDeedModel Riziko adresi tapu bilgileri

Nisan 2013



GrossAreaM2 int Daire brüt yüzölçümü

UsageType int Daire kulllanım tipi

BuildType int Bina inşa tarzı

BuildYear int Bina inşa yılı

TotalFloor int Binadaki toplam kat sayısı

AnteriorDamage int Daha önceki hasar durumu

LossPayeeType string Daini mürtehin durumu

Bank string Daini mürtehin banka

BankBranch string Daini mürtehin banka şubesi

FinancialInstitution string Daini mürtehin finans kurumu

DASKInput parametresine ait bazı alanların alabileceği sabit değerler ve karşılıkları aşağıda listelenmiştir.

InsurerType:

Key Value

0 Sigorta Ettiren Yok

1 Mal Sahibi

2 Kiracı

3 İntifa Hakkı Sahibi

4 Yönetici

5 Akraba

6 Dain-i Mürtehin

7 Diğer

UsageType:

Key Value

1 Mesken

2 Büro

3 Ticarethane

4 Diğer

BuildType:

Key Value

1 Çelik, Betonarme, Karkas

2 Yığma Kâgir

3 Diğer

Nisan 2013



BuildYear:

Key Value

1 1975 ve Öncesi

2 1976-1996

3 1997-1999

4 2000-2006

5 2007 ve Sonrası

TotalFloor:

Key Value

1 1-4 Kat Arası

2 5-7 Kat Arası

3 8-19 Kat Arası

4 20 Kat ve Üstü

AnteriorDamage:

Key Value

0 Hasarsız

1 Az Hasarlı

2 Orta Hasarlı

LossPayeeType:

Key Value

Y Yok

B Banka

F Finans Kurumu

Nisan 2013



2.3. CreditCardInput

Approve fonksiyonunda prim ödemesi kredi kartı ile gerçekleştirilecek ise kart bilgilerini göndermek için kullanılır.


CardType int Kart tipi

CardNumber string Kart numarası

Month string Son kullanım ay (mm)

Year string Son kullanım yıl (yyyy)

CVV string Güvenlik numarası

Installment int Taksit sayısı

CardHolderFirstname string Kart sahibi adı

CardHolderLastname string Kart sahibi soyadı

CardType:

Key Value

1 Visa

2 Master Card

Installment:

Key Value

1 Tek Çekim

2 2 Taksit

3 3 Taksit

2.4. TitleDeedModel

Proposal, Approve fonksiyonlarında tapu bilgilerini (Bağımsız Bölüm Numarası, Ada, Pafta, Parsel, Sayfa No) bildirmek için kullanılır. Gönderilmediği taktirde UAVT’den gelen veriler kullanılmaktadır.


BB string Bağımsız bölüm numarası

AD string Ada

PF string Pafta

PR string Parsel

SY string Sayfa no

Nisan 2013



2.5. DASKOutput

Compute, Proposal, Approve, Print fonksiyonlarında dönüş parametresi olarak kullanılır. Yapılan işleme göre geri döndürülen alanlar değişiklik gösterebilir.


IsSuccess boolean İşlem başarılı mı?

StatusCode string Sonuç kodu

StatusDescription string Sonuç açıklaması

TrackingCode string İşlem takip kodu


UnitName string Sigortalı adı

Premium decimal Prim


EndDate dateTime Vade bitiş tarihi

PolicyNo long Teklif/Poliçe numarası

PrintDownloadUrl string Teklif/Poliçe basım adresi

ClientNo long Sigorta ettiren müşteri no

DASKInsuranceAmount decimal DASK sigorta bedeli

Input DASKInput Fonksiyon giriş parametreleri

InvalidatedRiskAddress JetSatisAddressModel UAVT uyumsuz riziko adres bilgileri

DASKWarning string DASK’dan gönderilen, poliçe

oluşturmaya doğrudan engel olmayan

fakat kontrol edilmesi gereken uyarı

mesajları bulunur

2.6. JetSatisAddressModel

Detaylı adres bilgilerinin tutulduğu veri tipidir. Kullanılabilecek alanlar aşağıdaki tabloda listelenmiştir.


IL_CODE int İl kodu

IL string İl adı

IC_CODE int İlçe kodu

IC string İlçe adı

BE_CODE long Belde/Köy kodu

BE string Belde/Köy adı

MH_CODE int Mahalle kodu

MH string Mahalle adı

Nisan 2013



CS_CODE int Cadde/Sokak kodu

CD string Cadde adı

SK string Sokak adı

ST string Site adı

AP string Apartman adı

BN_CODE long Bina kodu

BN string Bina no

DR string Daire no

KT string Kat

PK string Posta kodu

BB string Bağımsız bölüm numarası

AD string Ada

PF string Pafta

PR string Parsel

SY string Sayfa no

AK string UAVT adres kodu

2.7. ListOutput

Key/Value ikilisi şeklinde liste dönen fonksiyonlarda dönüş veri tipi olarak kullanılır.


Code string Anahtar

Description string Görünen değer

Nisan 2013



3. DASK Servisi Fonksiyonları

Serviste bulunan fonksiyonlar ve açıklamaları aşağıdaki tabloda yer almaktadır.

Name Description

GetBankList Banka listesi

GetBankBranchList Banka şubeleri listesi

GetFinancierList Finans kuruluşları listesi

GetAddressDetail UAVT adres kodundan detay sorgulama

GetCityList İl listesi

GetTownList İle bağlı ilçe listesi

GetMunicipalityList İlçeye bağlı belde/köy listesi

GetQuarterList Belde/köy ile bağlı mahalle listesi

GetStreetList Mahalleye bağlı cadde/sokak listesi

GetBuildingList Cadde/sokak ile bağlı bina listesi

GetSectionList Binaya bağlı bağımsız bölüm listesi

Compute Prim hesaplama

Proposal Teklif kayıt

Approve Teklif poliçeleştirme (Yavaş olduğundan kullanılmamalıdır.

ApproveNoEmu metodu bunun yerini almıştır.)

ApproveNoEmu Teklif poliçeleştirme

Print Poliçe basımı

Nisan 2013



3.1. GetBankList

Daini mürtehin bilgisi için kullanılabilecek bankaları listeler.

Returns

Name Type Description

GetBankListResult ArrayOf<ListOutput>

3.2. GetBankBranchList

Daini mürtehin bilgisi için kullanılabilecek banka şubelerini listeler.

Parameters

Name Type Direction Description

BankCode string Input Banka kodu

Returns


GetBankBranchListResult ArrayOf<ListOutput>

3.3. GetFinancierList

Daini mürtehin bilgisi için kullanılabilecek finans kuruluşlarını listeler.

Returns


GetFinancierListResult ArrayOf<ListOutput>

3.4. GetAddressDetail

UAVT adres kodunu sorgulayarak detaylı adres bilgilerini verir. Sorgulama sonucunda kayıt bulunamaz ise null değer döner.

Parameters


addresscode long Input UAVT adres kodu

Returns


GetAddressDetailResult JetSatisAddressModel

Nisan 2013



3.5. GetCityList

Riziko adresi için kullanılabilen illeri listeler.

Returns


GetCityListResult ArrayOf<ListOutput>

3.6. GetTownList

Riziko adresi için kullanılabilen ile bağlı ilçeleri listeler.

Parameters


citycode int Input İl kodu

Returns


GetTownListResult ArrayOf<ListOutput>

3.7. GetMunicipalityList

Riziko adresi için kullanılabilen ilçeye bağlı belde/köy kayıtlarını listeler. Parameters


towncode int Input İlçe kodu

Returns


GetMunicipalityListResult ArrayOf<ListOutput>

3.8. GetQuarterList

Riziko adresi için kullanılabilen belde/köy ile bağlantılı mahalleleri listeler.

Parameters


muncode int Input Belde/köy kodu

Returns


GetQuarterListResult ArrayOf<ListOutput>

Nisan 2013



3.9. GetStreetList

Riziko adresi için kullanılabilen mahalle ile bağlantılı cadde/sokak kayıtlarını listeler.

Parameters


quartercode int Input Mahalle kodu

Returns


GetStreetListResult ArrayOf<ListOutput>

3.10. GetBuildingList

Riziko adresi için kullanılabilen cadde/sokak ile bağlantılı binaları listeler.

Parameters


streetcode int Input Cadde/sokak kodu

Returns


GetBuildingListResult ArrayOf<ListOutput>

3.11. GetSectionList

Riziko adresi için kullanılabilen bina ile bağlantılı bağımsız bölümleri listeler. Bu seviyede her bir bağımsız bölüm kodu UAVT Adres Kodu’na karşılık gelir.

Parameters


buildingcode long Input Bina kodu

Returns


GetSectionListResult ArrayOf<ListOutput>

Nisan 2013



3.12. Compute

Yenileme ve yeni iş için DASK primi hesaplayan servis fonksiyonudur. Riziko adresinin UAVT uyumlu olarak adres kodu ile belirtilmesi zorunludur. Bunun için sırasıyla GetCityList, GetTownList, GetMunicipalityList, GetQuarterList, GetStreetList, GetBuildingList, GetSectionList fonksiyonları kullanılarak adres koduna ulaşılabilir. Yenileme yapılacak poliçenin riziko adresi UAVT sistemine uyumsuz ise dönüş parametresinde StatusCode değişkeni status-riskaddress-error değerini alır. Bu durumda giriş parametresinde RiskAddressCode değişkenine adres kodu atanarak işlem yeniden denenir. Aşağıda bu servis fonksiyonunu ilgilendiren giriş parametreleri yer almaktadır. Listenin dışındaki diğer parametreler değerlendirmeye alınmayacak olup varsayılan olarak boş veya veri tipine uygun varsayılan değerler gönderilebilir.

Parameters


Input DASKInput Input Zorunlu

DASKInput:


Channel int Zorunlu

Username string Zorunlu

CitizenshipNumber string Yenilemede kullanılmaz. Yeni işlerde

UnitNo yok ise CitizenshipNumber veya

TaxNumber zorunlu.

TaxNumber string Yenilemede kullanılmaz. Yeni işlerde

UnitNo yok ise CitizenshipNumber veya

TaxNumber zorunlu.

UnitNo long Yenilemede kullanılmaz. Yeni işlerde

CitizenshipNumber veya TaxNumber

yok ise zorunlu.

ClientNo long Yenilemede kullanılmaz. Yeni işlerde

ClientCitizenshipNumber veya

ClientTaxNumber yok ise zorunlu.

ClientCitizenshipNumber string Yenilemede kullanılmaz. Yeni işlerde

ClientNo yok ise


ClientTaxNumber zorunlu.

ClientTaxNumber string Yenilemede kullanılmaz. Yeni işlerde

ClientNo yok ise



IsRenewal boolean Zorunlu

Nisan 2013



BeginDate dateTime Yenilemede kullanılmaz. Yeni işlerde

zorunlu

DASKPolicyNo long Yenilemede zorunlu. Yeni işlerde

kullanılmaz.

InsurerType int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

MobilePhoneNumber string Yeni işlerde zorunlu. Yenilemede

önceki poliçe üzerindeki geçersiz ise

gereklidir.

PhoneNumber string Yeni işlerde opsiyonel. Yenilemede


gereklidir.

ClientMobilePhoneNumber string Yeni işlerde zorunlu. Yenilemede


gereklidir.

ClientPhoneNumber string Yeni işlerde opsiyonel. Yenilemede


gereklidir.

RiskAddressCode string Yeni işlerde ve geçerli bir UAVT adres

kodu olmayan poliçe yenilemelerinde

zorunlu

GrossAreaM2 int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

UsageType int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

BuildType int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

BuildYear int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

TotalFloor int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

AnteriorDamage int Yenilemede kullanılmaz. Yeni işlerde

zorunlu

LossPayeeType string Yenilemede kullanılmaz. Yeni işlerde

zorunlu

Bank string LossPayeeType=B ise zorunlu

BankBranch string LossPayeeType=B ise zorunlu

FinancialInstitution string LossPayeeType=F ise zorunlu

Returns


ComputeResult DASKOutput

Nisan 2013



DASKOutput:


IsSuccess Boolean İşlem başarılı ise true değerini alır

StatusCode String Hata olması halinde hata kısa kodu

bulunur.

StatusDescription String Hata olması halinde açıklaması yer

alır.

TrackingCode String Teklif kayıt, teklif onaylama ve poliçe

basım işlemleri yapılacak ise

saklanmalıdır.

UnitNo Long Teklif kayıt, teklif onaylama işlemleri

yapılacak ise saklanmalıdır.

UnitName String Sigortalının adı

Premium Decimal Hesaplanan prim tutarı



ClientNo long Teklif kayıt, teklif onaylama işlemleri

yapılacak ise saklanmalıdır.


Input DASKInput Yeni işlerde fonksiyona gönderilen

giriş parametresi korunur.

Yenilemelerde ise yenilenecek

poliçeye ait tüm bilgiler okunabilir.

InvalidatedRiskAddress JetSatisAddressModel Yeni işlerde kullanılmaz. Yenileme

yapılan poliçede adres UAVT uyumlu

değil ise hatalı adres bilgisi yer alır.

DASKWarning string DASK’dan gelen uyarı mesajları

kullanıcıya gösterilerek devam

edilmesi tercihe bırakılmalıdır.

Nisan 2013



3.13. Proposal

Yenileme ve yeni iş için DASK teklifi oluşturan servis fonksiyonudur. Poliçenin oluşturulabilmesi için öncelikle teklif oluşturulmalıdır. DASK tarafından mobil telefon numarası poliçe üretimi için zorunlu tutulduğundan MobilePhoneNumber değeri önemlidir. Gönderilen telefon numarası ile müşteri kartndaki bilgiler güncellenmektedir. Aşağıda bu servis fonksiyonunu ilgilendiren giriş parametreleri yer almaktadır. Listenin dışındaki diğer parametreler değerlendirmeye alınmayacak olup varsayılan olarak boş veya veri tipine uygun varsayılan değerler gönderilebilir.

Parameters



DASKInput:


Channel int Zorunlu


TrackingCode string Opsiyonel. Gönderilmez ise yenisi

oluşturulur.

PolicyNo long Opsiyonel. Gönderilir ise mevcut

teklifin üzerine yazılır.

CitizenshipNumber string Yenilemede kullanılmaz. Yeni işlerde

UnitNo yok ise CitizenshipNumber

veya TaxNumber zorunlu.

TaxNumber string Yenilemede kullanılmaz. Yeni işlerde

UnitNo yok ise CitizenshipNumber

veya TaxNumber zorunlu.

UnitNo long Yenilemede kullanılmaz. Yeni işlerde

CitizenshipNumber veya TaxNumber

yok ise zorunlu.

ClientNo long Yenilemede kullanılmaz. Yeni işlerde


ClientTaxNumber yok ise zorunlu.

ClientCitizenshipNumber string Yenilemede kullanılmaz. Yeni işlerde

ClientNo yok ise



ClientTaxNumber string Yenilemede kullanılmaz. Yeni işlerde

ClientNo yok ise



Nisan 2013





zorunlu


kullanılmaz.


zorunlu

MobilePhoneNumber string Yeni işlerde zorunlu. Yenilemede


gereklidir.

PhoneNumber string Yeni işlerde opsiyonel. Yenilemede


gereklidir.

ClientMobilePhoneNumber string Yeni işlerde zorunlu. Yenilemede


gereklidir.

ClientPhoneNumber string Yeni işlerde opsiyonel. Yenilemede


gereklidir.



zorunlu

TitleDeed TitleDeedModel Opsiyonel


zorunlu


zorunlu


zorunlu


zorunlu


zorunlu


zorunlu


zorunlu




Nisan 2013



Returns


ProposalResult DASKOutput

DASKOutput:


IsSuccess boolean İşlem başarılı ise true değerini alır

StatusCode string Hata olması halinde hata kısa kodu

bulunur.

StatusDescription string Hata olması halinde açıklaması yer

alır.

TrackingCode string Teklif onaylama yapılacak ise mutlaka

saklanmalıdır.

UnitNo long Teklif onaylama yapılacak ise mutlaka

saklanmalıdır.

UnitName string Sigortalının adı

Premium decimal Hesaplanan prim tutarı



ClientNo long Teklif onaylama yapılacak ise mutlaka

saklanmalıdır.










kullanıcıya gösterilerek devam

edilmesi tercihe bırakılmalıdır.

Nisan 2013



3.14. Approve

Yavaş olduğundan bu metod kullanılmamalıdır. ApproveNoEmu metodu bunun yerini almıştır. Yenileme ve yeni iş için oluşturulan teklifleri onaylamak için kullanılan servis fonksiyonudur. Kayıtlı teklif gönderilen parametredeki değerlere göre son kez güncellenerek onaylama işlemi gerçekleştirilir.

Parameters



DASKInput:


Channel int Zorunlu


TrackingCode string Zorunlu

PolicyNo long Zorunlu

UseCreditCard boolean Zorunlu

CreditCard CreditCardInput UseCreditCard=true ise zorunlu

UnitNo long Zorunlu

ClientNo long Zorunlu



zorunlu


kullanılmaz.


zorunlu



zorunlu

TitleDeed TitleDeedModel Opsiyonel


zorunlu


zorunlu


zorunlu


zorunlu


Nisan 2013



zorunlu


zorunlu


zorunlu




Returns


ApproveResult DASKOutput

DASKOutput:




bulunur.


alır.

TrackingCode string Poliçe basımı yapılacak ise mutlaka

saklanmalıdır.



Premium decimal Poliçe prim tutarı













kullanıcıya gösterilerek sakıncalı

durumlarda oluşan poliçenin

başlangıcından iptali sağlanmalıdır.

Nisan 2013



3.15. ApproveNoEmu

Yenileme ve yeni iş için oluşturulan teklifleri onaylamak için kullanılan servis fonksiyonudur. Onaylama esnasında teklif üzerinde herhangi bir değişiklik yapılamaz.

Parameters



DASKInput:


Channel int Zorunlu




UseCreditCard boolean Zorunlu

CreditCard CreditCardInput UseCreditCard=true ise zorunlu

Returns


ApproveResult DASKOutput

DASKOutput:




bulunur.


alır.

TrackingCode string Poliçe basımı yapılacak ise mutlaka

saklanmalıdır.



Premium decimal Poliçe prim tutarı




Nisan 2013



3.16. Print

Onaylanmış olan DASK tekliflerinin (poliçelerin) basımının alınmasını sağlayan servis fonksiyonudur. Servis fonksiyonu çağırıldığında eğer poliçe basıma uygun ise PDF formatında hazırlanır. Dönüş parametresinde bulunan linkden poliçe indirilerek dijital ya da basılı şekilde kullanılabilir. İndirme linkleri kalıcı değildir bu nedenle istemci tarafında PDF dosyalarının indirilerek muhafaza edilmesi önemlidir. Aksi taktirde dosyaya ulaşılamadığı durumda yeniden basım alma web servis fonksiyonunu çalıştımanız gerekecektir.

Parameters



DASKInput:


Channel int Zorunlu




Returns


PrintResult DASKOutput

DASKOutput:



StatusCode string Hata olması halinde hata kısa kodu bulunur.

StatusDescription string Hata olması halinde açıklaması yer alır.

PrintDownloadUrl string Poliçe indirme linki.

Nisan 2013



4. Oluşabilecek Hatalar

Servis içerisinde yer alan tüm fonksiyonlar işletilmeden önce ve işletildikten sonra parametre, kapsam, uygunluk ve sistemsel kontrollerden geçirilmektedir. Bu kontroller sonucunda ise her bir fonksiyon hata ile ilgili sonucu kendi dönüş tipi içinde yer alan IsSuccess, StatusCode ve StatusDescription parametrelerine yazarak bunu istemciye göndermektedir.

Aşağıda bir hata olması durumunda alınabilecek mesajlar ile ilgili özet bir liste mevcuttur. Listede

detail-code ile belirtilen kısımlara hatanın türüne göre ilgili kısa kodu yazılmaktadır. Servislerimizdeki başarılı işlem yapıldığını gösteren StatusCode değeri ise status-success olarak belirlenmiştir.

STATUSCODE AÇIKLAMASI base-auth-detail-code Yetkilendirme ile ilgili bir sorun olması durumlarında base-validate-detail-code Genel servis giriş parametrelerinde bir sorun olması durumunda validate-detail-code Ürüne bağlı giriş parametrelerinde bir sorun olması durumunda status-product-error Ürün tanımlarına veya risk kriterlerine göre işlem yapılmaması durumunda status-fatal-error Uygulamada ele alınmamış bir hata olması durumunda

NOT Servis fonksiyonları her zaman kendi dönüş tipi olarak geri dönüş yapmakta, geri dönüş olarak

Exception / Error tipinde dönüş yapmamaktadır. Bu tip hatalar sadece servise ulaşılamaması veya sunucu tarafında sistemsel bir hata olması durumunda oluşmaktadır ve istemci tarafında kontrol edilmelidir.

DASK Web Servisi - Türk Nippon Sigortagalaksi.turknippon.com/appservice/docs/dask.pdfDASK Web...

Documents

Transcript of DASK Web Servisi - Türk Nippon Sigortagalaksi.turknippon.com/appservice/docs/dask.pdfDASK Web...