e-Fatura Paketi ve UBL-TR (Kod Listeleri) Kılavuzu Güncellendi

Gelir İdaresi Başkanlığı (GİB), 05 Eylül 2025 tarihinde e-Fatura Paketi ile UBL-TR (Kod Listeleri) Kılavuzu için güncellemeleri yayımladı. Yapılan değişiklikler 01 Ekim 2025 itibarıyla yürürlüğe girecektir.

Güncellemenin amacı

Güncellemeler; e-Belge üretiminde kullanılan şema ve paket içeriklerinin ile kod listelerinin standartlaştırılması, uyumluluğun artırılması ve doğrulama kurallarının netleştirilmesi amacıyla yayımlanmıştır.

• e-Fatura paket içeriklerinin ve örneklerinin güncellenmesi
• UBL-TR kod listeleri ile uyumun güçlendirilmesi
• Senaryo bazlı (iade, ihracat kayıtlı vb.) kuralların netleşmesi
• Doğrulama (schematron) süreçlerinde tutarlılık
• Veri bütünlüğü ve izlenebilirliğin artırılması

Öne çıkan yenilikler

Değişiklikleri iki başlık altında özetledik:

e-Fatura Paketi

• Şema ve paket dosyalarında sürüm uyumu ve örnek dokümanların güncellenmesi
• UBL-TR kod listeleri ile eşleşmeyen alanların hizalanması
• Belge üretim ve validasyon akışlarında tutarlılık iyileştirmeleri

UBL-TR (Kod Listeleri) V1.38

• AdditionalItemIdentificationIDType güncellemesi
• IlacTibbiCihazAdditionalItemIdentificationCheck güncellemesi
• IhracKayitliPartyIdentificationIDType eklendi
• IhracKayitliPartyIdentificationIDTypeCheck güncellemesi
• IADEInvioceCheck güncellemesi

Kimleri etkiliyor?

e-Fatura ve e-Arşiv kullanıcıları

Güncel paket ve kod listeleriyle uyumlu belge üretimi zorunludur.

Özel entegratörler

Müşteri senaryolarını yeni kurallara göre test edip güncellemelidir.

Ne zaman geçerli olacak?

• 05.09.2025 – Duyuru yayımlandı.
• 01.10.2025 – Tüm değişiklikler yürürlüğe girecek.

Sonuç

e-Fatura Paketi ve UBL-TR Kod Listeleri güncellemeleri; üretim, doğrulama ve raporlama süreçlerinde standart ve uyumlu ilerleyiş için kritik önem taşır. Teknik ekiplerin ve entegratörlerin geliştirme ve test planlarını 01.10.2025 yürürlük tarihine göre hizalaması önerilir. ERP ve e-Fatura entegrasyonunuzun yeni paket ile uyumunu yazılım sağlayıcınızla teyit edin.

Neden önemli?

Bu güncelleme, e-Fatura Paketi ve UBL-TR Kod Listeleri arasında sürüm uyumunu güçlendirerek belge üretimi ve doğrulama adımlarında tutarlılık sağlar. Özellikle iade, ihracat kayıtlı ve ilaç ve tıbbi cihaz senaryolarında kod listesinde yapılan küçük değişiklikler dahi reddedilen belge oranını etkileyebilir. Bu nedenle geliştirme ekiplerinin şema ve kod listesi referanslarını güncellemesi, test ortamında örnek belgeleri yeniden doğrulaması ve üretim öncesi son bir entegrasyon kontrolü yapması önerilir.

İş birimleri açısından bakıldığında, 01.10.2025 yürürlük tarihi, süreçleri durdurmadan geçiş yapabilmek için kritik eşiktir. Versiyon notlarının takip edilmesi, kullanıcı dokümantasyonunun güncellenmesi ve iç eğitimlerin kısa bir özetle duyurulması, uyum riskini azaltır. Bu duyuru yalnızca teknik bir güncelleme değil; iş sürekliliği ve mevzuat uyumu için önemli bir aksiyon penceresidir.