VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI SAKLAMACI ÜYE DROP COPY

Transkript

1 VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI SAKLAMACI ÜYE DROP COPY Temmuz 2015, Sürüm 12

2 DÖKÜMAN TARİHÇESİ Tarih Versiyon Açıklama Kasım İlk sürüm Sözleşmeler production ortamındaki sözleşmelere göre güncellendi Şubat Emir numaraları güncel hale getirildi Emir numaraları güncel hale getirildi 2 SERTİFİKASYON TEST ORTAMI bölümündeki sistemi tarihinin test tarihine göre güncelleneceğine dair açıklama Temmuz kaldırıldı 2

3 AŞ nin VİOPFIX API BAĞLANTISI TESTİ Üyelerimizin Dikkatine: Bu testin amacı üyelerimizin kendi sistemlerini mevcut haliyle VİOPFIX API ortamında test etmelerini sağlamaktır Lütfen aşağıdaki işlemleri sırasıyla yapınız ve bu işlemleri yaparken her adımda gelen mesajları mutlaka kontrol ediniz Öncelikle emrin sisteme gönderildiğinde oluşması beklenen etkiyi belirleyiniz Emri veya herhangi bir isteği sisteme gönderdikten sonra beklenen etkinin gerçekleşip gerçekleşmediğini, ilk aşamada aktiviteye ilişkin tarafınıza ulaşan cevabı; boyut, içerik, tamlık ve doğruluk açılarından, ikinci aşamada ise arkadaki her kanaldan yapılan aktivitelerin kaynağı olan ana sisteminizde doğru işlenmesi açısından kontrol ediniz Sertifikasyon programı kapsamında kılavuzda yer alan tüm adımların gerçekleştirilmesi sonrasında, Sistem Bağlantı Testleri (Bölüm 1) ve Emir İletim ve Fonksiyon Testleri (Bölüm 3) sırasında gönderilen ve alınan mesajlardan oluşan log dosyalarının BİAŞ a [8=FIXT119=32935=834=649=ISTVIOPFIX52= :33: =XXXFIX1128=91=114=037= =10039=040=242= :33: =46554=255=59=060= :33: =C150=0151=100381= =2448=XXX452=1448=XXXFM1452=12625 =31181=161300=CFAN1352=Y9757= =10010=117] formatında gönderilmesi beklenmektedir Bu log dosyaları, BİAŞ tarafından hazırlanan ve senaryolar sonucunda oluşması beklenen log dosyaları ile karşılaştırılacaktır Emir iletim hızına bağlı olarak asenkron kanaldan dönen cevap mesajları gecikebilmektedir Bu durum log dosyasında mesaj sıralarında değişikliklere sebep olabilmektedir Mesajların içeriklerinin aynı olması koşuluyla mesaj loglarının sırasının değişmesi karşılaştırma açısından sorun teşkil etmemektedir Sonuç olarak beklenen çıktıların alınması durumunda, üyelerimiz 3

4 sertifikasyon programını tamamlamış olacaklardır Log dosyalarının kontrollerden başarılı bir şekilde geçmesi için dokümandaki tablolarda verilen alanların eksiksiz doldurulması gerekmektedir Sertifikasyon sürecinde beklenmeyen bir durum olması halinde sorunu yetkililere ivedilikle bildiriniz Testin son bölümünü de doldurduktan sonra Borsa İstanbul yetkililerine ulaştırınız Vadeli İşlem ve Opsiyon Piyasası mevcut işlem kurallarında yer alan ve Borsa İstanbul tarafından VİOPFIX API de uygulanmasına izin verilen emir ve işlem fonksiyonlarının tamamını veya bir kısmını kendi VİOPFIX API programlarında kullanmayan veya kısmen kullanan üyelerimizin ileride müşterileri ile aralarında doğabilecek uyuşmazlıklarda hukuki sorumluluk tamamen ilgili üyemize ait olacaktır Bu nedenle üyelerimize, VİOPFIX API ile emirlerini Borsa İstanbul a iletecekleri müşterilerini bu konuda bilgilendirmeleri ve müşterileri ile aralarında buna uygun hukuki dayanağı oluşturmaları tavsiye edilmektedir Üye sisteminin hatasız çalışması üyelerimizin sorumluluğundadır 4

