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

# Kapsam ve sınırlamalar

> Desteklenen kaynaklar, mali işlem koşulları ve hata durumunda izlenecek adımlar.

Muhasip API; fatura, banka, POS ve tahsilat, GİB e-Arşiv, Trendyol pazaryeri, online işlemler, görevler, ajanda ve takvim kaynaklarını sunar. Kullanılabilir istekleri [API referansından](/api-reference/servis/core-get-apps) seçin.

## Entegrasyona başlamadan önce

* Geçerli API kimlik bilgilerini, ilgili modül izinlerini ve varsa IP kısıtını hazırlayın. [Kimlik ve izinler](/baslangic/kimlik-ve-izinler)
* Banka, POS ve e-belge işlemleri için ilgili hizmet bağlantısı etkin olmalıdır.
* Her işlemin alanlarını ve cevap biçimini kendi referansına göre kullanın. Firma uygulamalarının listelenmesi, ilgili bağlantının veya iznin hazır olduğunu göstermez.
* Google takvim bağlantısının kayıt durumu okunabilir; API üzerinden bağlantı oluşturma desteklenmez.

## Mali işlem koşulları

| İşlem | Desteklenen davranış ve sınır |
| - | - |
| Banka hareketini faturaya mahsup | Aynı firma, cari, para birimi ve yönde; açık ve daha önce ödeme almamış faturanın tam tutarı. Kısmi, önceden ödenmiş veya kapalı fatura `422` döndürür. |
| Döviz banka onayı | Kaydedilmiş pozitif kur gerekir. TRY dışında kur=1, fatura kuruyla uyuşmazlık veya kur farkı gereksinimi `422` döndürür. |
| Fatura iptali | Banka hareketine bağlı veya birden çok faturaya mahsup edilmiş ödeme varsa `409 INVOICE_COMPLEX_PAYMENT_CANCEL_UNSUPPORTED` döner; iptal başlatılmaz. |
| Desteklenmeyen kaynaktan fatura iptali | `409 INVOICE_EXCLUDED_SOURCE_CANCEL_UNSUPPORTED` döner; iptal başlatılmaz. |
| Eş zamanlı mali işlemler | Aynı firmada çakışan banka onayı, fatura aktarım/iptali veya pazaryeri aktarımı `409` döndürebilir. Okuma istekleri kullanılabilir. |
| Belirsiz mali sonuç | İşlem durumunu ve ilgili kayıtları inceleyin. Beklemek veya yeni anahtar üretmek, işlemi yeniden başlatma izni vermez. |
| Banka fatura otomasyonu | TRY hesapları ve tek `invoice` aksiyonu desteklenir. Etkin bağlantı, seri, belge şablonu, alıcı adresi ve toplamı yüzde 100 olan satır oranları gerekir. |
| POS tahsilat iptali | Yalnız aynı gün onaylanmış, başarılı ve henüz iade edilmemiş tahsilat iptal edilebilir. Kısmi veya geçmiş gün tahsilatı iptali desteklenmez. |
| GİB e-Arşiv | Kesin ETTN alınmadan belge başarıyla oluşturulmuş sayılmaz. SMS doğrulama ve imzalama ayrı adımlardır. |
| Pazaryeri aktarımı | TRY siparişinden fatura ve gerekirse cari, ürün veya depo oluşturur. E-belge gönderimi ve tahsilat ayrı işlemlerdir. |

## Sonuçları takip edin

Gereken işlemlerde `Idempotency-Key` kullanın. Dönen `operationId` ve kayıt kimliklerini saklayın. Tamamlanmış tekrar cevabında `replayed:true` ve sonuç kimlikleri bulunabilir; ilk cevabın bütün belge içeriği yeniden verilmez.

`reviewRequired:true` veya `retryable:false` durumunda otomatik tekrar yapmayın. [İşlem takibi](/rehberler/islem-takibi) ve [hata yönetimi](/rehberler/hata-yonetimi) rehberlerini izleyin.

## Cevap ve veri kuralları

* POS listesinde `isDefault=true` varsayılan hesabı, `false` ek hesapları getirir. Parametre gönderilmezse varsayılan hesap listelenir.
* Online işlem ayarlarında `status` boolean olarak zorunludur. Güncellemede `domain` gönderilmezse mevcut adres korunur.
* Bağlantı anahtarları ve parolaları cevaplardan geri okunmaz; erişim bilgilerinizi uygulamanızda güvenli saklayın.
* Proje, görev, ajanda ve takvimde yalnız izinli alanları gönderin. Geçersiz kimlik, tarih veya boş güncelleme reddedilebilir.
* Belge HTML/PDF çıktıları ve SMS imzası ilgili fatura veya e-Arşiv işlemleriyle yürütülür.

İstek sınırı istemci IP’si başına **6 saniyede 100 istektir**. Ayrıntılar [hız ve gövde sınırları](/rehberler/limitler) rehberindedir.


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