WEB SERVİS TEKNİK SUNUM TÜRKİYE ELEKTRONİK FON DAĞITIM PLATFORMU (TEFAS) WEB SERVİS TEKNİK SUNUM

GÜNDEM Web Servis Bilgileri Genel Özellikler Bağlantı Şekli ve Kuralları Web Servis İsimleri ve Dökümanları

TEFAS işlemleri 3 yöntem kullanılarak yapılabilir. 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İ İSTEMCİLER TAKASBANK İnternet Takasbank Uygulama Sunucusu İstemci Uygulama Sunucusu Şube Intranet SOAP Mesaj . TakasbankServis Sunucusu Client -N

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) ATA990:Test123’ün base64 Encoded halidir HTTP-REQUEST Mesajı Header: POST/com.takasbank.tvs.fpl.uyews/fplWS HTTP/1.1 accept:text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 authorization:Basic QVRBOTkwOlRlc3QxMjM= content-type:text/xml; charset=utf-8 connection:keep-alive content-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>

Authentication (HTTP Response Örneği) HTTP-RESPONSE Mesajı Header: HTTP/1.1 200 OK Size: 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.aspx FplWS.wsdl FplWS.xsd TEFASP Web Servis Tanitim.pptx TEFASWebServisOperParamUye.xlsx

TEST Üyeler testlerini Takasbank intranet ağı üzerinden yapacaktır C:\Windows\System32\drivers\etc\hosts dosyasına aşağıdaki satır eklenmelidir Test: 192.168.98.23 takaswebtest.takasdom.takasbank.com.tr Gerç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İSLER Talimat İşlemleri Tü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 İşlemleri insertAlSatTalimat => Talimat girişi cancelTalimat => Talimat iptali listAlSatTalRap => Talimatların listelenmesi insertTalepGiris => Saklamacısı farklı olan üyenin talimat girişi acceptTalep => Saklamacı talimat onayı refuseTalepToplu => Saklamacı talimat iptali raporTalep => Saklamacısı farklı olan üyenin talimatlarını listeleme listTakasBorcIzle => Net/Bürüt Nakit Borç/Alacak Listele listGelenTalIzle => Kurucu/Operatör kendine gelen talimatları listeleme listGercIslRap => Gerçekleşen talimatları listeleme

WEB SERVİSLER Bildirim İşlemleri Yardımcı Servisler updateFiyatBildir – Platforma fon fiyat bildirimi Giriş/Güncelleme listFiyatBildirRap – Platformdaki fon fiyatlarını listeleme insertHavuzTalimatGiris – Kurucu/Operatör fon Havuz Arttırma/Azaltma getHavuzBakiye -- Platformdaki fon sayısı updateKisitBildir – Platforma fon bilgileri bildirimi Giriş/Güncelleme listKisitBildirRap – Platformdaki fon bilgileri listeleme Yardımcı Servisler listKursatUyeRap – Platforma tanımlı fonları ve işlemci üyelerini listeler listTefaspFonRap – Platforma tanımlı fonları ve kurucu bilgilerini listeler listTefaspUyeRap – Platforma tanımlı üyeleri listeler

Teşekkürler Operasyon Analist Fatma Köksal Özgür Tunalı fkoksal@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