E-fatura görüntüleyici, XML biçimindeki elektronik faturayı insan gözüyle okunabilir bir fatura görüntüsüne çeviren araçtır. E-faturanın kendisi bir veri dosyasıdır; satıcı, alıcı, kalemler ve vergi bilgileri etiketler içinde durur ve görsel hâli, faturaya gömülü bir şablonla (XSLT) oluşturulur. Bu yüzden XML dosyasını çift tıklayıp açtığınızda karmaşık bir kod görürsünüz; görüntüleyici ise bu kodu tanıdık fatura sayfasına dönüştürür.
Aşağıda e-fatura XML görüntüleyici araçlarının nasıl çalıştığını, hangi yöntemin hangi durumda işe yaradığını, e-arşiv fatura görüntüleyici ile farkını ve en sık karşılaşılan hataları adım adım anlatıyoruz.
E-fatura görüntüleyici nedir ve neden gerekir?
Kâğıt faturada gördüğünüz şey belgenin kendisidir. E-faturada ise durum farklıdır: hukuken geçerli olan belge, Türkiye'de kullanılan UBL-TR standardına göre hazırlanmış XML dosyasıdır. Ekranda gördüğünüz fatura sayfası, bu verinin bir sunumudur.
Bu ayrım pratikte şu sonuçları doğurur:
- Aynı XML dosyası farklı şablonlarla farklı görünebilir; ama içindeki tutarlar, vergi kimlik numaraları ve tarih değişmez.
- Görüntü bozuk olsa bile veri sağlam olabilir; tersine, görüntü düzgün olsa bile dosyanın imzası veya içeriği sorunlu olabilir.
- XML dosyasını PDF gibi doğrudan açamazsınız; ya dosyanın geldiği platformu ya da bir görüntüleme aracını kullanmanız gerekir.
E-faturanın dosya yapısı: XML, XSLT ve imza
Bir e-fatura dosyasının içinde genellikle üç katman bulunur:
- Fatura verisi (UBL-TR XML): Faturanın tüm alanları burada yer alır. ETTN olarak bilinen evrensel tekil numara (UUID), fatura numarası, düzenleme tarihi, taraf bilgileri, mal ve hizmet kalemleri, KDV ve diğer vergiler etiketlerle kayıtlıdır.
- Görsel şablon (XSLT): Faturanın nasıl görüneceğini belirleyen dönüşüm dosyasıdır. Çoğu e-faturada bu şablon, XML'in içine Base64 kodlanmış hâlde gömülür. Görüntüleyici bu şablonu çıkarır ve veriye uygular.
- Elektronik imza veya mali mühür: Belgenin kim tarafından düzenlendiğini ve sonradan değiştirilmediğini gösteren imza bilgisidir.
Görüntüleyici esas olarak ilk iki katmanla çalışır. Üçüncü katmanın, yani imzanın doğrulanması ayrı bir iştir; buna aşağıda değineceğiz.
E-fatura XML görüntüleyici nasıl çalışır?
Hangi aracı kullanırsanız kullanın, arka planda işleyen süreç benzerdir:
- Araç XML dosyasını okur ve geçerli bir XML yapısı olup olmadığını kontrol eder.
- Dosyanın içindeki ek belge alanlarında gömülü XSLT şablonunu arar.
- Şablon bulunursa Base64 kodunu çözer ve XSLT dönüşümünü fatura verisine uygular.
- Sonuç HTML olarak ekranda gösterilir; çoğu araç bu görüntüyü yazdırma veya PDF olarak kaydetme imkânı da sunar.
- Şablon yoksa veya bozuksa araç ya hata verir ya da kendi varsayılan şablonunu kullanır.
Bu mantığı bilmek, sorun yaşadığınızda nereye bakacağınızı gösterir. Örneğin fatura açılıyor ama logo ve düzen eksikse muhtemelen şablon kısmında bir sorun vardır; dosya hiç açılmıyorsa XML yapısı veya dosya türü (örneğin sıkıştırılmış arşiv) sorun çıkarıyordur.
E-fatura görüntüleme yöntemleri ve karşılaştırma
E-faturayı görüntülemenin birkaç yolu vardır. Hangisinin size uygun olduğu, faturayı nereden aldığınıza ve ne sıklıkla bu işi yaptığınıza bağlıdır.
| Yöntem | Kurulum gerekir mi? | Uygun olduğu durum | Dikkat edilecek nokta |
|---|---|---|---|
| Yazılım veya entegratör paneli | Hayır, hesap yeterli | Düzenli olarak fatura alan işletmeler | Fatura kendi hesabınıza gelmiş olmalı |
| GİB portalı | Hayır, portal girişi gerekir | Portal kullanıcıları | Yalnız portal üzerinden işlem gören belgeler |
| Masaüstü görüntüleyici | Evet, çoğu zaman Java gerekir | Tek tük gelen XML dosyaları | Aracın kaynağı ve güncelliği |
| Tarayıcı veya metin editörü | Hayır | Ham veriye hızlıca göz atmak | Görsel fatura oluşmaz |
| Çevrim içi görüntüleme siteleri | Hayır | Acil, tek seferlik ihtiyaç | Ticari verinin üçüncü tarafa yüklenmesi |
Yazılım veya entegratör paneli
E-fatura mükellefiyseniz faturalarınız bir özel entegratör ya da onunla çalışan bir yazılım üzerinden size ulaşır. En zahmetsiz yol, faturayı bu panelden açmaktır: panel XML'i şablonla birlikte işler, faturayı ekranda gösterir ve genellikle PDF olarak indirmenize izin verir. Tedarikçilerinizden gelen belgeleri gelen e-faturalar ekranımızda görüntüleyebilir, ticari faturalara yanıt verebilir ve uygun olanları gider kaydına aktarabilirsiniz. Elektronik belgeler GİB özel entegratörü üzerinden iletilir; faturanın kendisi değil, onu nasıl işlediğiniz değişir.
Panel yönteminin bir diğer avantajı, görüntüleme ile kayıt işinin aynı yerde birleşmesidir. Faturayı açıp bakmak, ardından ayrı bir programa elle girmek yerine belgeyi tek ekrandan gider kaydına bağlarsınız.
GİB portalı
Faturalarını Gelir İdaresi Başkanlığının ücretsiz portalı üzerinden düzenleyen ve alan kullanıcılar, belgeleri portal içinden görüntüleyebilir. Portal giriş adımları ve güncel kullanım koşulları için e-Fatura portalının ve Gelir İdaresi Başkanlığının resmî sayfalarını kontrol etmeniz en sağlıklısıdır; arayüz zaman içinde değişebilir.
Masaüstü görüntüleyiciler ve Java
E fatura görüntüleyici java araması, Java çalışma ortamı gerektiren masaüstü görüntüleme araçlarından kaynaklanır. Bu tür araçlarda XML dosyasını programa yüklersiniz, araç gömülü şablonu uygular ve faturayı gösterir. Kullanırken şunlara dikkat edin:
- Aracı yalnız resmî kaynaktan veya güvendiğiniz bir yazılım sağlayıcısından indirin.
- Bilgisayarınızda uyumlu bir Java sürümünün kurulu olduğundan emin olun; eski araçlar yeni Java sürümlerinde sorun çıkarabilir.
- Kurumsal bilgisayarlarda güvenlik ayarları Java uygulamalarını engelleyebilir; bu durumda bilgi işlem sorumlunuzla görüşün.
Arada bir XML dosyası alan ama e-fatura sistemini aktif kullanmayan kişiler için masaüstü araçlar pratik olabilir. Düzenli fatura trafiği olan işletmeler için ise her dosyayı tek tek yüklemek zaman kaybıdır.
Tarayıcı ve metin editörü
XML dosyasını bir tarayıcıda veya metin editöründe açmak, ham veriyi görmenizi sağlar. Bu yöntemle fatura numarası, ETTN, tarih ve tutar gibi alanları etiketlerin arasında okuyabilirsiniz. Ancak görsel fatura oluşmaz, çünkü şablon dosyanın içine kodlanmış hâldedir ve tarayıcı onu kendiliğinden uygulamaz. Teknik bilgisi olan kullanıcılar gömülü şablonu çözüp ayrı bir XSLT dosyası olarak kaydedebilir ve bir XSLT işlemcisiyle dönüştürme yapabilir; fakat bu, günlük kullanım için pratik bir yol değildir.
Çevrim içi görüntüleme siteleri
İnternette XML dosyasını yükleyip faturayı gösteren siteler bulunur. Kolay görünseler de bir faturada vergi kimlik numaraları, adresler, fiyatlar ve ticari ilişkiler yer alır. Bu bilgileri kim tarafından işletildiğini bilmediğiniz bir siteye yüklemek, hem ticari sır hem de kişisel veri açısından risk taşır. Mecbur kalırsanız bile hassas belgeleri bu yolla açmaktan kaçının.
E-arşiv fatura görüntüleyici: farkı ne?
E-arşiv fatura, e-fatura sistemine kayıtlı olmayan alıcılara düzenlenen elektronik faturadır. Teknik olarak o da UBL-TR biçiminde bir XML belgesidir; ancak alıcıya ulaşma şekli farklıdır. Alıcı çoğunlukla faturayı e-posta ile PDF ya da bağlantı olarak alır veya kâğıt çıktısını teslim alır. Bu nedenle e-arşiv fatura görüntüleyici ihtiyacı daha çok şu durumlarda doğar:
- Size PDF yerine yalnız XML dosyası gönderildiyse,
- Muhasebe kaydı için XML'i saklamanız ve gerektiğinde açmanız gerekiyorsa,
- Gelen PDF ile XML'deki bilgileri karşılaştırmak istiyorsanız.
E-arşiv XML dosyaları da aynı mantıkla, yani gömülü şablonla görüntülenir; çoğu e-fatura görüntüleyici her iki belge türünü de açabilir. İki belge türünün ayrıntılı farkını merak ediyorsanız e-arşiv fatura nedir ve e-faturadan farkı yazımıza göz atabilirsiniz.
Sık karşılaşılan görüntüleme sorunları ve çözümleri
Görüntüleme sırasında yaşanan sorunların büyük kısmı birkaç temel nedene dayanır:
| Belirti | Olası neden | Ne yapabilirsiniz? |
|---|---|---|
| Dosya hiç açılmıyor | Dosya aslında sıkıştırılmış arşiv, uzantı yanlış veya dosya eksik indirilmiş | Arşivi açıp içindeki XML'i deneyin, dosyayı yeniden indirin |
| Sadece kod görünüyor | Dosya tarayıcıda veya editörde açıldı | Bir görüntüleyici veya panel kullanın |
| Düzen bozuk, logo yok | Gömülü şablon hatalı ya da eksik | Aracın varsayılan şablonunu deneyin, düzenleyenden yeni kopya isteyin |
| Türkçe karakterler bozuk | Karakter kodlaması uyumsuz | Dosyayı değiştirmeden başka bir araçla açın |
| Java aracı başlamıyor | Java kurulu değil, sürüm uyumsuz veya güvenlik engeli | Uyumlu sürümü kurun, yöneticinizle ayarları kontrol edin |
Önemli bir uyarı: Görüntüsü bozuk diye XML dosyasını elle düzenlemeyin. Dosyada yapılan en küçük değişiklik imzayı geçersiz kılar ve belge artık orijinal fatura niteliği taşımaz. Sorun şablonda ise çözüm, belgeyi düzenleyen tarafa başvurmak ya da farklı bir görüntüleme aracı denemektir.
Görüntülemek doğrulamak değildir
Bir faturanın ekranda düzgün görünmesi, onun gerçekten düzenlenmiş, GİB sistemine iletilmiş ve iptal edilmemiş olduğu anlamına gelmez. Görüntüleyici size belgenin nasıl göründüğünü söyler; belgenin geçerliliği ayrı bir kontrol konusudur. Özellikle şu durumlarda ek kontrol yapmak yerinde olur:
- Faturayı tanımadığınız bir kaynaktan, e-posta eki olarak aldıysanız,
- Tutar veya taraf bilgilerinde beklenmedik bir farklılık varsa,
- Fatura sonradan iptal edildi ya da itiraz edildi bilgisi geldiyse.
Bu kontroller için ETTN, karekod ve fatura durumu sorgulama yöntemlerini anlattığımız e-fatura sorgulama rehberimize bakabilirsiniz. İmza doğrulaması ve belgenin sistemdeki durumu, görüntüleme ile birlikte düşünülmesi gereken tamamlayıcı adımlardır.
Gelen faturaları düzenli yönetmek: arşiv, kayıt ve muhasebeci
Tek bir faturayı açmak kolaydır; zor olan, ay boyunca gelen onlarca faturayı kaybetmeden, doğru kayıtla ve mali müşavirinizin ulaşabileceği biçimde tutmaktır. Görüntüleme ihtiyacını bir alışkanlığa dönüştürmek için şu düzeni öneririz:
- Orijinal XML'i saklayın. PDF çıktısı pratik bir kopyadır ama asıl belge XML'dir. Yasal saklama yükümlülükleri ve süreleri için güncel düzenlemeleri GİB kaynaklarından veya mali müşavirinizden teyit edin.
- Dosyaları ETTN veya fatura numarasıyla adlandırın. Aynı tedarikçiden gelen benzer belgeleri karıştırmazsınız.
- Görüntüleme ile kaydı ayırmayın. Faturayı açtığınız anda gider kaydını da oluşturursanız, ay sonunda eksik belge kovalamazsınız.
- Muhasebecinizin erişimini planlayın. Dosyaları e-postayla tek tek göndermek yerine ortak ve salt okunur bir erişim, hem zamandan tasarruf sağlar hem de belge sürümlerinin karışmasını önler.
Bu düzeni kurarken kullanacağınız yazılımın kapsamı ve maliyeti önemli bir karar kriteridir. Paket içerikleri ve güncel ücretler için paketler ve fiyatlar sayfamızı inceleyebilirsiniz.
Kayıtları siz girersiniz; dönem beyanı, tasdik ve denetim işlemleri ise yetkili meslek mensubunun sorumluluğundadır. İşletmenizin durumuna özel saklama, kayıt veya vergi sorularınız için mali müşavirinizden destek almanız en doğru yoldur.
Sonuç
E-fatura görüntüleyici, XML dosyasındaki veriyi gömülü şablonla okunur bir faturaya çeviren basit ama önemli bir araçtır. Arada bir gelen dosyalar için masaüstü araçlar yeterli olabilir; düzenli fatura alan işletmeler için ise görüntüleme, yanıtlama ve kaydın aynı yerde yapılması en az hata üreten yöntemdir. Hangi aracı seçerseniz seçin, XML'i değiştirmeyin, hassas belgeleri bilinmeyen sitelere yüklemeyin ve görüntülemeyi doğrulamayla tamamlayın.
Tedarikçi faturalarınızı tek panelde açıp gider kaydına bağlamak için gelen e-faturalar sayfamızı inceleyebilirsiniz.