VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI ORTA SEVİYE. Şubat 2015, Sürüm 1.1

Transkript

1 VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI ORTA SEVİYE Şubat 2015, Sürüm 11

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 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=1215S059=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 EMİR İLETİM VE FONKSİYONLARI TESTİ 9 31 YENİ EMİR GİRİŞİ 9 32 EMİR İPTALİ MESAJ İNDİRME EMİR DEĞİŞTİRME 15 5

6 1 SİSTEM BAĞLANTI TESTLERİ Lütfen BİAŞ 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 Üyelerimizin testler sırasında, söz konusu dört hesabı aşağıdaki adımlarda belirtilen şekilde kullanmaları gerekmektedir Sertifikasyon testi için hazırlanan ortam, kurumların teste katıldıkları günün tarihine göre açılmaktadır Bu nedenle dokümanda belirtilen emir numaraları (OrderID) kurumların teste katıldığı tarihi içerecek şekilde değişiklik gösterecektir Emirlerin sırası hiçbir şekilde değişmeyecek, yalnızca emir numaralarının başındaki tarihi belirten ilk 8 hane güncellenecektir BİAŞ tarafından hazırlanan mesaj adımları: Sıra No 1 2 Senaryo Üyenin 4 numaralı hesabının risk durumu 3(riskli) e çekilir F_GARAN1215S0 sözleşmesi durdurulur MsgType [35] Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] 4 8

9 3 EMİR İLETİM VE FONKSİYONLARI TESTİ Lütfen HeartbtInt süresini 300 olarak ayarlayarak sisteme tekrar bağlanınız 31 YENİ EMİR GİRİŞİ Aşağıdaki tabloda yeni emir girişi için gerekli bilgiler yer almaktadır Lütfen ClOrdID bazında tabloda yer alan bilgileri içeren emirleri giriniz Her bir emir girişi sonrasında sonuç kolonunda yer alan beklenen mesajın alındığını kontrol ediniz Sıra No MsgType [35] ClOrdID [11] Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrdType [40] TimeInForce [59] TriggerType [1100] TriggerAction [1101] TriggerPrice [1102] PositionEffect [77] Account [1] Sonuç 1 D 1 2 D 2 3 D S0 CFAN C S0 CFAN C S0 CFAN K C 1 ER(Reject) (ERROR: Bu seans için geçersiz emir metodu) ER(Order Long) ER(Order Short) ER(Order Long) D 4 O_XU030 E1215C96 000S0 EOAN C 1 ER(Order Long) D S0 CFAN K 4 C 1 ER(Order Long) ER(Order Short) D S0 CFAN S C 1 ER(Order Long) D S0 CFAN C 1 ER(Order Long)

10 Sıra No MsgType [35] ClOrdID [11] Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrdType [40] TimeInForce [59] TriggerType [1100] TriggerAction [1101] TriggerPrice [1102] PositionEffect [77] Account [1] Sonuç 8 D S0 CFAN S C 1 ER(Order Long) D 10 D S0 CFAN C S0 CFAN C 2 ER(Order Long) ER(Order Long) ER(Order Short) D 12 D 13 D S0 CFAN S C S0 CFAN C 2 O_XU030 E1215C96 000S0 EOAN S C 4 ER(Order Long) ER(Order Long) ER(Order Short) ER(Reject) (ERROR: Bu seans ve riskli saklama hesabı için geçersiz emir metodu) 14 D 15 D 16 D F_GARAN 1215S0 FANA C S0 CFAN S C S0 CFAN C 1 ER(Reject) (ERROR: Sözleşme işlemleri durduruldu) ER(Order Long) ER(Order Long) ER(Order Long) ER(Order Short) ER(Order Short) ER(Order Short) ER(Order Short) ER(Order Short) ER(Order Short) ER(Trade) ER(Trade) ER(Trade) ER(Trade) News(Genel Yayın) News(Genel Yayın) ER(Order Long) ER(Order Short) ER(Order Short)

11 Sıra No MsgType [35] ClOrdID [11] Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrdType [40] TimeInForce [59] TriggerType [1100] TriggerAction [1101] TriggerPrice [1102] PositionEffect [77] Account [1] Sonuç ER(Trade) ER(Trade)