5 İçindekiler 1 SİSTEM BAĞLANTI TESTLERİ 6 2 SERTİFİKASYON TEST ORTAMI 8 3 DROP COPY FONKSİYONLARI TESTİ TEST ORTAMINDAKİ MEVCUT BİLGİLERİN İNDİRİLMESİ POZİSYON SORGUSU MESAJ İNDİRME BAĞLANTI SIRASINDA GİRİLEN EMİRLER VE OLUŞAN İŞLEMLER 15 5

6 1 SİSTEM BAĞLANTI TESTLERİ Lütfen Borsa İstanbul BT-Destek i (Tel: ) arayarak sertifikasyon programına başlamak istediğinizi belirtiniz BT-Destek yetkilisi onay verdiği zaman aşağıdaki adımları gerçekleştiriniz 1 Sisteme bağlı değilken Password alanını boş bırakarak Logon mesajı gönderiniz Cevap: Logout mesajında yük bilgilerinin geldiği görülür 2 BİAŞ tarafından şifreniz Qq olarak ayarlanmıştır Lütfen yükü gönderilen GW lerden yükü az olanı seçiniz ve seçilen GW üzerinden NewPassword alanını göndermeksizin ve HeartbtInt(108) alanını 60 sn olarak ayarlayarak verilen şifre ile bağlanınız Bağlantı aşamasında ResetSeqNumFlag(141)=Y (sıra numarasını sıfırla) olduğundan emin olunuz Cevap: PASSWORD_EXPIRED açıklaması ile Logout mesajı geldiği görülür 3 BİAŞ tarafından verilen şifre ile Password alanını ve yeni bir şifre ile NewPassword alanını doldurarak sisteme giriniz Cevap: Sisteme Logon mesajı ile girildiği görülür 4 Logout mesajı göndererek sistemle olan bağlantınızı sonlandırın Cevap: Logout mesajı ile sistemden çıkıldığı görülür 5 Yeni şifreniz ile sisteme giriniz Cevap: Sisteme Logon mesajı ile girildiği görülür 6 İşlem yapmadan bekleyerek Heartbeat mesajının size ulaştığını kontrol ediniz 7 TestRequest mesajı gönderin Cevap: Heartbeat mesajı alındığı görülür 8 Logout mesajı göndererek sistemle olan bağlantınızı sonlandırın 6

7 Cevap: Logout mesajı ile sistemden çıkıldığı görülür 9 NewPassword alanını doldurarak şifre değiştirerek Logon mesajı gönderiniz Cevap: Sisteme Logon mesajı ile girildiği görülür 10 Logout mesajı göndererek sistemle olan bağlantınızı sonlandırın Cevap: Logout mesajı ile sistemden çıkıldığı görülür 11 Yeni şifre ile sisteme giriniz Cevap: Sisteme Logon mesajı ile girildiği görülür 12 BeginSeqNo = 1 ve EndSeqNo = 1 değerlerini atayarak Resend Request gönderiniz Cevap: Yeniden talep edilen mesaj oturum mesajı olduğu için SequenceReset mesajı geldiği görülür 13 Mevcuttan daha büyük bir MsgSeqNum (50) değeri girerek sekans resetleme talebi gönderiniz Cevap: MsgSeqNum değerinin verilen değere (50) set edildiği görülür 14 Logout mesajı göndererek sistemle olan bağlantınızı sonlandırın Cevap: Logout mesajı ile sistemden çıkıldığı görülür 7

