Ana içeriğe geç

Hata Kodları Referansı

Bu sayfa, tüm eKüpSoft servislerinde karşılaşabileceğiniz hata kodlarını ve gerçek hata mesajlarını tek bir yerde toplar. Cevap zarfının genel yapısı için Cevap Yapısı bölümüne bakın.

Ortak hatalar (tüm uçlarda aynı)​

Aşağıdaki 3 hata, kimlik doğrulama/route/sunucu seviyesinde olduğu için her uçta aynı şekilde dönebilir (bkz. commonResponses).

KodKısa AçıklamaMesaj
401Unauthorizede-Posta veya şifre hatalı
404Not FoundThe route api/outsource/... could not be found.
500Server ErrorSunucu Hatası

Ek olarak, aktivasyon/hız limiti kapsamındaki uçlarda:

KodKısa AçıklamaMesaj
302YönlendirmeForm verileri ile ilgili sorun mevcut, lütfen verileri kontrol ediniz
429Too Many RequestsÇok fazla istek gönderildi.

422 — İş kuralı / validasyon hataları​

Bu hatalar endpoint'e özgüdür — hangi uçta hangisinin döndüğünü görmek için ilgili sayfanın Cevaplar (Responses) bölümüne bakın. Aşağıdaki liste, projede kullanılan tüm gerçek 422 mesajlarının kategorilere ayrılmış hâlidir (hızlı arama/Ctrl+F için).

Kimlik / Erişim / Etiket​

Mesaj
Bu vergi numarasına erişim izniniz yok.
Bu vergi numarasına ait adisyon gönderici etiketi bulunamadı.
Gönderici etiketi bulunamadı.
Hesaba ait aktif etiket bulunamadı. Lütfen etiket tanımlarınızı kontrol edin.
Aktif paket bulunamadı veya pakette yeterli hak yok.

XML / Şema / Şematron Doğrulama​

Mesaj
Şema / Şematron Kontrolü Hatalıdır.
E-Arşiv Özel Şematron Kontrolü Hatalıdır.
E-Adisyon Özel Şematron Kontrolü Hatalıdır.
XML içeriği boş olmamalıdır.
XML içeriği geçerli bir Base64 formatında değildir.
XML içeriğinde UBL-TR Invoice kök elemanı bulunamadı.
XML içerisinde CreditNote bulunamadı.
XML içerisinde ReceiptAdvice bulunamadı.
XML içerisinde zorunlu alan bulunamadı: :field
XML yapısı bozuk veya geçerli değildir. Hata: :error
Geçersiz DespatchAdvice XML formatı.
Belge imzalandı ancak doğrulama başarısız.
İrsaliye imzalandı ancak doğrulama başarısız.
Fatura XML oluşturma işlemi başarısız oldu. Lütfen gönderdiğiniz verileri kontrol edin.

e-Fatura / e-Arşiv İş Kuralları​

Mesaj
E-Arşiv kullanıcısı için E-Fatura gönderimi yapılamaz.
E-Fatura kullanıcısı için E-Arşiv gönderimi yapılamaz.
GIB kuralları gereği; GIB öneki kullanılamaz
NACE KDV Oran Kontrolü Hatalıdır.
Temel Fatura için Uygulama Yanıtı gönderimi yapılamaz.
Fatura zaten iptal edilmiş.
Fatura ile ilgili sorun mevcut lütfen güncelleme talep ediniz.

Uygulama Yanıtı Kuralları​

Mesaj
8 gün içerisinde uygulama yanıtı gönderimi yapılmalıdır.
Referans belge bulunamadı veya size ait değildir.
Referans belgeye ait uygulama yanıtı daha önce gönderilmiştir.

Belge Bulunamadı / Durum​

Mesaj
Sorgulanacak fatura bulunamadı.
Sorgulanacak irsaliye bulunamadı.
Belgeye ait zarf bulunamadı.
UBL dosyası bulunamadı.
UUID değeri boş olmamalıdır.
UUID değeri daha önce kullanılmış.
Dosya oluşturuluyor, lütfen birazdan tekrar deneyiniz.
ipucu

Bu sayfa yalnızca referans/arama amaçlıdır — her mesajın hangi endpoint'te, hangi koşulda döndüğünü görmek için ilgili endpoint'in kendi dokümantasyon sayfasına gidin (üstteki arama kutusunu veya sol menüyü kullanabilirsiniz).