e-Fatura XSLT Şablonu Nedir? GİB Kuralları ve Tasarım Rehberi

Kısaca

XSLT, UBL-TR XML'ini okunabilir sayfaya (HTML, oradan PDF) çeviren dönüşüm dosyasıdır; e-Faturada XML'in içinde bulunmalıdır.
Görüntünün üst ortasında GİB logosu ve altında "e-Fatura" ibaresi yer almalıdır.
Şablon ile XML çelişirse XML esastır; şablon bilgi üretmemeli, yalnız göstermelidir.
Şablon hatalıysa görüntüleyici GİB'in varsayılan şablonunu önerir; tasarımınız görünmez.

XSLT nedir, faturada nerede durur?

UBL-TR standardındaki e-Fatura; satıcı, alıcı, kalemler, vergiler ve toplamlar gibi bilgileri XML olarak taşır. XML makinenin okuması içindir. XSLT (Extensible Stylesheet Language Transformations) bu XML'i insanın okuyacağı bir sayfaya dönüştüren şablondur: hangi bilginin nerede, hangi yazı ve çizgiyle gösterileceğini belirler.

GİB'in e-Fatura Uygulaması Entegrasyon Kılavuzu, XML dosyaları içinde görüntüleme amacıyla kullanılacak XSLT tanımının mutlaka bulunması gerektiğini söyler. Uygulamada şablon, faturanın ek belge alanına (cac:AdditionalDocumentReference) gömülür; böylece alıcı faturayı hangi programla açarsa açsın aynı görünümü görür.

GİB'in görüntü kuralları

GİB logosu ve ibare: fatura görüntüsünün üst orta kesiminde Gelir İdaresi Başkanlığı logosu ve altında "e-Fatura" ibaresi bulunmalıdır.
XML esastır: XSLT ile fatura XML'i arasında içeriğe ilişkin bir farklılık olursa XML'deki bilgiler esas alınır.
Görüntüleyiciyle açılmalı: faturanın XSLT görüntüsü GİB'in e-Fatura Görüntüleyici programıyla görüntülenebilmelidir.

GİB'in e-Fatura Görüntüleyici kılavuzu, faturada XSLT bulunmaması ya da hatalı olması durumunda kullanıcıya faturayı GİB'in yayımladığı varsayılan XSLT ile görüntüleme seçeneği sunulduğunu anlatır. Yani bozuk bir şablon faturayı geçersiz kılmaz ama müşteriniz markanızı değil, düz bir varsayılan görünümü görür.

e-Arşiv faturada durum

e-Arşiv fatura da aynı UBL-TR yapısındadır ve görünümü şablonla oluşturulur; alıcıya çoğunlukla PDF olarak e-postayla iletilir. GİB'in Elektronik Arşiv Kılavuzu, PDF'e ek olarak konan UBL-TR XML'inin ayrıca imzalanmasının ve içinde görüntü bilgisi (xslt) bulunmasının zorunlu olmadığını belirtir. İnternetten satışta faturada yer alması gereken bilgiler için internet satışında e-Arşiv rehberine bakın.

Şablonu değiştirirken dikkat edilecekler

Bilgi üretmeyin, gösterin. Tutarları şablonda yeniden hesaplamak ya da metni şablona sabit yazmak XML ile çelişki doğurur; çelişkide XML geçerli olduğu için görünen sayfa yanıltıcı olur.
Zorunlu alanları koruyun. Satıcı ve alıcı kimliği, belge numarası ve tarihi, ETTN, kalemler, vergiler ve toplamlar tasarım uğruna gizlenmemelidir.
Dış kaynak çağırmayın. İnternetten yazı tipi, görsel ya da betik yükleyen şablon, alıcının ortamında açılmayabilir. Logo ve kaşe gibi görseller faturanın içine gömülmelidir.
PDF'te deneyin. Tarayıcıda düzgün görünen şablon, PDF üreten çizim motorunda farklı satır yüksekliği ya da taşma gösterebilir. Yayına almadan önce gerçek bir faturayla PDF çıktısını kontrol edin.
GİB görüntüleyicisiyle açın. Kılavuzun istediği gibi faturanın GİB e-Fatura Görüntüleyici'de de açıldığından emin olun.

Faturika'da kodsuz şablon

Fatura şablonu editörü bu kuralları sizin yerinize uygular: tasarımı görsel olarak yaparsınız, XSLT'yi Faturika üretir. Zorunlu bölümler gizlenemez, dış kaynak çağıran yapılar reddedilir, logo ve kaşe faturaya gömülür; tasarımı PDF çizim motorunda önizleyip onayladığınızda resmî belgelerinizde kullanılır.

Sık sorulan sorular

e-Faturada XSLT zorunlu mu?

GİB'in e-Fatura Uygulaması Entegrasyon Kılavuzu'na göre XML dosyaları içinde görüntüleme amacıyla kullanılacak XSLT tanımı mutlaka bulunmalıdır. Şablon faturanın içine gömülü olarak gönderilir.

XSLT ile XML farklı bilgi gösterirse hangisi geçerli?

Fatura XML'i. Kılavuza göre XSLT ile fatura XML'i arasında içeriğe ilişkin bir farklılık olması durumunda XML'de bulunan bilgiler esas alınır. Bu yüzden şablon yalnız görünümü belirlemeli, tutar ya da metin üretmemelidir.

Faturanın görüntüsünde bulunması gereken sabit öğeler var mı?

Kılavuza göre e-Fatura görüntüsünün üst orta kesiminde Gelir İdaresi Başkanlığı logosu ve altında "e-Fatura" ibaresi bulunmalıdır. Görüntü, GİB'in e-Fatura Görüntüleyici programıyla açılabilmelidir.

Şablon hatalıysa fatura açılmaz mı?

GİB'in e-Fatura Görüntüleyici kılavuzuna göre faturada XSLT yoksa ya da hatalıysa kullanıcıya, faturayı GİB'in yayımladığı varsayılan XSLT ile görüntüleme seçeneği sunulur. Fatura yine açılır; ancak sizin tasarımınızla değil.

e-Arşiv faturada da XSLT kullanılır mı?

e-Arşiv faturada da görüntü şablonla oluşturulur ve alıcıya genellikle PDF olarak iletilir. GİB'in Elektronik Arşiv Kılavuzu'na göre PDF'e ek olarak konan UBL-TR XML'inin ayrıca imzalanması ve içinde xslt bulunması zorunlu değildir.

Kaynaklar

Son gözden geçirme: 28.09.2026. Bu içerik genel bilgilendirme amaçlıdır; mevzuat değişebilir. Kendi durumunuz için mali müşavirinize danışın.

e-Fatura XSLT Şablonu Nedir?