8 2 SERTİFİKASYON TEST ORTAMI Sertifikasyon programına başlamadan önce sistem, BİAŞ tarafından testler için özel olarak hazırlanmış duruma getirilecektir Sertifikasyon programına BİAŞ tarafından aşağıda belirtilen adımlar girilerek başlanacaktır Yatırım kuruluşlarının, sertifikasyon sürecine başlamadan önce BİAŞ tarafından sisteme girilen aşağıda belirtilen senaryolara ait mesajları indirmeleri gerekmektedir Dokümandaki senaryolarda 1 nolu hesap portföy hesabı, 2 nolu hesap global hesap, 3 nolu hesap müşteri hesabı ve 4 nolu hesap riskli hesap olarak kullanılmıştır Bu hesaplar, sertifikasyon test ortamında üyelerimiz için tanımlanacaktır AAA olarak tanımlanan başka bir üyeye ise 1, 2, 3 ve 4 numaralı dört adet işlem hesabı tanımlanacaktır Bu işlem hesapları sertifikasyon alacak üyenin saklama hesaplarına atanacaktır: AAA üyesi 1 nolu işlem hesabı -> sertifika alacak kurum 1 nolu saklama hesabı AAA üyesi 2 nolu işlem hesabı -> sertifika alacak kurum 2 nolu saklama hesabı AAA üyesi 3 nolu işlem hesabı -> sertifika alacak kurum 3 nolu saklama hesabı AAA üyesi 4 nolu işlem hesabı -> sertifika alacak kurum 4 nolu saklama hesabı Üyelerimizin testler sırasında, söz konusu dört hesabı aşağıdaki adımlarda belirtilen şekilde kullanmaları gerekmektedir BİAŞ tarafından hazırlanan mesaj adımları: Sıra No Üyenin 4 numaralı hesabının risk durumu 3(riskli) e çekilir F_GARAN1 sözleşmesi durdurulur Yeni alış emri girilir (AAA üyesi için) Yeni satış emri girilir (AAA üyesi için) Yeni satış emri girilir (AAA üyesi için) MsgType [35] Symbol [55] Market SegmentID [1300] OrderQty [38] D CFAN S 1 D CFAN S 1 D CFAN S 1 Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] 4 8

9 Sıra No Farklı bir üyeden yeni satış emri girilir ve 1 nolu emirle 6 işlem olur Yeni alış emri girilir ve 2 nolu emirle işlem olur (AAA üyesi 7 için) 3 nolu emir değiştirilir (AAA 8 üyesi için) 2 nolu emir iptal edilir (AAA 9 üyesi için) Riskli olan hesaba emir girilir 10 (AAA üyesi için) Riskli olan hesabın emri Takasbank tarafından 11 reddedilir Yeni alış emri girilir (AAA üyesi 12 için) Yeni alış emri girilir (AAA üyesi 13 için) 1 nolu emrin hesap numarası hatalı işlem düzeltmesiyle 2 olarak düzeltilir (AAA üyesi 14 için) Riskli olan hesaba emir girilir 15 (AAA üyesi için) Riskli olan hesabın emri Takasbank tarafından 16 onaylanır 17 1 nolu işlem iptal edilir Üyenin 1 nolu işlem hesabı ile 2 nolu işlem hesabı arasında özel emir girilerek işleme 18 dönüştürülür (AAA üyesi için) MsgType [35] Symbol [55] Market SegmentID [1300] OrderQty [38] D CFAN D CFAN G CFAN F Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] CFAN S 1 D CFAN D CFAN D CFAN D CFAN CFOZ ve 2 9

