curl --request GET \
--url https://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions \
--header 'Authorization: Bearer <token>' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>'using RestSharp;
var options = new RestClientOptions("https://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions");
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://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions"
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,
"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": "8042",
"Message": "EndDate cannot be before StartDate.",
"Errors": [
{
"Code": "8042",
"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 işlemleri
Cariye ait koşan bakiyeli hareket dökümü.
curl --request GET \
--url https://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions \
--header 'Authorization: Bearer <token>' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>'using RestSharp;
var options = new RestClientOptions("https://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions");
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://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://dev.noyax.com/services/noyax_api/api/v1/finance/customers/{customerId}/transactions"
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,
"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": "8042",
"Message": "EndDate cannot be before StartDate.",
"Errors": [
{
"Code": "8042",
"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 (8040/8041) ve belge tarihine göre (her ikisi de dahil) aralığı belirler.EndDate,StartDate’ten önce olamaz (8042).CurrencyCode, 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, cari için görülen her döviz için bir satır içerir;EndDate’e kadarki (aralık öncesi de dahil) tüm hareketlerin genel toplamını (Borç toplamı eksi Alacak toplamı) taşır — bu değer, o dövizdeki hareketlerinEndDateitibarıyla koşan bakiyesine eşittir.StartDate’ten etkilenmez:StartDateyalnızcaLines’ta hangi hareketlerin listeleneceğini belirler. Bu yüzden bir dövizdeki tüm hareketlerStartDate’ten önceyse, o dövizLines’ta hiç görünmedenTotals’ta bir satır olarak çıkabilir. Her satırda ayrıca dövizin kısa kodu ve şirketin varsayılan dövizi olup olmadığı bulunur.Lines[].TransactionTypeName, satırın arkasındaki belgenin adıdır (ör. satış faturası, gelen havale).Lines[].TransactionAmount/TransactionCurrencyId, satırın kendiDebit/Credit/CurrencyCodealanları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.
Hata kodları
Bu endpoint’in dönebileceği kodlar. Her endpoint için geçerli olan genel hatalar (kimlik doğrulama, yetki, istek header’ları, günlük limit) burada tekrarlanmaz.| Kod | HTTP | Anlamı |
|---|---|---|
1000 | 404 | Cari bulunamadı ya da kullanıcı göremiyor. Alt kayıt endpoint’lerinde de döner |
8040 | 400 | StartDate zorunlu |
8041 | 400 | EndDate zorunlu |
8042 | 400 | EndDate, StartDate’ten önce olamaz |
8043 | 400 | currencyCode ile verilen döviz bulunamadı |
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ı getirir (GET /api/v1/definitions/currencies'ten döviz kodu, ör. TRY). Boşsa tüm dövizler dahildir.
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.