BAUHAUS B2B Web Servis Dökümantasyonu

Transkript

1 BAUHAUS B2B Web Servis Dökümantasyonu Giriş BAUHAUS B2B web servisi xml metodu ile çalışmaktadır. Web servisten alacağınız değerler size xml formatında iletilmektedir. Web servise erişim linki aşağıdaki gibidir. Güvenlik Web servis metodları sorgulanırken, kullanıcı adı ve şifre (MD5 hashli) gönderilmelidir. Bauhaus B2B web servis kullanıcı adı ve şifresi, B2B Portal e bağlanırken kullandığınız kullanıcı adı ve şifreniz ile aynıdır. Fakat şifrenizi web servis metodunda MD5 hashlı olarak yazmanız gerekmektedir. Şifrenizi vb. bir site aracılığı ile MD5 olarak hashleyebilirsiniz. Web servis metodlarını kullanabilmek için, kullanıcınıza web servis metodlarını sorgulama yetkisi BAUHAUS yönetimi tarafından verilmiş olması gerekmektedir. Metodlar GetBranches Tanımlı tüm şubeleri ve ilgili adres bilgilerini getirir. UserName: Kullanıcı adınız Sonuç <Branch Id="Şube No"> <Id> Şube No </Id> <BranchName> Şube Adı </BranchName> <BranchAddress> Şube Adresi </BranchAddress> <BranchPhone> Şube Telefon Numarası </BranchPhone> <BranchFax> Şube Fax Numarası </BranchFax> <BranchILN> Şube Tanım No </BranchILN> <InvoiceAddress> Fatura Adresi </InvoiceAddress> <InvoicePhone> Fatura Telefon Numarası </InvoicePhone> <InvocieFax> Fatura Fax Numarası </InvocieFax> <InvoiceILN> Fatura Tanım No </InvoiceILN> </Branch>

2 Veri Tipleri Id Numeric 3 BranchName String 10 BranchAddress String 185 BranchPhone String 20 BranchFax String 20 BranchILN Numeric 13 InvoiceAddress String 185 InvoicePhone String 20 InvocieFax String 20 InvoiceILN Numeric 13 GetOrder Bir siparişe ait tüm detay bilgileri getirir. Siparişin ait olduğu tedarikçi için yetkiniz olması gereklidir. OrderID: Sorgulanacak siparişin numarası BranchID: Sipariş için şube kodu UserName: Kullanıcı adınız Sonuç <Order OrderNo=" Sipariş No "> <SupplierID> Tedarikçi No </SupplierID> <Supplier> Tedarikçi Adı </Supplier> <OrderNo> Sipariş No </OrderNo> <StoreNo> Şube No </StoreNo> <StoreName> Şube Adı </StoreName> <OrderDate> Sipariş Tarihi (dd/mm/yyyy) </OrderDate> <DeliveryDate> Termin Tarihi (dd/mm/yyyy) </DeliveryDate> <Status> Sipariş Durumu </Status> <Total> Sipariş Tutarı </Total> <Currency> Para Birimi </Currency> <Footer1> Açıklama 1 </Footer1> <Footer2> Açıklama 2 </Footer2> <Footer3> Açıklama 3 </Footer3> <Footer4> Açıklama 4 </Footer4> <Footer5> Açıklama 5 </Footer5> <Footer6> Açıklama 6 </Footer6> <Footer7> Açıklama 7 </Footer7> <Footer8> Açıklama 8 </Footer8> <Items> <Item Id=" Detay Sıra No "> <ItemNo> Ürün No </ItemNo> <Description1> Açıklama 1 </Description1> <Description2> Açıklama 2 </Description2> <UnitPrice> Birim Fiyat</UnitPrice> <Quantity> Miktar</Quantity> <Unit>Birim</Unit>

3 <Delivered> Teslim Edilen </Delivered> <Discount> İndirim Tutarı </Discount> <Vat>Vergi Oranı</Vat> <Total> Tutar </Total> </Item> </Items> </Order> Veri Tipleri Order SupplierID Numeric 6 Supplier String 80 OrderNo Numeric 6 StoreNo Numeric 3 StoreName String 10 OrderDate DateTime dd/mm/yyyy DeliveryDate DateTime dd/mm/yyyy Status String 1 Bkz. Sipariş Durumları Total Decimal Currency String 4 Footer1 String 60 Footer2 String 60 Footer3 String 60 Footer4 String 60 Footer5 String 60 Footer6 String 60 Footer7 String 60 Footer8 String 60 Item Id integer ItemNo Numeric 6 Description1 String 30 Description2 String 30 UnitPrice Decimal Quantity Decimal Unit String 5 Bkz. Birimler Delivered Decimal Discount Decimal Vat Integer Total Decimal GetOrderBySupplierId Verilen parametrelere göre siparişleri getirir SupplierId: BAUHAUS daki tedarikçi numaranız. Eğer bu parameter boş geçilir ise, sorguyu yapan kullanıcı ile ilişkilendirilmiş tüm tedarikçilere ait siparişler listelenir. Bu alan numerik olmalıdır. StartDate: Sorgu tarih aralığının başlangıcı. Tarih alanı aa/gg/yyyy (Ör: 23/09/2017) şeklinde olmalıdır. Zorunlu alandır.

