> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Banka hareketinden ödeme kaydına

> Hareketi inceleyin, cariyi ve yönü doğrulayın; desteklenen tam fatura mahsubunu kontrollü tamamlayın.

Banka hareketine yorum eklemek, çalışma durumunu değiştirmek ve hareketi ödeme olarak onaylamak farklı etkilerdir. Hareket onayı mali ödeme kaydı oluşturabilir. Kısmi ödeme ve kur farkı gerektiren mahsuplar desteklenmez.

<Steps>
  <Step title="Hesabı ve hareketi okuyun">
    [Bağlı hesapları](/api-reference/banka/finance-list-banks), ardından [hareketleri](/api-reference/banka/finance-list-bank-transactions) okuyun. Gerekirse [hareket ayrıntısını](/api-reference/banka/finance-get-bank-transaction) alın.

    [Hesabı yenileme GET çağrısı](/api-reference/banka/finance-refresh-bank-account) banka hizmetini çalıştırır ve yerel verileri değiştirebilir; **write** izni ister. Hesap meşgulse `409`, hizmet sorunu varsa `502` alınabilir.
  </Step>

  <Step title="Eşleşme adayını değerlendirin">
    [Eşleşme tahmini](/api-reference/banka/finance-estimate-bank-match) eşleştirme adaylarını gösterir; hareketi onaylamaz ve ödeme oluşturmaz. Cariyi, banka yönünü, para birimini, tutarı ve varsa faturayı kendi iş bağlamınızda doğrulayın.
  </Step>

  <Step title="Onay türünü seçin">
    [Onay ucunda](/api-reference/banka/finance-approve-bank-transaction) `type=contact` cariye ödeme, `type=invoice` faturaya mahsup içindir. Her durumda hedef ve `contactsId` ilişkisi aynı firmada doğrulanmalıdır. Fatura mahsubunda `contactsId` zorunludur.

    Banka yönü tahsilat/ödeme yönüyle uyuşmalıdır. IBAN yalnız doğrulanan cariye ilişkilendirilir; başka cariye ait bir bilgiyi değiştirmek için bu ucu kullanmayın.
  </Step>

  <Step title="Mali sonucu doğrulayın">
    Dönen işlem makbuzunu ve güvenli ödeme/kayıt kimliklerini saklayın. Hareket ve ilgili fatura/ödeme durumunu tekrar okuyarak sonucu doğrulayın. Aynı hareketi yeni anahtarla tekrar onaylamayın.
  </Step>
</Steps>

## Faturaya mahsupta desteklenen sınır

* Fatura açık ve daha önce hiç ödeme almamış olmalıdır.
* Hareket, aynı firma/cari/para birimindeki faturanın **tam tutarını** karşılamalıdır.
* Gereken döviz kuru kaydedilmiş ve pozitif olmalıdır. TRY dışındaki kanıtsız `1` kuru veya faturayla uyuşmayan kur desteklenmez.
* Kısmi, daha önce ödenmiş, kapalı veya kur farkı gerektiren durumlar `422` ile reddedilir; ödeme kaydı oluşturulmaz.

## Otomasyon kullanıyorsanız

[Banka otomasyonları](/rehberler/kaynaklar/banka-otomasyonlari) API’de yalnız TRY hesabı ve desteklenen tek fatura aksiyonu sınırında çalışır. Aktif tanımın ayar ve satır dağılımı koşullarını sağlayın. Manuel `run` GET çağrısı mali işlem yapar ve `Idempotency-Key` ister.

Bir satırın sonucu belirsizse bütün çalışmayı başarılı saymayın. `review_required` durumunda otomasyon geçmişini, ilgili faturaları ve işlem sonucunu inceleyin; yeni anahtarla tekrar çalıştırmayın.

## Yorum veya durum güncellemesi

[Yorum güncellemesi](/api-reference/banka/finance-set-bank-transaction-comment) ve [çalışma durumu](/api-reference/banka/finance-set-bank-transaction-status) mali onayın yerine geçmez. Ödeme oluşturmak için onay akışını, yalnız not/durum değiştirmek için kendi kaynak ucunu kullanın.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.