Skip to main content
GET
Cari bakiyelerini listele
Salt okunur rapordur: bu sayfadaki hiçbir şey API üzerinden oluşturulamaz, güncellenemez ya da silinemez.
  • AsOfDate (opsiyonel, tarih + saat, ISO 8601 — ör. 2026-09-25T14:30:00) yalnızca bu tarih-saatten kesinlikle önceki hareketleri sayar; gönderilmezse geçerli tarih ve saat kullanılır. Örneğin 2026-09-25T00:00:00 gönderirseniz 25’in kendisi (00:00’dan itibaren) ve sonrası hariç tutulur, yalnızca 24’e kadarki hareketler dahil olur; 2026-09-25T14:30:00 gönderirseniz 25 Eylül saat 14:30’a kadarki (o an hariç) hareketler dahil olur — saat kısmını değiştirerek aynı günün istediğiniz noktasındaki bakiyeyi alabilirsiniz.
  • StartDate yoktur: bu, Cari işlemleri raporundan farklıdır — orada tarih aralığı vardır, burada yalnızca tek bir kesme noktası vardır ve bütün geçmiş hareketler bu noktaya kadar toplanır.
  • Yanıt cari başına gruplanır: her cari için CustomerCode/CustomerName ve Balances (döviz başına Debit/Credit/Balance) listesi döner. Bir cari birden fazla dövizde hareket gördüyse Balances birden fazla girdi içerir.
  • Yalnızca AsOfDate’ten önce en az bir hareketi olan cariler listede yer alır; hiç hareketi olmayan cariler dönmez.
  • ExcludeZeroBalance (opsiyonel, varsayılan false) true ise bakiyesi tam olarak 0 olan döviz satırları Balances’tan çıkarılır; bir carinin her dövizi 0’a netleşiyorsa o cari listeden tamamen çıkar (boş Balances ile dönmez). Bu filtre sayfalamadan önce uygulanır, yani TotalCount ve sayfa içeriği de bu filtreye göre hesaplanır.
  • MinAbsoluteBalance (opsiyonel, sayı) gönderilirse, mutlak değeri bu eşiğe eşit ya da küçük olan döviz satırları Balances’tan çıkarılır (ör. 100 gönderirseniz -100 ile 100 arası, uçlar dahil, tamamen elenir — yalnızca mutlak değeri kesin 100’den büyük olanlar kalır). Küçük kalıntı bakiyeleri (ör. kuruş farkları) ayıklamak için kullanılır; ExcludeZeroBalance ile birlikte de kullanılabilir. Bu filtre de sayfalamadan önce uygulanır.
  • Sayfalama page/pageSize (en fazla 50) cari sayısı üzerinden yapılır; bir carinin tüm dövizleri her zaman aynı sayfadadır. Arama parametresi yoktur.
  • Balance = Debit - Credit; pozitif değer carinin borçlu olduğunu gösterir.

Hata kodları

Bu endpoint’e özel bir hata kodu yoktur. Her endpoint için geçerli olan genel hatalar (kimlik doğrulama, yetki, istek header’ları, günlük limit) yine geçerlidir.

Yetkilendirmeler

Authorization
string
header
gerekli

Access token obtained from the Noyax auth service with your API key.

Başlıklar

X-UserID
integer<int32>
gerekli

İsteğin adına yapıldığı Noyax kullanıcısının ID'si. Oluşturulan, güncellenen ve silinen kayıtların denetim alanlarına yazılır.

Gerekli aralık: x >= 1
X-CompanyID
integer<int32>
gerekli

Şirketin ID'si. Kullanıcı bu şirkete tanımlı olmalıdır. Bütün okuma ve yazma işlemleri bu şirketle sınırlıdır.

Gerekli aralık: x >= 1
X-PeriodID
integer<int32>

Muhasebe döneminin ID'si. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Sorgu Parametreleri

page
integer<int32>
varsayılan:1

Sayfa numarası, 1'den başlar. Varsayılan 1.

pageSize
integer<int32>
varsayılan:50

Sayfa başına kayıt, en fazla 50. Varsayılan 50.

asOfDate
string<date-time>

Yalnızca bu tarih ve saatten kesinlikle önceki hareketler dahil edilir (ör. 25'i gönderirseniz 25'in kendisi ve sonrası hariç tutulur). ISO 8601 formatında, örneğin 2026-09-25T14:30:00. Gönderilmezse geçerli tarih ve saat kullanılır.

excludeZeroBalance
boolean
varsayılan:false

true ise bakiyesi tam olarak 0 olan dövizler Balances'ta yer almaz; her dövizi 0'a netleşen bir cari de listeden tamamen çıkar. Varsayılan false.

minAbsoluteBalance
number<double>

Gönderilirse, bakiyesinin mutlak değeri buna eşit ya da küçük olan dövizler Balances'ta yer almaz (ör. 100 gönderilirse -100 ile 100 arası, uçlar dahil, tamamen elenir); tüm dövizleri bu şekilde elenen bir cari de listeden tamamen çıkar. excludeZeroBalance ile birlikte kullanılabilir. Eşik istemiyorsanız göndermeyin.

Yanıt

OK

Success
boolean
gerekli

İşlemin başarılı olup olmadığı.

Örnek:

true

ResultCode
string
gerekli

Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.

Örnek:

"0000"

Data
object
gerekli

Response data. Null when Success is false.

Message
null | string

Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.