curl --request POST \
--url https://dev.noyax.com/services/noyax_api/api/v1/finance/credit-card-collections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"VoucherNumber": "Next",
"Date": "2026-09-24T16:02:00",
"BankAccountCode": "TEST POS",
"Description": "<string>",
"SharingCode": "<string>",
"Lines": [
{
"CustomerCode": "C-0001",
"Amount": 800,
"ExchangeRate": 1,
"PosChargeDate": "2026-09-24T16:03:00",
"RepaymentPlanName": "<string>",
"Description": "<string>",
"CustomerAmount": 123,
"CustomerCurrencyCode": "<string>",
"CustomerExchangeRate": 123
}
]
}
'using RestSharp;
var options = new RestClientOptions("https://dev.noyax.com/services/noyax_api/api/v1/finance/credit-card-collections");
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>");
request.AddJsonBody("{\n \"VoucherNumber\": \"Next\",\n \"Date\": \"2026-09-24T16:02:00\",\n \"BankAccountCode\": \"TEST POS\",\n \"Description\": \"<string>\",\n \"SharingCode\": \"<string>\",\n \"Lines\": [\n {\n \"CustomerCode\": \"C-0001\",\n \"Amount\": 800,\n \"ExchangeRate\": 1,\n \"PosChargeDate\": \"2026-09-24T16:03:00\",\n \"RepaymentPlanName\": \"<string>\",\n \"Description\": \"<string>\",\n \"CustomerAmount\": 123,\n \"CustomerCurrencyCode\": \"<string>\",\n \"CustomerExchangeRate\": 123\n }\n ]\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'POST',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
VoucherNumber: 'Next',
Date: '2026-09-24T16:02:00',
BankAccountCode: 'TEST POS',
Description: '<string>',
SharingCode: '<string>',
Lines: [
{
CustomerCode: 'C-0001',
Amount: 800,
ExchangeRate: 1,
PosChargeDate: '2026-09-24T16:03:00',
RepaymentPlanName: '<string>',
Description: '<string>',
CustomerAmount: 123,
CustomerCurrencyCode: '<string>',
CustomerExchangeRate: 123
}
]
})
};
fetch('https://dev.noyax.com/services/noyax_api/api/v1/finance/credit-card-collections', 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/credit-card-collections"
payload = {
"VoucherNumber": "Next",
"Date": "2026-09-24T16:02:00",
"BankAccountCode": "TEST POS",
"Description": "<string>",
"SharingCode": "<string>",
"Lines": [
{
"CustomerCode": "C-0001",
"Amount": 800,
"ExchangeRate": 1,
"PosChargeDate": "2026-09-24T16:03:00",
"RepaymentPlanName": "<string>",
"Description": "<string>",
"CustomerAmount": 123,
"CustomerCurrencyCode": "<string>",
"CustomerExchangeRate": 123
}
]
}
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"VoucherNumber": "<string>",
"Date": "2023-11-07T05:31:56Z",
"BankAccountCode": "<string>",
"BankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyCode": "<string>",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ExchangeRate": 123,
"Amount": 123,
"Description": "<string>",
"SharingCode": "<string>",
"SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"IsPosted": true,
"IsRepaid": true,
"CreateDate": "2023-11-07T05:31:56Z",
"ModifyDate": "2023-11-07T05:31:56Z",
"Lines": [
{
"CustomerName": "<string>",
"Valor": "2023-11-07T05:31:56Z",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"RepaymentPlanId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerCurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerCode": "C-0001",
"Amount": 800,
"ExchangeRate": 1,
"PosChargeDate": "2026-09-24T16:03:00",
"RepaymentPlanName": "<string>",
"Description": "<string>",
"CustomerAmount": 123,
"CustomerCurrencyCode": "<string>",
"CustomerExchangeRate": 123
}
]
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "8707",
"Message": "At least one line is required.",
"Errors": [
{
"Code": "8707",
"Message": "At least one line is required."
}
]
}{
"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."
}
]
}Kredi kartı tahsilat fişi oluştur
Yeni kredi kartı tahsilat fişini satırlarıyla birlikte tek işlemde ekler.
curl --request POST \
--url https://dev.noyax.com/services/noyax_api/api/v1/finance/credit-card-collections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"VoucherNumber": "Next",
"Date": "2026-09-24T16:02:00",
"BankAccountCode": "TEST POS",
"Description": "<string>",
"SharingCode": "<string>",
"Lines": [
{
"CustomerCode": "C-0001",
"Amount": 800,
"ExchangeRate": 1,
"PosChargeDate": "2026-09-24T16:03:00",
"RepaymentPlanName": "<string>",
"Description": "<string>",
"CustomerAmount": 123,
"CustomerCurrencyCode": "<string>",
"CustomerExchangeRate": 123
}
]
}
'using RestSharp;
var options = new RestClientOptions("https://dev.noyax.com/services/noyax_api/api/v1/finance/credit-card-collections");
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>");
request.AddJsonBody("{\n \"VoucherNumber\": \"Next\",\n \"Date\": \"2026-09-24T16:02:00\",\n \"BankAccountCode\": \"TEST POS\",\n \"Description\": \"<string>\",\n \"SharingCode\": \"<string>\",\n \"Lines\": [\n {\n \"CustomerCode\": \"C-0001\",\n \"Amount\": 800,\n \"ExchangeRate\": 1,\n \"PosChargeDate\": \"2026-09-24T16:03:00\",\n \"RepaymentPlanName\": \"<string>\",\n \"Description\": \"<string>\",\n \"CustomerAmount\": 123,\n \"CustomerCurrencyCode\": \"<string>\",\n \"CustomerExchangeRate\": 123\n }\n ]\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'POST',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
VoucherNumber: 'Next',
Date: '2026-09-24T16:02:00',
BankAccountCode: 'TEST POS',
Description: '<string>',
SharingCode: '<string>',
Lines: [
{
CustomerCode: 'C-0001',
Amount: 800,
ExchangeRate: 1,
PosChargeDate: '2026-09-24T16:03:00',
RepaymentPlanName: '<string>',
Description: '<string>',
CustomerAmount: 123,
CustomerCurrencyCode: '<string>',
CustomerExchangeRate: 123
}
]
})
};
fetch('https://dev.noyax.com/services/noyax_api/api/v1/finance/credit-card-collections', 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/credit-card-collections"
payload = {
"VoucherNumber": "Next",
"Date": "2026-09-24T16:02:00",
"BankAccountCode": "TEST POS",
"Description": "<string>",
"SharingCode": "<string>",
"Lines": [
{
"CustomerCode": "C-0001",
"Amount": 800,
"ExchangeRate": 1,
"PosChargeDate": "2026-09-24T16:03:00",
"RepaymentPlanName": "<string>",
"Description": "<string>",
"CustomerAmount": 123,
"CustomerCurrencyCode": "<string>",
"CustomerExchangeRate": 123
}
]
}
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"VoucherNumber": "<string>",
"Date": "2023-11-07T05:31:56Z",
"BankAccountCode": "<string>",
"BankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyCode": "<string>",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ExchangeRate": 123,
"Amount": 123,
"Description": "<string>",
"SharingCode": "<string>",
"SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"IsPosted": true,
"IsRepaid": true,
"CreateDate": "2023-11-07T05:31:56Z",
"ModifyDate": "2023-11-07T05:31:56Z",
"Lines": [
{
"CustomerName": "<string>",
"Valor": "2023-11-07T05:31:56Z",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"RepaymentPlanId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerCurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerCode": "C-0001",
"Amount": 800,
"ExchangeRate": 1,
"PosChargeDate": "2026-09-24T16:03:00",
"RepaymentPlanName": "<string>",
"Description": "<string>",
"CustomerAmount": 123,
"CustomerCurrencyCode": "<string>",
"CustomerExchangeRate": 123
}
]
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "8707",
"Message": "At least one line is required.",
"Errors": [
{
"Code": "8707",
"Message": "At least one line is required."
}
]
}{
"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."
}
]
}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ı |
|---|---|---|
0002 | 400 | İstek gövdesi okunamadı (bozuk JSON, alan tipi uyumsuz) |
0003 | 400 | Alan azami uzunluğu aşıyor (mesajda alan adı ve sınır yazar) |
0580 | 400 | Metinle verilen değer (kod ya da ad) birden fazla kayıtla eşleşiyor; hangisi olduğunu ayırt edecek bilgiyi ekleyin (ör. ilçe için City, il için Country) |
8180 | 400 | Şirket için "BANKAFİŞNO" seri tanımı bulunamadı |
8181 | 400 | Seri tanımının detayı yok |
8182 | 400 | Desteklenmeyen seri numarası bölüm tipi |
8183 | 400 | Üretilen fiş numarası azami uzunluğu aşıyor |
8184 | 400 | Üretilen fiş numarası şirkette zaten kullanılıyor |
8185 | 400 | Fiş numarası üretilemedi |
8701 | 400 | VoucherNumber zorunlu |
8702 | 400 | VoucherNumber şirkette (banka fişi tipleri arasında) kullanılıyor |
8703 | 400 | VoucherNumber güncellemede “Next” olamaz |
8704 | 400 | Date zorunlu |
8705 | 400 | BankAccountCode zorunlu |
8706 | 400 | BankAccountCode bulunamadı |
8707 | 400 | En az bir satır zorunlu |
8710 | 400 | SharingCode kullanıcının paylaşım kodlarından biri değil |
8800 | 400 | Satırda CustomerCode zorunlu |
8801 | 400 | Satırda cari bulunamadı |
8802 | 400 | Satırda Amount 0’dan büyük olmalı |
8803 | 400 | Satırda ExchangeRate (ya da CustomerExchangeRate) zorunlu ve 0’dan büyük olmalı |
8804 | 400 | Satırda PosChargeDate zorunlu |
8805 | 400 | Satırda RepaymentPlanName bulunamadı |
8806 | 400 | Satırda CustomerCurrencyCode bulunamadı |
8807 | 400 | Satırda CustomerAmount x CustomerExchangeRate, Amount x ExchangeRate’e eşit değil |
8808 | 400 | Satırda CustomerAmount ve CustomerCurrencyCode birlikte gönderilmeli |
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 >= 1Gövde
Zorunlu. Fiş numarası, şirkette tüm banka fişleri arasında benzersiz. Oluştururken "Next" gönderirseniz şirketin banka fişi numara serisinden üretilir. En fazla 20 karakter.
"Next"
Zorunlu. Fiş tarihi. Saat de gönderilirse fiş saati olarak yazılır, gönderilmezse o anki saat kullanılır.
"2026-09-24T16:02:00"
Zorunlu. Banka hesabı adı (GET /api/v1/finance/bank-accounts'tan Name). Fişteki bütün satırlar bu hesaba yazılır.
"TEST POS"
Açıklama. En fazla 1000 karakter.
Fişi kimlerin görebileceğini sınırlayan paylaşım kodu. Boşsa herkes görür; doluysa kullanıcının paylaşım kodlarından biri olmalıdır.
Zorunlu, en az bir satır.
Show child attributes
Show child attributes
Yanıt
Created
İş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.