4 EndDate: Sorgu tarih aralığının bitişi. Tarih alanı aa/gg/yyyy (Ör: 23/09/2017) şeklinde olmalıdır. Zorunlu alandır. Status: Sorgulanan siparişlerin durum filtresi. Eğer bu parameter boş geçilir ise, durumuna bakılmaksızın tüm siparişler listelenir. Boş bırakılmaz ise bu alan şu değerleri alabilir. 1:Yeni(New), 2:Sevk Edildi(Delivered), 3:Tamamlandı(Completed), 4:Geçikti(Delayed), 5:İptal(Cancelled by System, 6:İptal(Cancelled by BAUHAUS) UserName: Kullanıcı adınız Sonuç <Order OrderNo=" Sipariş No "> <SupplierID> Tedarikçi No </SupplierID> <Supplier> Tedarikçi Adı </Supplier> <OrderNo> Sipariş No </OrderNo> <StoreNo> Şube No </StoreNo> <StoreName> Şube Adı </StoreName> <OrderDate> Sipariş Tarihi (dd/mm/yyyy) </OrderDate> <DeliveryDate> Termin Tarihi (dd/mm/yyyy) </DeliveryDate> <Status> Sipariş Durumu</Status> <Total> Sipariş Tutarı </Total> <Currency> Para Birimi </Currency> <Footer1> Açıklama 1 </Footer1> <Footer2> Açıklama 2 </Footer2> <Footer3> Açıklama 3 </Footer3> <Footer4> Açıklama 4 </Footer4> <Footer5> Açıklama 5 </Footer5> <Footer6> Açıklama 6 </Footer6> <Footer7> Açıklama 7 </Footer7> <Footer8> Açıklama 8 </Footer8> <Items> <Item Id=" Detay Sıra No "> <ItemNo> Ürün No </ItemNo> <SupplierItemNo> Tedarikçi Ürün Kodu </SupplierItemNo> <Description1> Açıklama 1 </Description1> <Description2> Açıklama 2 </Description2> <UnitPrice> Birim Fiyat </UnitPrice> <Quantity> Miktar </Quantity> <Unit> Birim </Unit> <Delivered> Teslim Edilen </Delivered> <Discount> İndirim Tutarı </Discount> <Vat>Vergi Oranı</Vat> <Total> Tutar </Total> </Item> <Item Id=" Detay Sıra No "> </Item> </Items> </Order>

5 Veri Tipleri Order SupplierID Numeric 6 Supplier String 80 OrderNo Numeric 6 StoreNo Numeric 3 StoreName String 10 OrderDate DateTime dd/mm/yyyy DeliveryDate DateTime dd/mm/yyyy Status String 1 Bkz. Sipariş Durumları Total Decimal Currency String 4 Footer1 String 60 Footer2 String 60 Footer3 String 60 Footer4 String 60 Footer5 String 60 Footer6 String 60 Footer7 String 60 Footer8 String 60 Item Id integer ItemNo Numeric 6 SupplierItemNo String 20 Description1 String 30 Description2 String 30 UnitPrice Decimal Quantity Decimal Unit String 5 Bkz. Birimler Delivered Decimal Discount Decimal Vat Integer Total Decimal GetStockBySupplierId Bir önceki gün sonu ürün stok adetlerini getirir. SupplierId: BAUHAUS daki tedarikçi numaranız. Eğer bu parameter boş geçilir ise, sorguyu yapan kullanıcı ile ilişkilendirilmiş tüm tedarikçilere ait ürün stokları listelenir. Bu alan numerik olmalıdır. BranchCode: BAUHAUS şube kodu. Tüm şubelere ait stok bilgisini şube bazında almak için boş bırakılmalıdır. Tüm şubelere ait stok bilgisini kümülatif olarak almak için cum girilmelidir. SupplierItemCode: Tedarikçiye ait ürün kodu. Bu alan boş geçilirse tüm ürünler getirilir. Bir kod girilir ise sadece bu koda ait ürünün stok bilgisi alınır. BauhausItemCode: BAUHAUS ürün kodu. Bu alan boş geçilirse tüm ürünler getirilir. Bir kod girilir ise sadece bu koda ait ürünün stok bilgisi alınır.

6 UserName: Kullanıcı adınız Sonuç <Stock ItemNo=" Ürün Kodu "> <StoreNo> Şube Kodu </StoreNo> <StoreName> Şube Adı </StoreName> <ItemNo> Ürün Kodu </ItemNo> <SupplierItemNo> Tedarikçi Ürün Kodu </SupplierItemNo> <Description1> Açıklama 1 </Description1> <Quantity> Miktar </Quantity> <Unit>Birim </Unit> <SupplierID> Tedarikçi No </SupplierID> <Supplier> Tedarikçi Adı </Supplier> </Stock> <Stock ItemNo=" Ürün Kodu "> </Stock> Veri Tipleri StoreNo Numeric 3 StoreName String 10 ItemNo Numeric 6 SupplierItemNo String 20 Description1 String 30 Quantity Decimal Unit String 5 Bkz. Birimler SupplierID Numeric 6 Supplier String 80 GetTurnoverBySupplierId İstenen tarih aralığındaki ürün satış adetlerini getirir. SupplierId: Tedarikçi numaranız. Eğer boş bırakılırsa, sorguyu yapan kullanıcı ile ilişkilendirilmiş tüm tedarikçilere ait ürün satis adetleri listelenir. Bu alan numerik olmalıdır. BranchCode: BAUHAUS şube kodu. Tüm şubelere ait satış bilgisini şube bazında almak için boş bırakılmalıdır. Tüm şubelere ait satış bilgisini kümülatif olarak almak için cum girilmelidir. SupplierItemCode: Tedarikçiye ait ürün kodu. Bu alan boş geçilirse tüm ürünler getirilir. Bir kod girilir ise sadece bu koda ait ürünün satış bilgisi alınır. BauhausItemCode: BAUHAUS ürün kodu. Bu alan boş geçilirse tüm ürünler getirilir. Bir kod girilir ise sadece bu koda ait ürünün satış bilgisi alınır. StartDate: Sorgu tarih aralığının başlangıcı. Tarih alanı aa/gg/yyyy (Ör: 23/09/2017) şeklinde olmalıdır. Zorunludur EndDate: Sorgu tarih aralığının bitişi. Tarih alanı aa/gg/yyyy (Ör: 23/09/2017) şeklinde olmalıdır. Zorunludur. UserName: Kullanıcı adınız

7 Sonuç <Turnover ItemNo=" Ürün No "> <StoreNo> Şube No </StoreNo> <StoreName> Şube Adı </StoreName> <ItemNo> Ürün No </ItemNo> <SupplierItemNo> Tedarikçi Ürün No </SupplierItemNo> <Description1> Açıklama 1 </Description1> <Description2> Açıklama 2 </Description2> <Quantity> Miktar </Quantity> <Unit> Birim </Unit> <TurnoverAmount> Ciro Miktarı </TurnoverAmount> <Currency> Para Birimi </Currency> <SupplierID> Tedarikçi No </SupplierID> <Supplier> Tedarikçi Adı </Supplier> </Turnover> <Turnover ItemNo=" Ürün No "> </Turnover> Veri Tipleri StoreNo Numeric 3 StoreName String 10 ItemNo Numeric 6 SupplierItemNo String 20 Description1 String 30 Description2 String 30 Quantity Decimal Unit String 5 Bkz. Birimler TurnoverAmount Decimal Currency String 4 SupplierID Numeric 6 Supplier String 80 Birimler ADET KG PAKET SET BAG KOVA PLAKA TK BIDON KUTU POSET TKSPR ÇİFT MT PSISE TORBA KARTN MTKR RULO Sipariş Durumları No TR DE EN 1 Yeni Neu New 2 Sevk Edildi Geliefert Delivered 3 Tamamlandı Erledigt Completed 5 Gecikti Verspaetet Delayed 8 İptal (Sistem) Storniert(System) Canceled(System) 9 İptal (BAUHAUS) Storniert(BAUHAUS) Canceled(BAUHAUS)

8 Hata Kodları Sorgu sonucunda hata dönmesi halinde SoapException.Actor özelliğinden okunabilir. 2000: Sunucu Hatası 2001: Kullanıcı adı ya da şifre hatalı 2002: Kullanıcıya ait bir profil bulunamadı 2003: Tedarikçi kodu sorguyu yapan kullanıcı ile ilişkilendirilmiş tedarikçi kodlarından hiç birisi ile uyuşmadı. 2004: Bu metodu çağırmak için yeterli yetkiye sahip değilsiniz. 2005: Tarih formatı hatalı