VERGİ TEKNOLOJİLERİ VE DİJİTAL UYUM BİLGİ MERKEZİ
GÜNCEL REHBER
UBL-TR Dokümantasyonu
UBL-TR Dokümantasyonu: 2026 güncel GİB e-Belge, e-Defter, UBL-TR, XML, entegrasyon, hata kodları ve teknik uyum rehberi.
UBL-TR Dokümantasyonu uygulaması; mevzuat, GİB teknik kılavuzları, ERP entegrasyonu, UBL-TR, XML doğrulama, arşivleme ve hata yönetimi bakımından ayrıntılı olarak ele alınmıştır.
1. Kapsam ve Amaç
Bu rehber, elektronik belge ve elektronik defter uygulamalarının hukuki, teknik, muhasebesel ve operasyonel boyutlarını işletmeler, mali müşavirler, yazılım ekipleri ve yöneticiler açısından sistematik biçimde açıklamak amacıyla hazırlanmıştır.
2. Hukuki Dayanak
Elektronik uygulamalar Vergi Usul Kanunu, ilgili genel tebliğler, sirkülerler, teknik kılavuzlar, paket güncellemeleri ve Gelir İdaresi Başkanlığı duyuruları çerçevesinde değerlendirilmelidir.
3. 2026 Güncellik Kontrolü
2026 yılında elektronik belge ve e-Defter süreçleri bakımından yeni tebliğler, süre uzatımları ve sistem duyuruları yayımlanmıştır. İşlem öncesinde güncel GİB ve e-Defter sayfaları kontrol edilmelidir.
4. Mükellef Kapsamı
Uygulamaya zorunlu veya isteğe bağlı dahil olan mükellefler; faaliyet konusu, brüt satış hasılatı, belge türü, sektör ve özel düzenlemelere göre farklı yükümlülüklere tabi olabilir.
5. Başvuru ve Aktivasyon
Başvuru yöntemi, mali mühür veya elektronik imza, kullanıcı hesabı, özel entegratör seçimi, doğrudan entegrasyon veya portal yöntemi uygulamaya göre belirlenmelidir.
6. Portal, Özel Entegrasyon ve Doğrudan Entegrasyon
Kullanım yöntemi seçilirken belge hacmi, ERP entegrasyonu, arşivleme ihtiyacı, iş sürekliliği, destek hizmeti ve bilgi güvenliği kriterleri birlikte değerlendirilmelidir.
7. ERP Entegrasyonu
Cari kart, stok kartı, vergi kodu, ödeme yöntemi, teslimat bilgisi, belge senaryosu ve zorunlu alanlar ERP ile e-Belge sistemi arasında doğru eşleştirilmelidir.
8. UBL-TR Veri Modeli
UBL-TR yapısında belge kimliği, tarih, taraf bilgileri, satırlar, vergi toplamları, ödeme, teslimat ve ek doküman alanları kılavuzlara uygun oluşturulmalıdır.
9. XML Üretimi
XML dosyalarında karakter kodlaması, ad alanları, veri tipleri, zorunlu etiketler, uzunluk sınırları ve kod listeleri otomatik doğrulamadan geçirilmelidir.
10. Şema ve Schematron Kontrolü
Belge yalnızca XML olarak açılabiliyor diye geçerli sayılmaz. XSD şemaları ve iş kurallarını denetleyen Schematron kontrolleri birlikte uygulanmalıdır.
11. Elektronik İmza ve Mali Mühür
İmzalama sertifikasının geçerlilik süresi, yetkili kişi, zaman damgası, HSM veya kart okuyucu altyapısı ve imzalı dosyanın bütünlüğü düzenli kontrol edilmelidir.
12. Belge Numaralandırma
Belge numarası, seri yapısı, yıl bilgisi, mükerrerlik kontrolü, iptal edilen numaralar ve atlanan sıralar sistemsel olarak izlenmelidir.
13. Belge Senaryoları
Temel, ticari, ihracat, kamu, yolcu beraber fatura veya uygulamaya özgü diğer senaryoların hangi işlemde kullanılacağı süreç sahiplerine açıkça tanımlanmalıdır.
14. Gönderim ve Zarf Süreci
Belge paketi oluşturma, zarf gönderme, sistem yanıtı, kabul, ret, hata ve yeniden gönderim durumları işlem günlüğünde izlenmelidir.
15. GİB Yanıt Kodları
Teknik hata kodları; bağlantı, şema, imza, alıcı etiketi, tekrar gönderim ve sistem durumu gibi sınıflara ayrılarak çözüm matrisi oluşturulmalıdır.
16. İptal ve İtiraz
Belge türüne göre portal, KEP, noter, ticari uygulama yanıtı veya diğer yöntemlerle yürütülen iptal ve itiraz süreleri ayrı takip edilmelidir.
17. Belge Görüntüsü
XSLT görüntüsü, logo, açıklamalar, karekod, vergi bilgileri ve insan tarafından okunabilir görünüm teknik dosyayla tutarlı olmalıdır.
18. Karekod Uygulaması
Karekod içeriği, boyutu, belge üzerindeki konumu, yazıcı kalitesi ve mobil cihazlarda okunabilirliği test edilmelidir.
19. Arşivleme ve Saklama
XML, imzalı dosya, görüntü, sistem yanıtı, iptal kaydı ve gönderim logları yasal saklama süresi boyunca erişilebilir ve değiştirilemez biçimde korunmalıdır.
20. Yedekleme ve Felaket Kurtarma
Birincil sistem dışında coğrafi olarak ayrılmış yedek, düzenli geri yükleme testi, RPO-RTO hedefleri ve kesinti prosedürü oluşturulmalıdır.
21. Bilgi Güvenliği
Kullanıcı yetkileri, çok faktörlü erişim, loglama, veri şifreleme, sertifika yönetimi, güvenlik açığı takibi ve tedarikçi erişimleri kontrol edilmelidir.
22. KVKK ve Ticari Sır
Elektronik belgelerdeki kişisel veriler ve ticari bilgiler yalnızca gerekli kişilerce erişilebilir olmalı; saklama ve silme politikaları tanımlanmalıdır.
23. Muhasebe Kayıtlarıyla Mutabakat
Elektronik belge toplamları; satış, alış, KDV, stok, cari hesap, banka ve beyanname kayıtlarıyla dönemsel olarak karşılaştırılmalıdır.
24. KDV ve Vergi Kontrolleri
Vergi oranı, istisna kodu, tevkifat, özel matrah, döviz kuru, iskonto ve vergi toplamlarının belge ve muhasebe kayıtlarında uyumlu olması gerekir.
25. İç Kontrol ve Yetki Matrisi
Belge oluşturma, onay, gönderme, iptal, arşivleme ve hata düzeltme yetkileri görev ayrılığı esasına göre tanımlanmalıdır.
26. Operasyon Takvimi
Günlük belge kontrolleri, aylık mutabakat, sertifika yenileme, kılavuz takibi ve test çalışmaları yıllık takvimde planlanmalıdır.
27. Test Ortamı
Yeni sürüm canlıya alınmadan önce başarılı gönderim, ret, iptal, bağlantı kesintisi, hatalı veri ve sertifika süresi dolması senaryoları test edilmelidir.
28. Versiyon Yönetimi
Kılavuz, şema, kod listesi, XSLT ve yazılım sürümlerinin yayın tarihi, canlıya alma tarihi ve değişiklik notları kayıt altında tutulmalıdır.
29. Özel Entegratör Yönetimi
Hizmet seviyesi, destek süresi, veri saklama, çıkış planı, veri taşınabilirliği, kesinti bildirimi ve güvenlik sorumlulukları sözleşmede açıkça düzenlenmelidir.
30. Denetim Dosyası
Başvuru kayıtları, teknik testler, sözleşmeler, gönderim logları, mutabakatlar, kullanıcı yetkileri ve arşiv doğrulama raporları denetime hazır tutulmalıdır.
31. Yönetim Raporlaması
Belge adedi, hata oranı, ret oranı, iptal, gecikme, manuel müdahale, sistem kesintisi ve işlem maliyeti yönetime düzenli raporlanmalıdır.
32. Uygulama Kontrol Listesi
Mevzuat, kılavuz, zorunluluk tarihi, yöntem, sertifika, şema, ERP alanları, test, yetki, arşivleme ve mutabakat kontrolleri tek listede toplanmalıdır.
33. Ortak Veri Bileşenleri
Party, Address, TaxTotal, InvoiceLine, PaymentMeans ve Delivery gibi ortak bileşenlerin kullanımı belgeler arasında tutarlı olmalıdır.
34. Kod Listeleri
Birim, para birimi, vergi türü, istisna, ödeme, ülke ve belge tipi kodları güncel listelerden alınmalıdır.
Resmî Teknik Kaynaklar
Sık Sorulan Sorular
Bu içerik hangi tarihte güncellendi?
31 Temmuz 2026 itibarıyla erişilebilen güncel GİB ve e-Defter kaynakları dikkate alınmıştır.
Teknik kılavuz değiştiğinde ne yapılmalıdır?
Eski ve yeni sürüm karşılaştırılmalı, etkilenen alanlar belirlenmeli, test ortamında doğrulama yapıldıktan sonra canlıya geçilmelidir.
XML dosyasının açılması geçerli olduğu anlamına gelir mi?
Hayır. XSD, Schematron, imza, iş kuralı ve GİB sistem kontrollerinin tamamının başarılı olması gerekir.
Saygılarımızla,
Seaacademy İK Hizmetleri
0543 593 02 63
info@seaacademyik.com