e-Fatura XML Dosyası Nasıl Açılır? Görüntüleme Sorunları Nasıl Çözülür?

e-Fatura XML dosyası, faturanın asıl ve geçerli hâlidir; ekranda gördüğünüz fatura görüntüsü, dosyanın içine gömülü XSLT şablonuyla üretilir. Dosyayı açmanın en güvenli yolu GİB'in ücretsiz e-Fatura Görüntüleyici programı ya da muhasebe/entegratör yazılımınızdır. Tarayıcı ve Not Defteri yalnızca ham kodu gösterir; .zip gelen dosya önce arşivden çıkarılmalıdır.

Sorunların büyük kısmı da buradan doğar: tedarikçiden gelen dosya tarayıcıda "kod yığını" gibi açılır, ZIP içinden faturanın kendisi yerine zarf çıkar ya da görüntüleyici "XSLT bulunamadı" der. Aşağıda önce dosyanın ne olduğunu, sonra açma yöntemlerini ve en sık karşılaşılan hataların çözümünü bulacaksınız.

e-Fatura XML Dosyası Nedir? Neden PDF Değil?

e-Fatura, GİB'in belirlediği UBL-TR standardında hazırlanmış bir XML belgesidir. GİB'in e-Fatura Entegrasyon Kılavuzu bu dosyalar için üç temel kural koyar:

• Dosya, UBL-TR paketindeki XSD şemalarına uygun olmalıdır.
• Karakter kodlaması UTF-8 olmalıdır.
• Dosyanın içinde görüntüleme amacıyla kullanılacak bir XSLT tanımı mutlaka bulunmalıdır.

Aynı kılavuz önemli bir öncelik kuralı da içerir: XSLT görüntüsü ile fatura XML'i arasında içerik farkı olursa XML'deki bilgiler esas alınır. Yani ekrandaki görüntü bir "sunum katmanı"dır; tutarı, tarihi ve tarafları belirleyen XML'in kendisidir.

GİB'in e-Fatura Görüntüleyici Kullanım Kılavuzu bunu daha da net söyler: e-Faturanın kâğıt çıktısını almak, e-posta ile PDF göndermek ya da çıktının üzerine "Aslı Gibidir" yazmak uygun değildir; e-Faturanın geçerli hâli GİB üzerinden başarıyla geçmiş XML'idir. PDF, yalnızca okumayı kolaylaştıran bir kopyadır.

Elinize geçebilecek dosya türleri ve ne işe yaradıkları:

e-Fatura ile e-Arşiv Fatura arasındaki farkları bilmek de burada işe yarar: e-Arşiv faturalar da UBL-TR standardında XML olarak düzenlenir, ancak alıcıya çoğunlukla PDF veya e-posta bağlantısıyla iletilir.

e-Fatura XML Dosyası Nasıl Açılır? 4 Yöntem

1. GİB e-Fatura Görüntüleyici (önerilen)

GİB'in resmî görüntüleyicisi hem faturayı gösterir hem de geçerliliğini kontrol eder. Program, e-Belge sitesinin (ebelge.gib.gov.tr) ana sayfasından indirilir.

1. Ana sayfadaki "e-Fatura Görüntüleyici" bağlantısından EFaturaGoruntuleyici.jnlp dosyasını indirin.
2. .jnlp dosyasına tıklayarak programı başlatın. GİB sayfasındaki güncel sürüm notuna göre program Java 1.8 (101 ve üstü) ile çalışır.
3. Aç düğmesiyle faturayı seçin. Dosya uzantısı .zip değil, .xml olmalıdır.
4. Doğrula düğmesine basın: "Mali Mühür Doğrulandı!" yazıyorsa fatura imzalandıktan sonra değiştirilmemiştir.
5. Sorgula düğmesine basın: faturanın GİB sisteminden geçip geçmediğini ve ticari faturaysa alıcının sistem üzerinden ret verip vermediğini gösterir.

Programda görünümü değiştiren üç düğme vardır: Belge yalnızca fatura görüntüsünü, Xml yalnızca ham XML'i, Belge/Xml ikisini yan yana gösterir. Faturadaki bir tutarın XML'de nasıl yazıldığını kontrol etmek için Belge/Xml görünümü pratiktir.

Görüntüleyicinin önemli bir avantajı, dosyayı yalnızca göstermekle kalmayıp imzayı ve GİB kaydını da kontrol etmesidir. Tarayıcı ya da online araçlar bunu yapamaz.

2. Muhasebe programı veya özel entegratör paneli

