TÜRKİYE ELEKTRONİK FON ALIM SATIM PLATFORMU WEB SERVİS İŞLEMLERİ

Gündem Genel Bilgiler Güvenlik İşlemleri Geliştirme Test Üretim Kullanılacak Öncelikli Web Servisleri TEFASWebServisOperParam.xlsx Dokümanı Fon Alımı Web Servis Örneği

Genel TEFASP projesinin işlemleri projenin kendi ekranları(client) aracılığı ile yapılabileceği gibi ek olarak Web Servis kullanılarak da yapılabilir. TEFASP projesinin Web Servisleri 2 kategoriye ayrılmıştır. Öncelikli Web Servisler Diğer Web Servisler (Opsiyonel) Takasbank web servis sağlayıcı, üyeler istemci olacaktır. Üyeler kendi ekranları ile Takasbank’ın sağladığı Web Servis arayüzünün entegrasyonu sağlayacaklardır. Web servisler Request/Response modeline göre çalışacaktır. İletişim yöntemi senkron olarak tanımlanmıştır. İstemci tarafında kullanılan teknolojiye göre servisi asenkron olarak kullanabilir.

Genel - devam Her bir operasyon kendi içinde atomik transactiona sahiptir. Oparasyonlar arası veya istemci sunucu arası transaction yönetimi bulunmamaktadır. Web Servilerine erişim Takasbank Intranet ağı üzerinden olacaktır. Web servis veri iletişim protokolü HTTP olacaktır. HTTPS (SSL) kullanılacaktır Web servis mesaj formatı SOAP (Simple Object Acces Protocol) olacaktır. SOAP mesajının veri tipi document olacaktır. SOAP mesajları attachment içermeyecektir. Web Servis Server implemantasyonu Java JAX-WS library’leri ile yapılmıştır. Client (Aracı Kurum) tarafında Java veya .Net kullanılabilir.

Web servis mimarisi Aracı Kurum İnternet/ Intranet Client Aracı Kurum Web Uygulama Sunucu Takasbank Client Ekr-1 Takasbank Web Servis API Takasbank Web Sunucusu Client Ekr-2 Web Uygulaması SOAP Message . Takasbank Web Servis Sunucusu Client Ekr-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(bir java istemci ö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, "ATA90"); requestContext.put(BindingProvider.PASSWORD_PROPERTY, "TestSifre"); try { BakiyeResponse response= port.getHavuzBakiye("AAK1"); 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.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> ATA990:Test123’ün base64 Encoded halidir

Authentication(HTTP Response Örneği) HTTP-RERESPONSE 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 sevis sunucu programlarının yazılım süreci tamamlanmıştır. Web servis istemci programının yazılımları üyeler tarafından yerine getirilecektir. İstemci geliştirme ortamları için için Java veya .NET platformlarından biri kullanılabilir. Geliştirme işlemine yardımcı olması açısından aşağıdaki adreslere yadımcı dökümalar konulmuştur. Takasbank internet sitesi->Üyelik İşlemleri->Özel İşlemler->Web Servis Hizmetleri FplWS.wsdl FplWS.xsd Takasbank internet sitesi->Üyelik İşlemleri->Özel İşlemler->Tefasp İşlemleri TEFASP Web Servis Tanitim.pptx TEFASWebServisOperParam.xlsx

Test Üyeler, kendi taraflarında web servis istemci yazılımlarını tamamladıklarında testlerini Takasbank’ın kendilerine sağladığı test ortamında gerçekleştirebilirler Üyeler testleri Takasbank intranet ağı üzerinden yapacaktır. Test ortamına bağlantı linki, kullanıcı ve şifreler, teste hazır olan üyelere iletilecektir.

Test OrtamIna BağlantI C:\Windows\System32\drivers\etc\hosts dosyasına eklenir   192.168.98.23   takaswebtest.takasdom.takasbank.com.tr 192.168.98.20   takasweb.takasdom.takasbank.com.tr WSDL dökümanına erişim adresi aşağıdadır 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

ÜRETİM Testlerini başarıyla tamamlayan üyeler üretim ortamına geçebilir. Üretim ortamının bağlantı adresi(URL’i), kullanıcı ve şifreler üretim ortamına geçiş aşamasında üyelere bildirilir.

ÖNCELİKLİ WEB SERVİSLER Alım-Satım Talimat İşlemleri insertAlSatGecici insertAlSat (kullanıcı onayı istenirse) deleteAlSatGecici Talimat İzleme – İptal listTalimat cancelTalimat updateTalimat Temel Fon Bilgileri listFonKisit listKisitBildirRap fonDetay

dİğer WEB ServİsLER İşlemler Havuz Talimat İşlemleri Nakit Borç Kapatma Gelen Talimat İzleme Komisyon Bilgileri İzleme- Ödeme Bildirimler Fon Fiyat Bildirimi Raporlar Komisyon Ödemeleri Takip Raporu Gerçekleşen İşlemler Raporu Fon Özlük Bilgileri Raporu Fon Analiz Raporları

TEFASWebServisOperParam.xlsx DokümanI Operasyon Adı insertHavuzTalimatGiris Operasyon Açıklaması Havuz bakiyesini artırıp/azaltma talimat girişi yapılır. Giriş Parametreleri Parametre Adı Veri Tipi Açıklama   uyeKod char(3) Operatör Üye islemTip char(1) A: Havuz Artırım, E: Havuz Eksiltim fonKod Fon Kodu islemAdet decimal(20,3) İşlem Adet Çıkış Parametreleri ret Integer 10: işlem tamam

Fon AlIm/SatIm İşlemİ Örneğİ Aracı Kurum Takasbank İntranet Takasbank Takasbank Web Sunucusu Takasbank Uygulama Sunucusu Fon Alım Talimatı Giriş Ekranı insertAlSatGecici çağrılır SOAP/XML Message E ok? Fon Alım Onay Ekranı H Bitti KB: Şu anda ne kadar alınabiliyor ise o kadar alınsın ,gerisi gün içinde alınmak üzere beklesin. KI:Şu anda ne kadar alınabiliyor ise o kadar alınsın,gerisi iptal olsun. TA:Şu anda tamamı alınabiliyor ise alınsın,alınamıyor ise talimatım tamamen iptal olsun insertAlSat çağrılır SOAP/XML Message 10:Talimat Onaylanmıştır 15:İşlem gerçekleştirilmek üzere MKK ya gönderildi 20:Kıymet blokajı için MKK ya mesaj gönderildi