GİB Kullanıcı Listeleri Kılavuzu V.1.1: UserList ve UserTempList ile Vergi Kaçağına Karşı Dijital Kontrol
GİB Kullanıcı Listeleri Nedir?
Gelir İdaresi Başkanlığı (GİB), e-fatura ve e-irsaliye ekosistemindeki mükelleflerin güncel listesini UserList adlı bir XML dosyasıyla yayınlar. Bu liste; her mükellefin vergi kimlik numarasını (VKN/TCKN), unvanını, hesap türünü (GİB Portal / Entegrasyon / Özel Entegrasyon) ve sahip olduğu belge etiketlerini (alias) içerir.
Eylül 2026'da yayınlanan V.1.1 kılavuzu, mevcut UserList yapısını güncellerken, 509 Sıra No.lu VUK Genel Tebliği kapsamında hesapları kapatılan mükelleflerin takibi için tamamen yeni bir liste olan UserTempList'i devreye almıştır.
Kimler Etkileniyor?
Özel Entegratörler (En Kritik Grup)
Özel entegratörler bu düzenlemeden doğrudan etkilenmektedir:
- UserTempList'i günlük izlemek ve kapatılan mükellefleri tespit etmek zorundadırlar.
- ClosureDate itibarıyla mükellefin tüm e-belge hesaplarını kapatma ve belge düzenleme engeli getirme yükümlülükleri vardır.
- Kapatılan mükelleflerin e-Arşiv raporlarını 24 saat içinde Başkanlığa göndermek zorundadırlar.
- RegistrationCode değerine göre farklı senaryoları (terk, birleşme, nevi değişikliği, unvan değişikliği) doğru yönetmelidirler.
Mükellefler
- Hesap kapatma sonrası 7 gün boyunca yalnızca ClosureDate öncesi tarihe belge düzenlenebilir; sonrasında belge düzenleme tamamen engellenir.
- Nevi değişikliği durumunda yeni VKN/TCKN otomatik olarak eski entegratöre bağlanır — ayrı HR-xml göndermeye gerek yoktur.
- Unvan değişiklikleri GİB tarafından otomatik yapılır; entegratörlerin bunu izleyerek kendi sistemlerini güncellemesi gerekir.
Mali Müşavirler ve Muhasebeciler
- Danışmanlık verdikleri mükelleflerin hesap durumlarını takip etmeleri artık kolaylaşmıştır.
- Terk ve kapanma süreçlerinde belge düzenleme penceresi (7 gün) konusunda müşterilerini bilgilendirmelidirler.
- Dönem sonu kapanışlarında UserTempList kayıtlarını kontrol ederek eksik belge riski azaltabilirler.
UserTempList: Vergi Kaçağına Karşı Dijital Kalkan
Neden Getirildi?
Geleneksel sistemde bir mükellefin sicil kaydı kapatıldığında, özel entegratörlerin bunu zamanında öğrenmesi ve belge düzenleme engeli koyması güçtü. Bu boşluk, terk edilmiş veya resen kapatılmış şirketler üzerinden sahte fatura düzenlenmesine zemin hazırlıyordu.
UserTempList bu açığı kapatmak için tasarlanmıştır:
- Anlık bildirim: Sicil değişikliği olduğu anda liste güncellenir.
- 7 günlük takip penceresi: Kayıtlar 7 gün boyunca listede kalır; entegratörler bu süre içinde gerekli önlemleri almak zorundadır.
- Zorunlu hesap kapatma: ClosureDate'ten itibaren belge düzenleme engeli otomatik olarak devreye girer.
- e-Arşiv rapor teslimi: Kapatılan mükelleflerin raporları 24 saat içinde GİB'e iletilmelidir.
Status Kodları ve Anlamları
| Status | Kapsam | Açıklama |
|---|---|---|
| 1 | VUK 509 | Başkanlık tarafından hesapları kapatılan mükellefler |
| 3 | VUK 507 | Başkanlık tarafından hesapları kapatılan mükellefler |
| 5 | VUK 509 + 507 | Her iki tebliğ kapsamında kapatılan mükellefler |
RegistrationCode — Kapatma Senaryoları
Kılavuz, farklı kapatma nedenlerini kodlarla sınıflandırır:
Terk İşlemleri:
- 005: Terk
- 007: Ölüm / Tasfiye / Ortaklık Bozma
- 010: Resen Terk
- 096: 160/A Kapsamında Terk
- 083: 153/A Kapsamında Meslek Mensubunun Terki
Yapısal Değişiklikler:
- 055/056: Birleşme / Devir Halinde Terk
- 057: Tam Bölünme Halinde Terk
- 058/094: Nevi Değişikliği
- 016/073: Unvan Değişikliği
Her senaryo için entegratörün yapması gereken işlem farklıdır. Örneğin nevi değişikliğinde (058/094) yeni kimlik numarası otomatik olarak eski entegratöre bağlanırken, terk durumunda hesabın tamamen kapatılması gerekir.
7 Günlük Geçiş Penceresi: Dikkat Edilmesi Gerekenler
RegistrationCode'u boş olmayan ve 096/083 dışında bir değer alan kayıtlar için 7 günlük geçiş süreci uygulanır:
- İlk 7 gün: Yalnızca ClosureDate'ten önceki tarihe belge düzenlenebilir (IssueDate < ClosureDate).
- 7. günün sonunda: Mükellefin tüm e-belge hesapları otomatik olarak kapatılır.
- e-Fatura alıcısı kapandıysa: ClosureDate sonrası tarihli belge için e-Arşiv Fatura düzenlenebilir.
- e-İrsaliye alıcısı kapandıysa: Sanal alıcılı e-İrsaliye düzenlenmesi gerekir.
Örnek: ClosureDate = 1 Ağustos 2026 ise, mükellefin hesapları 9 Ağustos 2026 saat 00:00'da kesin olarak kapatılır.
TAXTEN Bu Süreci Nasıl Yönetiyor?
TAXTEN e-Belge altyapısı, GİB'in UserList ve UserTempList güncellemelerini otomatik olarak takip eder:
- UserList senkronizasyonu: Mükellef etiketleri (alias) ve hesap türleri periyodik olarak güncellenir.
- UserTempList izleme: Hesap kapatma bildirimleri anlık olarak işlenir; entegratör panelinde uyarı gösterilir.
- Otomatik belge engeli: ClosureDate itibarıyla ilgili mükellef için belge düzenleme otomatik olarak engellenir.
- e-Arşiv rapor otomasyonu: Kapatılan mükelleflerin bekleyen raporları otomatik olarak GİB'e iletilir.
- Nevi/unvan değişikliği takibi: Sicil değişiklikleri otomatik olarak kullanıcı hesaplarına yansıtılır.
Getirdiği Avantajlar
Vergi Kaçağının Önlenmesi
UserTempList'in en büyük katkısı sahte fatura düzenleme riskini minimize etmesidir. Terk edilmiş veya resen kapatılmış şirketler üzerinden fatura kesilmesi artık teknik olarak engellenebilir hale gelmiştir.
Gerçek Zamanlı Sicil Takibi
Entegratörler artık mükellef sicil değişikliklerini gün içinde öğrenebilir. Eskiden günler hatta haftalar sürebilen bilgi akışı, XML tabanlı listeyle anlık hale gelmiştir.
Hukuki Güvence
Belge düzenleme penceresinin net kurallarla tanımlanması, olası vergi ihtilaflarında hem mükellef hem de entegratör için hukuki öngörülebilirlik sağlar.
Otomasyon İmkanı
Tüm süreç XML tabanlı ve makine tarafından okunabilir olduğundan, entegratörlerin bu kontrolleri insan müdahalesi olmadan otomatikleştirmesi mümkündür.
Sonuç
GİB'in UserList Kılavuzu V.1.1 ve beraberindeki UserTempList, Türkiye'nin e-belge ekosisteminde önemli bir güvenlik katmanı oluşturmaktadır. Özellikle özel entegratörlerin bu yeni düzenlemeye uyum sağlaması, mükellef hesap kapatma süreçlerini otomatikleştirmesi ve 7 günlük geçiş penceresini doğru yönetmesi kritik önemdedir.
TAXTEN olarak bu kılavuzdaki tüm gereksinimleri altyapımıza entegre etmiş bulunuyoruz. Mükelleflerimiz ve iş ortaklarımız için sorunsuz bir geçiş süreci sunmaya devam ediyoruz.
Kılavuzun tam metnine GİB e-Belge portalından ulaşabilirsiniz.