e-Fatura mükellefiyseniz gelen faturalar zaten özel entegratörünüzün veya GİB Portal'ın gelen kutusuna düşer ve orada görüntülenir. Bu yöntemin artısı, faturanın dışarıdan dosya olarak taşınmasına gerek kalmamasıdır: görüntüleme, kabul/ret, PDF alma ve muhasebeleştirme tek ekranda yapılır.

Dışarıdan e-posta ile gelen bir XML'i açmak istediğinizde de çoğu muhasebe yazılımı "XML içe aktar" veya "faturayı yükle" seçeneği sunar. Dosya gömülü XSLT ile görüntülenir, bilgiler cari karta ve gider kaydına aktarılabilir.

3. Tarayıcı veya metin düzenleyici (yalnızca ham XML)

XML dosyasını Chrome, Edge veya Firefox'a sürüklediğinizde fatura görünmez; bunun yerine iç içe etiketlerden oluşan bir ağaç görürsünüz. Chrome bu durumda "Bu XML dosyasıyla ilişkili herhangi bir stil bilgisi yok gibi görünüyor" benzeri bir uyarı verir.

Bunun nedeni teknik: e-Faturadaki XSLT, dosyaya ayrı bir bağlantı olarak değil, cac:AdditionalDocumentReference altındaki EmbeddedDocumentBinaryObject alanına Base64 ile kodlanmış hâlde gömülüdür. Tarayıcılar bu gömülü şablonu kendiliğinden çözüp uygulamaz.

Yine de ham XML, hızlı kontrol için işe yarar. Aradığınız bilgiyi şu etiketlerde bulursunuz:

Dikkat: Dosyayı metin düzenleyicide açtıysanız kaydetmeden kapatın. Tek bir karakterin, hatta bir boşluğun değişmesi bile imzayı bozar ve fatura "Mali Mühür Geçersiz" hâle gelir.

4. Online XML görüntüleyiciler

İnternette XML yükleyip fatura görüntüsü veren ücretsiz siteler vardır. Pratiktirler, ancak iki risk taşırlar:

• Gizlilik: Fatura; VKN/TCKN, adres, tutar ve ürün bilgisi içerir. Bu veriyi tanımadığınız bir sunucuya yüklemek, hem ticari sır hem de kişisel veri açısından sorun yaratabilir. Aracın dosyayı sunucuya gönderip göndermediğini ve veriyi saklayıp saklamadığını bilmiyorsanız kullanmayın.
• Geçerlilik kontrolü yoktur: Bu araçlar görüntüyü üretir ama imzayı ve GİB kaydını çoğunlukla doğrulamaz. "Güzel görünen" bir fatura geçerli olmayabilir.

e-Fatura Görüntüleme Sorunları ve Çözümleri

Önce belirtiye göre hızlı teşhis tablosu:

Dosya .zip olarak geldi

e-Fatura, GİB'e iletilirken imzalanıp ZIP formatında sıkıştırılarak zarf hâline getirilir. Portal veya entegratörden indirilen dosyalar da çoğu zaman ZIP'tir. Windows'ta dosyaya sağ tıklayıp "Tümünü ayıkla" deyin; çıkan .xml dosyasını görüntüleyiciyle açın. ZIP'in içinden birden fazla XML çıkıyorsa, <Invoice ile başlayan dosya faturadır.

Fatura yerine zarf XML'i açılmış

Görüntüleyici yalnızca XML görünümünü gösteriyor ve dosyanın ikinci satırında <sh:StandardBusinessDocument...> etiketi varsa, açtığınız dosya faturanın kendisi değil, onu taşıyan zarftır. Ayırt etmek kolaydır:

Zarf XML'i          → <StandardBusinessDocument ...> ile başlar, </StandardBusinessDocument> ile biter
e-Fatura XML'i      → <Invoice ...> ile başlar, </Invoice> ile biter
Uygulama yanıtı     → <ApplicationResponse ...> ile başlar, </ApplicationResponse> ile biter

GİB, faturanın zarftan bir yazılım aracılığıyla çıkarılmasını önerir. Muhasebe programınız veya entegratör paneliniz bunu otomatik yapar. Elle yapmak zorundaysanız GİB kılavuzundaki yöntem şöyledir (bir zarfta tek fatura olduğu varsayımıyla):

1. Zarf XML'inin bir kopyasını alın; orijinale dokunmayın.
2. Kopyayı Notepad veya Notepad++ ile açın.
3. <Invoice ifadesini bulun ve < işaretinden önceki her şeyi silin.
4. </Invoice ifadesini bulun ve kapanıştaki > işaretinden sonraki her şeyi silin.
5. Dosyayı kaydedip görüntüleyiciyle açın.

