UBL-TR nedir?
UBL-TR, uluslararası UBL (Universal Business Language) XML standardının Türkiye’ye uyarlanmış hâli olup e-Fatura, e-Arşiv ve e-İrsaliye gibi e-belgelerin GİB’in belirlediği ve bütün yazılımların ortak kullandığı elektronik XML biçimidir.
Bir e-Fatura, ekranda gördüğünüz PDF değil, arka plandaki XML dosyasıdır. Bu dosyanın hangi alanları hangi sırayla taşıyacağını UBL-TR biçimi belirler: satıcı ve alıcı bilgileri, satırlar, birimler, vergi kalemleri, fatura tipi ve senaryo. PDF ise bu XML’in insanlar için hazırlanmış görüntüsüdür.
UBL-TR’de sık karşılaşılan alanlar:
- Fatura tipi: SATIŞ, İADE, TEVKİFAT, İSTİSNA, ÖZEL MATRAH, İHRAÇ KAYITLI gibi.
- Senaryo: temel ya da ticari e-Fatura, e-Arşiv.
- Birim kodları: adet, kilogram, litre gibi ölçülerin resmî kodları.
- ETTN: belgenin tekil kimliği.
e-Belge numarası 3 haneli birim (seri) kodu ile 13 haneli sıra numarasından oluşur; örneğin FTR2026000000001.[1] e-Belgeler mali mühür ya da e-imzasıyla birlikte elektronik olarak saklanır.[2]
Bir e-belge, GİB’e ve alıcıya bu XML hâliyle iletilir; alıcının yazılımı da faturayı XML’den okur. Bu sayede gelen e-Fatura elle yazılmadan alıcının kayıtlarına aktarılabilir. Biçime uymayan bir dosya sistem tarafından reddedilir ve alıcıya ulaşmaz. Bu yüzden e-belge yazılımlarının en önemli işi, girdiğiniz bilgileri hatasız biçimde bu yapıya çevirmektir.
Vonahesap’ta UBL-TR ile uğraşmazsınız. Fatura kesme ekranında doldurduğunuz alanlar UBL-TR biçimine çevrilir ve GİB izinli özel entegratör altyapısıyla iletilir. Tanımlar’daki her birimin UBL kodu listeden seçildiğinde kendiliğinden gelir. Kestiğiniz ve size gelen faturaların XML’ini indirebilir, muhasebecinizle paylaşabilirsiniz.
Resmî kaynaklar
- [1]Mevzuat Bilgi Sistemi — 509 Sıra No.lu VUK Genel Tebliği, V.4 bölümü
- [2]Mevzuat Bilgi Sistemi — 509 Sıra No.lu VUK Genel Tebliği, VI. bölüm
Bu yazı bilgilendirme amaçlıdır; kendi durumunuz için mali müşavirinize danışın.
İlgili terimler
İlk yıl tüm özellikler ücretsiz. Sonrasında yıllık yalnızca 4.990 ₺. Üyeliğinizi iki dakikada kendiniz açın.
Ücretsiz üye olun