XRechnung Hata Kodları: Kapsamlı Sorun Giderme Kılavuzu 2025
Bu hata kılavuzunda:
XRechnung Doğrulama ve Hata Kodlarını Anlama
XRechnung doğrulama birden çok seviyede gerçekleşir: şema doğrulama, iş kuralları (BR) ve Almanya'ya özgü kurallar (BR-DE). Bu hata kodlarını anlamak, gönderim öncesi sorunları hızla belirlemenize ve düzeltmenize yardımcı olur.
Hata kodları yapılandırılmış bir format izler:
- BR-XX: EN 16931'den Avrupa standart iş kuralları
- BR-DE-XX: Almanya'ya özgü iş kuralları
- Şema hataları: XML yapısı ve sözdizimi ihlalleri
- Doğrulama hataları: Veri tutarlılığı ve hesaplama sorunları
İş Kuralı (BR) Hataları - Avrupa Standardı
BR-01: Fatura Numarası Gerekli
Hata Mesajı: "Faturada fatura numarası (BT-1) bulunmalıdır."
Neden: Eksik fatura numarası
Çözüm: BT-1 alanına benzersiz bir fatura numarası ekleyin
Örnek: <cbc:ID>RE-2025-001234</cbc:ID>
BR-02: Fatura Düzenleme Tarihi Gerekli
Hata Mesajı: "Faturada fatura düzenleme tarihi (BT-2) bulunmalıdır."
Neden: Eksik veya geçersiz fatura tarihi
Çözüm: YYYY-AA-GG formatında düzenleme tarihi ekleyin
Örnek: <cbc:IssueDate>2025-01-16</cbc:IssueDate>
BR-04: Fatura Tipi Kodu Gerekli
Hata Mesajı: "Faturada fatura tipi kodu (BT-3) bulunmalıdır."
Neden: Eksik fatura tipi belirtimi
Çözüm: Tip kodu ekleyin (fatura için 380, alacak dekontu için 381)
Örnek: <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
BR-16: Satır Net Tutarı Gerekli
Hata Mesajı: "Fatura satırında fatura satırı net tutarı (BT-131) bulunmalıdır."
Neden: Fatura satırı için eksik net tutar
Çözüm: Her satırın miktar × birim fiyat = satır net tutarı olduğundan emin olun
BR-45: KDV Kategorisi Gerekli
Hata Mesajı: "Her KDV dökümünde KDV kategori kodu (BT-118) bulunmalıdır."
Neden: Vergi dökümünde eksik KDV kategorisi
Çözüm: Uygun KDV kategori kodunu ekleyin (S, AA, Z, E, vb.)
BR-49: Ödeme Yöntemi Gerekli
Hata Mesajı: "Ödeme talimatında ödeme yöntemi tip kodu (BT-81) belirtilmelidir."
Neden: Eksik ödeme yöntemi belirtimi
Çözüm: Ödeme yöntemi kodu ekleyin (30=havale, 59=SEPA)
Almanya'ya Özgü (BR-DE) Hatalar
BR-DE-1: Leitweg-ID Gerekli
Hata Mesajı: "Element 'Alıcı referansı' (BT-10) iletilmelidir (Leitweg-ID)."
Neden: B2G faturaları için eksik veya hatalı Leitweg-ID
Çözüm: Kamu kurumu tarafından sağlanan tam Leitweg-ID'yi ekleyin
Kritik: Tireler ve büyük/küçük harf dahil tam olarak eşleşmelidir
BR-DE-2: Satıcı Elektronik Adresi Gerekli
Hata Mesajı: "Element 'Satıcı elektronik adresi' (BT-34) iletilmelidir."
Neden: Eksik satıcı elektronik uç nokta kimliği
Çözüm: Uç nokta olarak PEPPOL kimliği veya e-posta adresi ekleyin
Örnek: DE:VAT:DE123456789 veya fatura@sirket.de
BR-DE-16: Belirli Vergi Kodları için KDV Kimliği Gerekli
Hata Mesajı: "Faturada en az 'Satıcı KDV tanımlayıcısı' (BT-31) veya 'Satıcı vergi kayıt tanımlayıcısı' (BT-32) elementlerinden biri iletilmelidir."
Neden: KDV kimliği olmadan S, Z, E, AE, K, G, L veya M vergi kodlarının kullanılması
Çözüm: Satıcının KDV tanımlayıcısını ekleyin (USt-IdNr.)
Format: DE123456789 (ülke kodu + numara)
BR-DE-19: Skonto için Ödeme Koşulları
Hata Mesajı: "Ödeme koşulları (BT-20) ödeme iskontosu koşullarını belirtmelidir."
Neden: Uygun koşullar olmadan nakit iskontosu teklifi
Çözüm: Ödeme koşullarına iskonto yüzdesi ve süresini dahil edin
Örnek: "#SKONTO#TAGE=14#PROZENT=2.00#"
Şema Doğrulama Hataları
Geçersiz XML Yapısı
Hata: "'Invoice' elementinin içeriği tamamlanmamış"
Neden: Eksik gerekli XML elementleri veya yanlış sıra
Çözüm: Tüm zorunlu elementlerin doğru sırada mevcut olduğundan emin olun
- Ad alanı bildirimlerini kontrol edin
- Element sırasının şemayla eşleştiğini doğrulayın
- Eksik kapanış etiketlerinin olmadığından emin olun
Geçersiz Veri Tipi
Hata: "Elementle başlayan geçersiz içerik bulundu"
Neden: Yanlış veri tipi (örn. sayısal alanda metin)
Çözüm: Doğru veri tiplerini sağlayın:
- Tutarlar: Maksimum 2 ondalık basamaklı ondalık
- Tarihler: YYYY-AA-GG formatı
- Kodlar: Yalnızca geçerli kod listesi değerleri
Ad Alanı Hataları
Hata: "Elementin bildirimi bulunamıyor"
Neden: Eksik veya yanlış ad alanı bildirimleri
Çözüm: UBL veya CII sözdizimi için doğru ad alanlarını doğrulayın
UBL: xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
Hesaplama ve Mantık Hataları
BR-CO-10: Satır Tutarları Toplamı Hatası
Hata: "Fatura satırı net tutarları toplamı = KDV hariç fatura toplam tutarı"
Neden: Satır kalemleri ara toplama eklenmez
Çözüm: Yeniden hesaplayın: Tüm satır net tutarlarının toplamı fatura ara toplamına eşit olmalıdır
Kontrol: Σ(Satır tutarları) = Fatura ara toplamı
BR-CO-14: KDV Hesaplama Hatası
Hata: "Fatura toplam KDV tutarı = Σ KDV kategori vergi tutarları"
Neden: KDV hesaplamaları eşleşmiyor
Çözüm: Her kategori için KDV'nin doğru hesaplandığından emin olun
Formül: Vergilendirilebilir tutar × KDV oranı = KDV tutarı
BR-CO-15: Fatura Toplamı Hatası
Hata: "KDV dahil fatura toplam tutarı = KDV hariç fatura toplamı + Fatura toplam KDV"
Neden: Genel toplam hesaplaması yanlış
Çözüm: Doğrulayın: Ara toplam + Toplam KDV = Genel Toplam
Format ve Veri Tipi Hataları
Tarih Formatı Hataları
Yaygın Sorunlar:
- Yanlış format: YYYY-AA-GG olmalıdır (GG.AA.YYYY değil)
- Geçersiz tarihler: İmkansız tarihleri kontrol edin (örn. 2025-13-32)
- Eksik baştaki sıfırlar: 2025-1-5 değil 2025-01-05 kullanın
Tutar Formatı Hataları
Yaygın Sorunlar:
- Ondalık ayırıcı: Virgül (,) değil nokta (.) kullanın
- Ondalık basamaklar: Parasal tutarlar için maksimum 2
- Negatif tutarlar: Parantez değil eksi işareti kullanın
Doğru: 1234.56 | Yanlış: 1.234,56
Kod Listesi Hataları
Yaygın Sorunlar:
- Geçersiz para birimi: ISO 4217 kodlarını kullanın (EUR, USD, GBP)
- Geçersiz ülke: ISO 3166-1 Alpha-2 kullanın (DE, FR, IT)
- Geçersiz birim: UN/ECE Öneri 20 kodlarını kullanın
Yönlendirme ve İletim Hataları
Leitweg-ID Bulunamadı
Hata: "Leitweg-ID eşleştirilemedi"
Neden: Bilinmeyen veya aktif olmayan Leitweg-ID
Çözüm:
- Leitweg-ID'yi alıcıyla doğrulayın
- Yazım hatalarını kontrol edin (büyük/küçük harfe duyarlı!)
- Kimliğin hala aktif olduğundan emin olun
Dosya Boyutu Aşıldı
Hata: "Maksimum dosya boyutu aşıldı"
Neden: Fatura dosyası çok büyük (genellikle >15MB)
Çözüm:
- Gömülü ekleri kaldırın
- Ekleri ayrı gönderin
- Dosya yapısını optimize edin
Sorun Giderme Adımları
Adım Adım Sorun Giderme
-
Resmi Doğrulayıcıları Kullanın
- XRechnung uyumluluğu için KoSIT Doğrulayıcı
- Portala özel doğrulayıcılar
-
Hata Hiyerarşisini Kontrol Edin
- Önce şema hatalarını düzeltin
- Sonra iş kuralı ihlallerini
- Son olarak hesaplama hatalarını
-
Örneklere Karşı Doğrulayın
- Çalışan örneklerle karşılaştırın
- Resmi test durumlarını kullanın
-
Minimal Faturayla Test Edin
- Yalnızca zorunlu alanlarla başlayın
- İsteğe bağlı alanları kademeli olarak ekleyin
Yaygın Hızlı Düzeltmeler
- ✓ Leitweg-ID'yi karakter karakter iki kez kontrol edin
- ✓ Tüm tarihlerin YYYY-AA-GG formatında olduğundan emin olun
- ✓ KDV hesaplamalarını manuel olarak doğrulayın
- ✓ Para birimi ve ülke kodlarını kontrol edin
- ✓ Satıcının elektronik adresinin olduğunu doğrulayın
- ✓ Vergilendirilebilir kategoriler kullanırken KDV kimliğini onaylayın
Dönüştürücümüzle Doğrulama Hatalarından Kaçının
XRechnung dönüştürücümüz faturanızı otomatik olarak doğrular ve çözümlerle birlikte net hata mesajları sağlar:
- Veri girerken gerçek zamanlı doğrulama
- Sade dilde net hata açıklamaları
- Otomatik hesaplama doğrulaması
- Format uyumluluğu garanti edilir
🚀 Faturalarınızı dönüştürmeye hazır mısınız?
PDF faturalarınızı bugün XRechnung, ZUGFeRD ve diğer formatlara dönüştürmeye başlayın. 3 günlük ücretsiz deneme dahil.