<Invoice> ile </Invoice> arasındaki tek bir karakter değişirse imza bozulur. Bu yüzden elle çıkarma son çaredir; sonuçta mutlaka Doğrula ile imzayı kontrol edin.

"XSLT bulunamadı" veya hatalı XSLT uyarısı

Gönderici faturaya XSLT eklememişse görüntüleyici, GİB'in yayımladığı varsayılan XSLT ile gösterip göstermeyeceğinizi sorar. "Evet" derseniz fatura standart şablonla açılır; "Hayır" derseniz yalnızca XML görünümü kalır.

XSLT var ama hatalıysa üç seçenek çıkar: Varsayılan XSLT ile Göster (faturayı standart şablonla açar), Hata Detayları (şablondaki hataları listeler) ve Kapat. Pratikte varsayılan şablon işinizi görür. Faturanın geçerliliği şablona bağlı değildir; şablon yalnızca görünümü belirler. Yine de sürekli hatalı XSLT gönderen bir tedarikçiye durumu bildirmek, onun diğer müşterilerinin de işini kolaylaştırır.

Tarayıcıda sadece kod görünüyor

Bu bir hata değil, beklenen davranıştır: tarayıcı, e-Faturanın içine Base64 ile gömülü XSLT'yi çözüp uygulamaz. Çözüm, dosyayı GİB e-Fatura Görüntüleyici'yle veya muhasebe yazılımınızla açmaktır. Tarayıcıyı yalnızca bir etiketin değerine hızlıca bakmak için kullanın.

Türkçe karakterler bozuk görünüyor

e-Fatura XML'leri UTF-8 kodlamasıyla hazırlanmak zorundadır. "ş" yerine "ÅŸ", "ı" yerine "ı" gibi karakterler görüyorsanız dosya büyük olasılıkla farklı bir kodlamayla (ANSI, Windows-1254 vb.) açılmış veya daha kötüsü o kodlamayla yeniden kaydedilmiştir.

• Metin düzenleyicide kodlamayı UTF-8 olarak seçip yeniden açın.
• Dosyayı başka bir kodlamayla kaydettiyseniz o kopya artık orijinal değildir; imzası da bozulmuş olur. Göndericiden, entegratör panelinden veya e-postadaki orijinal ekten dosyayı yeniden alın.
• Görüntüleyicide karakterler doğru, yalnızca e-posta önizlemesinde bozuksa sorun faturada değil, e-posta istemcisindedir.

Görüntüleyici (.jnlp) açılmıyor

.jnlp dosyası, Java Web Start teknolojisiyle çalışan bir başlatıcıdır. Oracle, Java Web Start'ı Java 11 ile birlikte JDK'dan kaldırdı. Bu yüzden bilgisayarınızda yalnızca yeni bir Java sürümü kuruluysa .jnlp dosyası çift tıklamayla açılmayabilir ya da "bu dosyayı nasıl açmak istiyorsunuz?" sorusu gelir.

Kontrol edilecekler:

• Java sürümü: GİB sayfasındaki sürüm notuna göre görüntüleyici Java 1.8 (101 ve üstü) ile çalışır. Web Start'ı içeren bir Java 8 kurulumu gerekir.
• Alternatif başlatıcı: Yeni Java sürümleri kullanılan bilgisayarlarda, JNLP dosyalarını çalıştırmak için geliştirilmiş açık kaynaklı OpenWebStart gibi başlatıcılar kullanılabilir.
• Güvenlik uyarısı: Program imzalı bir Java uygulamasıdır ve ilk açılışta izin ister. Yayıncının "Gelir İdaresi Başkanlığı" olduğunu kontrol edip onaylayın.
• Kurumsal bilgisayarlar: Bilgi işlem politikası Java uygulamalarını engelliyorsa, kurulum için BT ekibinizden destek alın.

Java kurulumuyla uğraşmak istemiyorsanız, faturayı muhasebe programınıza veya entegratör panelinize yükleyerek görüntülemek daha kısa yoldur.

"Mali Mühür Geçersiz!" veya "GİB sisteminden geçmemiş" uyarısı

Bu iki uyarı görüntüleme sorunu değil, geçerlilik sorunudur ve fatura açılsa bile ciddiye alınmalıdır:

İmza geçersizse önce elinizdeki dosyanın orijinal olup olmadığını düşünün: metin düzenleyicide açılıp kaydedilmiş, kodlaması değiştirilmiş ya da elle zarftan çıkarılmış olabilir. Orijinal dosyayla da aynı sonuç çıkıyorsa göndericiyle iletişime geçin.

