WEB SERVİS TEKNİK SUNUM

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

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

3. 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

4. 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.

5. WEB SERVİS MİMARİSİ İSTEMCİLER TAKASBANK İnternet Takasbank Uygulama Sunucusu İstemci Uygulama Sunucusu Şube Intranet SOAP Mesaj . . . TakasbankServis Sunucusu Client -N

6. DOĞRULAMA • Doğrulama yöntemi olarak HTTP simpleauthenticationkullanı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

7. DOĞRULAMA( Java İstemci Örneği) publicstaticvoid main(String[] args) { FplWebServiceImplService service = newFplWebServiceImplService(); FplWebService port=service.getFplWebServicePort(); Map<String, Object> requestContext = ((BindingProvider)port).getRequestContext(); requestContext.put(BindingProvider.USERNAME_PROPERTY, "ATA990"); requestContext.put(BindingProvider.PASSWORD_PROPERTY, "Test123"); try { BakiyeResponseresponse= port.getHavuzBakiye("AAK"); List<BigDecimal> havuzBakList= response.getResultList(); for (BigDecimalhavuzBak : havuzBakList) { System.out.println("havuzBak:"+havuzBak); } } catch (Exception_Exception e) { e.printStackTrace(); } } Kullanıcı ve şifre

8. DOĞRULAMA (HTTP Request Örneği) 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 <?xmlversion="1.0" encoding="UTF-8" standalone="no"?> <S:Envelopexmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:getHavuzBakiyexmlns:ns2="http://webservice.uyews.fpl.tvs.takasbank.com/"> <fonKod>AAK</fonKod> </ns2:getHavuzBakiye> </S:Body> </S:Envelope> ATA990:Test123’ün base64 Encoded halidir

9. Authentication (HTTP Response Örneği) HTTP-RESPONSE Mesajı Header: HTTP/1.1 200 OK Size: 300 (461) bytes <?xmlversion="1.0" encoding="UTF-8" standalone="no"?> <S:Envelopexmlns: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>

10. 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ümanlarkonulmuştur. http://www.takasbank.com.tr/tr/Sayfalar/TEFAS.aspx FplWS.wsdl FplWS.xsd TEFASP Web Servis Tanitim.pptx TEFASWebServisOperParamUye.xlsx

11. TEST • Üyeler testlerini Takasbank intranet ağı üzerinden yapacaktır • C:\Windows\System32\drivers\etc\hosts dosyasınaaşağıdaki satır eklenmelidir Test: 192.168.98.23 takaswebtest.takasdom.takasbank.com.tr Gerçek Ortam: 192.168.98.20takasweb.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/

12. WEB SERVİSLER 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

13. WEB SERVİSLER • Bildirim İşlemleri • 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

14. Teşekkürler Analist Özgür Tunalı otunali@takasbank.com.tr +(90) 212 315 20 90 Operasyon Fatma Köksal fkoksal@takasbank.com.tr +(90) 212 315 21 83 Yazılım Nalan Keskin nbaydan@takasbank.com.tr +(90) 212 315 21 38