getCustomerDebitAging

Genel Bilgi

Özellik	Değer
Endpoint Adı	`getCustomerDebitAging`
SOAPAction	`urn:WebticariService#getCustomerDebitAging`
Açıklama	Belirli bir carinin vade bazında borç yaşlandırma (aging) raporunu XML formatında döner. Vadesi geçmiş ve gelecekteki borçları vadelerine göre gruplar.
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	Borç yaşlandırması alınacak carinin ID'si (0 = tümü)

Yanıt Parametreleri

Parametre	Tip	Açıklama
`return`	`xsd:string`	Vade gruplarına göre borç tutarlarını içeren XML

Yanıt XML Yapısı

<debitAging>
  <overdueBalance>3500.00</overdueBalance>
  <overdueInterest>87.50</overdueInterest>
  <overdueBalanceExpiryDay>45</overdueBalanceExpiryDay>
  <undueBalance>1200.00</undueBalance>
  <undueBalanceExpiryDay>15</undueBalanceExpiryDay>
  <balance>-4700.00</balance>
  <currency>TRY</currency>
  <customerId>254</customerId>
  <customerCode>MUS001</customerCode>
  <customerName>Örnek Müşteri A.Ş.</customerName>
</debitAging>

Yanıt Alanları

Alan	Açıklama
`overdueBalance`	Vadesi geçmiş toplam borç tutarı
`overdueInterest`	Vadesi geçmiş borça uygulanan gecikme faizi (`gecikmis_taksit_faiz` ayarı)
`overdueBalanceExpiryDay`	Vadesi geçmiş borçların ağırlıklı ortalama geçikme gün sayısı
`undueBalance`	Vadesi gelmemiş toplam borç tutarı
`undueBalanceExpiryDay`	Vadesi gelmemiş borçların ağırlıklı ortalama kalan gün sayısı
`balance`	Net bakiye (odeme - borc); negatif = alacaklı durum
`currency`	Cari doviz birimi (`cr_doviz`)
`customerId`	Cari numarası
`customerCode`	Cari kodu
`customerName`	Cari unvanı

Örnek SOAP İstek

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

Hata Durumları

Durum	Açıklama
`Invalid Token`	Token geçersiz veya süresi dolmuş (30 dakika)
Boş / sıfır yanıt	Cari bulunamadı veya hiç borç kaydı yok

Notlar

overdueBalance ve undueBalance hesabı yapılırken ödeme tutarı (odeme) vadesi en eski borçlardan düşülerek net vade analizi yapılır (kayan pencere hesaplaması).
Gecikme faiz oranı tbayarlar tablosundaki gecikmis_taksit_faiz değerinden alınır.
Kullanıcının şube yetkisi (izin 645) hem cari hem borç/ödeme tablolarına otomatik uygulanır.