Görüntüleyici yalnızca sistem üzerinden verilen ret yanıtını gösterir. Alıcı faturaya noter, taahhütlü mektup, telgraf veya KEP gibi harici yollarla itiraz etmişse bu bilgi görüntüleyicide görünmez. İtiraz yolları ve süreler için e-faturaya itiraz ve iptal rehberimize bakabilirsiniz.

Tarayıcıların XSLT Desteğini Kaldırması Neyi Değiştirir?

Google, güvenlik gerekçesiyle Chrome'dan XSLT desteğini kaldırma kararı aldı ve bunun takvimini Chrome for Developers sitesinde yayımladı. Bu takvime göre XSLT, 17 Kasım 2026'dan itibaren Chrome'un kararlı sürümlerinde çalışmayı bırakacak; kurumsal politika ve Origin Trial ile tanınan geçiş istisnaları ise 17 Ağustos 2027'de sona erecek. Karar hem XML dosyalarındaki XSLT işleme talimatını hem de JavaScript'teki XSLTProcessor arayüzünü kapsıyor.

e-Fatura açısından pratik sonucu şudur:

• GİB e-Fatura Görüntüleyici etkilenmez; masaüstünde çalışan bir Java uygulamasıdır ve kendi XSLT motorunu kullanır.
• Tarayıcının yerleşik XSLT motoruna dayanan web tabanlı görüntüleyiciler etkilenebilir. Kullandığınız online araç veya panel faturayı tarayıcıda dönüştürüyorsa, sağlayıcının bu değişikliğe göre güncelleme yapıp yapmadığını kontrol edin.
• Muhasebe ve entegratör yazılımları faturayı sunucu tarafında HTML'e veya PDF'e çeviriyorsa kullanıcı tarafında bir değişiklik gerekmez.

Chrome takvimi Google tarafından güncellenebilir; güncel tarihleri Chrome for Developers sayfasından kontrol edin.

Teknik Ekipler İçin: XSLT'yi Elle Uygulamak

Toplu fatura görüntüleme veya arşiv dönüştürme gibi işlerde XSLT'yi komut satırından uygulamak mümkündür. Mantık iki adımdır: gömülü şablonu çıkarmak ve XML'e uygulamak.

1. cac:AdditionalDocumentReference içindeki
   cbc:EmbeddedDocumentBinaryObject alanının Base64 içeriğini kopyalayın
   ve çözerek fatura.xslt dosyasına yazın.

2. Şablonu faturaya uygulayın (ör. libxslt ile):
   xsltproc fatura.xslt fatura.xml > fatura.html

Çıkan HTML dosyası tarayıcıda normal bir sayfa gibi açılır. Bu işlem orijinal XML'e dokunmaz; yine de üretilen HTML'in yalnızca bir görüntü olduğunu, yasal belgenin XML olmaya devam ettiğini unutmayın.

e-Fatura XML Dosyalarını Saklarken Dikkat Edilecekler

Görüntüleme sorunlarının önemli bir kısmı, dosyanın bir yerde "bozulmasından" kaynaklanır. Birkaç alışkanlık bunu önler:

• Orijinal XML'i değiştirmeden saklayın. PDF'i yanına ek olarak koyabilirsiniz, ama yerine koymayın.
• Metin düzenleyicide açtığınız dosyayı kaydetmeyin. İnceleme için bir kopya üzerinde çalışın.
• Dosyaları ETTN veya fatura numarasıyla adlandırın. "fatura_son_v2.xml" gibi adlar arşivde aramayı zorlaştırır.
• Gelen faturaları tek bir yerde toplayın. e-postada, masaüstünde ve portalda dağınık duran XML'ler hem kaybolur hem de mükerrer kayda yol açar.
• Saklama yükümlülüğünü göz ardı etmeyin. e-Faturalar, kâğıt faturalar gibi kanuni saklama süresi boyunca muhafaza edilmelidir; güncel süre ve saklama şartlarını mali müşavirinizle teyit edin.

Faturaları bir entegratör paneli ve muhasebe yazılımında tutmak bu adımların çoğunu otomatikleştirir: gelen XML görüntülenir, imzası kontrol edilir, cari karta işlenir ve arşivde ETTN ile aranabilir hâle gelir. Paramset ön muhasebe programı ve özel entegratör paneli bu akışı tek yerden yönetir; dosyaları tek tek indirip açma ihtiyacını ortadan kaldırır.

Sık Sorulan Sorular

