UBL-TR Nedir?
Yayın: · Son güncelleme:
Bu bilgi Ekim 2026 itibarıyla günceldir. Oran, limit ve mevzuat değişebilir; işlem yapmadan önce resmî kaynaktan kontrol edin.
UBL-TR Nedir? Kısaca
UBL-TR, uluslararası UBL (Universal Business Language) standardının Türkiye'ye uyarlanmış hâlidir. e-Fatura, e-Arşiv Fatura ve e-İrsaliye gibi belgeler GİB'in belirlediği bu XML formatında oluşturulur ve iletilir.
UBL-TR nedir?
UBL-TR, elektronik belgelerin hangi alanları hangi yapıda içereceğini tanımlayan XML tabanlı veri standardıdır. Temelinde OASIS'in geliştirdiği uluslararası UBL 2.1 standardı bulunur. Gelir İdaresi Başkanlığı bu yapıya vergi kimlik numarası, fatura senaryosu ve tevkifat gibi Türkiye'ye özgü alanlar ekleyerek UBL-TR'yi oluşturmuştur.
Ne işe yarar?
UBL-TR, faturayı makinelerin okuyabildiği ortak bir dile çevirir. Satıcının yazılımı faturayı bu formatta üretir, sistem belgeyi doğrular ve alıcının programı aynı alanları otomatik okur. Böylece tutar, KDV ve alıcı bilgisi elle yeniden girilmez.
Format dışındaki bir dosya, görüntüsü fatura gibi olsa da e-Fatura sayılmaz. 509 Sıra No'lu VUK Genel Tebliği, belirlenen format ve standartlara uymayan belgenin e-Fatura hükmünde olmadığını açıkça belirtir.
Örnek
Örneğin 10.000 TL tutarındaki bir danışmanlık faturasında satıcı unvanı, ETTN, tarih, hizmet satırları ve vergi toplamları ayrı XML etiketlerinde tutulur. Ekranda gördüğünüz PDF görünümü ise bu XML'e bağlı bir stil dosyasıyla (XSLT) oluşturulur. Görünüm değişebilir, hukuki değeri olan veri XML'deki kayıttır.
Nelere dikkat etmeli?
Kendi yazılımınızla entegrasyon kuruyorsanız GİB'in ebelge.gib.gov.tr adresinde yayımladığı güncel UBL-TR kılavuzlarını ve şema sürümünü takip edin. Çoğu işletmede bu iş özel entegratör ya da muhasebe yazılımı tarafından yürütülür. Sizin kontrol etmeniz gereken asıl nokta, alıcı ve tutar bilgilerinin doğru girilmesidir.
Sıkça Sorulan Sorular
UBL-TR ile PDF fatura arasındaki fark nedir?
UBL-TR, faturanın veri hâlidir ve hukuki geçerliliği olan kayıt budur. PDF ise bu verinin okunabilir bir görüntüsüdür; tek başına e-Fatura yerine geçmez.
UBL-TR formatını öğrenmek zorunda mıyım?
Hayır. Fatura düzenleyen işletmelerin çoğu bu formatı özel entegratör ya da muhasebe programı üzerinden kullanır. Kendi sisteminizi GİB'e doğrudan bağlamak istiyorsanız teknik kılavuzları incelemeniz gerekir.