Ana içeriğe atla
PUT
Banka havale fişini güncelle
Tek tek alan değiştirecekseniz kısmi güncellemeyi kullanın: PATCH yalnızca gönderdiğiniz alanları değiştirir. TransferType değiştirilemez, VoucherNumber "Next" olamaz. Muhasebeleşmiş bir fiş güncellenemez. Satırların güncellemedeki kimliği ve kapatılmış hareket kilidi için genel bakış sayfasına bakın.

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.

Yetkilendirmeler

Authorization
string
header
gerekli

Access token obtained from the Noyax auth service with your API key.

Başlıklar

X-UserID
integer<int32>
gerekli

İ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.

Gerekli aralık: x >= 1
X-CompanyID
integer<int32>
gerekli

Ş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.

Gerekli aralık: x >= 1
X-PeriodID
integer<int32>

Muhasebe döneminin ID'si. İsteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Yol Parametreleri

bankTransferId
string<uuid>
gerekli

Banka havale fişi ID'si.

Gövde

TransferType
integer<int32>
gerekli

Zorunlu. 1: Gelen havale (Gelen EFT/Havale), 2: Giden havale (Giden EFT/Havale). Fiş oluşturulduktan sonra değiştirilemez.

Örnek:

1

VoucherNumber
null | string
gerekli

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.

Örnek:

"Next"

Date
null | string<date-time>
gerekli

Zorunlu. Fiş tarihi. Saat de gönderilirse fiş saati olarak yazılır, gönderilmezse o anki saat kullanılır.

Örnek:

"2026-09-24T14:06:00"

BankAccountName
null | string
gerekli

Zorunlu. Banka hesabı adı (GET /api/v1/finance/bank-accounts'tan Name). Fişteki bütün satırlar bu hesaba yazılır.

Örnek:

"Garanti TL Ticari"

Lines
object[]
gerekli

Zorunlu, en az bir satır.

Description
null | string

Açıklama. En fazla 1000 karakter.

SharingCode
null | string

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.

ExchangeRate
number<double>

Fişin kur değeri, entegratör tarafından hesaplanır (satırların ExchangeRate'inin Amount ile ağırlıklandırılmış ortalaması). Gönderildiği gibi saklanır; 0'dan büyük olmalıdır. Varsayılan 1.

Örnek:

1

Yanıt

OK

Success
boolean
gerekli

İşlemin başarılı olup olmadığı.

Örnek:

true

ResultCode
string
gerekli

Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.

Örnek:

"0000"

Data
object
gerekli

Response data. Null when Success is false.

Message
null | string

Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.