getCustomerBABS

Genel Bilgi

Özellik	Değer
Endpoint Adı	getCustomerBABS
SOAPAction	urn:WebticariService#getCustomerBABS
Açıklama	Belirli bir cari için BA (Mal ve Hizmet Alımları) ve BS (Mal ve Hizmet Satışları) bildirim listesini XML formatında döner.
Kimlik Doğrulama Gerektirir	Evet (token)

---

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
token	xsd:string	Evet	login endpoint'inden alınan oturum token'ı
customerId	xsd:int	Hayır	BA-BS listesi alınacak carinin ID'si (0 = tümü)
month	xsd:int	Evet	Ay (1-12)
year	xsd:int	Evet	Yıl (örn. 2024)

---

Yanıt Parametreleri

Parametre	Tip	Açıklama
return	xsd:string	BA ve BS bildirim verilerini içeren XML

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:getCustomerBABS>
      <token>abc123tokendeğeri</token>
      <customerId>254</customerId>
      <month>3</month>
      <year>2024</year>
    </tns:getCustomerBABS>
  </soapenv:Body>
</soapenv:Envelope>

---

Yanıt XML Yapısı

<invoices>
  <invoice>
    <type>Alış Fatura</type>
    <amount>25000.00</amount>
    <count>3</count>
  </invoice>
  <invoice>
    <type>Satış Fatura</type>
    <amount>18500.00</amount>
    <count>2</count>
  </invoice>
</invoices>

Alan	Açıklama
type	Alış Fatura (BA) veya Satış Fatura (BS)
amount	Toplam tutar (vergi hariç, OTV dahil)
count	İlgili ay içindeki belge sayısı

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:getCustomerBABS>
      <token>abc123tokendeğeri</token>
      <customerId>254</customerId>
      <month>3</month>
      <year>2024</year>
    </tns:getCustomerBABS>
  </soapenv:Body>
</soapenv:Envelope>

---

Hata Durumları

Durum	Açıklama
Invalid Token	Token geçersiz veya süresi dolmuş (30 dakika)
Boş yanıt	Cari bulunamadı, ayın toplam ba_bs_limiti eşiğine ulaşamadı veya hiç fatura yok

---

Notlar

• Yalnızca ba_bs_limiti değerini aşan kalemler listelenir; bu değer sistem ayarlarından (tbayarlar.ba_bs_limiti) okunur.
• Sadece muhasebe onayı verilmiş (st_muhonay='E') ve iptal edilmemiş faturalar dahil edilir.
• Stok tipi SK (servis/komisyon), VR (varyant) ve GS (genel stok) hariç tutulur.
• month parametresi tek haneli gönderilebilir (orn. 3); sunucu otomatik olarak 03 formatına çevirir.
• Kullanıcının şube yetkisi (izin 513) otomatik uygulanır.