WEB SERVİS TEKNİK SUNUM

TÜRKİYE ELEKTRONİK FON DAĞITIM PLATFORMU

(TEFAS)

GÜNDEM

Web Servis BilgileriGenel ÖzelliklerBağlantı Şekli ve KurallarıWeb Servis İsimleri ve Dökümanları

GENEL BİLGİLER

TEFAS işlemleri 3 yöntem kullanılarak yapılabilir.

TAKASBANK ekranlarıWeb Servisler (19 tane)BIST ExAPI terminalleri üzerinden (4 tane)

insertAlSatIMKB

cancelTalimatIMKB

listTalimatIMKB

listFonKisitIMKB

WEB SERVİS GENEL ÖZELLİKLERİ

Web Servislere erişim Takasbank Intranet ağı üzerinden olacaktır.

Takasbank web servis sağlayıcısı, üyeler istemci olacaktır.

(Request/Response )

Web servis veri iletişim protokolü HTTPS (SSL) , mesaj formatı SOAP

(Simple Object Acces Protocol) dır.

WEB SERVİS MİMARİSİ

İnternet

Şube

Client -N

.

.

.

İSTEMCİLER TAKASBANK

İstemci Uygulama Sunucusu

SOAPMesaj

Takasbank Uygulama Sunucusu

TakasbankServis

Sunucusu

Intranet

DOĞRULAMA

Doğrulama yöntemi olarak HTTP simple

authentication kullanılacaktır

Kullanıcı olarak kurumsal kullanıcılar

(ATA990,GLB990 vb.) kullanılacaktır

Şifreler kurumsal kullanıcı şifreleri olacaktır

Kullanıcı/Şifre bilgileri HTTP paketinin Header

kısmında gönderilecektir

DOĞRULAMA( Java İstemci Örneği)

public static void main(String[] args) {

FplWebServiceImplService service = new FplWebServiceImplService();FplWebService port=service.getFplWebServicePort();

Map<String, Object> requestContext = ((BindingProvider)port).getRequestContext(); requestContext.put(BindingProvider.USERNAME_PROPERTY, "ATA990"); requestContext.put(BindingProvider.PASSWORD_PROPERTY, "Test123");

try {BakiyeResponse response= port.getHavuzBakiye("AAK");List<BigDecimal> havuzBakList= response.getResultList();for (BigDecimal havuzBak : havuzBakList) {

System.out.println("havuzBak:"+havuzBak);}

} catch (Exception_Exception e) {e.printStackTrace();

}

}

Kullanıcı ve şifre

DOĞRULAMA (HTTP Request Örneği)

HTTP-REQUEST Mesajı

Header: POST/com.takasbank.tvs.fpl.uyews/fplWS HTTP/1.1accept:text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2authorization:Basic QVRBOTkwOlRlc3QxMjM=content-type:text/xml; charset=utf-8connection:keep-alivecontent-length:253

<?xml version="1.0" encoding="UTF-8" standalone="no"?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

<S:Body><ns2:getHavuzBakiye xmlns:ns2="http://webservice.uyews.fpl.tvs.takasbank.com/">

<fonKod>AAK</fonKod></ns2:getHavuzBakiye>

</S:Body></S:Envelope>

ATA990:Test123’ün base64 Encoded halidir

Authentication (HTTP Response Örneği)

HTTP-RESPONSE Mesajı

Header: HTTP/1.1 200 OKSize: 300 (461) bytes

<?xml version="1.0" encoding="UTF-8" standalone="no"?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

<S:Body><ns2:getHavuzBakiyeResponse

xmlns:ns2="http://webservice.uyews.fpl.tvs.takasbank.com/"><return>

<resultList>970461.000</resultList></return>

</ns2:getHavuzBakiyeResponse></S:Body>

</S:Envelope>

GELİŞTİRME

Web servis sunucu programlarının yazılım süreci tamamlanmıştır. Web servis istemci programlarının yazılımları üyeler tarafından hazırlanacaktır. Geliştirme işlemine yardımcı olması açısından aşağıdaki adrese yardımcı dökümanlar konulmuştur.

http://www.takasbank.com.tr/tr/Sayfalar/TEFAS.aspxFplWS.wsdlFplWS.xsdTEFASP Web Servis Tanitim.pptxTEFASWebServisOperParamUye.xlsx

TESTÜyeler testlerini Takasbank intranet ağı üzerinden yapacaktırC:\Windows\System32\drivers\etc\hosts dosyasına aşağıdaki satır eklenmelidir

Test:192.168.98.23 takaswebtest.takasdom.takasbank.com.trGerçek Ortam:192.168.98.20 takasweb.takasdom.takasbank.com.tr

Test ortamına bağlantı için kullanıcı ve şifreler, teste hazır olan üyelere iletilecektir.Üretim ortamına geçiş sırasında kurumsal kullanıcı ve şifre bilgileri üye işlerine talep yapılarak alınacaktır.

Web Servis test için URL; https://takaswebtest.takasdom.takasbank.com.tr:2550/com.takasbank.tvs.fpl.uyews/fplWS?wsdl https://takaswebtest.takasdom.takasbank.com.tr:2550/com.takasbank.tvs.fpl.uyews/fplWS?xsd=1

TAKASBANK test ekranları için URL; https://takaswebtest.takasdom.takasbank.com.tr:2550/com.takasbank.login.uyeweb/

WEB SERVİSLERTüm web servislerin parametre ve açıklamalarını gösteren dokumana http://www.takasbank.com.tr/tr/Sayfalar/TEFAS.aspx adresinde ‘Web Servis Açıklama Bilgileri’ linkinden ulaşılabilir.

Talimat İşlemleriinsertAlSatTalimat => Talimat girişicancelTalimat => Talimat iptalilistAlSatTalRap => Talimatların listelenmesi insertTalepGiris => Saklamacısı farklı olan üyenin talimat girişiacceptTalep => Saklamacı talimat onayırefuseTalepToplu => Saklamacı talimat iptaliraporTalep => Saklamacısı farklı olan üyenin talimatlarını listelemelistTakasBorcIzle => Net/Bürüt Nakit Borç/Alacak ListelelistGelenTalIzle => Kurucu/Operatör kendine gelen talimatları listelemelistGercIslRap => Gerçekleşen talimatları listeleme

WEB SERVİSLER

Bildirim İşlemleriupdateFiyatBildir – Platforma fon fiyat bildirimi Giriş/Güncelleme listFiyatBildirRap – Platformdaki fon fiyatlarını listelemeinsertHavuzTalimatGiris – Kurucu/Operatör fon Havuz Arttırma/AzaltmagetHavuzBakiye -- Platformdaki fon sayısıupdateKisitBildir – Platforma fon bilgileri bildirimi Giriş/Güncelleme listKisitBildirRap – Platformdaki fon bilgileri listeleme

Yardımcı ServislerlistKursatUyeRap – Platforma tanımlı fonları ve işlemci üyelerini listelerlistTefaspFonRap – Platforma tanımlı fonları ve kurucu bilgilerini listelerlistTefaspUyeRap – Platforma tanımlı üyeleri listeler

TeşekkürlerOperasyon

Fatma Köksalfkoksal@takasbank.com.tr

+(90) 212 315 21 83

Analist Özgür Tunalı

otunali@takasbank.com.tr +(90) 212 315 20 90

Yazılım Nalan Keskin

nbaydan@takasbank.com.tr+(90) 212 315 21 38