curl --request POST \
--url https://dev.noyax.com/services/noyax_api/api/v1/finance/bank-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": false,
"SharingCode": "<string>"
}
'using RestSharp;
var options = new RestClientOptions("https://dev.noyax.com/services/noyax_api/api/v1/finance/bank-accounts");
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 \"BankName\": \"İŞ BANKASI\",\n \"Name\": \"İş Bankası TRY Hesabı\",\n \"BranchName\": \"<string>\",\n \"BranchCode\": \"<string>\",\n \"AccountNumber\": \"<string>\",\n \"Iban\": \"<string>\",\n \"AccountType\": 1,\n \"CurrencyCode\": \"TRY\",\n \"IsDisabled\": false,\n \"SharingCode\": \"<string>\"\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({
BankName: 'İŞ BANKASI',
Name: 'İş Bankası TRY Hesabı',
BranchName: '<string>',
BranchCode: '<string>',
AccountNumber: '<string>',
Iban: '<string>',
AccountType: 1,
CurrencyCode: 'TRY',
IsDisabled: false,
SharingCode: '<string>'
})
};
fetch('https://dev.noyax.com/services/noyax_api/api/v1/finance/bank-accounts', 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/bank-accounts"
payload = {
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": False,
"SharingCode": "<string>"
}
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",
"BankId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": false,
"SharingCode": "<string>"
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "8016",
"Message": "AccountType must be between 1 and 4.",
"Errors": [
{
"Code": "8016",
"Message": "AccountType must be between 1 and 4."
}
]
}{
"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."
}
]
}Banka hesabı oluştur
Yeni banka hesabı ekler.
curl --request POST \
--url https://dev.noyax.com/services/noyax_api/api/v1/finance/bank-accounts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": false,
"SharingCode": "<string>"
}
'using RestSharp;
var options = new RestClientOptions("https://dev.noyax.com/services/noyax_api/api/v1/finance/bank-accounts");
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 \"BankName\": \"İŞ BANKASI\",\n \"Name\": \"İş Bankası TRY Hesabı\",\n \"BranchName\": \"<string>\",\n \"BranchCode\": \"<string>\",\n \"AccountNumber\": \"<string>\",\n \"Iban\": \"<string>\",\n \"AccountType\": 1,\n \"CurrencyCode\": \"TRY\",\n \"IsDisabled\": false,\n \"SharingCode\": \"<string>\"\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({
BankName: 'İŞ BANKASI',
Name: 'İş Bankası TRY Hesabı',
BranchName: '<string>',
BranchCode: '<string>',
AccountNumber: '<string>',
Iban: '<string>',
AccountType: 1,
CurrencyCode: 'TRY',
IsDisabled: false,
SharingCode: '<string>'
})
};
fetch('https://dev.noyax.com/services/noyax_api/api/v1/finance/bank-accounts', 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/bank-accounts"
payload = {
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": False,
"SharingCode": "<string>"
}
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",
"BankId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"BankName": "İŞ BANKASI",
"Name": "İş Bankası TRY Hesabı",
"BranchName": "<string>",
"BranchCode": "<string>",
"AccountNumber": "<string>",
"Iban": "<string>",
"AccountType": 1,
"CurrencyCode": "TRY",
"IsDisabled": false,
"SharingCode": "<string>"
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "8016",
"Message": "AccountType must be between 1 and 4.",
"Errors": [
{
"Code": "8016",
"Message": "AccountType must be between 1 and 4."
}
]
}{
"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."
}
]
}BankNamezorunludur ve şirketteki bankalardan biri olmalıdır.Namezorunludur.CurrencyCodezorunludur ve şirketteki dövizlerden biri olmalıdır.AccountType1 (Ticari hesap), 2 (Teminat hesabı), 3 (POS hesabı) ya da 4 (Kredi kartı hesabı — kendi kredi kartımız) olmalıdır.BranchName,BranchCode,AccountNumber,Ibanisteğe bağlıdır; azami uzunlukları alan açıklamasındadır, aşan değerler0003ile reddedilir.IsDisabledgönderilmezsefalsekabul edilir.SharingCodeisteğe bağlıdır; doluysa kullanıcının paylaşım kodlarından biri olmalı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ı |
|---|---|---|
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) |
8011 | 400 | Banka hesabı Name zorunlu |
8012 | 400 | BankName zorunlu |
8013 | 400 | BankName bulunamadı |
8014 | 400 | CurrencyCode zorunlu |
8015 | 400 | CurrencyCode bulunamadı |
8016 | 400 | AccountType 1-4 arasında olmalı |
8018 | 400 | SharingCode kullanıcının paylaşım kodlarından biri değil |
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. GET /api/v1/finance/banks'ten banka adı.
"İŞ BANKASI"
Zorunlu. Şirket içinde benzersiz hesap adı. En fazla 255 karakter.
"İş Bankası TRY Hesabı"
Şube adı. En fazla 50 karakter.
Şube kodu. En fazla 10 karakter.
Hesap numarası. En fazla 20 karakter.
IBAN. En fazla 50 karakter.
Zorunlu. 1: Ticari hesap, 2: Teminat hesabı, 3: POS hesabı, 4: Kredi kartı hesabı (şirketin kendi kredi kartı).
1
Zorunlu. GET /api/v1/definitions/currencies'ten döviz kodu.
"TRY"
Hesabın kullanım dışı olup olmadığı (yeni işlemlerde kullanılmaz).
false
Hesabı 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.
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"
Show child attributes
Show child attributes
Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.