Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 1 -
Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 2 -
1. CONNACT nedir?... 5 2. İLETİŞİM YAPISI... 6 <host_adresi>... 6 3. MESAJ TİPLERİ... 9 3.1 Ürün Kategorileri... 9 3.2 Ürün Kataloğu... 11 Örnek Ürün Kataloğu... 13 3.3 Stok Sorgulama... 13 3.4 Fiyat listesi... 14 Örnek Fiyat Listesi... 15 3.5 On-line Fiyat ve Stok sorgulama... 15 Örnek Stok ve Fiyat sorgulaması... 17 3.6 On-line sipariş... 19 Örnek Sipariş... 21 3.7 Bloke Ürün Listesi... 22 3.8 Online Sipariş Sorgulama... 22 3.9 Online Sipariş Detay Sorgulama... 25 3.10 Online Arızalı Ürün Sorgulama... 28 3.11 PAYNET İşlemleri... 30 3.5.1. PAYNET Sistemi Webservis Tanımı... 30 3.5.2. PAYNET Sistemi Webservis Sınıfları... 31 AuthenticationInfo... 31 xactparam... 31 xactresult... 32 bank... 32 agentbankdetail... 32 instalmentitem... 32 bankinstalmentitem... 33 bankinstalmentcollection... 33 xactitem... 33 xactdetail... 33 NameValue... 34 iodeme... 34 campaignitem... 34 campaignratio... 34 campaigndetail... 34 koiqueryparam... 35 koiinfo... 35 koiqueryresult... 35 koisalesparam... 35 3.5.3. PAYNET Sistemi Webservis Metodları... 36 Sales... 36 Reversal... 36 GetBankList... 36 GetBankDetails... 36 GetInstalmentOptions... 36 GetTransactionList... 36 Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 3 -
GetTransactionDetail... 37 Paynet Vadaa Metodları... 37 koiquery... 37 koisales... 37 EK A... 38 A.1 HATA YAKALAMA... 38 A.2 Paynet ve Connact Entegrasyonu İpuçları... 39 A.3 CONNACT Entegrasyon Formu... 43 Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 4 -
1. CONNACT nedir? CONNACT e-mağaza işleten bayilere yönelik bir ArenaOpen hizmetidir. CONNACT, Arena ile bayi arasındaki bilgi akışının otomasyonunu sağlayarak bayinin stok maliyetini azaltır, bayinin tüketiciye en güncel bilgiyi ve en iyi hizmeti vermesini sağlar. CONNACT, tüm dünyanın Kabul ettiği de-facto standartlar üzerine inşa edilmiştir. XML desteği olan herhangi bir araç ile CONNACT e-mağazaya entegre edilebilir. Ayrıca, bayilerin kendi içlerinde kullandıkları ticari paketler için de bir veri sağlayan bir altyapıdır. CONNACT, bayi ile Arena arasında beş farklı mesaj tipini destekler. i. Ürün kataloğu ii. Stok Sorgulama iii. Ürün Kategorileri iv. Fiyat listesi v. Fiyat ve Stok Sorgulaması vi. Bloke ürünler vii. Sipariş viii. Sipariş sorgulama ix. Arızalı Ürün Sorgulama x. PAYNET işlemleri Ürün kataloğu: Arena uzman kadrosu ile, sektördeki teknolojik gelişmeleri takip ederek ürün kataloğunu güncel tutar, ürünleri sınıflandırır, tüketicinin satın alma kararı vermeden önce bilmek istediği ürün özelliklerini veri tabanına kaydeder. Bayi, CONNACT kullanarak Arena nın ürün kataloğunu kendi veri tabanına aktarabilir. Bloke ürünler listesi ile de katalogdan çıkarılan ürünlerin listesi alınabilir. Ürün Kategorileri: Arena nın kendi ürün yapısı için belirlediği ürün kategori, alt kategorileri ve marka bilgilerini içerir. Fiyat listesi: Bayinin seçtiği ürünler için güncel fiyatları ile fiyat listesini verir. CONNACT, bayinin en güncel fiyatlara ulaşmasını sağlayarak bayiye rekabet avantajı kazandırır. Fiyat listesi, hem alış fiyatını, hem de piyasadaki perakende satış fiyatını içerir. Fiyat ve Stok sorgulaması: Sorguya gönderilen ürünler bazında anlık fiyat ve stok sorgusunun cevabını verir. Bayi, son kullanıcının siparişini onaylamadan önce, ürünün Arena da olup olmadığını anlık olarak, kendi fiyat seviyesindeki fiyatını ve teslim tarihini sorgulanabilir. Sipariş: Arena ya online sipariş verebilmek için kullanılan mesaj tipidir. Bayi, son kullanıcının siparişini onayladıktan sonra, bu siparişi kendi seçeceği bir referans numarası ile Arena ya on-line yollayabilir. Ayrıca, siparişin doğrudan başka bir adrese ulaştırılması için malı teslim alan bilgisini de bu mesajda gönderilebilir. Sipariş Sorgulama: Daha önce verilmiş siparişlerin durumu ve detaylarını alabilmek için hazırlanan bir servistir. Sipariş faturalanmamış ise olası çıkış tarihleri, faturalanmış ise de fatura kesim tarihi bu servisten alınabilir. Arızalı Ürün Sorgulama: Teknik Servise verilmiş ürünleriniz için size bir form numarası verilir. Bu form numarası ile Teknik serviste bekleyen veya teslim aşamasına gelen ürünlerinizin durumunu öğrenebilirsiniz. PAYNET işlemleri : PAYNET sistemi, Arena Bilgisayar A.Ş. nin, bayilerine artı değer olarak sunduğu bir online ödeme sistemidir. Bayilerin kendi Sanal POS üyelikleri kullanılarak işlem yaılan PAYNET te, sistemin normal bir POS cihazı gibi satış ve satış iptal işlemlerini yapması öngörülmektedir. CONNACT için PAYNET işlemi ile bayilerin Sanal POS altyapısı kurmadan kendi siteleri veya arayüzleri üzerinden online kredi kartı işlemi yapmasına olanak sağlanacaktır. CONNACT un stok sorgulama ve sipariş mesajları stok tutma gereksinimini azaltır, Arena nın stoğunu kendi stoğu gibi satma imkanı verir. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 5 -
Şekil-1: Arena ile e-mağaza arasındaki bilgi alışverişi 2. İLETİŞİM YAPISI CONNACT, XML dosyalarını taşımak için http protokolünü kullanır. Örneklerde <host adresi> olarak belirtilen bölüm ile ilgili bilgi aşağıdadır. <host_adresi> Canlı sistem : http://webservice.arenaopen.com/sondaweb/ Test sistemi : http://connacttest.arenaopen.com/ Not : on-line sipariş işlemi test ortamında SSL kullanmamaktadır. Ayrıca yukarıda belirtilen (kök dizin) adreslere doğrudan erişilmeye çalışılmamalıdır, bunun yerine aşağıda belirtildiği gibi adresin sonuna mutlaka ilgili sayfa adı ve gerekli xml bilgisi uygun formatta eklenerek işlem yapılmalıdır. Örnek olarak, Fiyat ve Stok sorgulaması yapmak için yollanan sorgulama ve bu sorgulamaya gelen cevap aşağıdadır. Sorgu: http://<host_adresi>/basket.aspx?data=<?xml%20version="1.0"%20encoding="utf- 8"?><PRS><PRO><PI>51645A</PI><PQ>3000</PQ></PRO><PRO><PI>260-09- 03</PI><PQ>3</PQ></PRO></PRS> Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 6 -
Cevap : <?xml version='1.0' encod_ng='utf-8'?> <PBI> <PB> <IN>20</IN> <SN>0</SN> <PI>260-09-03</PI> <PQ>3</PQ> <DD>16.08.2005 17:30</DD> <UP>88</UP> <CU>USD</CU> <TR>18</TR> <AV>1</AV> </PB> <PB> <IN>30</IN> <SN>0</SN> <PI>51645A</PI> <PQ>3000</PQ> <DD>01.01.0001 00:00</DD> <UP>0</UP> <CU></CU> <TR>0</TR> <AV>0</AV> </PB> </PBI> TABLO-1: Örnek Fiyat Ve Stok Sorgulaması XML i Sorgulamaları CONNACT ya yollamak ve gelen cevapları işlemek için XML desteği olan herhangi bir e-ticaret aracı veya ActiveX desteği olan herhangi bir programlama dili kullanılabilir. ( Lütfen kendi programınızı yazmaya başlamadan önce dökümanın sonunda yer alan A2 Paynet ve Connact Entegrasyon İpuçları nı dikkatle okuyunuz). Örneğin Arena ya on-line Fiyat ve Stok sorgulaması yollamak ve gelen cevabı işlemek için ASP 3.0 da aşağıdaki gibi bir rutin yazılır. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 7 -
Const strurl = http://localhost/sondaweb/basket.aspx?data=<?xml version='1.0' encoding='utf-8'?><prs><pro><pi>51645a</pi><pq>3000</pq></pro><pro><pi>260-09-03</pi><pq>3</pq></pro></prs> Dim objxmldoc Set objxmldoc = Server.CreateObject("MSXML2.DOMDocument.4.0") 'Set Properties objxmldoc.async = False objxmldoc.validateonparse = False objxmldoc.resolveexternals = False 'loading over HTTP from a remote server objxmldoc.setproperty "ServerHTTPRequest", True If objxmldoc.load(strurl) Then Dim PBINodes Set PBINodes = objxmldoc.selectnodes("/pbi/pb") Response.Write "<b>sepet</b>" 'For each PB node Dim PBNode Response.Write("<table border='1'>") For Each PBNode in PBINodes With Response.Write "<tr>".write "<td>" & PBNode.selectSingleNode("IN").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("SN").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("PI").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("PQ").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("DD").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("UP").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("CU").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("TR").nodeTypedValue & "</td>".write "<td>" & PBNode.selectSingleNode("AV").nodeTypedValue & "</td>".write "</tr>" End With Next Response.Write("<table>") Else Response.Write "Error: " & objxmldoc.parseerror.reason End If TABLO 2: Örnek kod Hafızası yeterli olmayan bir bilgisayarda büyük XML dosyalarını browser ile açmak zaman alabilir. XML dosyasını Save as... komutu ile diskinize kaydetmek istediğinizde, URL in sonuna SaveToFile=true parametresini eklemeniz size zaman kazandırır. Örnek: http://<host_adres>/productcatalog.aspx?savetofile=true SaveToFile parametresini tanıyan fonksiyonlar. Ürün kataloğu Ürün Kategorileri Fiyat listesi Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 8 -
3. MESAJ TİPLERİ Ürün Kategorileri Arena daki ürünlerin ürün kategorilerini çekmek için CONNACT a aşağıdaki sorgulama yollanmalıdır. Ürün kategorileri her an değişmekte olmayıp, ürün kategorilerinin günde 1 kez çekilmesi yeterli olacaktır. http://<host_adres>/productcategories.aspx Bu sorgu sonucunda dönen cevap şu şekilde olacaktır: <?xml version="1.0" encoding="utf-8"?> <PRODUCTCATEGORIES xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns="http:// <host_adres>/productcategories.xsd"> <L1CATEGORIES> <L1CATEGORY> <ID>ADP</ID> <D>Bağlantı Ürünleri</D> </L1CATEGORY> <L1CATEGORY> <ID>HBY</ID> <D>Hobi / Oyun Ürünleri</D> </L1CATEGORY> </L1CATEGORIES> <L2CATEGORIES> <L2CATEGORY> <ID>ADPCAB </ID> <D>Kablolar</D> </L2CATEGORY> <L2CATEGORY> <ID>ADPCABCSA</ID> <D>Kasa kabloları</d> </L2CATEGORY> </L2CATEGORIES> <BRANDS> <BR> <ID>3COM</ID> <D>3COM</D> </BR> <BR> <ID>3M</ID> <D>3M</D> </BR> </BRANDS> </PRODUCTCATEGORIES> L1CATEGORIES : Kategoriler L2CATEGORIES : Alt Kategoriler BRANDS : Markalar Kategoriler 3 karakter uzunlugundadır. Alt kategoriler 6 karakter uzunlugunda olup ilk 3 karakter bağlı olduğu kategoriyi belirtir, 3 kırılımlı ürünlerde alt kategoriler 9 karakter uzunluğundadır, ilk 6 karakter bağlı olduğu alt kategoriyi belirtir. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 9 -
Gelen cevaba ait XML Schema aşağıda verilmiştir. Bu Schema ya http://<host_adres>/productcategories.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="productcategories" targetnamespace=" http://<host_adres>/productcategories.xsd" elementformdefault="qualified" xmlns="http://tempuri.org/productcategories.xsd" xmlns:mstns="http://tempuri.org/productcategories.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="productcategories"> <xs:complextype> <xs:element name="l1categories" type="l1type" /> <xs:element name="l2categories" type="l2type" /> <xs:element name="brands" type="btype" /> </xs:element> <xs:complextype name="l1type"> <xs:element name="l1category" maxoccurs="unbounded" type="categorytype" /> <xs:complextype name="l2type"> <xs:element name="l2category" maxoccurs="unbounded" type="categorytype" /> <xs:complextype name="btype"> <xs:element name="br" maxoccurs="unbounded" type="categorytype" /> <xs:complextype name="categorytype"> <xs:element name="id" type="xs:string" /> <xs:element name="d" type="xs:string" /> </xs:schema> Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 10 -
Ürün Kataloğu Ürün kataloğunu çekmek için CONNACT a aşağıdaki sorgulama yollanmalıdır. http://<host_adres>/productcatalog.aspx Ürün kataloğuna ait XML Schemas aşağıda verilmiştir. Bu Schema ya http://<host_adres>/productcatalogschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. PRODUCT kısmında ürünler yer alır. Ürünlerle ilgili sahalar aşağıdadır: ID: Üreticinin kullandığı stok kodu D1: Ürün açıklamasının ilk satırı (kısa açıklama) D2: Ürün açıklamasının diğer satırları (detay açıklama) L1: Ana grup kodu. Ana grup kodunun açıklaması L1CATEGORIES kısmındadır. L2: Alt grup kodu. Alt grup kodunun açıklaması L2CATEGORIES kısmındadır. BR: Marka KDV: KDV oranı IMG: Ürüne ait resim dosyasının yolu (ftp://... veya http://... ile başlar) EAN: Ürüne ait EAN kodu. ATP: Ürün Stok Bilgisi. Alabilecegi degerler: 50+,10+,5+,1,2,3,4,1H,2H,3H,1A H : Hafta A: Ay anlamındadır DM3: Ürünün kaç desimetreküp yer kapladığı Ürünün herbir özelliği için ayrı bir S düğümü yer alır. L: Özelliğin adı. Örneğin CPU Hızı V: Özelliğin değeri. Örneğin 800 Mhz Ürün kataloğu günde bir kez çekilmelidir. Bu dosya çok büyük olduğundan, ürün kataloğunun aynı gün ikinci kez çekilmesine izin verilmeyecektir. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 11 -
<?xml version="1.0" encoding="utf-8"?> <xs:schema id="productcatalogschema" targetnamespace="http://<host_adres>/productcatalogschema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/productcatalogschema.xsd" xmlns:mstns="http://<host_adres>/productcatalogschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="productcatalog"> <xs:complextype> <xs:element name="product" type="catalogtype" minoccurs="1" maxoccurs="unbounded" /> </xs:element> <xs:complextype name="catalogtype"> <xs:element name="id" type="xs:string" ></xs:element> <xs:element name="d1" type="xs:string" ></xs:element> <xs:element name="d2" type="xs:string" ></xs:element> <xs:element name="l1" type="xs:string" ></xs:element> <xs:element name="l2" type="xs:string" ></xs:element> <xs:element name="br" type="xs:string" ></xs:element> <xs:element name="kdv" type="xs:string" ></xs:element> <xs:element name="img" type="xs:string" ></xs:element> <xs:element name="ean" type="xs:string" ></xs:element> <xs:element name="atp" type="xs:string" ></xs:element> <xs:element name="dm3" type="xs:string" ></xs:element> <xs:element name="s" type="texttype" minoccurs="0" maxoccurs="unbounded"></xs:element> <xs:complextype name="texttype"> <xs:element name="l" type="xs:string"></xs:element> <xs:element name="v" type="xs:string"></xs:element> </xs:schema> TABLO-3: ProductCatalogSchema.xsd Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 12 -
Örnek Ürün Kataloğu <?xml version="1.0" encoding="utf-8"?> <PRODUCTCATALOG xmlns="http://<host_adres>/productcatalogschema.xsd"> <PRODUCT> <ID>000000000000001011</ID> <D1>KAS EVEREST MIDDLE TOWER SİYAH 350W USB</D1> <D2>sürücü yuvası, 2 x 3.5" disket sürücü yuvası, 5 x 3.5" HDD yuvası, 2 fanı, 7 genişleme slotu, ön, arka ve yanlarda fan yuvası, ön panelde USB, mikrofon ve kulaklık çıkışlarıyla son derece şık bir kasa.</d2> <L1>OEM</L1> <L2>OEMCAS</L2> <BR>EVEREST</BR> <KDV>18</KDV> <IMG>http://kurumsal.arena.com.tr/urun_resimleri/image.asp?dir= standart&matnr=000000000000001011&prodh=" </IMG> <EAN>1011</EAN> <ATP>0</ATP> <DM3>30</DM3> <S> <L>Renk</L> <V>SIYAH</V> </S> <S> <L>Fan Eklenebilme Özelliği</L> <V>VAR</V> </S> </PRODUCT> [...] </PRODUCTCATALOG> TABLO 4: Örnek Ürün Kataloğu Stok Sorgulama Ürün kataloğu ile birlikte stok bilgileri de gönderilmektedir. Ancak gün içinde tekrar ve güncel stok listesini çekmek için CONNACT a aşağıdaki sorgulama kullanılmalıdır. http://<host_adres>/productstocks.aspx. Saat 11:00 ve 14:00 de xml in güncel halini çekebilirsiniz. Dönen cevap şu şekilde olacaktır; <?xml version="1.0" encoding="utf-8"?> <PRODUCTSTOCKS> <PR> <ID>2481</ID> <ATP>5+</ATP> </PR> <PR> <ID>2490</ID> <ATP>2</ATP> </PR> Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 13 -
... </PRODUCTSTOCKS> Sahaların açıklaması: ID: Ürün kodu ATP: Ürün Stok Bilgisi. Alabilecegi degerler: 50+,10+,5+,1,2,3,4,1H,2H,3H,1A H : Hafta A: Ay Fiyat listesi Fiyat listesini çekmek için CONNACT a aşağıdaki sorgulama yollanmalıdır. http://<host_adres>/pricelist.aspx CONNACT bu sorgulama ile bayiye standart fiyatları gösterir. Fiyat Listesine ait XML Schemas aşağıda verilmiştir. Bu Schema ya http://<host_adres>/pricelistschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="pricelistschema" targetnamespace="http://<host_adres>/sonda/pricelistschema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/sonda/pricelistschema.xsd" xmlns:mstns=" http://www.arenab2b.com/sonda/pricelistschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="pricelist"> <xs:complextype> <xs:element name="product" type="producttype" maxoccurs="unbounded" /> </xs:element> <xs:complextype name="producttype"> <xs:element name="id" type="xs:string" /> <xs:element name="pp" type="xs:decimal" /> <xs:element name="ep" type="xs:decimal" /> <xs:element name="cu" type="xs:string" /> </xs:schema> Sahaların açıklaması aşağıdadır. ID: Üreticinin kullandığı stok kodu PP: Bayi fiyatı EP: Son kullanıcı fiyatı CU: Para birimi (USD, DEM veya TRL) Fiyat listesinin günde bir kez çekilmesi yeterlidir. TABLO 5: PriceListSchema.xsd Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 14 -
Örnek Fiyat Listesi <?xml version="1.0" encoding="utf-8"?> <PRICELIST xmlns="http://<host_adres>/pricelistschema.xsd"> <PRODUCT> <ID>32480</ID> <PP>133.1600</PP> <EP>159.3300</EP> <CU>USD</CU> </PRODUCT> <PRODUCT> <ID>32645</ID> <PP>102.0300</PP> <EP>122.0700</EP> <CU>USD</CU> </PRODUCT> [... ] </ PRICELIST> TABLO 6: Örnek Fiyat Listesi On-line Fiyat ve Stok sorgulama On-line fiyat ve stok sorgulaması gerçekleştirmek için CONNACT a aşağıdaki sorgulama yollanmalıdır. http://<host_adres>/basket.aspx?data=<xmldata> HTTP POST ve HTTP GET methodlarını destekler. Fiyat ve stok sorgulaması yapacagınız ürünlerin kodlarını ve miktarlarını xml data olarak göndermeniz gerekiyor. Bir seferde gönderilecek ürün sayısı 20 adedi geçmemelidir. Gönderceginiz xml data nın ( <XMLdata> ) Scheması Aşagıdadır. Bu Schema ya http://<host_adres>/productsschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz <?xml version="1.0" encoding="utf-8"?> <xs:schema id="productsschema" targetnamespace="http://<host_adres>/productsschema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/productsschema.xsd" xmlns:mstns="http://<host_adres>/productsschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="prs"> <xs:complextype> <xs:element name="pro" type="itemtype" maxoccurs="20" /> </xs:element> <xs:complextype name="itemtype"> <xs:element name="pi" type="xs:string" /> <xs:element name="pq" type="xs:int" /> </xs:schema> TABLO 7: ProductsSchema.xsd Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 15 -
Sahaların açıklaması aşağıdadır: PI : Ürün Kodu PQ: Ürün Miktarı Gelen cevaba ait XML Schema aşağıda verilmiştir. Bu Schema ya http://<host_adres>/productbasketschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="productbasketschema" targetnamespace="http://<host_adres>/productbasketschema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/productbasketschema.xsd" xmlns:mstns="http://<host_adres>/productbasketschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="pbi"> <xs:complextype> <xs:element name="pb" type="baskettype" minoccurs="0" maxoccurs="21" /> </xs:element> <xs:complextype name="baskettype"> <xs:element name="in" type="xs:int" /> <xs:element name="sn" type="xs:int" /> <xs:element name="pi" type="xs:int" /> <xs:element name="pq" type="xs:int" /> <xs:element name="dd" type="xs:date" /> <xs:element name="up" type="xs:decimal" /> <xs:element name="cu" type="xs:string" /> <xs:element name="tr" type="xs:decimal" /> <xs:element name="av" type="xs:int" /> Sahaların açıklaması aşağıdadır: TABLO 7: ProductBasketSchema.xsd IN : Kalem Numarası SN: Üst Kalem Numarası. Eger Ürün Bundle ise baglı oldugu ürünün IN (Kalem Numarası) nı gösterir. Eger Ürün Bundle degil ise degeri 0 dır. PI: Ürün Kodu PQ: Ürün Miktarı DD: PQ alanında Belirtilen Miktarın Teslim Tarihi UP: Ürünün Birim Fiyatı CU: Para Birimi TR: KDV Oranı AV: Eğer belirtilen miktarı karşılayacak kadar stok Arena da mevcut ise AV(availability) sahasında 1 değeri gönderilir. Aksi halde 0 değeri gönderilir. Ürün Bundle ürün ise AV alanı 0 döner. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 16 -
Örnek Stok ve Fiyat sorgulaması Örneğin 51645A dan 3000 adet ve 260-09-03 den 2 adet olacak sekilde fiyat ve stok sorgulaması yapmak istiyorsunuz. Bunun için gondermeniz gereken xml şu şekilde olmalıdır. <?xml version="1.0" encoding="utf-8"?> <PRS> <PRO> <PI>51645A</PI> <PQ>3000</PQ> </PRO> <PRO> <PI>260-09-03</PI> <PQ>3</PQ> </PRO> </PRS> TABLO 8: Örnek Stok ve Fiyat Sorgulaması HTTP GET Methodu ile şu şekilde sorgu yapabiliriz: http://<host_adres>/basket.aspx?data=<?xml version="1.0"encoding="utf- 8"?><PRS><PRO><PI>51645A</PI><PQ>3000</PQ></PRO><PRO><PI>260-09- 03</PI><PQ>3</PQ></PRO></PRS> Bu sorgulama sonucunda dönen cevap TABLO-9 daki gibi olacaktır: Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 17 -
<?xml version='1.0' encoding='utf-8'?> <PBI> <PB> <IN>20</IN> <SN>0</SN> <PI>260-09-03</PI> <PQ>3</PQ> <DD>16.08.2005 17:30</DD> <UP>88</UP> <CU>USD</CU> <TR>18</TR> <AV>1</AV> </PB> <PB> <IN>30</IN> <SN>0</SN> <PI>51645A</PI> <PQ>3000</PQ> <DD>01.01.0001 00:00</DD> <UP>0</UP> <CU></CU> <TR>0</TR> <AV>0</AV> </PB> <PB> <IN>30</IN> <SN>20</SN> <PI>260-09-03</PI> <PQ>0</PQ> <DD>16.08.2005 17:30</DD> <UP>0</UP> <CU>USD</CU> <TR>18</TR> <AV>0</AV> </PB> <PB> <IN>40</IN> <SN>20</SN> <PI>ART18CX</PI> <PQ>0</PQ> <DD>16.08.2005 17:30</DD> <UP>0</UP> <CU>USD</CU> <TR>18</TR> <AV>0</AV> </PB> </PBI> TABLO 9: Örnek Stok ve Fiyat Sorgulaması Cevabı Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 18 -
On-line sipariş On-line sipariş sorgulaması gerçekleştirmek için CONNACT a aşağıdaki sorgulama yollanmalıdır. Burada dikkat edilmesi gereken order.aspx SSL kullanıyor bu yüzden https ile sorgu göndermeniz gerekiyor. https://<host_adres>/order.aspx?data=<xmldata> HTTP POST ve HTTP GET methodlarını destekler. Sipariş vereceginiz ürünlerin ürünlerin kodlarını, miktarlarını, Teslimat adresini ve Referans numarasını xml data olarak göndermeniz gerekiyor. Gönderceginiz xml data nın ( <XMLdata> ) Scheması Aşagıdadır. Bu Schema ya http://<host_adres>/ordershchema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="ordershchema" targetnamespace="http://<host_adres>/ordershchema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/ordershchema.xsd" xmlns:mstns="http://<host_adres>/ordershchema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="order"> <xs:complextype> <xs:element name="rn" type="xs:string" /> <xs:element name="st" type="shiptotype"></xs:element> <xs:element name="pb" type="itemstype" ></xs:element> </xs:element> <xs:complextype name="shiptotype"> <xs:element name="id" type="xs:string" nillable="true"></xs:element> <xs:element name="a1" type="xs:string" nillable="true"></xs:element> <xs:element name="a2" type="xs:string" nillable="true"></xs:element> <xs:element name="a3" type="xs:string" nillable="true"></xs:element> <xs:element name="ct" type="xs:string" nillable="true"></xs:element> <xs:element name="db" type="xs:string" nillable="true"></xs:element> <xs:element name="nm" type="xs:string" nillable="true"></xs:element> <xs:complextype name="itemstype"> <xs:element name="pro" type="itemtype" minoccurs="1" maxoccurs="21"></xs:element> <xs:complextype name="itemtype"> <xs:element name="pi" type="xs:string" /> <xs:element name="pq" type="xs:int" /> </xs:schema> TABLE 10 : OrderSchema.xsd Sahaların Açıklamaları: RN: Referans ARENA nın faturasına basılır. Bayinin referans olarak, kendi sistemindeki satınalma Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 19 -
siparişinin numarasını yollaması tavsiye edilir. Referans, en fazla 14 alfasayısal karakterden oluşur. ST : Siparişin teslim adresi. Teslim adresi olarak bayi kendi şubesinin kodunu verebilir, yada 3.tarafa sevk edebilirler. Eğer teslim adresi bayinin kendi şubesi ise id alanına şube kodunu girmesi yeterlidir. Eğer 3.tarafa sevk yapılacak ise ID alanın boş bırakılıp adres bilgileri girilmelidir. ST düğümünün saha açıklamaları şu şekildedir. ID: Bayinin şube kodu A1: Adres 1 alanı A2: Adres 2 alanı A3: Adres 3 alanı CT: İl adı (Adana,İstanbul) DB: Siparişi teslim alan bilgisi NM: Gönderilen kişinin adı PB : Şipariş Verilmek istenilen Ürünlerin Listesini Tutan Düğüm PI : Ürün Kodu PQ: Ürün Miktarı Gelen cevaba ait XML Schema aşağıda verilmiştir. Bu Schema ya http://<host_adres>/orderconfirmationschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="orderconfirmationschema" targetnamespace="http://<host_adres>/orderconfirmationschema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/orderconfirmationschema.xsd" xmlns:mstns="http://<host_adres>/orderconfirmationschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="oc"> <xs:complextype> <xs:element name="os" type="xs:string" /> <xs:element name="om" type="xs:string" nillable="true"></xs:element> <xs:element name="on" type="xs:string" nillable="true"></xs:element> </xs:element> </xs:schema> Sahaların Açıklamaları: TABLE 10: OrderConfirmationSchema.xsd OS: Sipariş Verme İşleminin Durumu Degerleri OK veya ERROR. OM: OS Alanın Degeri ERROR ise Bu Alanda Hatayı Açıklayan Mesaj Dönderilir. ON: OS Alanın Değeri OK ise oluşan siparişin Arena nın sistemindeki numarasıdır. Bayinin bu numarayı kendi veri tabanında saklaması tavsiye edilir. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 20 -
Örnek Sipariş <?xml version="1.0" encoding="utf-8"?> <ORDER> <RN>99990101</RN> <ST> <ID>5355</ID> </ST> <PB> <PRO> <PI>260-09-03</PI> <PQ>3</PQ> </PRO> </PB> </ORDER> TABLE 11: Örnek Sipariş http://<host_adres>/order.aspx?data= <?xml version="1.0" encoding="utf-8"?><order><rn>99990101</rn><st><id>5355</id></st><pb><pro><pi>260-09- 03</PI><PQ>3</PQ></PRO></PB></ORDER> 3.trarafa Sevk Etmek için şu şekilde bir XML yapısı gönderilmelidir: <?xml version="1.0" encoding="utf-8"?> <ORDER> <RN>99990101</RN> <ST> <A1>ISTANBUL CAD NO:96</A1> <A2>KEMERBURGAZ</A2> <A3>EYUP</A3> <CT>34</CT> <DB>AYŞE BAYRK</DB> <NM>AHMET BAYRAK</NM> </ST> <PB> <PRO> <PI>260-09-03</PI> <PQ>3</PQ> </PRO> </PB> </ORDER> TABLE 12: 3. Tarafa sevk edilen Örnek Sipariş Bu sorgular sonucunda dönen cevap şu şekilde olacaktır: <?xml version='1.0' encoding='utf-8'?> <OC> <OS>OK</OS> <ON>0001430660</ON> </OC> TABLE 13: Örnek Sipariş Sonucu Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 21 -
Bloke Ürün Listesi Bloke Ürün Listesi Arena Bilgisayar A.S. tarafından artık şatışı yapılmayacak ürünleri içerir. Bu fonksiyon Belirtilen tarih aralığında bloke edilen ürünlerin listesini döndürür. Sorguyu Tarih aralığı belirterek çekebilirsiniz. Tarih aralığı belirtilmediği zaman o gün bloke edilen ürünleri döndürür. http://<host_adres>/blockedproducts.aspx?date1=<tarihbaslangıç>&date2=<tarihson> tarih formatı DD.MM.YYYY şeklinde olmalıdır. Örnek Sorgu : http://webservice.arenaopen.com/sondaweb/blockedproducts.aspx?date1=19.02.2006&date2=20.02.2006 yukarıdaki sorgu 19.02.2006 ile 20.02.2006 tarihleri arasında bloke edilmiş ürünleri döndürür. <?xml version="1.0"?> <BP> <AV>True</AV> <PRS> <PRO> <PI>ST_3200826A</PI> <BD>2006-02-20</BD> </PRO> <PRO> <PI>ST_3160212A</PI> <BD>2006-02-20</BD> </PRO> </ PRS > </ BP > Sahaların Açıklamaları: AV : Bloke Ürün Olup Olmadığını gösterir. Bu alan True ise Belirtilen Tarihlerde Bloke Ürün mevcut demektir ve <PRS> kırılımı içerisinde bloke ürünleri döndürür. PRS : Kırılımı içimde birden fazla PRO kırılımı olabilir. PI : Bloke edilen ürünün kodu. BD : Bloke edilme tarihi. Online Sipariş Sorgulama On-line sipariş sorgulaması gerçekleştirmek için CONNACT a aşağıdaki sorgulama yollanmalıdır. Burada dikkat edilmesi gereken order.aspx SSL kullanıyor bu yüzden https ile sorgu göndermeniz gerekiyor. https://<host_adres>/orderlist.aspx?data=<xmldata> HTTP GET Methodu ile şu şekilde sorgu yapabiliriz: Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 22 -
https://<host_adres>/orderlist.aspx?data= <?xml version="1.0" encoding="utf- 8"?><ORDERS><OLST><DB>21.07.2005</DB><DE>21.09.2005</DE><SP></SP><LA></LA><ON>< /ON><PN></PN><PID></PID><US></US></OLST></ORDERS> HTTP POST ve HTTP GET methodlarını destekler. Sipariş listesi için parametreleri xml data olarak göndermeniz gerekiyor. Tarih alanları doldurulması zorunlu alanlardır.diğer alanları arama kriterlerinize gore doldurabilir ya da boş bırakabilirsiniz.gönderceginiz xml data nın ( <XMLdata> ) Scheması Aşagıdadır. Bu Schema ya http://<host_adres>/orderlistshchema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="orderlistschema" targetnamespace="http://<host_adres>/orderlistschema.xsd" elementformdefault="qualified" xmlns="http://<host_adres>/orderlistschema.xsd" xmlns:mstns="http://<host_adres>//orderlistschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="orders"> <xs:complextype> <xs:element name="olst" type="itemtypeorders" maxoccurs="1" nillable="true" /> </xs:element> <xs:complextype name="itemtypeorders"> <xs:element name="db" type="xs:datetime" /> <xs:element name="de" type="xs:datetime" /> <xs:element name="sp" type="xs:string" nillable="true"/> <xs:element name="la" type="xs:string" nillable="true"/> <xs:element name="on" type="xs:string" nillable="true"/> <xs:element name="pn" type="xs:string" nillable="true"/> <xs:element name="pid" type="xs:string" nillable="true"/> <xs:element name="usr" type="xs:string" nillable="true"/> </xs:schema> Sahaların Açıklamaları: DB : Başlangıç Tarihi DE : Bitiş Tarihi SP : Sipariş Tipi Tüm siparişler için Müşteri Temsilcisine verilen siparişler için 10 pencere.com Siparişleri için 20 LA : Bütün siparişler için X Açık siparişler için ON : Sipariş Numarası PN : Sepet Adı PID : Ürün Kodu USR : Kullanıcı Adı Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 23 -
Gelen cevaba ait XML Schema aşağıda verilmiştir. Bu Schema ya http://<host_adres>/orderlistconfirmationschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <?xml version="1.0" encoding="utf-8"?> <xs:schema id="orderlistconfirmationschema" targetnamespace=" http://<host_adres>/orderlistconfirmationschema.xsd" elementformdefault="qualified" xmlns="http://tempuri.org/orderlistconfirmationschema.xsd" xmlns:mstns="http://tempuri.org/orderlistconfirmationschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="orders"> <xs:complextype> <xs:element name="item" type="orderconfirmation" /> </xs:element> <xs:complextype name="orderconfirmation"> <xs:element name="sip" type="xs:string" /> <xs:element name="date" type="xs:datetime" nillable="true"/> <xs:element name="sno" type="xs:string" nillable="true"/> <xs:element name="sv" type="xs:string" nillable="true"/> <xs:element name="tdate" type="xs:datetime" nillable="true"/> <xs:element name="st" type="xs:string" nillable="true"/> <xs:element name="sd" type="xs:string" nillable="true"/> </xs:schema> Sahaların Açıklamaları: SIP : Sipariş numarası DATE : Sipariş Tarihi SNO : Sepet Adı/Numarası SV : Kullanıcı adı TDATE : Son Termin Tarih Değişikliği ST : Sipariş tipi SD : Sipariş Durumu Dönen cevap şu şekilde olacaktır; <?xml version="1.0" encoding="utf-8"?> <ORDERS> <ITEM> <SIP>0001430658</SIP> <DATE>28.07.2005</DATE> <SNO>SEPET1</SNO> <SV>KULLANICI</SV> <TDATE>01.01.0001</TDATE> <ST>Standart Sipariş</ST> <SD>Açık</SD> </ITEM>. Versiyon 2.05 Arena Bilgisayar A.Ş. 2007 tüm hakları saklıdır. - 24 -