Cari işlemleri
curl --request GET \
--url https://api.noyax.com/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://api.noyax.com/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://api.noyax.com/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://api.noyax.com/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
Cari işlemleri
Cariye ait koşan bakiyeli hareket dökümü.
GET
/
api
/
v1
/
finance
/
customers
/
{customerId}
/
transactions
Cari işlemleri
curl --request GET \
--url https://api.noyax.com/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://api.noyax.com/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://api.noyax.com/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://api.noyax.com/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."
}
]
}Salt okunur rapordur: bu sayfadaki hiçbir şey API üzerinden oluşturulamaz, güncellenemez ya da silinemez.
Yanıtta iki liste bulunur:
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ı, istek limitleri) 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
Başlıklar
Sorgu Parametreleri
Yanıt
OK