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

# Sorun giderme

> Sık entegrasyon sorunlarını erişim, istek sözleşmesi ve mali sonuç açısından araştırın.

## Health çalışıyor, uygulama listesi çalışmıyor

`/health` kimliksizdir. `/apps` için aktif API kimliği, uygun firma, IP ve `muhasip:apps:read` izni gerekir. Sağlık cevabı bu koşulları doğrulamaz. Erişim ayarlarınızı [kimlik ve izinler](/baslangic/kimlik-ve-izinler) rehberine göre kontrol edin.

## Firma uygulamada görünüyor ama işlem yetkim yok

İlgili işlem sayfasındaki izinleri ve bağlantı ön koşullarını kontrol edin. Anahtarınızın gereken okuma veya yazma iznine sahip olduğundan ve ilgili hizmet bağlantısının etkin olduğundan emin olun.

## GET çağrısı write izni istiyor

Banka yenileme, fatura aktarım/eşitleme, banka otomasyonu çalıştırma ve bazı pazaryeri sorguları veri değiştirebilir. Bu uçlarda GET salt okuma anlamına gelmez. `HEAD` ile aynı işlemi çalıştırmaya çalışmayın.

## `Idempotency-Key` ekledim ama 409 devam ediyor

Aynı hedef farklı anahtarla korumayı aşmaz. Mevcut işlem sürüyor, hedef kilitli veya içerik değişmiş olabilir. `operationId` ile durumu okuyun; yeni anahtar üretmeyin. `failed_before_dispatch` istisnasını yalnız işlem durumundaki kontrollü koşullarla değerlendirin.

## İlk cevapta belge vardı, tekrarda yok

`replayed:true` cevapları güvenli makbuz ve kimliklerle sınırlı olabilir. İlk HTML/PDF, belge içeriği veya bütün mali gövde tekrar edilmez. Uygun sonuç kimliğiyle ilgili kaynağı okuyun.

## Banka hareketini kısmi faturaya bağlayamıyorum

Banka hareketi yalnız açık ve daha önce ödeme almamış faturanın tam tutarına mahsup edilebilir. Cari, ödeme yönü, para birimi ve kur eşleşmelidir. Kısmi, önceden ödenmiş veya kur farkı gerektiren işlem `422` ile reddedilir. Kur bilinmiyorsa `1` göndererek devam etmeyin.

## Fatura iptali karmaşık ödeme ilişkisi nedeniyle reddediliyor

Banka hareketine bağlı veya birden çok faturaya mahsup edilmiş ödeme içeren iptal `409 INVOICE_COMPLEX_PAYMENT_CANCEL_UNSUPPORTED` ile reddedilir. Desteklenmeyen kaynaktan oluşturulmuş faturada `409 INVOICE_EXCLUDED_SOURCE_CANCEL_UNSUPPORTED` döner. Bu hatalarda iptal başlatılmaz; kayıt ilişkilerini inceleyin ve işlemi otomatik yeniden göndermeyin.

## GİB taslağında kesin ETTN yok

Son belge listesini veya rastgele UUID’yi yeni belgenin kimliği saymayın. İşlem `review_required` ise yeni belge göndermeyin; GİB ve yerel işlem kayıtlarıyla yetkili inceleme yapın.

## Sayfada boş sonuç veya beklenmeyen alan var

Liste ve geçmiş parametreleri farklı olabilir. `page/limit` ile `page/pageSize` ayrımını ve kaynağın `result`, `resultData`, `total` alanlarını kontrol edin. Her uçta aynı zarf, sıralama veya cursor beklemeyin.

## Destek kaydı hazırlarken

HTTP yöntemini, dokümandaki yolu, yaklaşık zamanı, HTTP kodunu, güvenli hata kodunu ve varsa işlem kimliğini paylaşın. API secret, entegrasyon parolası, SMS kodu, ham belge ve kişisel verileri rapora koymayın. Gerçek firma verileriyle yapılacak incelemeyi yetkili destek kanalında yürütün.

[Hata yönetimi](/rehberler/hata-yonetimi) · [İşlem takibi](/rehberler/islem-takibi) · [Manuel kabul](/rehberler/manuel-kabul)


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