Bimel Ürün Veritabanı Paylaşım Platformu XML Servisleri www.bimel.com.tr 10 Ekim 2012 1
Belge Sürümleri Sürüm Tarih Yazar Değişiklik V1.0 14.04.2008 Burak USGURLU burak@bimel.com.tr İlk yayınlanma. V2.0 17.02.2009 Burak USGURLU burak@bimel.com.tr Sistemin iyileştirilmesi sonucu oluşan değişikliklerin yansıtılması. V3.0 13.10.2009 Burak USGURLU burak@bimel.com.tr XML belgelerine Ürün Kategorilerinin eklenmesinin yansıtılması. XML belgelerinin Excel formatında kullanılması. V3.1 26.04.2011 Burak USGURLU burak@bimel.com.tr XML alanlarına garanti süresi ve miktar birimi eklendi. V3.2 10.10.2012 Burak USGURLU burak@uskur.com.tr XML alanlarına sipariş edilebilecek en az miktar ve katları eklendi. 2
İçindekiler 1 Sistem Hakkında...4 1.1 Yardım ve Destek...4 2 XML Servisleri Temel Kullanım Bilgileri...5 2.1 Oturum Açma...5 2.2 XML Raporları Yönetim Sayfası...5 2.3 Yeni XML Raporu Oluşturma...6 2.4 İzinli IP Adresi Tanımlama...8 2.5 Rapora Erişim ve Örnek XML...8 2.6 Ürün Kategorileri...9 3 XML Biçiminin Excel Biçimine Çevirilmesi...10 3
1 Sistem Hakkında Bimel, web sitesinde yer alan ürünleri ticari ilişkide bulunduğu bayilerinin mevcut sistemlerini kullanarak web sitelerine kolayca yerleştirebilmesi amacıyla bir girişim başlatmış bulunuyor. Verilerin alışverişinde kullanılan standart bir dil olması, geniş kullanım alanı sunması ve evrensel bir format olması bakımından Bimel, XML Servislerini kullanıma açmıştır. Bimel olarak bayilerimize kendilerine özel XML dosyası oluşturabilecekleri bir arayüz hazırlamış bulunuyoruz. Bu arayüze http://xml.bimel.com.tr adresinden ulaşmak mümkün. Bu arayüz sayesinde bayilerimiz XML dosyalarında yer almasını istediği ürün kategorilerini ve markaları kolayca seçerek, ayrıca ürünler hakkında almak istediği bilgileri (ürün kodu, fiyatı, anlık stoktaki adedi, ürün resimleri, açıklamaları, vb.) belirleyerek XML raporlarını ihtiyaçları doğrultusunda kolayca şekillendirebilmektedir. Geriye oluşturulan bu XML dosyasını bayilerimizin kendi web sitelerine işlemesi kalıyor. 1.1 Yardım ve Destek XML servisleri konusunda yardım ve destek için webadmin@bimel.com.tr eposta adresine sorununuzu ayrıntılı biçimde anlatan bir eposta atabilirsiniz. Size en kısa sürede dönüş yapılacaktır. 4
2 XML Servisleri Temel Kullanım Bilgileri 2.1 Oturum Açma Bayi portalından Bimel Bayi sayfasına erişmesini istediğiniz tüm şirket çalışanlarınız için hesap açabilirsiniz! Bimel XML servislerine http://xml.bimel.com.tr adresinden erişebilirsiniz. Oturum açmak için bayi sayfalarımızda kullandığınız Kayıtlı E-posta adresinizi ve parolanızı kullanabilirsiniz. 2.2 XML Raporları Yönetim Sayfası Başarılı bir şekilde giriş yapınca Bayi XML yönetim arayüzü ile karşılaşacaksınız. Bu sayfa aracılığıyla oluşturmuş olduğunuz XML Raporlarını listeleyebilir ve bu raporlara erişebilecek IP adreslerini belirleyebilirsiniz. XML Raporu Nedir? XML raporu, ürünlerimiz hakkında sizin belirleyebileceğiniz bilgilerin (adı, açıklaması, fiyatı, stoğu, vb.) yer aldığı, içersinde hangi markaların, hangi türde ürünlerinin yer almasını seçebileceğiniz XML formatında belgedir. Oluşturacağınız XML raporlarının birer adresi olacaktır ve bu adresten raporu her çektiğinizde ürünlerin bilgileri (stok, fiyat, açıklama, vs.) güncellenip gelecektir. 5
2.3 Yeni XML Raporu Oluşturma 1. Yeni XML Raporu Oluştur bağlantısına tıklayınız. 6
Rapor içinde yer almasını sağlayabileceğiniz alanlar: - Id: Ürüne özel tekil sayı. - Code: Ürünün kodu. - ShortDescription: Ürünü açıklayıcı ~300 karakterlik metin. HTML içerebilir. - LongDescription: Ürünü açıklayıcı uzun metin. HTML içerebilir. - Producer: Ürünün üreticisinin ismi. En fazla 150 karakter. - Ean: Ürünün EAN kodu. En fazla 13 karakter. - Image: Ürün resminin adresi. (URL) - Stock: Ürünün stoktaki miktarı. - PartnerPrice: Ürünün size özel fiyatı. - PartnerPriceCurrency: Ürünün size özel fiyatının kuru. - EndUserPrice: Ürünün son kullanıcı fiyatı. - EndUserPriceCurrency: Ürünün son kullanıcı fiyatının kuru. - Vat: Ürüne uygulanan KDV oranı. - ProductCategories: Ürünün yer aldığı kategoriler. - UnitSet: Ürünlerin miktar birimi. (ADET, MT, vb.) - WarrantyPeriod: Ürünlerin garanti süresi. (Yıl) - BatchQuantity: Ürünün en az sipariş edilebileceği miktarı ve katları. Örneğin 305 değerine sahip bir ürün en 305 birim ve katları biçiminde sipariş edilebilir. (305, 610,...). 2. Yeni rapor oluşturma sayfasında, oluşturacağınız XML raporunu ihtiyaçlarınız doğrultusunda şekillendirebilirsiniz. Raporun her alanı için açıklayıcı bilgiler sayfada verilmiştir. Alanın üzerine fare imlecinizi tutarak açıklamaları okuyabilirsiniz. Raporu istediğiniz gibi şekillendirdikten sonra Gönder e tıklayarak kaydetmeyi unutmayınız. Raporu istediğiniz zaman tekrar değiştirebilirsiniz. 3. Raporunuz kayıt edilince otomatik bir adres oluşturulacaktır. Bu adresi kullanarak rapora ulaşabilirsiniz. Raporla ilgili herhangi bir değişiklik yaptığınızda bu adreste değişecektir. 7
2.4 İzinli IP Adresi Tanımlama Raporunuza erişmeden önce rapora erişebilecek IP adreslerini belirlemeniz gerekmektedir. Bu işlem için ekranın sağında bulunan İzinli IP Adresleriniz alanını kullanabilirsiniz. IP Ekle formunu kullanarak raporlarınıza erişebilecek IP adresini kayıt ettirebilirsiniz. 2.5 Rapora Erişim ve Örnek XML Ürettiğiniz rapora, izin verdiğiniz IP adresinden üretilen URL'yi kullanarak erişebilirsiniz. Örnek bir ürün kayıdı aşağıda verilmiştir. <Products> <Product> <Id>849</Id> <Code>DA-70113</Code> <ShortDescription>Digitus 4 Port USB Hub, USB 1.1</ShortDescription> <LongDescription>... </LongDescription> <Producer>Assmann</Producer> <Ean/> <Image>http://xml.bimel.com.tr/image/641</Image> <Stock>42</Stock> <PartnerPrice>999.99</PartnerPrice> <PartnerPriceCurrency>USD</PartnerPriceCurrency> <EndUserPrice>999.99</EndUserPrice> <EndUserPriceCurrency>USD</EndUserPriceCurrency> <Vat>18</Vat> <ProductCategories> <ProductCategory id="99">usb Hub</ProductCategory> </ProductCategories> </Product> </Products> 8
2.6 Ürün Kategorileri XML servisleri aracılığıyla ürün kategorilerimizin yapısını XML formatında çekebilirsiniz. Ürün kategorilerimiz ağaç yapısındadır (iç içe) ve XML'i çekerek kategorilerin isimlerini ve numaralarını alabilirsiniz. Bu bilgileri daha sonra ürün bilgileri içersinde bulunan kategori bilgileriyle beraber kullanabilirsiniz. Bu XML verisi anlık olarak Bimel'in ürün kategorileri ağacını yansıtmaktadır. Kategori bilgilerini indirebilmek için bağlantı kuracağınız bilgisayarın IP adresinin "İzinli IP Adresleriniz" içersinde yer alması gerekmektedir. Ürün kategorileri XML raporuna XML Raporları Yönetim Sayfasından erişebilirsiniz. 9
3 XML Biçiminin Excel Biçimine Çevirilmesi XML evrensel bir biçim olduğu için kolayca Excel'e aktarılabilmektedir. XML biçiminde yukarıda anlatıldığı şekilde oluşturacağınız raporu aşağıdaki adımları takip ederek Excel biçimine, buradan dilediğiniz başka biçimlere aktarabilirsiniz. 1. Aktarmak istediğiniz raporun adresini tarayıcınızın adres çubuğuna yazarak çağırınız. Raporun yüklenmesi tamamlandığında Dosya > Farklı Kaydet... 'e tıklayarak raporu bilgisayarınıza kaydediniz. 2. Excel'i çalıştırarak Ofis Logosu > Aç aracılığıyla kayıt ettiğiniz XML raporunu bulup açınız. 3. Daha sonra açılacak sorulara aşağıdaki resimdeki gibi cevap veriniz. 10
4. Bu işlemler sonucunda XML'de yer alan bilgiler Excel'e aktarılacaktır. 11