XBRL GL, e-Defter'in kullandığı uluslararası muhasebe veri formatıdır. Açılımı eXtensible Business Reporting Language Global Ledger'dır; kısaca genel muhasebe kayıtlarını standart etiketlerle taşıyan bir XML yapısıdır. Yevmiye ve büyük defter kayıtlarını, her tutarı, hesap kodunu ve tarihi tek tek etiketleyerek makinelerin okuyabileceği, doğrulayabileceği ve değişmezliğini denetleyebileceği biçimde saklar. e-Defter dosyalarınız bu yüzden gözle okunmaz; makineler için tasarlanmıştır.
Yazar: e-Defter PRO İçerik Ekibi. e-Defter dosyalarını XBRL GL formatında üreten ve doğrulayan saha ekibi.
Bir mükellef geçen ay dosyasını açıp "bu ne karmaşa" dedi. Ekranında etiketlerle dolu bir metin vardı, muhasebe defteri gibi görünmüyordu.
Aslında görünmesi de gerekmiyordu.
O dosya XBRL GL formatındaydı ve insan gözü için değil, sistemler için yazılmıştı. Bu yazıda e-Defter'in neden bu formatı kullandığını, yapısının nasıl çalıştığını ve e-Fatura'nın formatından farkını anlatıyoruz. e-Defter'in genel çerçevesini e-Defter nedir rehberimizde bulabilirsiniz.
Kısaca Bilmeniz Gerekenler
- XBRL GL, muhasebe kayıtlarını standart etiketlerle taşıyan uluslararası bir XML formatıdır.
- e-Defter, yevmiye ve büyük defteri bu formatta üretir; GİB (Gelir İdaresi Başkanlığı) formatı benimsemiştir.
- Format makine okunur olduğu için dosya çift tıklamayla okunur metne dönmez; görüntüleyici gerekir.
- XBRL GL defter kayıtlarını, UBL-TR ise e-Fatura belgesini taşır; ikisi farklı amaç için tasarlanmıştır.
- Uyumsuz formatta üretilen bir dosya geçerli e-Defter sayılmaz; format bir ayrıntı değil, geçerlilik şartıdır.
XBRL GL nedir?
XBRL GL, muhasebe verisini uluslararası bir standartta ve etiketli bir yapıda tutan bir XML formatıdır. Adındaki XBRL kısmı, iş ve finans raporlaması için geliştirilmiş açık bir standardı ifade eder. GL kısmı ise Global Ledger, yani genel muhasebe defteri anlamına gelir ve formatın defter kayıtlarına odaklandığını gösterir.
Formatın temel fikri şudur: her muhasebe bilgisi bir etiketle işaretlenir. Bir yevmiye kaydındaki tarih, hesap kodu, borç ve alacak tutarı, açıklama; hepsi kendi etiketini taşır. Böylece veri sadece bir metin yığını değil, anlamı makinece bilinen yapılandırılmış bir kayıt olur.
Bu yapılandırma, verinin sistemler arasında sorunsuz taşınmasını ve otomatik doğrulanmasını sağlar. İşte e-Defter'in bu formatı seçmesinin altında da bu özellik yatar.
e-Defter neden XBRL GL formatını kullanır?
e-Defter, yevmiye defteri ve büyük defterin elektronik ve yasal halidir. Bu defterlerin standart, doğrulanabilir ve değişmez biçimde tutulması gerekir. XBRL GL tam da bunu sağladığı için GİB tarafından e-Defter'in veri formatı olarak benimsenmiştir.
Standart olması, her mükellefin defterinin aynı yapıda üretilmesi demektir. Böylece GİB, farklı yazılımlardan gelen milyonlarca defteri aynı kurallarla okuyup denetleyebilir. Doğrulanabilir olması, dosyanın kurallara uyup uymadığının makinece kontrol edilebilmesi demektir. Değişmezliği ise berat ve imza katmanı güvence altına alır.
Buradan çıkan sonuç önemli. Format bir tercih ya da ayrıntı değildir; defterin geçerlilik şartıdır. Uyumsuz bir formatta üretilen dosya, ne kadar doğru veri içerirse içersin, geçerli bir e-Defter sayılmaz.
XBRL GL'nin yapısı: etiketli veri ve taksonomi
XBRL GL'nin kalbinde iki kavram vardır: etiketli veri ve taksonomi. Etiketli veri, az önce anlattığımız gibi, her bilginin kendi etiketini taşımasıdır. Taksonomi ise bu etiketlerin sözlüğüdür; hangi etiketin ne anlama geldiğini, hangi kuralla kullanılacağını tanımlar.
Bir örnekle netleşir. Bir yevmiye maddesinde şu bilgiler bulunur: madde numarası, tarih, borçlu ve alacaklı hesaplar, tutarlar, açıklama. XBRL GL bunların her birini ayrı bir etikete yerleştirir. Taksonomi de bu etiketlerin doğru sırada, doğru tipte ve doğru ilişkiyle kullanılmasını şart koşar.
- Muhasebe kaydı oluşur (yevmiye maddesi).
- Her alan ilgili XBRL GL etiketine yerleştirilir.
- Taksonomi etiketlerin kural ve ilişkilerini doğrular.
- Sonuç, GİB'in okuyup denetleyebileceği standart bir dosya olur.

