XRechnung'u Okunabilir Hale Getirme: Görüntüleyici, Görselleştirme ve Arşive Ne Girmeli

XRechnung, hiçbir insanın doğrudan okumaması gereken bir XML dosyasıdır ve bir memur veya müşteri yine de faturaya bir göz atmak istediğinde sorunun tam da özü budur. Bunun çözümüne görselleştirme denir: XML yapısından, yasal olarak bağlayıcı olan orijinal XML'de hiçbir şeyi değiştirmeden, insan tarafından okunabilir bir HTML veya PDF görünümü oluşturan bir XSLT dönüşümü. Bu makale, bunun teknik olarak nasıl çalıştığını ve bunun ne kadarının otomatikleştirilebileceğini göstermektedir. Güncelleme: Ağustos 2026.

Bir XRechnung neden basitçe bir tarayıcıda açılamaz?

Bir XRechnung, EN16931 standardına ve Almanya'ya özgü CIUS uzantısına göre standartlaştırılmış bir yapıda yalnızca ticari verileri içerir, ancak herhangi bir düzen (layout) bilgisi içermez. Dosyayı doğrudan açtığınızda, başlık, kalem ve toplam alanlarına sahip bir fatura yerine iç içe geçmiş XML etiketleri görürsünüz. Salt verilerden yeniden okunabilir bir şey elde etmek için, hangi alanın sayfada nerede görüneceğini belirleyen ek bir dönüşüme ihtiyaç vardır.

KoSIT'in resmi görselleştirmesi nasıl çalışır?

Bunun için KoSIT, iki aşamada çalışan XSL dönüştürücüleri sunar. Projenin mimari açıklamasına göre ilk adımda, ister UBL ister CII sözdiziminde olsun, XML faturası, kullanılan EN16931 ticari terimlerine ilişkin bilgilerle zenginleştirilmiş, sözdiziminden bağımsız bir ara forma dönüştürülür. İkinci adımda, bu ara formdan, nihai görünümü, faturanın tek tek bileşenlerinin konumunu ve sırasını belirleyen CSS dosyaları aracılığıyla kontrol edilen, uygulamaya özgü bir HTML gösterimi oluşturulur. Proje açıklamasına göre bu yapı taşları, açıkça kendi yazılımınıza entegre edilecek isteğe bağlı bileşenler olarak tasarlanmıştır, indirilmeye hazır bir uygulama olarak değil.

Bunun ne kadarı bir otomasyona anlamlı biçimde dahil edilebilir?

Öncelikle otomatikleştirilebilecek olan, gelen XML dosyasından HTML veya PDF görünümüne giden adımdır: Bir iş akışı, ara dönüşümü ve ikinci aşamayı art arda çalıştırabilir ve yeni bir fatura geldiği anda sonucu doğrudan bir e-postaya, bir talebe (ticket) veya bir dosyalama sistemine ekleyebilir. Böylece örneğin muhasebe, kimsenin manuel olarak bir görüntüleyici aracı açmasına gerek kalmadan, orijinal XML'in yanında otomatik olarak okunabilir bir görünüm elde eder. Buna karşılık, "bir kez kurup unutmak" anlamında otomatikleştirilemeyen şey, CSS tasarımının kendisidir, çünkü yazı tipi boyutu veya alan sırası gibi düzen kararlarını görselleştirme kurulurken hâlâ insanlar bir kez alır.

Arşive ne girmeli, XML mi yoksa HTML görünümü mü?

Yasal olarak bağlayıcı olan, yalnızca orijinal XML dosyasıdır; HTML veya PDF görselleştirmesi yalnızca bir okuma yardımcısıdır. Bu nedenle GoBD'ye uygun saklama için XML dosyasını değiştirmeden arşivleyin; ek olarak oluşturulan bir görselleştirmeyi paralel olarak saklayabilirsiniz, ancak bu orijinalin yerini almaz. Bunun yerine görselleştirilmiş sürümü tek saklama yöntemi olarak kullanan kişi, XRechnung'un ileri işleme ve denetim açısından asıl amacı olan makine tarafından okunabilir verileri kaybetme riskiyle karşı karşıyadır.

XRechnung görselleştirmesi hakkında sıkça sorulan sorular

Gelen her XRechnung için ayrı bir görselleştirmeye ihtiyacım var mı?

Hayır, dönüşüm tüm XRechnung'lar için aynı şablona göre çalışır, çünkü EN16931 standardına göre standartlaştırılmış yapıya dayanır. Görselleştirmeyi bir kez kurar ve ardından gönderenden bağımsız olarak gelen her faturaya uygularsınız.

Görselleştirme, UBL ve CII faturaları arasında farklılık gösterir mi?

Her iki sözdizimi biçimi de sözdiziminden bağımsız ara forma yönelik aynı ilk dönüşüm aşamasından geçer; bundan sonra HTML görünümüne giden yol aynıdır. Şirket içindeki son kullanıcılar için, gelen faturanın altında yatan XML sözdizimi bu sayede artık görünmez hale gelir.

Bir PDF görselleştirmesi, klasik kağıt faturanın yerini görsel olarak tamamen alır mı?

Büyük ölçüde evet, çünkü başlık, kalem ve toplam alanları, tanıdık bir fatura görünümü elde edilecek şekilde CSS tasarımı aracılığıyla düzenlenebilir. Ancak sonucun belirli bir şirkete özgü fatura şablonuyla tam olarak örtüşmesi, yalnızca CSS dosyası buna göre ayrı ayrı uyarlandığında mümkündür.

Görselleştirmeyi kendi geliştirmem olmadan kullanabilir miyim?

KoSIT tarafından sağlanan yapı taşları, bunları mevcut bir yazılıma veya bir n8n iş akışına entegre eden geliştiricilere yöneliktir. Teknik entegrasyon gerektirmeyen hazır bir tıkla-kullan arayüzü resmi bileşenlerde bulunmamaktadır; burada bazı e-fatura portalları ve muhasebe programları kendi, kimi zaman basitleştirilmiş görüntüleyicilerini sunmaktadır.