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

# Entegrasyon notları

> Muhasip API entegrasyonunda dikkate alınacak istek, izin ve mali işlem kuralları.

## 18 Ekim 2026

* Gereken mali çağrılarda `Idempotency-Key` kullanın ve dönen işlem kimliğini saklayın. Tekrar cevabı sonuç kimlikleriyle sınırlı olabilir.
* Okuma ve yazma izinlerini ayrı tanımlayın. Firma ve IP erişim koşullarını kontrol edin.
* POS listesinde `isDefault=true` varsayılan hesabı, `false` ek hesapları seçer.
* Online işlem ayarını kaydederken `status` boolean olarak zorunludur; güncellemede atlanan `domain` korunur.
* Faturada `type=view` taslak oluşturur. Veri değiştiren GET istekleri yazma izni gerektirir.
* Banka hareketini faturaya mahsupta yalnız açık ve daha önce ödeme almamış faturanın tam tutarı desteklenir. Kısmi ödeme ve kur farkı gerektiren işlemler `422` döndürür.
* Fatura iptalinde banka hareketine bağlı veya birden çok faturaya mahsup edilmiş ödeme varsa `409` döner ve iptal başlatılmaz.
* GİB e-Arşiv’de belge kimliğini kesin ETTN üzerinden doğrulayın.

Ayrıntılar için [ortak kurallar](/baslangic/ortak-kurallar), [işlem takibi](/rehberler/islem-takibi) ve [kapsam ve sınırlamalar](/rehberler/kapsam-ve-sinirlamalar) sayfalarını inceleyin.


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