VIO DIŞ WEB SERVİS KULLANICI REHBERİ İçindekiler 1. GİRİŞ 2 2. FİLTRELERİN KULLANIMI 3 3. STOK LİSTESİ nin ALINMASI. 4 4. HİZMET LİSTESİ nin ALINMASI 5 5. CARİ LİSTESİ nin ALINMASI... 6 6. FATURA/İRSALİYE ALINMASI... 7
1. GİRİŞ VİO Dış Web Servisi ile Cari, Stok, Hizmet listeleri ile Perakende, İrsaliye ve Fatura kayıtları alınabilir. Bu dökümanda kayıtlara erişim için kullanılacak XML yapıları açıklanmaktadır. XML İSTEK leri genel olarak şu biçimdedir: <UserData DumperVersion="2" Cmd="Çekilecek Bilgiye Ait Belirteç"> <Login KullaniciAdi="kullanıcı adı" Sifre="parola" /> <Filtreler> <Filtre Tip="ozellik" Belirtec="Filtre Saha Belirteci" Numerikmi="" Deger="F" /> <Filtre Tip="basisonu" Belirtec="Filtre Saha Belirteci" Numerikmi="*" Basi="1" Sonu="1000" /> </Filtreler>
2. FİLTRELERİN KULLANIMI Bilgi Yükleme işleminde alınacak verileri sınırlandırmak için bir Filtre Aralığı verilebilir. Bu filtre aralığı, xml de <Filtreler> adlı node un altında belirtilir. FİLTRE ÇEŞİTLERİ ozellik: Tekil filtredir. (Örn: ELMA isimli stok un aranması) <Filtre Tip= ozellik Belirtec= Aciklama Deger= ELMA /> basisonu: Baş-Son Aralığı verilebilen bir filtredir (Örn: Stok Kodu 1 ile 3 arasında olan stokların aranması) <Filtre Tip= basisonu Belirtec= Kod Basi= 1 Sonu= 3 /> liste: Belirli değerlere ait bilgilerin çekilmesini sağlayan filtredir (Örn: Stok Kodu sadece [ 1, 3, 5 ] olan stokların aranması) <Filtre Tip= liste Belirtec= Kod > <Deger>1</Deger> <Deger>3</Deger> <Deger>5</Deger> </Filtre>
3. STOK LİSTESİ nin ALINMASI a. İSTEK XML i <UserData DumperVersion="2" Cmd="StokYukle"> <Login KullaniciAdi="test" Sifre="test" /> <Filtreler> <Filtre Tip="ozellik" Belirtec="Kod" Deger="2700980" /> </Filtreler> : Bilgi Yükleme işleminin yapılacağını belirtir <Cmd= StokYukle >: Stok listesinin istendiğini belirtir <Filtre Tip= ozellik >: Tekil saha filtresi yazılacak <Filtre Belirtec= Kod >: Kod sahasına ait filtre yazılacak <Filtre Değer= >: Kod filtresine ait aranacak değer b. CEVAP XML i <Result IsError=""> <Content Status="*" DumperVersion="2"> <UserData> <Kayitlar> <Kayit> <Kod>2700980</Kod> <Aciklama>**Aktarımda Oluştu**</Aciklama> <Brm>AD</Brm> </Kayit> </Kayitlar> </Content> </Result> <Result IsError= >: İşlemde hata olmadığını belirtir <Content Status= * >: Veri bütünlüğünün doğrulandığını belirtir <Kayitlar >: Stok kayıtları
4. HİZMET LİSTESİ nin ALINMASI c. İSTEK XML i <UserData DumperVersion="2" Cmd="HizmetYukle"> <Login KullaniciAdi="test" Sifre="test" /> <Filtreler> <Filtre Tip="ozellik" Belirtec="Aciklama" Deger="hizmet1" /> </Filtreler> : Bilgi Yükleme işleminin yapılacağını belirtir <Cmd= Hizmet >: Hizmet listesinin istendiğini belirtir <Filtre Tip= ozellik >: Tekil saha filtresi yazılacak <Filtre Belirtec= Aciklama >: Aciklama sahasına ait filtre yazılacak <Filtre Değer= >: Aciklama filtresine ait aranacak değer d. CEVAP XML i <Result IsError=""> <Content Status="*" DumperVersion="2"> <UserData> <Kayitlar> <Kayit> <Kod>h1</Kod> <Aciklama>Hizmet 1</Aciklama> </Kayit> </Kayitlar> </Content> </Result> <Result IsError= >: İşlemde hata olmadığını belirtir <Content Status= * >: Veri bütünlüğünün doğrulandığını belirtir <Kayitlar >: Hizmet kayıtları
5. CARİ LİSTESİ nin ALINMASI e. İSTEK XML i <UserData DumperVersion="2" Cmd="CariYukle"> <Login KullaniciAdi="test" Sifre="test" /> <Filtreler /> : Bilgi Yükleme işleminin yapılacağını belirtir <Cmd= CariYukle >: Cari listesinin istendiğini belirtir f. CEVAP XML i <Result IsError=""> <Content Status="*" DumperVersion="2"> <UserData> <Kayitlar> <Kayit> <Kod>c1</Kod> <Unvan1>cari 1</Unvan1> <Unvan2></Unvan2> </Kayit> </Kayitlar> </Content> </Result> <Result IsError= >: İşlemde hata olmadığını belirtir <Content Status= * >: Veri bütünlüğünün doğrulandığını belirtir <Kayitlar >: Cari kayıtları
6. SATIŞ FATURALARI nın ALINMASI g. İSTEK XML i <UserData DumperVersion="2" Cmd="PIFYukle"> <Login KullaniciAdi="test" Sifre="test" /> <Filtreler> <Filtre Tip="ozellik" Belirtec="PIFTipi" Deger="F" /> <Filtre Tip="ozellik" Belirtec= AlmSat" Deger="T" /> <Filtre Tip="ozellik" Belirtec="Iade" Deger="" /> </Filtreler> : Bilgi Yükleme işleminin yapılacağını belirtir <Cmd= PIFYukle >: Perakende/İrsaliye/Fatura kayıtlarının istendiğini belirtir <Filtreler> o PIFTipi= F : Sadece Faturalar o AlmSat= T : Sadece SATIŞ fişleri o Iade= : Sadece NORMAL fişler (İADE OLMAYANLAR) Aynı şekilde İadeler istenirse IADE= I, Alımlar istenirse: AlmSat= A, İrsaliyeler istenirse de PIFTipi= I yapılır. h. CEVAP XML i <Result IsError=""> <Content Status="*" DumperVersion="2"> <UserData> <Kayitlar> <Baslik> <Id>10</Id> <PIFTipi>F</PIFTipi> <AlmSat>T</AlmSat> <Iade></Iade> <AyrimTipi></AyrimTipi> <Tarih>2013-01-02-00.00.00.000000</Tarih> <Seri></Seri> <No>2</No> <MusteriKod>c1</MusteriKod> <MusteriAdi>1. cari</musteriadi> <AltHesapKod></AltHesapKod> <AltHesapAdi></AltHesapAdi> <PlasiyerKod>P01</PlasiyerKod>
<PlasiyerAdi>ALİ VELİ</PlasiyerAdi> <TahsilatKarmami></TahsilatKarmami> <TahsilatKod>6</TahsilatKod> <TahsilatAdi>pos 2ykb</TahsilatAdi> <YerKod>P01</YerKod> <YerAdi>ALİ VELİ</YerAdi> <OdemeGunu>A</OdemeGunu> <YerOrtakmi>*</YerOrtakmi> <DvKod></DvKod> <DvKur>0.000000</DvKur> <Detaylar> <Detay> <KayitTipi>S</KayitTipi> <Id>32</Id> <Kod>sut</Kod> <Aciklama>sut</Aciklama> <Miktar>20.000000</Miktar> <BelgeFiyat>5.23</BelgeFiyat> <BelgeBedel>104.60</BelgeBedel> <DetayYerKod></DetayYerKod> <EkKod></EkKod> <EkAdi></EkAdi> </Detay> <Result IsError= >: İşlemde hata olmadığını belirtir <Content Status= * >: Veri bütünlüğünün doğrulandığını belirtir <Kayitlar >: İlgili Fatura kayıtları <Baslik>: Fatura nın BAŞLIK bilgileri <Detaylar>: Fatura nın DETAY bilgileri (kalemler) ** İstenilen filtre aralığı, Filtre Kullanımı bölümünde belirtilen şekilde (ozellik, basisonu, liste gibi) genişletilebilir/daraltılabilir.