12 32 EMİR İPTALİ Aşağıda tabloda emir girişi yapılmış olan emirlerin iptalleri yer almaktadır Belirtilen senaryoları kapsayan, tabloda yer alan bilgileri içeren emir iptallerini giriniz Her bir emir iptali girişi sonrasında sonuç kolonunda yer alan beklenen mesajların alındığını kontrol ediniz Sıra No SENARYOLAR EOAN pazarında O_XU030E1215C96000S0 sözleşmesine girmiş olduğunuz 150 adet günlük alış piyasa emir girişini iptal ediniz (ClOrdID=4) CFAN pazarında 1215S0 sözleşmesine girmiş olduğunuz 200 adetlik 44 fiyat seviyesindeki seanslık alış limit emri iptal ediniz (ClOrdID=8 Bu iptal işlemi Sıra No=15 olan adımda yapılan işlem sonucunda oluşan nolu yeni emre uygulanmalıdır) CFAN pazarında 1215S0 sözleşmesine girmiş olduğunuz 1000 adetlik 47 fiyat seviyesindeki seanslık satış limit emri iptal ediniz (ClOrdID=11) CFAN pazarında 1215S0 sözleşmesine girmiş olduğunuz 40 adetlik 455 fiyat seviyesindeki günlük limit satış emrini iptal ediniz (ClOrdID=16) nolu (sistemde olmayan bir emir ) alış emrini iptal ediniz MsgType [35] F F F F F OrderID ClOrdID Side SONUÇ News(Sistem Uyarıları) ER(Order Short) News(Sistem Uyarıları) ER(Order Short) News(Sistem Uyarıları) ER(Order Short) OrderCancelReject (ERROR: İptal edilecek emir bulunamadı) OrderCancelReject (ERROR: Geçersiz emir numarası) 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 Senaryo 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) ApplBegSeqNum alanına mevcut en büyük ApplSeqNum değerinden daha büyük bir değer girilerek sistem uyarıları indirme talebinizi gönderiniz BW News(EndOfAlert) NewsCategory alanına 4 değeri (tüm genel yayın mesajları için) girilerek ApplicationMessageRequ est mesajı gönderiniz BW News(Genel Yayın) News(Genel Yayın) News(Genel Yayın) 13

14 Sıra No Senaryo MsgType [35] ApplBegSeqNum [1182] ApplReqID [1346] ApplReqType [1347] NewsCategory [1473] OrderID [37] TrdMatchID [880] Sonuç News(EndOfBC) NewsCategory alanına 5 değeri (tüm sistem uyarıları mesajları için) girilerek ApplicationMessageRequ est mesajı gönderiniz BW 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 News(Sistem Uyarıları) News(Sistem Uyarıları) News(Sistem Uyarıları) News(EndOfAlert) ER(Order Long) ER (Order Long) ER (Order Short) ER (Order Short) News(EndOfOrder) ER(Trade) ER(Trade) News(EndOfTrade) 14

15 34 EMİR DEĞİŞTİRME Aşağıdaki tabloda emir değişikliklerine ilişkin mesajlar yer almaktadır Yeni emir girişi tablosunda yer alan ve ClOrdID bazında sisteme girilen emirler üzerinde değişiklikler yapılacaktır Yapılacak değişikliklerin senaryosunu ve tabloda yer alan değişiklik yapılacak alanları dikkate alarak emir değiştirme mesajlarını giriniz Her bir emir değişiklik girişi sonrasında sonuç kolonunda yer alan beklenen mesajların alındığını kontrol ediniz Sıra No SENARYOLAR MsgType OrderID (37) OrigClOrdID (41) Symbol (55) OrderQty(38) Price(44) Side(54) OrderType(40) TimeInForce(59) PositionEffect(77) SONUÇ S0 sözleşmesine girmiş olduğunuz 10 adetlik 450 fiyat seviyesindeki günlük alış limit emrini geçerli bir veri ile güncelleyiniz (ClOrdID=7) G F_COTE GE1215 S0 * * 1 * * C News(Genel Yayın) ER(Order Long) ER(Order Short) ER(Order Short) S0 sözleşmesine girmiş olduğunuz 10 adetlik 450 fiyat seviyesindeki seanslık alış limit emrini geçerli bir veri ile güncelleyiniz (ClOrdID=6) G F_COTE GE1215 S0 * * 1 * * C News(Genel Yayın) ER(Order Long) ER(Order Short) ER(Order Short) S0 sözleşmesine girmiş olduğunuz 60 adetlik 484 fiyat seviyesindeki KİE satış limit emrini geçerli bir veri ile güncelleyiniz (ClOrdID=10) G F_COTE GE1215 S0 * * 2 * * C OrderCancelReject (ERROR: Emir düzeltilemiyor; emir, açık emir değil) * OrderQty, Price, OrderType veya TimeInForce alanlarından herhangi biri değiştirilerek emir güncellenmelidir 15

16 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 16 sayfalarının ıslak imza ve kaşe, diğer sayfalarının paraf atılarak tarafımıza iletilmesi beklenmektedir 16