e-Faturanın PDF'i geçerli bir belge midir?

Hayır. GİB'e göre e-Faturanın geçerli hâli, GİB üzerinden başarıyla geçmiş XML'idir. PDF veya kâğıt çıktı yalnızca okumayı kolaylaştıran bir kopyadır; üzerine "Aslı Gibidir" yazmak da onu asıl belge yapmaz.

Faturanın görüntüsü ile XML'deki bilgiler farklıysa hangisi geçerlidir?

XML geçerlidir. GİB Entegrasyon Kılavuzu, XSLT görüntüsü ile fatura XML'i arasında içerik farkı olduğunda XML'deki bilgilerin esas alınacağını açıkça belirtir.

e-Fatura XML dosyasını Excel'de açabilir miyim?

Excel, XML dosyalarını tablo olarak içe aktarabilir ama fatura görüntüsü üretmez; etiketleri sütunlara dağıtır. Tutar veya kalem kontrolü için kullanılabilir, fatura görüntülemek için uygun değildir. Dosyayı Excel'de açıp kaydetmek orijinali bozar.

e-Arşiv faturayı da aynı yöntemlerle açabilir miyim?

e-Arşiv faturalar da UBL-TR standardında XML olarak düzenlenir ve görüntü şablonu taşır; muhasebe programları bu dosyaları da açar. Ancak e-Arşiv faturalar alıcıya çoğunlukla PDF veya bağlantı olarak iletilir, XML'e ihtiyaç duyduğunuzda düzenleyenden isteyebilirsiniz.

Faturanın GİB'den geçip geçmediğini nasıl anlarım?

XML dosyasını GİB e-Fatura Görüntüleyici'de açıp Sorgula düğmesine basın. Program faturanın GİB sisteminden geçip geçmediğini ve ticari faturaysa sistem üzerinden reddedilip reddedilmediğini gösterir. Bu kontrol e-Fatura sisteminde olmayanlar için de kullanılabilir.

Görüntüleyici "XSLT bulunamadı" diyorsa fatura geçersiz mi?

Hayır. XSLT yalnızca görünümü belirler; eksik veya hatalı olması faturayı geçersiz kılmaz. Görüntüleyici bu durumda GİB'in varsayılan XSLT'siyle gösterme seçeneği sunar. Geçerliliği Doğrula ve Sorgula sonuçları belirler.

Özetle

• e-Fatura XML dosyası faturanın asıl hâlidir; görüntü, içine Base64 ile gömülü XSLT şablonundan üretilir. İçerik farkında XML esas alınır.
• En güvenli açma yolu GİB e-Fatura Görüntüleyicidir; faturayı gösterir, Doğrula ile imzayı, Sorgula ile GİB kaydını kontrol eder.
• .zip gelen dosya önce arşivden çıkarılır; görüntüleyiciye .xml verilir.
• İkinci satırda StandardBusinessDocument görüyorsanız zarfı açmışsınızdır; faturayı zarftan bir yazılımla çıkarın.
• XSLT eksik veya hatalıysa varsayılan XSLT ile görüntüleyin; bu faturayı geçersiz kılmaz.
• Tarayıcı ve Not Defteri yalnızca ham kodu gösterir; dosyayı kaydetmeden kapatın, tek karakter değişikliği imzayı bozar.
• "Mali Mühür Geçersiz" veya "GİB sisteminden geçmemiş" uyarıları görüntüleme değil geçerlilik sorunudur; göndericiden orijinal dosyayı isteyin.

Görüntüleyici sürümü, Java gereksinimi ve tarayıcı takvimleri zaman içinde değişebilir; kurulum öncesinde GİB e-Belge sitesindeki güncel sürüm notunu kontrol edin.

Kaynaklar

• GİB — e-Fatura Görüntüleyici Kullanım Kılavuzu v1.0 — Doğrula/Sorgula sonuçları, XSLT bulunmaması, zarf XML'inin açılması (bölüm 3 ve 4)
• GİB — e-Fatura Uygulaması Entegrasyon Kılavuzu v1.10 — bölüm 4.3 "Verilerin Hazırlanması" (UTF-8, zorunlu XSLT, XML'in esas alınması, ZIP zarf)
• GİB — e-Belge ana sayfası (e-Fatura Görüntüleyici indirme ve sürüm notu)
• GİB — e-Fatura Paketi (UBL-TR örnek faturalar ve şemalar)
• Chrome for Developers — Removing XSLT for a more secure browser
• OpenWebStart — JNLP uygulamalarını yeni Java sürümlerinde çalıştırma