10 3 DROP COPY FONKSİYONLARI TESTİ VİOPFIX üzerinden izleme yetkisi bulunan kullanıcılar kendilerine verilen yetkiler doğrultusunda sadece emir bilgilerine, sadece işlem bilgilerine veya her ikisine birden sahip olabileceklerdir Kurumların yetki seviyelerine bakılmaksızın tüm adımları gerçekleştirmeleri gerekmektedir Lütfen HeartbtInt süresini 300 olarak ayarlayarak sisteme tekrar bağlanınız 31 TEST ORTAMINDAKİ MEVCUT BİLGİLERİN İNDİRİLMESİ İşlem sisteminin mevcut durumuna ulaşmak için sistemde oluşan emirler, işlemler ve bilgi mesajlarını indirmeniz gerekmektedir Aşağıdaki tabloda mesajların indirilmesi için gerekli bilgiler yer almaktadır Lütfen tablolarda verilen bilgileri dikkate alarak sistemdeki mevcut emirleri, işlemleri ve bilgi mesajlarını indiriniz Her bir mesaj girişi sonrasında Sonuç kolonunda yer alan beklenen mesajın alındığını kontrol ediniz Sıra No MsgType ApplBegSeqNum ApplReqID ApplReqType NewsCategory OrderID TrdMatchID Sonuç Emir numarası ve ApplBegSeqNum alanına 0 değeri girerek emir indirme talebinizi gönderiniz BW İşlem numarası ve ApplBegSeqNum alanına 0 değeri girerek işlem indirme talebinizi gönderiniz BW ApplBegSeqNum alanına 0 değeri girerek genel BW ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Long) News(EndOfOrder) ER(Trade) ER(Trade) ER(Trade) ER(Trade) ER(Trade) ER(Trade) ER(Trade) News(EndOfTrade) News(Genel Yayın) News(Genel Yayın) 10

11 Sıra No MsgType ApplBegSeqNum ApplReqID ApplReqType NewsCategory OrderID TrdMatchID Sonuç yayın mesajı indirme talebinizi gönderiniz News(Genel Yayın) News(EndOfBC) 11

12 32 POZİSYON SORGUSU Aşağıda tabloda pozisyon sorguları yer almaktadır Belirtilen senaryoları kapsayan, tabloda yer alan bilgileri içeren pozisyon sorgularını giriniz Her bir pozisyon sorgusu sonrasında sonuç kolonunda yer alan beklenen mesajların alındığını kontrol ediniz Sıra No MsgType [35] Account [1] AccountType [581] PosReqID [710] PosReqType [724] Symbol [55] NoPartyIDs [453] PartyID [448] PartyRole [452] Sonuç Tüm zorunlu alanlar ve hesap no girilerek pozisyon sorgusu yapınız AN Tüm zorunlu alanlar ve hesap türü girilerek (ilgili hesap türüne ait toplam pozisyon bilgisi için) pozisyon sorgusu yapınız AN Tüm zorunlu alanlar ve üye bilgisi girilerek (ilgili üyeye ait toplam pozisyon için) pozisyon sorgusu yapınız AN <UYE*> 1 PositionReport News(EndOfPosition) PositionReport News(EndOfPosition) PositionReport News(EndOfPosition) * Sertifikasyona katılan üyenin/ yazılım kuruluşunun kendi kodunu girmesi beklenmektedir 12

13 33 MESAJ İNDİRME Aşağıda tabloda emir, işlem, genel yayın ve sistem uyarısı mesajlarını indirme mesajları yer almaktadır Belirtilen senaryoları kapsayan, tabloda yer alan bilgileri içeren indirme mesajlarını giriniz Her bir mesaj indirme sonrasında sonuç kolonunda yer alan beklenen mesajların alındığını kontrol ediniz Sıra No MsgType [35] ApplBegSeqNum [1182] ApplReqID [1346] ApplReqType [1347] NewsCategory [1473] OrderID [37] TrdMatchID [880] Sonuç Emir numarası ve ApplBegSeqNum alanına mevcut en büyük ApplSeqNum değerinden daha büyük bir değer girilerek emir indirme talebinizi gönderiniz BW İşlem numarası ve ApplBegSeqNum alanına mevcut en büyük ApplSeqNum değerinden daha büyük bir değer girilerek İşlem indirme News(EndOfOrder) talebinizi gönderiniz BW News(EndOfTrade) ApplBegSeqNum alanına mevcut en büyük ApplSeqNum değerinden daha büyük bir değer girilerek genel yayın mesajı indirme talebinizi gönderiniz BW News(EndOfBC) Başka bir üyeye ait bir emrin OrderID si ile emir indirme talebi gönderiniz BW NewsCategory alanına 4 değeri (tüm genel yayın mesajları için) girilerek ApplicationMessageRequ est mesajı gönderiniz BW News(EndOfOrder) News(Genel Yayın) News(Genel Yayın) News(Genel Yayın) News(EndOfBC) 13

