VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI SAKLAMACI ÜYE DROP COPY Temmuz 2015, Sürüm 12
DÖKÜMAN TARİHÇESİ Tarih Versiyon Açıklama Kasım 2014 10 İlk sürüm Sözleşmeler production ortamındaki sözleşmelere göre güncellendi Şubat 2015 11 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 2015 12 kaldırıldı 2
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=20140910-07:33:3720556=XXXFIX1128=91=114=037=201508030000000638=10039=040=242=20150 213-07:33:0662644=46554=255=59=060=20150213-07:33:0662677=C150=0151=100381=465000453=2448=XXX452=1448=XXXFM1452=12625 =31181=161300=CFAN1352=Y9757=201508030000000321002=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
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
İçindekiler 1 SİSTEM BAĞLANTI TESTLERİ 6 2 SERTİFİKASYON TEST ORTAMI 8 3 DROP COPY FONKSİYONLARI TESTİ 10 31 TEST ORTAMINDAKİ MEVCUT BİLGİLERİN İNDİRİLMESİ 10 32 POZİSYON SORGUSU 12 33 MESAJ İNDİRME 13 34 BAĞLANTI SIRASINDA GİRİLEN EMİRLER VE OLUŞAN İŞLEMLER 15 5
1 SİSTEM BAĞLANTI TESTLERİ Lütfen Borsa İstanbul BT-Destek i (Tel: 212-298 24 27) 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 Qq123456 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
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
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 1 2 3 4 5 Ü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 10 45 1 2 S 1 D CFAN 500 46 2 2 S 1 D CFAN 100 465 2 2 S 1 Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] 4 8
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 10 45 2 2 0 1 D CFAN 100 1 1 1 1 G CFAN 100 465 2 2 0 1 F Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] CFAN 500 46 2 2 S 1 D CFAN 100 43 1 2 0 4 D CFAN 150 43 1 2 0 1 D CFAN 50 43 1 2 0 1 D CFAN 100 43 1 2 0 4 CFOZ 3000 42 1 ve 2 9
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ç 1 2 3 Emir numarası ve ApplBegSeqNum alanına 0 değeri girerek emir indirme talebinizi gönderiniz BW 0 1 0 0 İşlem numarası ve ApplBegSeqNum alanına 0 değeri girerek işlem indirme talebinizi gönderiniz BW 0 2 0 0 ApplBegSeqNum alanına 0 değeri girerek genel BW 0 3 0 4 ER(Order Long) - 2015080300000001 ER(Order Long) - 2015080300000002 ER(Order Long) - 2015080300000003 ER(Order Long) - 2015080300000005 ER(Order Long) - 2015080300000006 ER(Order Long) - 2015080300000007 ER(Order Long) - 2015080300000008 ER(Order Long) - 2015080300000009 ER(Order Long) - 2015080300000010 ER(Order Long) - 2015080300000011 ER(Order Long) - 2015080300000012 News(EndOfOrder) ER(Trade) - 2015080300000001 ER(Trade) - 2015080300000005 ER(Trade) - 2015080300000002 ER(Trade) - 2015080300000010 ER(Trade) - 2015080300000011 ER(Trade) - 2015080300000013 ER(Trade) - 2015080300000014 News(EndOfTrade) News(Genel Yayın) News(Genel Yayın) 10
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
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ç 4 5 6 Tüm zorunlu alanlar ve hesap no girilerek pozisyon sorgusu yapınız AN 1 1 0 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 14 2 0 Tüm zorunlu alanlar ve üye bilgisi girilerek (ilgili üyeye ait toplam pozisyon için) pozisyon sorgusu yapınız AN 3 0 1 <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
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ç 7 8 9 10 11 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 1000 1 0 İşlem numarası ve ApplBegSeqNum alanına mevcut en büyük ApplSeqNum değerinden daha büyük bir değer girilerek İşlem indirme 20150 80300 00000 1 News(EndOfOrder) talebinizi gönderiniz BW 1000 2 0 1 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 1000 3 0 4 News(EndOfBC) Başka bir üyeye ait bir emrin OrderID si ile emir indirme talebi gönderiniz BW 1 5 0 NewsCategory alanına 4 değeri (tüm genel yayın mesajları için) girilerek ApplicationMessageRequ est mesajı gönderiniz BW 0 6 0 4 20150 80300 00000 4 News(EndOfOrder) News(Genel Yayın) News(Genel Yayın) News(Genel Yayın) News(EndOfBC) 13
Sıra No MsgType [35] ApplBegSeqNum [1182] ApplReqID [1346] ApplReqType [1347] NewsCategory [1473] OrderID [37] TrdMatchID [880] Sonuç 12 13 14 NewsCategory alanına 5 değeri (tüm sistem uyarıları mesajları için) girilerek ApplicationMessageRequ est mesajı gönderiniz BW 0 7 0 5 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 0 8 0 20150 80300 00000 1 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 0 9 0 1 ER(Order Long) ER (Order Long) ER (Order Short) ER (Order Short) News(EndOfOrder) ER(Trade) ER(Trade) News(EndOfTrade) 14
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: 212-298 24 27) 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 15 16 17 18 Yeni alış emri girilir ve 2015080300000006 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 2015080300000008, 2015080300000009, 2015080300000012 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 10 47 1 2 S 1 CFAN 500 46 2 2 S 1 CFAN 500 43 2 2 0 1 CFAN 100 1 1 1 1 Sonuç ER(Order Long) - 2015080300000015 2015080300000015 2015080300000006 ER(Trade) - 2015080300000015 ER(Trade) - 2015080300000006 ER(Order Long) - 2015080300000016 2015080300000008 2015080300000009 2015080300000012 ER(Trade) - 2015080300000008 ER(Trade) - 2015080300000009 ER(Trade) - 2015080300000012 ER(Order Long) - 2015080300000018 2015080300000018 ER(Trade) - 15
Sıra No MsgType [35] Symbol [55] Market SegmentID [1300] OrderQty [38] Price [44] Side [54] OrderType [40] TimeInForce [59] Account [1] Sonuç 2015080300000018 19 20 21 22 2015080300000016 nolu emir değiştirilir (AAA üyesi için) 2015080300000019 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 500 465 2 2 0 1 CFAN 500 46 2 2 S 1 CFAN 100 43 1 2 0 4 ER(Order Long) - 2015080300000019 2015080300000016 2015080300000019 2015080300000019 ER(Order Long) - 2015080300000020 2015080300000020 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 17 sayfalarının ıslak imza ve kaşe, diğer sayfalarının paraf atılarak tarafımıza iletilmesi beklenmektedir 17