XRechnung doğrula: KoSIT-Validator, Schematron-Hatalar ve ne anlama geldikleri

KoSIT-Validator, bir XRechnung'un alıcıya ulaşmadan veya bir kamu satın alma kuruluşu tarafından reddedilmeden önce gerçekten standarda uygun olup olmadığını doğrulamak için kullandığınız referans yazılımdır. XML-Schema'ya karşı bir doğrulamayı XRechnung-Spesifikasyonundaki Schematron-Kuralları ile birleştirir ve yapısal hataları ve fatura mantığına karşı maddi ihlalleri bildirir. Kendi faturalamalarından veya bir otomasyon iş akışından XRechnungen oluşturanlar, bu doğrulamayı gönderimden önce planlamalı, bir fatura geri geldiğinde değil. Durum: Ağustos 2026.

KoSIT-Validator aslında ne doğruluyor?

KoSIT-Validator kendi dokümantasyonuna göre birkaç adımdan geçer: Mevcut XML-Formatını tanır, dosyayı XML-Schema ve Schematron-Kurallarına karşı doğrular, bundan bireysel bir rapor oluşturur ve bir kabul durumunu hesaplar. Gerçek doğrulama kuralları Validator'ün kendisinin sağlamadığı, sözde Senaryo-Dosyası denilen ayrı bir konfigürasyonun sağladığı. XRechnung için bunu XRechnung-Validator-Konfiguration, EN16931'den Schematron-Kuralları ve Almanca CIUS-XRechnung uzantısı ile UBL- ve UN/CEFACT-Rechnungen için uygun XML-Schemas'ı bir araya getirir. Bu konfigürasyon olmadan Validator hiçbir şey doğrulamaz, kasıtlı olarak genel bir araç olarak oluşturulmuştur.

Komut satırı üzerinden bir doğrulama nasıl başlatırsınız?

Validator'u bir Java-Programı olarak çağırırsınız ve ona Senaryo-Konfigurasyonunu ve doğrulanacak dosyayı geçersiniz. Pratik açıdan bu şu anlama gelir:

• Çağrı: java -jar validator-Version-standalone.jar -s Szenario-Konfigurationsdatei -r Repository-Pfad Dateiname, isteğe bağlı olarak ek parametreler ile.
• Yardım: --help parametresi tüm mevcut seçenekleri doğrudan Terminal'de gösterir.
• Alternatifler: Validator, kendi yazılıma bir Java-Kütüphanesi olarak da gömülebilir veya daemon modu'nda HTTP-Arayüzü ile çalıştırılabilir, -D parametresi aracılığıyla.

Otomasyon iş akışı için daemon modu özellikle ilginçtir, çünkü doğrulama daha sonra HTTP-Çağrısı aracılığıyla bir Pipeline'a takılabilir, her seferinde yeni bir işlem başlatmak yerine.

Schema-Hatalar Schematron-Hatalar'dan ne fark eder?

Bir Schema-Hatası, XML-Dosyasının öngörülen yapısına uymadığı anlamına gelir; örneğin, zorunlu bir alan tamamen eksik veya bir öğe yanlış yerde. Bunlar genellikle herhangi bir maddi doğrulamadan önce düzeltilmesi gereken katı teknik hatalarıdır. Öte yandan bir Schematron-Hatası, dosyanın yapısal olarak geçerli olduğu ancak XRechnung-Spesifikasyonunun maddi bir kuralını ihlal ettiği anlamına gelir; örneğin, toplamı tutmayan bir hesaplama veya seçilen kategoriye uymayan bir vergi oranı. Her iki hata türü de aynı XML-Raporunda yer alır ve nihai kabul durumuna ortak olarak girerler; Validator sonunda bu durumu bildirir.

Doğrulama gönderimden önce nasıl otomatikleştirilebilir?

En güvenilir, bir fatura hiç evinden çıkmadan önce otomatik olarak çalışan bir doğrulamadır. Bir n8n-Workflow'da, oluşturulan XRechnung-XML HTTP-İsteği aracılığıyla daemon modu'nda çalışan bir Validator-İnstansına gönderilebilir ve gönderme adımı başlamadan önce döndürülen rapor değerlendirilir. Doğrulama başarısız olursa, Workflow iptal edilir ve hata Muhasebe'ye bildirilir, geçersiz bir faturayı göndermek yerine. Tam da bu tür ön doğrulama ve onay adımları, biz aynı zamanda NordFlux kendi faturalamalarını yapan müşteriler için ayarlarız.

XRechnung doğrulama hakkında sık sorulan sorular

KoSIT-Validator ile doğrulama, gönderimden önce tek kontrol olarak yeterli midir?

EN16931 ve XRechnung-CIUS'a göre teknik ve maddi uygunluk için evet, çünkü Validator tam da bunun için oluşturulmuştur. Ancak, banka bağlantısı veya hizmet açıklaması gibi içerilen iş verilerinin maddi olarak doğru olup olmadığını kontrol etmez; bu sizin sorumluluğu olmaya devam eder.

Her fatura türü için ayrı bir konfigürasyon gerekli midir?

Evet, Senaryo-Konfigürasyonu ilgili formata bağlıdır. XRechnung için XRechnung-Validator-Konfigürasyonunu kullanırsınız, ZUGFeRD gibi diğer EN16931-Uygulamaları için ise buna göre kendi Schematron-Kuralları ile diğer konfigürasyon dosyaları vardır.

Validator'u Java bilgisi olmadan kullanabilir miyim?

Komut satırının temel bilgisi, tekil dosyalara karşı basit bir çağrı için yeterlidir, bunun için bir Java-Geliştirme ortamına ihtiyaç duymazsınız. Bir otomasyon İş Akışına, örneğin daemon modu aracılığıyla entegre etmek için HTTP-Çağrıları hakkında teknik anlayış faydalıdır.

Schematron-Kuralları değişirse ne olur?

XRechnung-Schematron-Kuralları anlamsal bir sürümü takip ederler: Ana sürümler uyumsuz kural değişiklikleri getirir, yan sürümler yeni kod listeleri gibi geçerli içerikleri genişletir ve Yama-Sürümler geriye dönük uyumlu hataları onarır. Kullanılan konfigürasyon sürümünü gözlemde tutmaya ve ana sürüm değişimlerinde mevcut doğrulama İş Akışlarını yeniden test etmeye değer.