curl --request GET \
--url https://api.noyax.com/api/v1/customers/{customerId}/statement \
--header 'Authorization: Bearer <token>' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/customers/{customerId}/statement");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'GET',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.noyax.com/api/v1/customers/{customerId}/statement', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/customers/{customerId}/statement"
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Lines": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Date": "2023-11-07T05:31:56Z",
"Debit": 123,
"Credit": 123,
"Balance": 123,
"TransactionType": 122,
"TransactionTypeName": "Sales invoice",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Description": "<string>",
"DocumentNumber": "<string>",
"ExchangeRate": 123,
"DueDate": "2023-11-07T05:31:56Z",
"TransactionAmount": 123,
"TransactionCurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"InstallmentCount": 123,
"DocumentUrl": "<string>",
"CreateDate": "2023-11-07T05:31:56Z",
"ModifyDate": "2023-11-07T05:31:56Z"
}
],
"Totals": [
{
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyCode": "TRY",
"IsDefault": true,
"Balance": 123
}
]
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "1025",
"Message": "EndDate cannot be before StartDate.",
"Errors": [
{
"Code": "1025",
"Message": "EndDate cannot be before StartDate."
}
]
}{
"Success": false,
"ResultCode": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token.",
"Errors": [
{
"Code": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token."
}
]
}{
"Success": false,
"ResultCode": "0110",
"Message": "You do not have permission for this operation.",
"Errors": [
{
"Code": "0110",
"Message": "You do not have permission for this operation."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}Cari ekstresi
Cariye ait koşan bakiyeli hareket dökümü.
curl --request GET \
--url https://api.noyax.com/api/v1/customers/{customerId}/statement \
--header 'Authorization: Bearer <token>' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/customers/{customerId}/statement");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'GET',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.noyax.com/api/v1/customers/{customerId}/statement', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/customers/{customerId}/statement"
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Lines": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Date": "2023-11-07T05:31:56Z",
"Debit": 123,
"Credit": 123,
"Balance": 123,
"TransactionType": 122,
"TransactionTypeName": "Sales invoice",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Description": "<string>",
"DocumentNumber": "<string>",
"ExchangeRate": 123,
"DueDate": "2023-11-07T05:31:56Z",
"TransactionAmount": 123,
"TransactionCurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"InstallmentCount": 123,
"DocumentUrl": "<string>",
"CreateDate": "2023-11-07T05:31:56Z",
"ModifyDate": "2023-11-07T05:31:56Z"
}
],
"Totals": [
{
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyCode": "TRY",
"IsDefault": true,
"Balance": 123
}
]
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "1025",
"Message": "EndDate cannot be before StartDate.",
"Errors": [
{
"Code": "1025",
"Message": "EndDate cannot be before StartDate."
}
]
}{
"Success": false,
"ResultCode": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token.",
"Errors": [
{
"Code": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token."
}
]
}{
"Success": false,
"ResultCode": "0110",
"Message": "You do not have permission for this operation.",
"Errors": [
{
"Code": "0110",
"Message": "You do not have permission for this operation."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}Lines (hareket dökümü) ve Totals (döviz başına genel toplam).
StartDateveEndDatezorunludur (1023/1024) ve belge tarihine göre (her ikisi de dahil) aralığı belirler.EndDate,StartDate’ten önce olamaz (1025).CurrencyId, hemLines’ı hemTotals’ı tek bir dövize daraltır; boş bırakılırsa tüm dövizler döner.Linesbelge tarihine, sonra iç belge sırasına göre sıralanır.Lines[].Balance, döviz başına koşan bakiyedir: o dövizde, bu satır dahil o ana kadarki kümülatif Borç − Alacak değeridir; dövizler arası birleşik tek bir toplam değildir. Cari birden fazla dövizde hareket görmüşse, her döviz kendi bakiye sırasına sahiptir.Totals,Lines’ta görülen her döviz için bir satır içerir; ilgili dövizdeki tüm tarih aralığının genel toplamını (Borç toplamı eksi Alacak toplamı) taşır — bu değer, o dövizdeki son satırınBalance’ına eşittir. Her satırda ayrıca dövizin kısa kodu ve şirketin varsayılan dövizi olup olmadığı bulunur.Lines[].TransactionType, ham belge tipi kodudur;TransactionTypeName, aşağıdaki tablodan çözülmüş İngilizce adıdır.Lines[].TransactionAmount/TransactionCurrencyId, satırın kendiDebit/Credit/CurrencyIdalanlarından farklı olabilecek durumlarda (ör. banka hesabının kendi döviziyle yapılan ama cariye başka bir dövizle yansıyan bir havale) belgenin asıl tutarını ve dövizini taşır. Satırın kendi dövizi zaten belgenin dövizi isenulldöner — bu, fatura/sipariş satırlarının çoğunda beklenen bir durumdur, eksik veri değildir.Lines[].InstallmentCount, bu hareketle ilişkili taksit sayısıdır; taksit yoksa0’dır.
Hareket tipleri
TransactionType, satırın arkasındaki belge türünü gösterir.
| Kod | Anlamı |
|---|---|
| 101 | Cari açılış |
| 102 | Borç dekontu |
| 103 | Alacak dekontu |
| 104 | Cari virman |
| 111 | Alış siparişi |
| 112 | Satış siparişi |
| 121 | Alış faturası |
| 122 | Satış faturası |
| 123 | Alış iade faturası |
| 124 | Satış iade faturası |
| 131 | Müstahsil makbuzu |
| 141 | Alış serbest meslek makbuzu |
| 201 | Cari tahsilat (kasa) |
| 202 | Cari ödeme (kasa) |
| 203 | Cari tahsilat ve ödeme (kasa) |
| 211 | Bankaya yatırılan (kasadan) |
| 212 | Bankadan çekilen (kasaya) |
| 213 | Bankaya yatırılan ve bankadan çekilen |
| 221 | Kasa açılış |
| 222 | Kasa virman |
| 231 | Masraf (kasa) |
| 241 | Çek/senet tahsilatı (kasa) |
| 242 | Senet ödemesi (kasa) |
| 250 | Kasadan personele maaş ödemesi |
| 251 | Kasadan personele ek mesai ödemesi |
| 255 | Kasadan personele avans ödemesi |
| 256 | Kasadan personele harcırah ödemesi |
| 260 | Kasaya personelden iade |
| 301 | Gelen havale |
| 302 | Giden havale |
| 303 | Gelen ve giden havale |
| 311 | Banka hesabı açılış |
| 312 | Banka virman |
| 321 | Kredi kartı |
| 322 | Banka geri ödemesi |
| 331 | Masraf (banka hesabı) |
| 341 | Çek/senet tahsilatı (banka) |
| 342 | Çek/senet ödemesi (banka) |
| 343 | Çek/senet portföye geri alma |
| 350 | Bankadan personele maaş ödemesi |
| 351 | Bankadan personele ek mesai ödemesi |
| 355 | Bankadan personele avans ödemesi |
| 356 | Bankadan personele harcırah ödemesi |
| 400 | Çek hareketi |
| 450 | Senet hareketi |
| 500 | Mahsup fişi |
| 610 | Bordro tahakkuku |
| 620 | Bordro kesintisi |
Yetkilendirmeler
Access token obtained from the Noyax auth service with your API key.
Başlıklar
İ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.
x >= 1Ş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.
x >= 1Muhasebe döneminin ID'si. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.
x >= 1Yol Parametreleri
Cari ID'si.
Sorgu Parametreleri
Zorunlu. Tarih aralığının başlangıcı (dahil).
Zorunlu. Tarih aralığının bitişi (dahil). StartDate'ten önce olamaz.
Yalnızca bu dövizdeki satırları döner, GET /api/v1/definitions/currencies içinden. Boş bırakılırsa tüm dövizler döner.
Yanıt
OK
İşlemin başarılı olup olmadığı.
true
Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.
"0000"
Response data. Null when Success is false.
Show child attributes
Show child attributes
Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.