UBL Nedir? UBL Formatı ve UBL-TR Açıklaması

UBL, elektronik faturaların temelinde yer alan uluslararası bir veri standardıdır. Türkiye'de e-Fatura ve e-Arşiv faturaları, Gelir İdaresi Başkanlığı'nın (GİB) belirlediği UBL-TR formatında üretilir. Peki UBL nedir, UBL formatı nasıl çalışır ve "UBL ile XML aynı mı?" sorusunun yanıtı nedir? Bu rehberde teknik detayları sade bir dille açıklıyoruz.

UBL Nedir?

UBL (Universal Business Language / Evrensel İş Dili), ticari belgeleri elektronik ortamda standart bir yapıda ifade etmek için geliştirilen, XML tabanlı uluslararası bir standarttır. OASIS adlı uluslararası bir standart kuruluşu tarafından oluşturulmuştur. Temel amacı, farklı ülkelerdeki ve farklı yazılımlardaki sistemlerin aynı belgeyi tutarlı biçimde okuyup işleyebilmesidir.

UBL sadece fatura için değil, birçok ticari belge tipi için ortak bir dil sunar:

• Fatura (Invoice)
• İrsaliye (Despatch Advice)
• Sipariş (Order)
• Makbuz ve alındı belgeleri (Receipt Advice)
• Katalog ve fiyat listeleri

Bir belgeyi UBL formatında hazırladığınızda, o belge herhangi bir tedarikçi yazılımına bağımlı olmadan, standart etiketlerle ifade edilmiş olur. Bu da belgenin bir sistemden diğerine sorunsuz aktarılmasını sağlar.

UBL-TR Nedir?

GİB, uluslararası UBL 2.1 standardını Türkiye'nin yasal gereksinimlerine (vergi türleri, KDV tevkifatı, tevkifat kodları, vergi dairesi bilgileri gibi yerel alanlara) uyarlayarak UBL-TR adını vermiştir. Yani UBL-TR, UBL standardının Türkiye özelinde genişletilmiş halidir.

Bu düzenlemenin pratik sonucu şudur: Türkiye'de kesilen her e-Fatura ve e-Arşiv faturası, arka planda aslında bir UBL-TR dosyasıdır. Kullanıcı ekranda düzgün bir fatura görürken, sistemler arasında dolaşan asıl belge bu standart yapıdadır. e-Arşiv faturanın ne olduğunu ayrı bir rehberde ele aldık.

UBL ile XML Aynı Mı?

En sık sorulan soru budur. Kısa yanıt: Aynı değildir ama birbirleriyle yakından ilişkilidir.

XML (eXtensible Markup Language), veriyi etiketlerle yapılandırmanın genel kurallarını tanımlayan, genel amaçlı bir işaretleme dilidir. Kendi başına "bu bir faturadır" demez; yalnızca verinin nasıl etiketleneceğinin dilbilgisini verir. UBL ise bu dilbilgisini kullanarak, faturanın hangi alanlardan oluşacağını, alanların adlarını ve sırasını sabitleyen bir şemadır.

Basit bir benzetmeyle: XML alfabe ve dilbilgisi gibidir; UBL ise o dille yazılmış, herkesin aynı biçimde doldurduğu resmi bir sözleşme şablonudur.

Dolayısıyla "XML'i UBL'e çevirmek" (xml to ubl) dediğimizde kastedilen, elimizdeki ham veriyi UBL-TR şemasının beklediği etiket ve yapıya oturtmaktır. Bu dönüşümü genellikle muhasebe yazılımları ve entegratörler otomatik yapar.

UBL Dosyası Nasıl Görüntülenir?

Bir UBL dosyasını düz metin editöründe açtığınızda, etiketlerle dolu ham bir XML metni görürsünüz. Bu haliyle insan tarafından okunması zordur. Bu nedenle UBL dosyalarına çoğunlukla bir XSLT görüntüleme şablonu eşlik eder. XSLT, ham veriyi logo, tablo ve tutarların yer aldığı okunabilir bir fatura görünümüne dönüştürür.

Bir UBL/e-Fatura dosyasını görüntülemenin başlıca yolları:

• Entegratör veya e-Fatura portalı üzerinden fatura önizlemesiyle
• GİB e-Arşiv portalı görüntüleyicisiyle
• Dosyaya eşlik eden XSLT şablonuyla tarayıcıda açarak
• Muhasebe programınızın fatura ekranından

e-Fatura mükellefi olmak ve bu belgeleri kesmeye başlamak için gereken adımları e-Fatura başvurusu rehberimizde bulabilirsiniz.

UBL Formatı Neden Önemli?

UBL-TR gibi ortak bir standart olmasaydı, her yazılım faturayı kendi biçiminde üretir ve sistemler birbirini anlayamazdı. UBL'in sağladığı temel faydalar şunlardır:

• Sistemler arası uyum: Farklı firmaların farklı yazılımları aynı belgeyi okuyabilir.
• Otomatik işleme: Fatura verileri elle girilmeden muhasebeye aktarılabilir; hata payı düşer.
• Yasal geçerlilik: GİB'in kabul ettiği tek yapı olduğu için belgeler resmî olarak geçerlidir.
• Güvenli arşivleme: Standart yapı, faturaların yıllar sonra da sorunsuz okunmasını sağlar.

UBL dosyalarının oluşturulması, mali mühürle imzalanması ve GİB'e iletilmesi teknik bir süreçtir ve genellikle bir özel entegratör aracılığıyla yürütülür. Multi Portal gibi entegratörler bu adımları sizin adınıza otomatik yönetir; siz yalnızca faturanızı hazırlarsınız, formatın UBL-TR standardına uygunluğu arka planda sağlanır.

UBL Dosyasının İçinde Neler Bulunur?

Bir UBL-TR faturası, standartla belirlenmiş bölümlerden oluşur. "UBL dosyası nedir?" sorusunu somutlaştırmak için tipik bir e-fatura UBL dosyasının başlıca alanları şunlardır:

• Belge başlığı: Fatura numarası, düzenlenme tarihi, para birimi ve fatura tipi (e-Fatura / e-Arşiv).
• Taraf bilgileri: Satıcı ve alıcının unvanı, vergi numarası, vergi dairesi ve adres bilgileri.
• Fatura kalemleri: Her ürün/hizmet için ad, miktar, birim fiyat ve tutar.
• Vergi bilgileri: KDV oranları, tevkifat ve diğer vergi hesaplamaları.
• Toplamlar: Ara toplam, vergiler ve ödenecek genel toplam.

Tüm bu alanlar sabit etiket adlarıyla ifade edildiği için, faturayı alan taraf hangi yazılımı kullanırsa kullansın bilgileri doğru yerden okuyabilir. UBL-TR'nin gücü de tam olarak bu tutarlılıktan gelir.