Bu yapı sayesinde defteriniz sadece saklanmaz; üzerinde tutarlılık kontrolü de yapılabilir. Borç ve alacak dengesi, hesap kodlarının geçerliliği, zorunlu alanların doldurulması gibi denetimler formatın yapısı üzerinden yürür.
XBRL GL neden gözle okunmaz?
XBRL GL dosyasını çift tıklayıp açtığınızda okunur bir defter değil, etiketlerle dolu bir kod görürsünüz. Bu bir hata değildir; formatın doğasıdır. Etiketli yapı makinelerin işini kolaylaştırır, ama insan gözü için tasarlanmamıştır.
Dosyayı okunur hale getirmek için bir dönüşüm gerekir. Bu dönüşümü GİB'in e-Defter Görüntüleyicisi ya da resmi dönüşüm şablonu yapar. Görüntüleyici etiketli veriyi tablolara çevirir ve yevmiye maddelerini düzenli gösterir. Konunun ayrıntısını e-Defter Görüntüleyici rehberimizde anlattık.
Yani dosyanızın açılmaması bir sorun değil, beklenen bir durumdur. Doğru araçla saniyeler içinde okunur.
XBRL GL ile UBL-TR farkı nedir?
Burada sık bir karışıklık var. e-Fatura da bir XML formatı kullanır, ama o format XBRL GL değil UBL-TR'dir. İki format farklı işler için tasarlanmıştır ve karıştırılmamalıdır.
UBL-TR bir belgeyi, yani tek bir faturayı taşır. XBRL GL ise bir defteri, yani tüm muhasebe kayıtlarının bütününü taşır. Biri tekil bir ticari işlemi anlatır, diğeri dönem boyunca biriken kayıtları. e-Fatura ile e-Defter arasındaki bu katman farkını e-Fatura ile e-Defter farkı yazımızda ayrıntısıyla ele aldık.
Kısacası format, taşıdığı şeye göre seçilir. Belge taşıyorsanız UBL-TR, defter taşıyorsanız XBRL GL. e-Defter defter taşıdığı için XBRL GL kullanır.

XBRL GL ve berat ilişkisi
XBRL GL dosyası defterin kendisidir; berat ise o defterin özeti ve onayıdır. Defter dosyası üretildikten sonra, içeriğinin özetini taşıyan bir berat oluşturulur. Bu berat imzalanır ve GİB'e yüklenerek defterin varlığı ile değişmezliği onaylanır.
Yani XBRL GL ve berat birbirini tamamlar. Defter dosyası veriyi taşır, berat o verinin belirli bir tarihte var olduğunu ve sonradan değişmediğini güvence altına alır. Beratın ne olduğunu ve nasıl çalıştığını e-Defter beratı nedir yazımızda bulabilirsiniz.
Bu ilişki, formatın neden değişmezlikle birlikte anlam kazandığını gösterir. XBRL GL veriyi standartlaştırır, berat ise o standardı zamana bağlar.
Özetle
XBRL GL, e-Defter'in dilidir. Muhasebe kayıtlarınızı makinelerin okuyup doğrulayabileceği standart bir yapıya çevirir. Dosyanın gözle okunmaması bu tasarımın sonucudur, bir kusur değil. Formatın doğru üretilmesi ise defterinizin geçerliliğinin temelidir. Defter üretimi ve doğrulama tarafında yardıma ihtiyacınız olursa uzman ekibimize danışın.







