e-Fatura XML Dosyası Nasıl Açılır ve Görüntülenir?

Elinize bir e-Fatura XML dosyası geldi ve çift tıkladığınızda karşınıza fatura yerine iç içe geçmiş etiketlerden oluşan bir metin yığını çıktı. Bu son derece normaldir: XML bir görüntü formatı değil, veri formatıdır. Faturanın rakamları, tarafları ve kalemleri oradadır ama insan gözü için düzenlenmemiştir.

Bu yazıda e-Fatura XML dosyasını fatura görünümünde açmanın pratik yollarını, hangisinin ne zaman işe yaradığını ve dikkat edilmesi gereken noktaları anlatıyoruz.

Neden XML çift tıklayınca fatura gibi görünmez?

UBL-TR standardında düzenlenen her e-Fatura, verinin kendisini taşır. Faturanın görsel hali ise ayrı bir teknolojiyle üretilir: XSLT. XSLT, XML içindeki veriyi alıp insanın okuyabileceği bir HTML sayfasına dönüştüren bir şablondur.

GİB düzenlemesi gereği her e-Fatura XML'inin içinde bu görüntüleme şablonu bulunmak zorundadır. Şablon, XML dosyasının içine base64 formatında gömülü olarak gelir. Yani faturanın görüntüsü aslında elinizdeki dosyanın içindedir; sadece onu çalıştıracak bir araca ihtiyacınız vardır.

Önemli bir hukuki ayrıntı: XSLT ile üretilen görüntü ile XML içindeki veri çelişirse, esas alınan XML'deki veridir. Görüntü yalnızca bir sunum katmanıdır.

Yöntem 1: Ücretsiz online görüntüleyici (en pratik)

En hızlı yol, XML'i tarayıcı üzerinden çalışan bir görüntüleyiciye yüklemektir. PDFXMLPro'nun ücretsiz e-Fatura görüntüleyicisi dosyayı sürükleyip bıraktığınız anda, XML içindeki XSLT şablonunu işleyip faturayı GİB'deki orijinal haliyle ekrana getirir.

• Kayıt veya kurulum gerekmez.
• Dosya tarayıcınızda işlenir, sunucuya yüklenmez — mali veriniz cihazınızdan çıkmaz.
• Faturayı PDF olarak kaydedebilir veya yazdırabilirsiniz.
• XML içine gömülü PDF varsa çıkarabilirsiniz.

Bu yöntem, ayda birkaç faturayı kontrol etmesi gereken muhasebeciler ve gelen faturayı doğrulamak isteyen işletmeler için yeterlidir.

Yöntem 2: XSLT şablonunu elle ayırıp tarayıcıda açmak

Teknik bilgisi olanlar için klasik yöntem şudur: XML içindeki base64 kodlu XSLT bloğunu bulup çözersiniz, ayrı bir dosya olarak kaydedersiniz ve XML ile aynı klasöre koyarsınız. Ardından XML dosyasının başına şablonu işaret eden bir işlem talimatı eklersiniz ve dosyayı tarayıcıda açarsınız.

Yöntem çalışır ama zahmetlidir ve modern tarayıcıların güvenlik kısıtları yüzünden yerel dosyalarda sık sık başarısız olur. Tek bir faturayı incelemek için harcanacak emeğe değmez; toplu iş için hiç uygun değildir.

Yöntem 3: Muhasebe programı veya entegratör portalı

e-Fatura mükellefiyseniz, gelen faturalar zaten entegratörünüzün portalında görüntülenebilir durumdadır. Aynı şekilde Logo, Zirve, Mikro gibi programların e-Fatura modülleri gelen belgeyi listeler ve görüntüler.

Bu yolun sınırı şudur: yalnızca sizin sisteminizden geçmiş belgeleri görürsünüz. Bir müşterinizin size WhatsApp'tan attığı XML dosyasını ya da arşivden çıkan eski bir belgeyi portalda bulamazsınız. Bu durumda bağımsız bir görüntüleyiciye ihtiyaç duyarsınız.

XML açılmıyorsa: sık karşılaşılan sorunlar

• Dosya bozuk gelmiş olabilir: e-posta ekinden indirilirken kesilen dosyalar açılmaz. Dosya boyutunun makul olduğunu kontrol edin.
• Dosya aslında ZIP olabilir: Bazı entegratörler faturaları ZIP içinde gönderir. Uzantıya değil, içeriğe bakın.
• Karakter kodlaması: Türkçe karakterler bozuk görünüyorsa dosya UTF-8 dışında bir kodlamayla kaydedilmiş olabilir.
• XSLT gömülü değil: Nadiren, standart dışı üretilmiş belgelerde görüntüleme şablonu bulunmaz. Bu durumda veriyi ham haliyle okumak veya genel bir XML görüntüleyici kullanmak gerekir.

Faturayı sadece görmek değil, aktarmak istiyorsanız

Görüntüleme, işin yalnızca yarısıdır. Çoğu muhasebeci XML'i faturayı görmek için değil, muhasebe programına aktarmak için açar. Elinizdeki belge zaten XML ise aktarım genellikle doğrudan yapılabilir.

Asıl darboğaz elinizdeki belgenin PDF olduğu durumdur. PDF, muhasebe programlarına aktarılamaz; içindeki verinin önce yapılandırılmış XML'e dönüştürülmesi gerekir. PDFXMLPro bu dönüşümü otomatikleştirir: PDF faturayı yükler, satır kalemlerini ve KDV matrahlarını ayrıştırır, GİB şemasından geçmiş UBL-TR XML üretir.

Özet

Tek bir faturayı hızlıca görmek istiyorsanız online görüntüleyici en pratik yoldur. Teknik incelemede XSLT'yi elle ayırma yöntemi işe yarar. Düzenli olarak gelen belgeleri işliyorsanız asıl çözüm görüntüleme değil, aktarımı otomatikleştirmektir.

Toplu XML dosyalarını incelemek

Tek bir faturayı açmak kolaydır; asıl zorluk yüzlerce belgeyi elden geçirmektir. Ay sonunda gelen belgelerin tamamını tek tek açıp kontrol etmek gerçekçi değildir.

Bu durumda yaklaşım değişir: belgeleri tek tek görüntülemek yerine, verilerini toplu olarak tabloya dökmek daha verimlidir. XML'den Excel'e dönüştürme aracıyla fatura numarası, tarih, tutar ve KDV bilgilerini tek bir tabloda görebilir, gözden kaçan belgeleri kolayca yakalayabilirsiniz.

Gelen faturayı doğrularken nelere bakılmalı?

• Satıcı VKN'si cari kartınızdaki numarayla eşleşiyor mu?
• Fatura tarihi ve numarası beklediğiniz belgeyle uyumlu mu?
• KDV oranı ve matrah, sözleşmedeki koşullara uygun mu?
• Tevkifat varsa oran ve kod doğru mu?
• Toplam tutar, satır kalemlerinin toplamıyla tutuyor mu?

Bu kontrolleri görüntü üzerinden yapmak yerine XML alanları üzerinden yapmak daha güvenlidir; çünkü hukuki olarak geçerli olan veri XML içindedir.

Son olarak bir güvenlik notu: mali belgeler hassas veridir. XML'inizi rastgele bir siteye yüklemeden önce dosyanın nereye gittiğine bakın. Tarayıcı içinde çalışan araçlarda dosya cihazınızdan hiç çıkmaz; sunucuya yükleme yapan araçlarda ise verinin nerede saklandığı belirsizdir.