CONNACT TEKNİK DÖKÜMANI 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 Ü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. 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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 1 -
Şekil-1: Arena, Neticaret ve e-mağaza arasındaki bilgi alışverişi Gün içerisinde web servislerimizi sorgularken uyulması gereken saat aralıkları ve sorgu adetleri aşağıdaki tablodadır. Sorgu Sayısı ve Saat Aralıkları Tablosu Web Servis Adı İşlem Sayısı Başlangıç Saati Bitiş Saati Ürün Kataloğu 1 21:00 09:30 Fiyat Listesi 1 21:00 09:30 Ürün Sınıfları 1 21:00 09:30 Ürün Kategorileri 4 lü 1 21:00 09:30 Ürün Resimleri 1 21:00 09:30 Sipariş Verme 300 00:00 23:59 Bloke Ürün Listesi 2 00:00 23:59 Stok Listesi 24 00:00 23:59 Teknik Servis 50 00:00 23:59 Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 2 -
Sipariş Listesi 50 00:00 23:59 Sepet Görüntüleme 300 00:00 23:59 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://connact.neticaret.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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 3 -
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 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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 4 -
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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 5 -
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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 6 -
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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 7 -
Ü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 adı (Ürün resimlerini yüklemek için lütfen Ürün Resim Yükleme bölümüne bakınız.) 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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 9 -
Örnek Ürün Kataloğu <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>000000000000001011-00.jpg</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; <PRODUCTSTOCKS> <PR> <ID>2481</ID> <ATP>5+</ATP> </PR> <PR> <ID>2490</ID> <ATP>2</ATP> </PR>. Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 10 -
.. </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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 11 -
Ö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 <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 Sahaların açıklaması aşağıdadır: Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 12 -
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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 13 -
Ö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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 14 -
<?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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 15 -
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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 16 -
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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 17 -
Örnek Sipariş <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: <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 18 -
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://connact.neticaret.com/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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 19 -
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. <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 20 -
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. <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; <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 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 21 -
.. </ORDERS> Online Sipariş Detay Sorgulama On-line arızalı ürün 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>/orderdetail.aspx?data=<orderno> HTTP GET Methodu ile şu şekilde sorgu yapabiliriz: https://<host_adres>/orderdetail.aspx?data=0001430658 HTTP POST ve HTTP GET methodlarını destekler. Sipariş detayı için sipariş numarasını göndermeniz gereklidir. Gelen cevaba ait XML Schema aşağıda verilmiştir. Bu Schema ya http://<host_adres>/ OrderDetailConfirmation.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <xs:schema id="orderdetailconfirmation" targetnamespace="http://<host_adres>/orderdetailconfirmation.xsd" elementformdefault="qualified" xmlns="http://tempuri.org/orderdetailconfirmation.xsd" xmlns:mstns="http://tempuri.org/orderdetailconfirmation.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="order"> <xs:complextype> <xs:element name="adres" type="adrestype" /> <xs:element name="detay" type="detaytype" /> <xs:element name="items" type="items" /> </xs:element> <xs:complextype name="orderitemtype"> <xs:element name="itemno" type="xs:string" nillable="true" /> <xs:element name="pid" type="xs:string" nillable="true" /> <xs:element name="desc" type="xs:string" nillable="true" /> <xs:element name="quan" type="xs:string" nillable="true" /> <xs:element name="unit" type="xs:string" nillable="true" /> <xs:element name="untp" type="xs:string" nillable="true" /> <xs:element name="curr" type="xs:string" nillable="true" /> <xs:element name="pymt" type="xs:string" nillable="true" /> <xs:element name="ddt" type="xs:datetime" nillable="true" /> <xs:element name="idt" type="xs:datetime" nillable="true" /> <xs:element name="sit" type="xs:string" nillable="true" /> <xs:complextype name="detaytype"> <xs:element name="ordno" type="xs:string" nillable="true" /> <xs:element name="bno" type="xs:string" nillable="true" /> <xs:element name="odate" type="xs:datetime" nillable="true" /> Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 22 -
<xs:element name="dtyp" type="xs:string" nillable="true" /> <xs:element name="whs" type="xs:string" nillable="true" /> <xs:element name="ptyp" type="xs:string" nillable="true" /> <xs:element name="ordr" type="xs:string" nillable="true" /> <xs:element name="crd" type="xs:string" nillable="true" /> <xs:element name="url" type="xs:string" nillable="true"/> <xs:complextype name="adrestype"> <xs:element name="fatura" type="faturatype" maxoccurs="1" /> <xs:element name="sevkiyat" type="sevkiyattype" maxoccurs="1" /> <xs:complextype name="faturatype"> <xs:element name="name" type="xs:string" nillable="true" /> <xs:element name="adr" type="xs:string" nillable="true" /> <xs:element name="tel" type="xs:string" nillable="true" /> <xs:element name="city" type="xs:string" nillable="true" /> <xs:complextype name="sevkiyattype"> <xs:element name="sadr" type="xs:string" nillable="true" /> <xs:element name="scity" type="xs:string" nillable="true" /> <xs:element name="sname" type="xs:string" nillable="true" /> <xs:element name="stel" type="xs:string" nillable="true" /> <xs:complextype name="items"> <xs:element name="itm" type="orderitemtype" maxoccurs="unbounded" /> </xs:schema> Sahaların açıklaması: ORDER/ADRES/FATURA/ : fatura adresi bilgileri bu sahanın altındadır. ORDER/ADRES/SEVKIYAT/ :sevkiyat adresi bilgileri bu sahanın altındadır. ORDER/DETAY/ : Sipariş bilgileri bu sahanın altındadır. ORDNO : Sipariş numarası. BNO :Sipariş / sepet no. ODATE : Siparişin Alındığı Zaman. DTYP : Teslimat Şekli. WHS : Siparişin Çıkış Yeri. PTYP : Ödeme Şekli. ORDR : Siparişi Veren kişi. CRD : Kredi Kontrol Durumu. URL : Kargo Şirketinden takip için gerekli olan link. ORDER/ITEM/ : Sipariş kalemleri ile bilgiler bu sahanın altındadır. ITEMNO :Kalem Numarası. PID :Ürün Kodu. DESC :Ürün Açıklaması. Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 23 -
QUAN :Ürün Adedi. UNIT :Birim. UNTP :Birim Fiyatı. CURR :Para birimi. PYMT : Ödeme Koşulu. DDT : Olası Sevk Zamanı. IDT : Faturalama Zamanı. Dönen cevap şu şekilde olacaktır; <ORDER> <ADRES> <FATURA> <NAME>EROL GOKCEK</NAME> <ADR>ISTANBUL CADDESI, NO:96 KEMERBURGAZ EYUP</ADR> <TEL>0212 3646575</TEL> <CITY>ISTANBUL</CITY> </FATURA> <SEVKIYAT> <SADR>ISTANBUL CADDESI, NO:96 KEMERBURGAZ EYUP</SADR> <SCITY>ISTANBUL</SCITY> <SNAME>EROL GOKCEK</SNAME> <STEL>0212 3646575</STEL> </SEVKIYAT> </ADRES> <DETAY> <ORDNO>0001430658</ORDNO> <BNO>ıyyggg</BNO> <ODATE>28.07.2005</ODATE> <DTYP>Arena deposunda teslim</dtyp> <WHS>İSTANBUL SATIŞ / PAZARLAMA MRK</WHS> <PTYP>Nakit</PTYP> <ORDR>AYGUL ERGUL</ORDR> <CRD>Kredi onayı verildi</crd> <URL>http://www.yurticikargo.com.tr/02.hizmet/gonderi_takip_pr_ozel_v n.asp?vn=3&ozel_alan=82161339</url> </DETAY> <ITEMS> <ITM> <ITEMNO>10</ITEMNO> <PID>USB-4PORT-SLIM</PID> <DESC>Usb hub 2.0 4 port slim ince tasarım</desc> <QUAN>16</QUAN> <UNIT>ADT</UNIT> <UNTP>0,67</UNTP> <CURR>YTL</CURR> <PYMT>Peşin</PYMT> <DDT>01.01.0001</DDT> <IDT>01.01.0001</IDT> </ITM> <ITM> <ITEMNO>10</ITEMNO> <PID /> <DESC /> <QUAN>16</QUAN> <UNIT>ADT</UNIT> Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 24 -
<UNTP>0</UNTP> <CURR /> <PYMT /> <DDT>28.07.2005</DDT> <IDT>01.01.0001 </IDT> </ITM> </ITEMS> </ORDER> Her item numarası örnektede görüldüğü gibi xml de 1 den fazla gelecektir.birincisi Ürün hakkında bilgileri digerleri ise adet sayısına göre ne zaman faturalandığını gösterir. Online Arızalı Ürün Sorgulama On-line arızalı ürün 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>/techservicelist.aspx?data=<xmldata> HTTP GET Methodu ile şu şekilde sorgu yapabiliriz: https://<host_adres>/techservicelist.aspx?data= <?xml%20version="1.0"%20encoding="utf- 8"?><tech><item><BD>01.07.2005</BD><TD>01.07.2005</TD><FN></FN><PID></PID><SN></S N></item></tech> 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>/techservice.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <xs:schema id="techservice" targetnamespace="http://<host_adres>/techservice.xsd" elementformdefault="qualified" xmlns="http://tempuri.org/techservice.xsd" xmlns:mstns="http://tempuri.org/techservice.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:complextype name="itemtypetech"> <xs:element name="bd" type="xs:datetime" /> <xs:element name="td" type="xs:datetime" /> <xs:element name="fn" type="xs:string" nillable="true"/> <xs:element name="pid" type="xs:string"nillable="true" /> <xs:element name="sn" type="xs:string" nillable="true" /> <xs:element name="tech"> <xs:complextype> <xs:element name="item" type="itemtypetech" /> </xs:element> </xs:schema> Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 25 -
Sahaların Açıklamaları: BD TD FN PID SN : Başlangıç Tarihi : Bitiş Tarihi : Arızalı ürünün form numarası : Arızalı Ürün Kodu : Seri numarası Gelen cevaba ait XML Schema aşağıda verilmiştir. Bu Schema ya http://<host_adres>/techserviceconfirmationschema.xsd adresinden ulaşabilir ve doğrulama yapabilirsiniz. <xs:schema id="techserviceconfirmationschema" targetnamespace="http://<host_adres>/techserviceconfirmationschema.xsd" elementformdefault="qualified" xmlns="http://tempuri.org/techserviceconfirmationschema.xsd" xmlns:mstns="http://tempuri.org/techserviceconfirmationschema.xsd" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="tech"> <xs:complextype> <xs:element name="ts" type="techconfirmtype" /> </xs:element> <xs:complextype name="techconfirmtype"> <xs:element name="pid" type="xs:string" nillable="true"/> <xs:element name="sn" type="xs:string" nillable="true"/> <xs:element name="nb" type="xs:string" nillable="true"/> <xs:element name="sts" type="xs:string" nillable="true"/> <xs:element name="stst" type="xs:string" nillable="true"/> <xs:element name="date" type="xs:datetime" nillable="true"/> <xs:element name="time" type="xs:datetime" nillable="true"/> <xs:element name="pid2" type="xs:string" nillable="true"/> <xs:element name="sn2" type="xs:string" nillable="true"/> <xs:element name="expt" type="xs:string" nillable="true"/> <xs:element name="curr" type="xs:string" nillable="true"></xs:element> </xs:schema> Sahaların Açıklamaları: PID :Ürün Kodu SN :Seri numarası NB :İrsaliye numarası STST :Arızalı ürünün durumu DATE :Tarih TIME :Saat PID2 :Eğer ürün değiştirilmiş ise yeni ürünün kodu SN2 :Eğer ürün değiştirilmiş işe yeni ürünün seri numarası EXTP :Ödenmesi gereken ekstra tutar CURR : Para Birimi Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 26 -
Dönen cevap şu şekilde olacaktır; <TECH> <TS> <PID>KINGSTON-512MB-SD</PID> <SN>ARENA-000000052304</SN> <NB>0110236976</NB> <STST>Müşteriye teslim edildi</stst> <DATE>14.07.2005</DATE> <TIME>26.09.2006 10:32:00</TIME> <PID2>KINGSTON-512MB-SD</PID2> <SN2>ARENA-000000053267</SN2> <EXTP>0</EXTP> <CURR /> </TS>... </TECH> Ürün Resimleri Ürünlere ait resim bilgilerini döner. Aşağıdaki adresten bu xml e ulaşılabilir. http://<host_adres>/productimages.aspx Sahaların Açıklamaları: ID U :Ürün Kodu : Ürün image Dosya adı <ProductImages> <PIMG> <ID>DTI-4GB</ID> <PI> <U>KINGSTON%20DTI%204GB%20copy.jpg</U> <U>Kingston_4GB_Data_Traveller.jpg</U> </PI> </PIMG> <PIMG> <ID>DM4S6B10F-00</ID> <PI> <U>DM4S6B10F-00.jpg</U> </PI> </PIMG>... </ProductImages> Ürün Resim Yükleme Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 27 -
Ürün resimlerini kendi sisteminize yüklemek için aşağıdaki sorguyu göndermeniz gerekmektedir. http://<host_adres>/image.aspx?customerid=<costomerid>&productid=<productid>&imagename=<i magename> Sahaların Açıklamaları: CustomerId ProductId ImageName : Neticaret tarafından verilen bayi kodu : Ürün kodu : Yüklenecek Image dosya adı. Örnek Sorgu: Bir önceki bölümde bulunan örnek XML datasındaki DM4S6B10F-00 kodlu ürüne ait DM4S6B10F- 00.jpg image dosyasını 20161 kodlu bayi için talep eden sorgu örneği: http://connact.neticaret.com/image.aspx?customerid=20161&productid=dm4s6b10f- 00&ImageName=DM4S6B10F-00.jpg Not: Ürün resimleri site adınıza göre watermark basılarak gönderilmektedir. Ürün Kategorileri (Dört Kırılım) Arena daki ürünlerin ürün kategorilerini dört kırılımlı ç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>/productcategories4.aspx Bu sorgu sonucunda dönen cevap şu şekilde olacaktır: <PRODUCTCATEGORIES xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns="http://tempuri.org/productcategories.xsd"> <L1CATEGORIES> <L1CATEGORY> <ID>SOF</ID> <D>Yazılım</D> </L1CATEGORY>... </L1CATEGORIES> <L2CATEGORIES> <L2CATEGORY> <ID>OEMCAB</ID> <D>Kablolar</D> </L2CATEGORY>... </L2CATEGORIES> <L3CATEGORIES> <L3CATEGORY> <ID>OFSSUPINK</ID> <D>Inkjet Kartuşlar</D> </L3CATEGORY>... </L3CATEGORIES> <L4CATEGORIES> <L4CATEGORY> <ID>OEMVGAPCXATI</ID> <D>ATI Chipsetli</D> </L4CATEGORY> Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 28 -
... </L4CATEGORIES> <BRANDS> <BR> <ID>APACHE</ID> <D>APACHE</D> </BR>... </BRANDS> </PRODUCTCATEGORIES> L1CATEGORIES : Birinci Kırılım Kategoriler L2CATEGORIES : İkinci Kırılım Kategoriler L3CATEGORIES : Üçüncü Kırılım Kategoriler L4CATEGORIES : Dördüncü Kırılım Kategoriler BRANDS : Markalar L1CATEGORIES 3 karakter uzunluğundadır. L2CATEGORIES 6 karakter uzunluğundadır, ilk 3 karakteri bağlı olduğu ana kategoriyi gösterir (L1CATEGORIES). L3CATEGORIES 9 karakter uzunluğundadır, ilk 6 karakter bağlı olduğu ikinci kırılımı (L2CATEGORIES) gösterir. L4CATEGORIES 12 karakter uzunluğundadır, ilk 9 karakteri bağlı olduğı üçüncü kırılımı gösterir (L3CATEGORIES) Versiyon 1.00 E-Çözüm Elektronik Tic. Ltd. Şti. tüm hakları saklıdır. - 29 -