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`	Evet	BA-BS listesi alınacak carinin ID'si (`cr_no`); boş veya `0` gönderilirse sonuç dönmez
`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ı

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ğerine ulaşan veya 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 (örn. 3); sunucu otomatik olarak 03 formatına çevirir.
Kullanıcının şube yetkisi (izin 513) otomatik uygulanır.