getAccountStatement

Genel Bilgi

Özellik	Değer
Endpoint Adı	`getAccountStatement`
SOAPAction	`urn:WebticariService#getAccountStatement`
Açıklama	Belirli bir cariye ait hesap ekstresini (borç/alacak hareketleri) 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	Ekstresi alınacak carinin ID'si (0 = tümü)

Yanıt Parametreleri

Parametre	Tip	Açıklama
`return`	`xsd:string`	Cari hesap hareketlerini içeren XML ekstresi

Yanıt XML Yapısı

<accountStatement>
  <item>
    <stockCode>STOK001</stockCode>
    <stockName>Örnek Ürün</stockName>
    <quantity>5.00</quantity>
    <unitPrice>150.00</unitPrice>
    <unitPriceNonDiscount>175.00</unitPriceNonDiscount>
    <originalPrice>750.00</originalPrice>
    <originalCurrency>TRY</originalCurrency>
    <paymentType>borc</paymentType>
    <documentNo>FAT2024001</documentNo>
    <date>15.01.2024</date>
    <debitAmount>750.00</debitAmount>
    <creditAmount>0</creditAmount>
    <amountExchangeRate>1</amountExchangeRate>
    <amountCurrency>TRY</amountCurrency>
    <description>Açıklama</description>
    <type>Satış Fatura</type>
    <documentDescription>Sevk notu</documentDescription>
    <vade_tarihi>30.01.2024</vade_tarihi>
    <documentId>1001</documentId>
  </item>
  <!-- Alacak hareketi örneği -->
  <item>
    <paymentType>odeme</paymentType>
    <debitAmount>0</debitAmount>
    <creditAmount>750.00</creditAmount>
    <type>Alış Fatura</type>
    <!-- ... diğer alanlar ... -->
  </item>
</accountStatement>

Yanıt Alanları

Alan	Açıklama
`stockCode`	Stok kodu
`stockName`	Stok adı
`quantity`	Miktar (birime göre normalize edilmiş)
`unitPrice`	İskontolu birim fiyat (KDV dahil)
`unitPriceNonDiscount`	İskontosuz birim fiyat (KDV dahil)
`originalPrice`	Ödeme/borc belgesi tutarı
`originalCurrency`	Belge para birimi
`paymentType`	`borc` (satış/alınan) veya `odeme` (alış/ödenen)
`documentNo`	Belge numarası
`date`	İşlem tarihi (`dd.mm.yyyy`)
`debitAmount`	Borç tutarı (cari para biriminde)
`creditAmount`	Alacak tutarı (cari para biriminde)
`amountExchangeRate`	Kur (farklı para birimlerinde manuel hesaplanır)
`amountCurrency`	Cari para birimi
`description`	Hareket açıklaması
`type`	İşlem tipi (Satış Fatura, Alış Fatura, Satış İrsaliye, v.b.)
`documentDescription`	Belge açıklaması
`vade_tarihi`	Vade tarihi (`dd.mm.yyyy`)
`documentId`	İlgili satış/alış belgesi ID'si

Örnek SOAP İstek

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

Hata Durumları

Durum	Açıklama
`Invalid Token`	Token geçersiz veya süresi dolmuş (30 dakika)
Boş yanit	`customerId` bulunamadı ya da hiç hareketi yok

Notlar

tbborc (satış/irsaliye hareketleri) ve tbodeme (alış/irsaliye hareketleri) tabloları UNION ALL ile birleştirilerek tek liste olarak döner.
Sonuçlar M (tarih) ve A (belge no) sırasına göre ASC sıralanır (bu alanlar yanıtta görünmüyor).
Tarih aralığı filtresi desteklenmez; cariye ait tüm hareketler döner.
Kullanıcının şube yetkisi (izin 645) otomatik uygulanır.
Çok para birimli işlemlerde amountExchangeRate manuel hesaplanır; aynı para birimli işlemlerde 1 döner.