Rehber · 2026-05-16

API ve otomasyon hata mesajları

Yaygın entegrasyon hata kodlarının teknik olmayan kullanıcılar için açıklaması.

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.

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 bu hesap ya da endpoint için geçerli değil.	Doğru anahtarı oluşturun veya kopyalayın.
RATE_LIMITED	Kısa süre içinde çok fazla istek gönderildi.	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.

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.

Fatura dönüşümünü API ile bağlayın: erişim alın, idempotency anahtarıyla yükleyin, görevi sorgulayın ve sonucu indirin.

PDF faturaları e-postayla dönüştürün: Enterprise kanalını açın, gönderenleri doğrulayın, formatı seçin, gönderin ve yanıtı kontrol edin.

E-fatura projeleri için pratik ERP kontrol listesi: veri eşleme, format seçimi, doğrulama, istisna yönetimi ve canlıya geçiş kontrolleri.