Giriş
Önemli Açıklamalar;
<aciklama>deger</aciklama> : şeklinde yeşil renk ile vurgulanmış taglar tekrar edebilir tag olduğunu ifade etmektedir.
<aciklama>1</ aciklama>: şeklinde kırmızı yazı rengiyle vurgulanmış taglar zorunlu alanlardır.
<aciklama>1</ aciklama>: şeklinde turuncu yazı rengiyle vurgulanmış taglar şartlı zorunlu alanlardır.
[Aciklama] : tag içeriği belirtilen şeklinde ifade edilen değerler sabit değerlerdir. Bu taglara bu sabit değerlerden farklı değerler verilemez.
Login
Her methodta kullanılan token parametresini almak için kullanılan methoddur.
login($customerNo,$username,$password) yordamı customerNo, username ve password olarak üç parametre ile çalışır.
Dönen değer 40 karakter uzunluğunda bir token değeridir. Eğer eksi ile başlayan hata kodları dönmüşse login işlemi başarısızdır. Hata kodları ve anlamları şunlardır;
0 : Token oluşturulurken hata oluştu!
-1 ve -2 : Kullanıcı adı veya şifre hatalı!
-3 ve -5 : Müşteri No hatalı!
-4 : Pda lisansınız dolu!
-6 : Çok fazla yanlış giriş denemesi yapıldığı için sistem bloke edildi. Web üzerinden giriş yapıp tekrar deneyiniz!
-7 ve -8 : Kullanıcı durumu pasif olduğu için token alınamadı!
importSellingXML
Satış, alıştan iade faturalarını Webticari’ye aktarmak için kullanılan metoddur.
<satislar>
<satis>
<client_id>
Bu alana belgenin, gönderen tarafındaki id’leri yazılır ve aynı veri webservice’ten <transferred>, <duplicates> veya <tranpossed> tagleri içerisinde geri döner. Böylece hangi id’li faturaların kaydedilip hangilerinin kaydedilmediği webservice’ten alınmış olur.
</client_id>
Buradan sonrası belge bilgilerini içerir ve databasedeki tableların fıeld nameleri tag name olarak kullanılır:
<st_seribelgeno> A </st_seribelgeno>
<st_ belgeno> 00001 </ st_ belgeno>
<st_ tarih> 2012-09-20 16:30:11 [yyyy-MM-dd HH:mm:ss]
</ st_ tarih>
<st_ carino> tbcari tablosundaki cr_no alanında tanımlı değer girilir. </ st_ carino>
<st_carisube> 0 </st_carisube>
<st_belgeturu> [SATIŞ FATURASI] [ALIŞTAN İADE] </ st_belgeturu>
<st_doviz> [TL] [USD] [EUR] [GBP] [tbkurlar tablosundaki kr_adi alandaki tüm değerler girilebilir.] </st_doviz>
st_kur, st_ozelkod, st_ozelkod2, st_ozelkod3, st_altiskonto, st_opsiyon, st_personelkull, st_acikhesap, st_personel, st_gecis, st_gecisid, st_odeme, st_aciklama, st_aciklama1, st_aciklama2, st_aciklama3, st_aciklama4, st_muhkod, st_muhonay, st_durum, st_sevkiyat, st_sube, st_tevkifat, st_cariyetkili, st_satici, st_masrafmerkezi, st_yazdirma
< st_var >
st_var* alanları Webticari tarafında aktif olarak kullanılmazlar. Kullanıma özel bilgilerin saklanması için kullanılır.
</ st_var >
< st_var 1> </ st_var 1>
< st_var2 > </ st_var 2>
<sepet>
<kalem
<sp_urunno> tburun tablosundaki ur_no alanında tanımlı değer girilir. </sp_urunno>
<sp_birim> tburun tablosundaki ur_birim alanında tanımlı değer girilir. </sp_birim></kalem>
</sepet>
<odemeler>
<odeme>
<tutar>1</tutar>
<birim> [TL]</birim>
<kur>1</kur>
<odemeTipi>
[Nakit]
[Kredi]
[ParaUstu]
[Puan]
[Virman]
[Havale]
</odemeTipi>
<kasa>
tbkasaisim tablosundaki kai_no alandaki tanımlı değer girilir.
</kasa>
<bankaId>
Ödeme tipi “Havale” olan ödemelerde zorunlu alandır. tbbanka tablosundaki bn_id alanında tanımlı değer girilir.
</bankaId>
<posid>
Ödeme tipi “Kredi” olan ödemelerde zorunlu alandır. tbbankakredikarti tablosundaki kk_no alanında tanımlı değer girilir.
</posid>
<planid>
Ödeme tipi “Kredi” olan ödemelerde ödeme planının belirtildiği alandır. Tbbankakredikartiplan tablosundaki bkp_id alanında tanımlı değer girilir.
</planid>
<virmancari>
Ödeme tipi virman olan ödemelerde zorunlu alandır. tbcari tablosundaki cr_no alanında tanımlı değer girilir.
<virmancari>
<aciklama> aciklama</aciklama>
</odeme>
</odemeler>
</satis>
</satislar>
importSellingXML(token,satislar) yordamı, token ve satislar olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. Satislar parametresine ise yukarıdaki xml şema dizaynına uygun şekilde gönderilir. Sonuç olarakta aşağıdaki şema dizaynındaki xml verisi döner;
<transactions>
Entegre edilen faturalar bu tag altında döndürülür.
<transferreds>
<transaction>
<client_id> </client_id>
<server_id>Fatura ID</server_id>
</transaction>
</transferreds>
Entegre edilemeyen faturalar bu tag altında döndürülür.
<transposeds>
<transaction>
<client_id></client_id>
<errorno>Hata Numarası</errorno>
<errormessage>Hata Açıklaması</errormessage>
</transaction>
</transposeds>
Belirtilen cariye belirtilen tarihte fatura kesilmiş olduğu için entegre edilmeyen faturalar bu tag altında döndürülür.
<duplicates>
<transaction>
<client_id></client_id>
<cr_kod>Cari Kodu</cr_kod>
<cr_adi>Cari Adı</cr_adi>
<st_tarih>Fatura Tarihi</st_tarih>
</transaction>
</duplicates>
</ transactions>
importSalesOrderXML
Satış siparişlerini Webticari’ye aktarmak için kullanılan metoddur.
<siparisler>
<siparis>
<client_id>
Bu alana belgenin, gönderen tarafındaki id’leri yazılır ve aynı veri webservice’ten <transferred>, <duplicates> veya <tranpossed> tagleri içerisinde geri döner. Böylece hangi id’li siparişlerin kaydedilip hangilerinin kaydedilmediği webservice’ten alınmış olur.
</client_id>
Buradan sonrası belge bilgilerini içerir ve databasedeki tableların fıeld nameleri tag name olarak kullanılır:
<sipsat_seribelgeno>A</sipsat_seribelgeno>
<sipsat_belgeno>00001</sipsat_belgeno>
<sipsat_tarih>
2012-09-20 16:30:11
[yyyy-MM-dd HH:mm:ss]
</sipsat_tarih>
<sipsat_carino>
tbcari tablosundaki cr_no alanında tanımlı değer girilir.
</sipsat_ carino>
<sipsat_carisube>0</sipsat_carisube>
<sipsat_belgeturu>
[SATIŞ SİPARİŞİ]
[SATIŞ REZERVASYONU]
</sipsat_belgeturu>
<sipsat_doviz>
[TL]
[USD]
[EUR]
[GBP]
[tbkurlar tablosundaki kr_adi alandaki tüm değerler girilebilir.]
</sipsat_doviz>
sipsat_kur, sipsat_ozelkod, sipsat_ozelkod2, sipsat_ozelkod3, sipsat_altiskonto, sipsat_opsiyon, sipsat_personelkull, sipsat_acikhesap, sipsat_personel, sipsat_gecis, sipsat_gecisid, sipsat_odeme, sipsat_aciklama, sipsat_aciklama1, sipsat_aciklama2, sipsat_aciklama3, sipsat_aciklama4, sipsat_muhkod, sipsat_muhonay, sipsat_durum, sipsat_sevkiyat, sipsat_sube, sipsat_tevkifat, sipsat_cariyetkili, sipsat_satici, sipsat_masrafmerkezi, sipsat_yazdirma
<sipsat_var>
sipsat_var* alanları Webticari tarafında aktif olarak kullanılmazlar. Kullanıma özel bilgilerin saklanması için kullanılır.
</sipsat_var>
<sipsat_var1> </sipsat_var1>
<sipsat_var2 > </sipsat_var2>
<sepet>
<kalem>
<sipsatsp_depo>
tbdepo tablosundaki dp_no alanında tanımlı değer girilir.
</sipsatsp_depo>
<sipsatsp_urunno>
tburun tablosundaki ur_no alanında tanımlı değer girilir.
</sipsatsp_urunno>
</kalem>
</sepet>
</siparis>
</siparisler>
importSalesOrderXML(token,siparisler) yordamı, token ve siparişler olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir.
Siparişler parametresine ise yukarıdaki xml şema dizaynına uygun şekilde gönderilir. Sonuç olarakta aşağıdaki şema dizaynındaki xml verisi döner;
<transactions>
Entegre edilen siparişler bu tag altında döndürülür.
<transferreds>
<transaction>
<client_id></client_id>
<server_id>Sipariş ID</server_id>
</transaction>
</transferreds>
Entegre edilemeyen siparişler bu tag altında döndürülür.
<transposeds>
<transaction>
<client_id></client_id>
<errorno>Hata Numarası</errorno>
<errormessage>Hata Açıklaması</errormessage>
</transaction>
</transposeds>
Belirtilen cariye belirtilen tarihte sipariş oluşturulmuş olduğu için entegre edilmeyen siparişler bu tag altında döndürülür.
<duplicates>
<transaction>
<client_id></client_id>
<cr_kod>Cari Kodu</cr_kod>
<cr_adi>Cari Adı</cr_adi>
<sipsat_tarih>Sipariş Tarihi
</siparis_tarih>
</transaction>
</duplicates>
</transactions>
Varyantlı Sipariş Gönderme
<siparisler>
<siparis>
<sipsat_carino>1</sipsat_carino>
<sipsat_belgeno>111122</sipsat_belgeno>
<sepet>
<kalem>
<ur_kod>153.002</ur_kod>
<sipsatsp_fiyat>1</sipsatsp_fiyat>
<variants>
<variant>
<sr_adi>34</sr_adi> yada <sr_kod>B_1</sr_kod>
</variant>
<variant>
<sr_adi>MAVİ</sr_adi>
</variant>
</variants>
</kalem>
</sepet>
</siparis>
</siparisler>
Örnek Kullanım:
$satis = “
<siparisler>
<siparis>
<cr_kod>120.01.004</cr_kod>
<sepet>
<kalem>
<ur_kod>00112233.2.7.SS.35</ur_kod>
<sipsatsp_adet>3</sipsatsp_adet>
</kalem>
</sepet>
</siparis>
</siparisler>
“;
$client->importSalesOrderXML($token,$satis);
Varyantları Alma
Request
<urn:exportStockVariantXML soapenv:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/“>
<token xsi:type=”xsd:string”>d773b1e0237a58a63e361a12d8718a28fd68b179</token>
<stockId xsi:type=”xsd:string”>14</stockId>
<field xsi:type=”xsd:string”>ur_kod</field>
</urn:exportStockVariantXML>
Response
<stock>
<ur_kod>153.002.R_1.B_1</ur_kod>
<variants>
<variant>
<sr_adi>MAVİ</sr_adi>
<sr_kod>R_1</sr_kod>
<var_kod>1</var_kod>
<var_isim>RENK</var_isim>
</variant>
<variant>
<sr_adi>34</sr_adi>
<sr_kod>B_1</sr_kod>
<var_kod>2</var_kod>
<var_isim>BEDEN</var_isim>
</variant>
</variants>
</stock>
<stock>
<ur_kod>153.002.R_2.B_1</ur_kod>
<variants>
<variant>
<sr_adi>SARI</sr_adi>
<sr_kod>R_2</sr_kod>
<var_kod>1</var_kod>
<var_isim>RENK</var_isim>
</variant>
<variant>
<sr_adi>34</sr_adi>
<sr_kod>B_1</sr_kod>
<var_kod>2</var_kod>
<var_isim>BEDEN</var_isim>
</variant>
</variants>
</stock>
<stock>
<ur_kod>153.002.R_1.B_2</ur_kod>
<variants>
<variant>
<sr_adi>MAVİ</sr_adi>
<sr_kod>R_1</sr_kod>
<var_kod>1</var_kod>
<var_isim>RENK</var_isim>
</variant>
<variant>
<sr_adi>36</sr_adi>
<sr_kod>B_2</sr_kod>
<var_kod>2</var_kod>
<var_isim>BEDEN</var_isim>
</variant>
</variants>
</stock>
<stock>
<ur_kod>153.002.R_2.B_2</ur_kod>
<variants>
<variant>
<sr_adi>SARI</sr_adi>
<sr_kod>R_2</sr_kod>
<var_kod>1</var_kod>
<var_isim>RENK</var_isim>
</variant>
<variant>
<sr_adi>36</sr_adi>
<sr_kod>B_2</sr_kod>
<var_kod>2</var_kod>
<var_isim>BEDEN</var_isim>
</variant>
</variants>
</stock>
Sipariş Silme
$siparis = ‘
<siparisler>
<siparis>
<sipsat_id>3599</sipsat_id>
<client_id>599</client_id>
</siparis>
</siparisler>’;
$response = $client->deleteSalesOrderXML($token,$siparis);
Sipariş İptal Etme
cancelSalesOrderXML($token, $salesOrders)
Sipariş Listeleme
getSalesOrderListXML($token,$customerId=0,$limit=50,$offset=0)
Rezeryasyon Oluşturma
$rezervasyon = “
<siparisler>
<siparis>
<cr_kod>$cariKodu</cr_kod>
<sipsat_tarih>2016-03-18</sipsat_tarih>
<sipsat_belgeturu>SATIŞ REZERVASYONU</sipsat_belgeturu>
<biletler>
<bilet>
<kalkis_hava_iata>ZMH</kalkis_hava_iata>
<varis_hava_iata>MRD</varis_hava_iata>
<hy_iata>4O</hy_iata>
<sipsatbilet_kalkis_tarih>2016-03-20 17:00:00</sipsatbilet_kalkis_tarih>
<sipsatbilet_varis_tarih>2016-03-20 20:00:00</sipsatbilet_varis_tarih>
<sipsatbilet_ucusno>TK150</sipsatbilet_ucusno>
<sipsatbilet_alisfiyati>100</sipsatbilet_alisfiyati>
<sipsatbilet_servisbedeli>10</sipsatbilet_servisbedeli>
<sipsatbilet_iskonto>5</sipsatbilet_iskonto>
<sipsatbilet_ceza>15</sipsatbilet_ceza>
<sipsatbilet_satisfiyati>120</sipsatbilet_satisfiyati>
<sipsatbilet_sinif>A</sipsatbilet_sinif>
<yolcular>
<yolcu>
<yolcu_adi>xxx</yolcu_adi>
<yolcu_soyadi>yyy</yolcu_soyadi>
<yolcu_unvan>MR</yolcu_unvan>
<yolcu_dogumtarihi>2000-03-20</yolcu_dogumtarihi>
<yolcu_ceptel>05555555555</yolcu_ceptel>
</yolcu>
<yolcu>
<yolcu_adi>zzz</yolcu_adi>
<yolcu_soyadi>ccc</yolcu_soyadi>
<yolcu_unvan>MR</yolcu_unvan>
<yolcu_dogumtarihi>2000-03-20</yolcu_dogumtarihi>
<yolcu_ceptel>055555555555</yolcu_ceptel>
</yolcu>
</yolcular>
</bilet>
<bilet>
<kalkis_hava_iata>ZMH</kalkis_hava_iata>
<varis_hava_iata>MRD</varis_hava_iata>
<hy_iata>4O</hy_iata>
<sipsatbilet_kalkis_tarih>2016-03-20 17:00:00</sipsatbilet_kalkis_tarih>
<sipsatbilet_varis_tarih>2016-03-20 20:00:00</sipsatbilet_varis_tarih>
<sipsatbilet_ucusno>TK150</sipsatbilet_ucusno>
<sipsatbilet_alisfiyati>100</sipsatbilet_alisfiyati>
<sipsatbilet_servisbedeli>10</sipsatbilet_servisbedeli>
<sipsatbilet_iskonto>5</sipsatbilet_iskonto>
<sipsatbilet_ceza>15</sipsatbilet_ceza>
<sipsatbilet_satisfiyati>120</sipsatbilet_satisfiyati>
<sipsatbilet_sinif>A</sipsatbilet_sinif>
<yolcular>
<yolcu>
<yolcu_adi>ttt</yolcu_adi>
<yolcu_soyadi>ooo</yolcu_soyadi>
<yolcu_unvan>MR</yolcu_unvan>
<yolcu_dogumtarihi>2000-04-20</yolcu_dogumtarihi>
<yolcu_ceptel>0555555555</yolcu_ceptel>
</yolcu>
</yolcular>
</bilet>
</biletler>
</siparis>
</siparisler>
“;
$response = $client->importSalesOrderXML($token,$rezervasyon);
importCustomerXML
<carikartlari>
<carikart>
<client_id></client_id>
<cr_kod></cr_kod>
<cr_adi></cr_adi>
cr_ozelkod, cr_ozelkod2, cr_ozelkod3, cr_ozelkod4, cr_ozelkod5, cr_ozelkod6, cr_adres, cr_il, cr_ilce, cr_semt, cr_adres2, cr_il2, cr_ilce2, cr_semt2, cr_ulke2, cr_postakodu, cr_tel, cr_fax, cr_tel2, cr_evtel, cr_cep, cr_cep2, cr_mail, cr_web, cr_tckimlik, cr_ulke, cr_vergidairesi, cr_vergino, cr_bagkur, cr_babaadi, cr_sosyalguvenceno, cr_doviz, cr_iskonto, cr_turu, cr_unvan, cr_grup, cr_altgrup, cr_not, cr_kayittar, cr_personel, cr_opsiyon, cr_opsiyonaysonu, cr_durum, cr_risklimiti, cr_risklimiti_kriter, cr_resim, cr_websifre, cr_webkuladi, cr_istihbarat, cr_sube, cr_dogumtarihi, cr_evlilikyildonumu, cr_bankahesap, cr_temsilci, cr_rutgunu, cr_koordinatenlem, cr_koordinatboylam, cr_var1, cr_var2, cr_var3
</carikart>
</carikartlari>
importCustomerXML (token, carikartlari) yordamı token ve carikartlari olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. carikartlari parametresine ise yukarıdaki xml şema dizaynı gönderilir. Sonuç olarakta varsayılan sonuç şema dizaynındaki xml verisi döner.
* cr_turu alanının alabileceği değerler ve anlamları;
A = Alıcı,
S = Satıcı,
AS = Alıcı / Satıcı,
P = Perakende,
M = Muhtahsil,
PS = Personel,
U = Üretici,
O = Operatör,
SP = Supplier,
T = Tour,
H = Hotel,
G = Guide
<transactions><transferreds><transaction><client_id></client_id><server_id>154</server_id></transaction></transferreds><transposeds></transposeds><duplicates></duplicates></transactions>
$cari = ‘
<cariler>
<cari>
<cr_kod> 111222 </cr_kod>
<cr_adi> test </cr_adi>
</cari>
</cariler>’;
$client->importCustomerXML($token,$cari);
importStockXML
Stok kartlarını Webticari’ye aktarmak için kullanılan metoddur.
importStockXML (token, stokkartlari) yordamı token ve stokkartlari olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. stokkartlari parametresine ise yukarıdaki xml şema dizaynı gönderilir. Sonuç olarakta varsayılan sonuç şema dizaynındaki xml verisi döner.
<transactions><transferreds><transaction><client_id></client_id><server_id>135</server_id></transaction></transferreds><transposeds></transposeds><duplicates></duplicates></transactions>
$stok = ‘
<stoklar>
<stok>
<ur_kod> 111222 </ur_kod>
<ur_adi> test </ur_adi>
<bi_birim> AD </bi_birim>
</stok>
</stoklar>’;
$client->importStockXML($token,$stok);
importIncomeExpenseXML
Gelir/Gider hareketlerini Webticari’ye aktarmak için kullanılan metoddur.
importIncomeExpenseXML (token,gelirgider) yordam token ve gelirgider olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. gelirgider parametresine ise yukarıdaki xml şema dizaynı gönderilir. Sonuç olarakta varsayılan sonuç şema dizaynındaki xml verisi döner.
importCashTransactionXML
Nakit işlemlerini Webticari’ye aktarmak için kullanılan metoddur.
Örnek Kullanım:
<nakitler>
<nakit>
<cr_kod>329.01.0157</cr_kod>
<nk_tutarson>1000</nk_tutarson>
<nk_tutarsonbirim>TL</nk_tutarsonbirim>
<nk_tutarsonkur>1.00000</nk_tutarsonkur>
<nk_islemtarih>2012-09-21</nk_islemtarih>
<nk_belgeno>pd234qe </nk_belgeno> //Ödemeye bağlı pnr ları veya sizin tarafta bil belge no varsa onu yazabilirsiniz.
<nk_aciklama>PNR:P3UQ6X 09.10.2016 ASR > IST THY MR MUSTAFA DAGCI 2352192721073 </nk_aciklama>
</nakit>
</nakitler>
$response= $client->importCashTransactionXML($token,’Tahsilat’,$nakit);
importChequeTransactionXML
<cekler>
<cek>
<client_id></client_id>
<cr_kod>Cari Kodu</cr_kod> yada <ck_carino>Cari ID</ck_carino>
<ck_tutarson>Ödeme yapılan tutar</ck_tutarson>
Tahsilat ise; <ck_bankaid>Banka İsim Id</ck_bankaid> yada <bnisim_kod>Banka İsim Kodu</bnisim_kod > yada <bnisim_ad>Banka İsim Adı</bnisim_ad>
Tediye ise; <ck_bankaid>Banka Id</ck_bankaid> yada <bn_hesapkodu>Banka Hesap Kodu</bn_hesapkodu> yada <bn_hesapadi>Banka Hesap Adı</bn_hesapadi>
ck_ozelkod, ck_takipno, ck_bankasube, ck_kasideyeri, ck_cekno, ck_hesapno, ck_tutarson, ck_tutarsonbirim, ck_tutarsonkur, ck_durum, ck_vadetarih, ck_sahibi, ck_cirosahibi, ck_aciklama, ck_sube, ck_muhonay, ck_iptal, ck_proje, ck_temsilci, ck_tipi, ck_var1, ck_var2, ck_var3, ck_tutar, ck_tutarbirim, ck_tutarkur, ck_tarih, ck_carisube, ck_personel, kasa
</cek >
<cek></cek>[…]
</cekler>
importCreditTransactionXML
Kredi kartı işlemlerini Webticari’ye aktarmak için kullanılan metoddur.
Örnek Kullanım:
<kredikartlari>
<kredikart>
<cr_kod>120.001</cr_kod></cr_kod>
<kk_tutarson>100.00</kk_tutarson>
<kk_posid>Pos Id</kk_posid> yada <kk_bankano>Banka ID</kk_bankano> yada
<kk_tutarsonbirim>TL
<kk_tutarsonkur>1.0000</kk_tutarsonkur>
<kk_odemetarih> 2015-09-23 <kk_odemetarih>
<kk_aciklama>PNR:P3UQ6X <kk_aciklama>
09.10.2016 ASR > IST THY
MR MUSTAFA DAGCI 2352192721073 <nk_aciklama> </kk_aciklama>
<kk_belgeno> p3uq6x </kk_belgeno> //pnrları veya sizde belge , makbuz no varsa yazabilirsiniz.
</kredikart>
<kredikart></kredikart>[…]
</kredikartlari>
$response= $client->importCreditTransactionXML($token,’Tahsilat’,$kredikart);
importAccountingVoucherXML
Muhasebe fişlerini Webticari’ye aktarmak için kullanılan metoddur.
Örnek Kullanım:
$xml=”
<fisler>
<fis>
<client_id>77</client_id>
<fis_fisno>00001</fis_fisno>
<hareketler>
<hareket>
<hspl_kod>100</hspl_kod>
<fishk_borc>100</fishk_borc>
</hareket>
<hareket>
<hspl_kod>102</hspl_kod>
<fishk_alacak>100</fishk_alacak>
</hareket>
</hareketler>
</fis>
</fisler>
“;
$response = $webservis->importAccountingVoucherXML($token,$xml);
deleteAccountingVoucherXML
Muhasebe fişlerini Webticari’den silmek için kullanılan metoddur.
deleteAccountingVoucherXML(token=string, fisler=string) yordamı token ve fisler olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. fisler parametresine ise yukarıdaki xml şema dizaynı gönderilir. Sonuç olarakta varsayılan sonuç şema dizaynındaki xml verisi string olarak geri döner.
$xml=”
<fisler>
<fis>
<client_id>375</client_id>
<fis_no>375</fis_no>
</fis>
<fis>
<client_id>376</client_id>
<fis_no>376</fis_no>
</fis>
</fisler> “;
$response = $webservis->deleteAccountingVoucherXML($token,$xml);
importBankTransferXML
<havaleler>
<havale>
<client_id></client_id>
<bn_hesapadi>Banka Hesap Adı</bn_hesapadi> yada <bn_hesapkodu>Banka Hesap Kodu</bn_hesapkodu> yada <bh_bnid>Banka ID</bh_bnid>
<cr_kod>Cari Kodu</cr_kod> yada <bh_carino>Cari ID</bh_carino>
<tutarodeme>Ödeme yapılan tutar</tutarodeme>
<tutarodemebirim>Ödeme yapılan para birimi</tutarodemebirim>
<tutarodemekur>Ödeme yapılan döviz kuru</tutarodemekur>
bh_caribankaid, bh_aciklama, bh_tutar, bh_tutarbirim, bh_tutarkur, bh_tutarodeme, bh_tutarodemebirim, bh_tutarodemekur, bh_tarih, bh_tur, bh_carisube, bh_evrakno, bh_muhonay, bh_sube, bh_var1, bh_var2, bh_var3
</havale>
<havale></havale>[…]
</havaleler>
Örnek Kullanım:
importStockTransportXML
importSalesReceiptXML
Satış İrsaliyelerini import etmek için kullanılan method dur.
<Satıslar>
<satis>
<client_id>
Bu alana belgenin, gönderen tarafındaki id’leri yazılır ve aynı veri webservice’ten <transferred>, <duplicates> veya <tranpossed> tagleri içerisinde geri döner. Böylece hangi id’li irsaliyelerin kaydedilip hangilerinin kaydedilmediği webservice’ten alınmış olur.
</client_id>
Buradan sonrası belge bilgilerini içerir ve databasedeki tableların fıeld nameleri tag name olarak kullanılır:
<irsat_seribelgeno> A </irsat_seribelgeno>
<irsat_belgeno> 00001 </irsat_belgeno>
<irsat_tarih> 2013-09-20 16:30:11 [yyyy-MM-dd HH:mm:ss] </irsat_tarih>
<irsat_carino>
tbcari tablosundaki cr_no alanında tanımlı değer girilir.
</irsat_carino>
<irsat_carisube> 0 </irsat_carisube>
<irsat_belgeturu>
[SATIŞ İRSALİYESİ]
</irsat_belgeturu>
<irsat_doviz>
[TL]
[USD]
[EUR]
[GBP]
[tbkurlar tablosundaki kr_adi alandaki tüm değerler girilebilir.]
</irsat_doviz>
irsat_kur, irsat_ozelkod, irsat_ozelkod2, irsat_ozelkod3, irsat_altiskonto, irsat_opsiyon, irsat_personelkull, irsat_acikhesap, irsat_personel, irsat_gecis, irsat_gecisid, irsat_odeme, irsat_aciklama, irsat_aciklama1, irsat_aciklama2, irsat_aciklama3, irsat_aciklama4, irsat_muhkod, irsat_muhonay, irsat_durum, irsat_sevkiyat, irsat_sube, irsat_tevkifat, irsat_cariyetkili, irsat_satici, irsat_masrafmerkezi, irsat_yazdirma
<irsat_var>
irsat_var* alanları Webticari tarafında aktif olarak kullanılmazlar. Kullanıma özel bilgilerin saklanması için kullanılır.
</irsat_var>
<irsat_var1> </irsat_var1>
<irsat_var2> </irsat_var2>
<sepet>
<kalem>
<irsatsp_depo>
tbdepo tablosundaki dp_no alanında tanımlı değer girilir.
</irsatsp_depo>
<irsatsp_urunno>
tburun tablosundaki ur_no alanında tanımlı değer girilir.
</irsatsp_urunno>
<irsatsp_adet>
Sepet ürün miktarı için bu alan kullanılmalıdır.
</irsatsp_adet>
<irsatsp_maliyet>
Ürün maliyeti girilmelidir.
</irsatsp_maliyet>
<irsatsp_fiyat>
Ürün fiyatı girilmelidir.
</irsatsp_fiyat>
<irsatsp_tutar>
Ürün tutar girilmelidir.
</irsatsp_tutar>
</kalem>
</sepet>
</satis>
</satislar>
importSalesReceiptXML(token,Satışlar) yordam token ve satışlar olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. Satışlar parametresine ise yukarıdaki xml şema dizaynı gönderilir. Sonuç olarakta varsayılan sonuç şema dizaynındaki xml verisi döner.
importPurchaseReceiptXML
deleteSellingXML
Satış, alıştan iade faturalarını Webticari’den silmek için kullanılan metoddur.
<satislar>
<satis>
<client_id></client_id>
<st_id></st_id>
<muhentegre_sil>
Bağlı muhasebe fişini silmek için kullanılır.
[E]
[H]
</muhentegre_sil >
</satis>
</satislar>
deleteBuyingXML
Alış, satıştan iade faturalarını Webticari’den silmek için kullanılan metoddur.
<alislar>
<alis>
<client_id></client_id>
<st_id></st_id>
<muhentegre_sil>
Bağlı muhasebe fişini silmek için kullanılır.
[E]
[H]
</muhentegre_sil >
</alis>
</alislar>
exportDataXML
Webticari’den veri çekmek için kullanılan metoddur.
<token>?</token>
<query>
SELECT cr_no,cr_kod FROM `tbcari` WHERE cr_mail = ‘ali@webticari.net’
</query>
exportDataXML(token=string, sql=string) yordamı token ve sql olarak iki parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. Sql parametresine ise çekmek istediğiniz verileri üretebilecek standart Mysql syntax yapısına uygun select sorgusu verilir. Bu Sql sorgusu ile sonuç üretmek; Webticari tarafından erişim izni verilen tablolara ve izin verilen yapıdaki select sorgu cümlesi şartına uymak kaydıyla gerçekleşecektir. Sonuç olarak, aşağıdaki xml veri deseninde string veri geri döndürür.
<table>
<rows>
<row>
<sorguda belirtilen alanlar>veri</ sorguda belirtilen alanlar>
</row>
</rows>
</table>
Örnek Kullanım:
* Varsayılan dönemdeki muhasebe hesap planı çekme
$sql=”SELECT hspl_no AS id, hspl_kod AS kod, hspl_adi AS ad FROM muhhesapplani{donem}”;
$response = $webservis-> exportDataXML($token,$qry);
* Satıcı, kullanıcı gibi personelleri çekmek için
$qry = “SELECT * FROM tbpersonel”;
$response = $webservis-> exportDataXML($token,$qry);
* Satış faturalarını çekmek için
$qry = “SELECT * FROM tbsatis{donem},tbsepet{donem}, tbcari, tbpersonel,tbdepo WHERE dp_no=sp_depo AND sp_satici=ps_no AND st_carino=cr_no AND st_id=sp_satisno”;
$response = $webservis-> exportDataXML($token,$qry);
* Alış faturalarını çekmek için
$qry = “SELECT * FROM tbalis{donem},tbasepet{donem}, tbcari, tbpersonel,tbdepo WHERE dp_no=sp_depo AND sp_satici=ps_no AND st_carino=cr_no AND st_id=sp_alisno”;
$response = $webservis-> exportDataXML($token,$qry);
* Tüm stokları çekmek için
Not: ExportStokXml fonksiyonunu kullanmanızı tavsiye ederiz.
$qry = “Select * From tburun”;
$response = $webservis-> exportDataXML($token,$qry);
* Tüm carileri çekmek için
Not: ExportCustomerXml fonksiyonunu kullanmanızı tavsiye ederiz.
$qry = “Select * From tbcari”;
$response = $webservis-> exportDataXML($token,$qry);
* Stok envanterlerini çekmek için (GENEL)
$qry = “SELECT soen_adet FROM tbstokenvanter{donem} WHERE soen_urunno = {urun no} and soen_yer= ‘ANA’”;
* Stok envanterlerini çekmek için (DEPO Bazlı)
$qry = “SELECT soen_adet FROM tbstokenvanter{donem} WHERE soen_urunno = {urun no} and soen_yer= ‘DEPO’ AND soen_no = {depo no}”;
Not: Depo numaralarını öğrenmek için tbdepo tablosunu çekip dp_no bilgisini alabilirsiniz. “SELECT dp_no FROM tbdepo”
exportStockXML
Stok kartlarını çekmek için kullanılan metoddur.
exportStockXML($token, “ur_kod, ur_adi, ur_grup, ur_altgrup, ur_marka, ur_model, ur_firma,ur_muadilkod, ur_ozelkod, ur_ozelkod2, ur_ozelkod3, ur_ozelkod4, ur_ozelkod5, ur_ozelkod6, ur_adi2, ur_grup, ur_altgrup, ur_marka, ur_model, ur_firma, ur_doviz, ur_kdv, ur_satiskdv, ur_otv, ur_oiv, ur_aciklama, ur_serinokaydet, ur_resim, ur_resim2, ur_resim3, ur_resim4, ur_kayittar, ur_kullbirim, ur_depo, ur_durum, ur_tipi, ur_ozellik, ur_garantisure, ur_minsatiskari, ur_prim, ur_opsiyon, ur_var1, ur_var2, ur_var3, ur_sube,bi_maaliyet, bi_alisfiyat, bi_satisfiyat1, bi_satisfiyat2, bi_satisfiyat3, bi_satisfiyat4, bi_satisfiyat5, bi_satisfiyat6, bi_satisfiyat7, bi_satisfiyat8, bi_satisfiyat9, bi_satisfiyat10, bi_kullfiyat, bi_stoktoplam, bi_barkodtur, bi_barkod, bi_en, bi_boy, bi_yukseklik, bi_hacim, bi_agirlik, bi_raf1, bi_raf2, bi_raf3, bi_stoktoplam,bi_stokminimum, bi_stokoptimum, bi_stokmaksimum, bi_sube”, ” ur_kod=’D-0008′ “)
* Resim çekmek için:
exportStockImageBase64JSON($token,$jsonId,$imageNo=1,$thumbnail=NULL)
* “jsonId parametresine:json array tipinde ur_no ları verilecek”
exportCustomerXML
Cari kartlarını çekmek için kullanılan metoddur.
exportCustomerXML($token,$field,$condition,$limit) yordamı token, field, condition ve limit olarak dört parametre ile çalışır. Token parametresine “login” metoduyla alınan token değeri verilir. Token haricindeki parametreler zorunlu değildir. Field parametresi ile çekilecek alanlar “cr_no,cr_adi, cr_kod” şeklinde belirtilebilir. Field parametresi boş bırakılırsa tüm cari bilgileri gelecektir. Condition parametresi ile belirli şartlardaki cari kartları çekilebilir. Limit parametresi ile çekilecek kart sayısı “0 yada 0,10” şeklinde belirtilebilir.
* Condition parametresine cr_kod=’ 120.000122’ şeklinde cari kodunu vermeniz gerekmektedir.
* Condition parametresini boş bırakırsanız tüm carileri çekebilirsiniz.
exportCustomerXML($token, “cr_kod, cr_adi, cr_adres, cr_il, cr_ilce, cr_ozelkod, cr_ozelkod2, cr_ozelkod3, cr_ozelkod4, cr_ozelkod5, cr_ozelkod6, cr_tckimlik, cr_vergino, cr_sube, cr_mail, cr_tel “, ” cr_kod=’120.000122′ “)
convertSalesOrderToReceipt
Satış siparişlerini satış irsaliyesine çeviriren method dur.
<token>{login methodu ile çekilen token}</token>
<siparis>{sipariş id}</siparis>
$response= $client->convertSalesOrderToReceipt($token,$Siparisler);
convertSalesOrderToInvoice
Satış siparişlerini satış faturasına çeviriren method dur.
<token>{login methodu ile çekilen token}</token>
<siparis>{sipariş id}</siparis>
$response= $client->convertSalesOrderToReceipt($token,$Siparisler);
getAccountStatement
Cari ekstere raporu almaya yarayan method dur.
<token>{login methodu ile çekilen token}</token>
<customerId>{cari no}</customerId>
$response= $client->getAccountStatement($token,$carino);
importServiceXML
Servis kaydı oluşturmaya yarayan method dur.
<token>{login methodu ile çekilen token}</token>
<hareketler>
<hareket>
<cr_kod>12345</cr_kod>
<ur_kod>987654</ur_kod>
<ser_kayittarih>2024-1-1 15:20:00</ser_kayittarih>
<ser_teslimtarih>2024-1-1 15:20:00</ser_teslimtarih>
<ser_ariza>Akt kapak arızası var.</ser_ariza>
<ser_not></ser_not>
ser_formno>345964-1111111111111</ser_formno>
ser_durum>3</sr_durum>
ser_tur>Periyodik Bakım</ser_tur>
</hareket>
</hareketler>
NOT: ser_tur için verilen değerler;
-Periyodik Bakım (Herzaman ser_durum = 1)
-Ücretli Ürün
-Grantili Ürün