# UBL-TR

> UBL-TR, Gelir İdaresi Başkanlığı'nın (GİB) e-Fatura ve diğer e-Belge uygulamaları için benimsediği, açık UBL standardına dayanan XML tabanlı belge formatıdır. Faturadaki her bilgi, yeri ve adı önceden belli olan bir alanda durur. Bu sayede fatura yalnız insanlar tarafından değil yazılımlar tarafından da okunabilir ve muhasebe sistemine otomatik aktarılabilir.

URL: https://corrplus.net/tr/sozluk/ubl-tr-nedir/
Güncellendi: 2026-11-10
Corrplus Ekibi

**Tanım:** UBL-TR, Gelir İdaresi Başkanlığı'nın (GİB) e-Fatura ve diğer e-Belge uygulamaları için benimsediği, açık UBL standardına dayanan XML tabanlı belge formatıdır.

## UBL-TR nasıl çalışır?

UBL (Universal Business Language), ticari belgeler için geliştirilmiş açık bir XML standardıdır. UBL-TR, bu standardın Türkiye'deki e-Belge uygulamalarına göre uyarlanmış halidir. Bir [e-Fatura](/tr/sozluk/e-fatura-nedir/) dosyasında satıcı ve alıcının vergi numarası, fatura numarası, tarih, fatura satırları, birim fiyat, KDV oranı ve toplamlar ayrı alanlarda yer alır. Her faturanın bir de ETTN'si, yani evrensel tekil tanımlama numarası vardır.

## UBL-TR ne zaman karşınıza çıkar?

e-Fatura düzenlediğinizde veya aldığınızda arka planda dolaşan dosya budur. Çoğu kullanıcı onu görmez; portal veya entegratör ekranı faturayı okunur bir görünüme çevirir. Format, gelen faturaları ERP'ye otomatik aktarmak istediğinizde önem kazanır. Formatın kılavuzlarını ve şemalarını GİB yayımlar ve günceller.

## ERP entegrasyonunda UBL-TR nasıl kullanılır?

En temiz kaynak, entegratörün API'sinden alınan UBL-TR XML'dir. Akış XML'i okur, satıcıyı ERP'deki cari kartla eşleştirir ve kaydı Logo, Mikro veya Netsis gibi bir ERP'ye [API entegrasyonu](/tr/sozluk/api-entegrasyonu-nedir/) ya da içe aktarma dosyasıyla yazar. Fatura numarası ve ETTN, aynı faturanın iki kez işlenmesini önlemek için kontrol edilir.

XML'in bulunmadığı PDF ve kâğıt faturalarda veri önce belgeden çıkarılmalıdır. Bu iş OCR ve [akıllı doküman işleme](/tr/sozluk/akilli-dokuman-isleme-nedir/) ile yapılır ve insan onayı gerektirir. Akışın tamamını [iş süreci otomasyonu](/tr/hizmetler/is-sureci-otomasyonu/) sayfamızda anlatıyoruz.

## Sık sorulan sorular

### UBL-TR dosyasını okumak için yapay zeka gerekir mi?

Hayır. UBL-TR yapılandırılmış bir XML'dir; vergi numarası, satırlar, KDV ve toplamlar ayrı alanlardadır ve doğrudan okunur. Yapay zeka, yapılandırılmış verinin olmadığı PDF ve taranmış kâğıt faturalarda devreye girer.

### UBL-TR ile PDF fatura arasındaki fark ne?

PDF, faturanın insan için hazırlanmış görüntüsüdür. UBL-TR ise aynı bilginin makine tarafından okunabilen halidir. Otomasyonda PDF'ten veri çıkarmak hata payı taşır; XML'de alanlar zaten ayrıdır.

### UBL-TR'nin güncel sürümünü ve kurallarını nereden öğrenirim?

Formatın teknik kılavuzlarını ve şema dosyalarını GİB yayımlar ve günceller. Bir entegrasyon kurarken GİB'in e-Belge sitesindeki güncel kılavuzu ve entegratörünüzün dokümantasyonunu esas alın.
