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).
| Kod | Kısa Açıklama | Mesaj |
|---|---|---|
| 401 | Unauthorized | e-Posta veya şifre hatalı |
| 404 | Not Found | The route api/outsource/... could not be found. |
| 500 | Server Error | Sunucu Hatası |
Ek olarak, aktivasyon/hız limiti kapsamındaki uçlarda:
| Kod | Kısa Açıklama | Mesaj |
|---|---|---|
| 302 | Yönlendirme | Form verileri ile ilgili sorun mevcut, lütfen verileri kontrol ediniz |
| 429 | Too 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. |
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).