Rehber · Mayıs 2026’da güncellendi
Markdown dışa aktarAPI ve otomasyon hata mesajları
Common integration error codes explained for non-technical users.
Bu kimin için
Bir müşteri entegrasyon, otomasyon veya toplu iş akışından hata gördüğünde ve hangi adımı atacağını bilmesi gerektiğinde bu makaleyi kullanın.
Yaygın mesajlar
| Mesaj veya kod | Ne anlama gelir | Ne yapmalı |
|---|---|---|
| AUTHENTICATION_REQUIRED | İstek kullanılabilir bir oturum bilgisi veya bearer token içermiyordu. | Tekrar oturum açın veya eksik API tokenini ekleyin. |
| INVALID_API_KEY | API anahtarı yanlış, süresi dolmuş, iptal edilmiş veya yanlış ortamdan geliyor. | Doğru anahtarı oluşturun veya kopyalayın. |
| RATE_LIMITED | Too many requests were sent in a short period. | Yeniden deneme penceresini bekleyin, sonra daha yavaş devam edin. |
| PAYLOAD_TOO_LARGE | Yüklenen dosya boyut sınırını aşıyor. | PDF’i sıkıştırın veya işi daha küçük faturalara bölün. |
| INVALID_UPLOAD | Yüklenen dosya geçerli bir fatura girdisi olarak okunamadı. | Dosyanın boş, bozuk, parola korumalı veya yanlış formatta olmadığını kontrol edin. |
| VALIDATION_FAILED | Fatura verilerinde engelleyici sorunlar var. | Dönen alanları inceleyin ve tekrar denemeden önce fatura verilerini düzeltin. |
| OUTPUT_PROFILE_REQUIRED | İstenen çıktı formatı daha net bir uyumluluk profili gerektirir. | XRechnung, EN 16931, ZUGFeRD veya Factur-X gibi hedef profili seçin. |
| OUTPUT_PROFILE_CONFLICT | Seçilen format ve profil birbiriyle çelişiyor. | Uyumlu bir çıktı hedefi seçin ve tekrar deneyin. |
Yeniden deneme rehberi
Zaman aşımı, kullanılamayan servisler ve bazı yükleme hataları gibi geçici hataları yeniden deneyin.
Doğrulama, kimlik doğrulama, hız sınırı, dosya boyutu veya profil hatalarını körü körüne yeniden denemeyin. Önce düzeltme gerekir.