14 Sıra No MsgType [35] ApplBegSeqNum [1182] ApplReqID [1346] ApplReqType [1347] NewsCategory [1473] OrderID [37] TrdMatchID [880] Sonuç NewsCategory alanına 5 değeri (tüm sistem uyarıları mesajları için) girilerek ApplicationMessageRequ est mesajı gönderiniz BW News(EndOfAlert) ApplBegSeqNum alanına 0 ve OrderID alanına ilk girilen emrin numarası (ilk emirden sonraki tüm yeni emirlerin, değişikliklerin gönderilmesi için) girilerek bir ApplicationMessageRequ est emir indirme mesajı gönderiniz BW ApplBegSeqNum alanına 0 ve TrdMatchID alanına ilk oluşan işlemin numarası (ilk işlemden sonraki tüm işlemleringönderilmesi için) girilerek bir ApplicationMessageRequ est işlem indirme mesajı gönderiniz BW ER(Order Long) ER (Order Long) ER (Order Short) ER (Order Short) News(EndOfOrder) ER(Trade) ER(Trade) News(EndOfTrade) 14

15 34 BAĞLANTI SIRASINDA GİRİLEN EMİRLER VE OLUŞAN İŞLEMLER Yukarıda belirtilen test adımları tamamlandıktan sonra BT-Destek i (Tel: ) arayarak veya bt-destek@borsaistanbulcom adresine eposta göndererek son bölüme geldiğinizi belirtiniz Bu bölümde, aşağıda belirtilen emirler Borsa personeli tarafından sistemde oluşturularak ilgili emir ve işlem bilgilerini başarıyla almanız beklenmektedir Aşağıda belirtilen emir ve işlem bilgileri tarafınıza ulaştıktan sonra testi tamamlayarak loglarınızı BT-Destek e ulaştırabilirsiniz NOT: Simülatör testlerinde, aşağıda belirtilen emir ve işlem bilgileri 33 MESAJ İNDİRME bölümünün son adımı test edildikten sonra otomatik olarak gönderilmektedir Sıra No Yeni alış emri girilir ve nolu emir ile işlem olur (AAA üyesi için) Yeni satış emri girilir (AAA üyesi için) Farklı bir üyeden yeni satış emri girilir ve , , nolu emirlerle işlem olur Yeni alış emri girilir ve farklı bir üyenin emriyle işlem olur (AAA üyesi için) MsgType [35] D D D D Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] CFAN S 1 CFAN S 1 CFAN CFAN Sonuç ER(Order Long) ER(Trade) ER(Trade) ER(Order Long) ER(Trade) ER(Trade) ER(Trade) ER(Order Long) ER(Trade) - 15

16 Sıra No MsgType [35] Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] Sonuç nolu emir değiştirilir (AAA üyesi için) nolu emir iptal edilir (AAA üyesi için) Riskli olan hesaba emir girilir (AAA üyesi için) Riskli olan hesabın emri Takasbank tarafından reddedilir G F D CFAN CFAN S 1 CFAN ER(Order Long) ER(Order Long)

17 TEST SONUCU: Aracı Kurum Unvanı Teste Katılan Teknik Yetkili Teste Katılan Piyasa Yetkilisi Teste Katılan Borsa Yetkilisi Genel Değerlendirme (Bu bölüm Borsa İstanbul AŞ yetkilileri tarafından doldurulacaktır) Not: VİOPFIX API Üye Yazılımı Sertifikasyon Programı sürecini başarıyla tamamladığınız takdirde, bu dokümanının 4 ve 17 sayfalarının ıslak imza ve kaşe, diğer sayfalarının paraf atılarak tarafımıza iletilmesi beklenmektedir 17