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 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şlem422 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 iptal409 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. İşlemreview_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.