GİB User List Kılavuzunu V1.1 Olarak Güncelledi

Gelir İdaresi Başkanlığı (GİB), 30 Eylül 2026 tarihinde User List (Kullanıcı Listeleri) Kılavuzunu güncelledi. Duyuruda, kılavuzdaki açıklamalara yönelik geliştirmelerin 16 Kasım 2026 tarihine kadar yapılması gerektiği bildiriliyor.

Mükellef açısından ne değişiyor?

16 Kasım 2026, özel entegratörlerin kılavuzdaki geliştirmeleri tamamlaması gereken tarih. Mükellef açısından önemli olan ise, e-Belge hesabının kapanış sürecinde e-Fatura ve e-İrsaliye gönderme ve alma işlemlerinin nasıl işleyeceği.

Bazı sicil işlemlerinde e-Belge hesabı kapanış tarihinde doğrudan kapanıyor ve belge düzenleme işlemi duruyor. Bazı işlemlerde ise hesap hemen kapanmıyor ve 7 günlük bir teknik geçiş süresi uygulanıyor.

Bu 7 günlük süre, mükellefin 7 gün daha yeni tarihli e-Fatura veya e-İrsaliye düzenleyebileceği ya da alabileceği anlamına gelmiyor. Ancak kapanış tarihinden önceki döneme ait e-Fatura ve e-İrsaliyeler, bu süre içinde hâlâ düzenlenebiliyor. Mükellef de kapanış tarihinden önceki tarihlere ait e-Belgelerini bu süre içinde düzenleyebiliyor.

Örneğin kapanış tarihi 1 Ağustos 2026 olan ve 7 günlük sürece giren bir hesap 9 Ağustos 2026 saat 00.00'da tamamen kapanıyor. Bu süre içinde belge tarihi 1 Ağustos'tan önceyse mükellef e-Fatura ve e-İrsaliye düzenleyebiliyor; aynı şekilde mükellefe de bu tarihlere ait e-Fatura ve e-İrsaliye düzenlenebiliyor.

Belge tarihi kapanış tarihinden sonraysa mükellefe e-Fatura düzenlenemiyor; gerektiğinde e-Arşiv Fatura düzenleniyor. e-İrsaliye tarafında ise sanal alıcı kullanılıyor.

Kılavuzdaki sicil kodları ve özel entegratörlerin uygulaması gereken teknik kurallar aşağıda ayrıntılı olarak yer alıyor.

Özel entegratör açısından ne değişiyor?

Kılavuzun sürüm tablosuna göre yeni sürüm V1.1 ve yayım tarihi 30 Eylül 2026. İlk sürüm olan V1.0, 2 Nisan 2026 tarihinde yayımlanmıştı. Sürüm tablosu V1.1 için iki alan yazıyor: 2.1 UserList bölümüne test erişim adreslerinin eklenmesi ve 3. USER TEMP LIST bölümündeki açıklamaların güncellenmesi. Duyuru metni sürüm numarası vermiyor; V1.1, kılavuzun kendi tablosundan okunuyor.

Güncellemenin özel entegratörler için asıl bölümü UserTempList işlemleri. V1.1, sicil durum kodu RegistrationCode değerine göre hesap kapatma, belge düzenleme, nevi değişikliği ve unvan değişikliğinin nasıl yürütüleceğini ayrı ayrı yazıyor.

• Status değeri 1, 3 veya 5 iken RegistrationCode boşsa veya işlem türü 096/083 ise hesap ClosureDate itibarıyla kapatılıyor ve e-Arşiv raporları 24 saat içinde gönderiliyor.
• Status değeri 1, 3 veya 5 iken RegistrationCode dolu ve işlem türü 096/083 dışındaysa V1.1, ClosureDate ve IssueDate ilişkisine bağlı 7 günlük sürece ilişkin kuralları açıklıyor.
• 058/094 için nevi değişikliği, 016/073 için unvan güncellemesi ayrıca düzenleniyor.
• GİB duyurusu, kılavuzdaki açıklamalara yönelik geliştirmelerin 16 Kasım 2026 tarihine kadar yapılmasını söylüyor.

UserTempList nedir?

UserTempList, 509 Sıra No.lu Vergi Usul Kanunu Genel Tebliği kapsamındaki düzenlemeler nedeniyle hesapları kapatılan mükelleflerin bilgilerinin ve sicil entegrasyonu işlemlerinin sonuçlarının takip edilebilmesi için kullanılıyor.

Bir kayıt UserTempList'e girdikten sonra 7 gün boyunca listede kalıyor. Bu süre V1.1 ile gelmedi. V1.0'da da kayıt, listeye girdiği tarihi takip eden 7 gün boyunca listede kalıyordu.

V1.1'deki fark, bu 7 gün içinde özel entegratörün nasıl hareket edeceğinin Status ve RegistrationCode değerlerine göre ayrılması.

Hangi durumda hesap ClosureDate tarihinde hemen kapanıyor?

Status değeri 1, 3 veya 5 olan kayıtlarda RegistrationCode boşsa ya da sicil işlem türünü gösteren son üç hane 096 veya 083 ise özel entegratör, mükellefin tüm e-Belge hesaplarını ClosureDate alanındaki tarih ve zaman itibarıyla kapatıyor ve belge düzenlenmesini engelliyor.

Bu durumda e-Arşiv uygulamaları kapsamında GİB'e gönderilecek e-Arşiv raporları da ClosureDate itibarıyla 24 saat içinde gidiyor. Rapora yalnızca IssueDate değeri ClosureDate ile aynı gün veya daha önceki bir tarihe ait belgeler giriyor.

Bu esas V1.0'daki kapatma modeliyle aynı çizgide. V1.0 da UserTempList içindeki mükellefin hesabının ClosureDate itibarıyla kapatılmasını ve e-Arşiv raporlarının 24 saat içinde gönderilmesini yazıyordu. V1.0'da Status için yalnızca 1 tanımlıydı; sicil koduna göre ayrım yoktu.

Hangi kayıtlarda 7 günlük belge düzenleme süresi uygulanıyor?

Status değeri 1, 3 veya 5 olan bir kaydın RegistrationCode alanı doluysa ve sicil işlem türü 096 veya 083 dışında bir değer taşıyorsa kılavuz ayrı bir süreç yazıyor.

058 ve 094 için nevi değişikliğine ilişkin ek işlem aşağıda ayrıca açıklanıyor. 016 ve 073 için ise kılavuz, UserList üzerindeki unvan güncellemesini ve özel entegratörün kendi kullanıcı hesaplarındaki unvanı güncellemesini ayrıca düzenliyor.

Kapatma penceresindeki kayıtlarda hesap, ClosureDate anında kapanmak yerine kılavuzdaki 7 günlük süre boyunca takip ediliyor. Mükellef bu sürede yalnızca ClosureDate tarihinden önceki tarihlere ilişkin e-Belge düzenleyebiliyor. Belgenin IssueDate değeri ClosureDate sonrasındaki bir tarihse belge düzenlenmesine izin verilmiyor.

Kılavuz kapatma zamanını örnekliyor. ClosureDate 1 Ağustos 2026 ise e-Belge hesapları 9 Ağustos 2026 saat 00.00'da kapatılıyor.

Kaydın 7 gün boyunca UserTempList'te durması ile hesabın 7 gün açık tutulması aynı şey değil. Listede 7 gün kalmak V1.0'da da vardı. V1.1, belirli sicil işlem türleri için bu süreyi ClosureDate öncesindeki tarihlere belge düzenlenebilen bir geçiş dönemi olarak da tanımlıyor.

Kapanan mükellefe e-Fatura ve e-İrsaliye nasıl düzenlenecek?

V1.1, 7 günlük dönemde mükellefin kendi düzenlediği belgeler ile bu mükellefe düzenlenen belgeleri ayrı yazıyor.

IssueDate, ClosureDate öncesindeyse ilgili mükellefe bu 7 gün içinde e-Fatura ve e-İrsaliye düzenlenebiliyor. IssueDate ClosureDate sonrasındaki bir tarihse, e-Fatura kullanıcılığı kapanmış mükellefe e-Fatura düzenlenemiyor; gerektiğinde e-Arşiv Fatura düzenlenebiliyor.

Aynı durumda, IssueDate değeri ClosureDate sonrasındaysa e-İrsaliye kullanıcılığı kapanmış mükellef için sanal alıcılı e-İrsaliye düzenlenmesi gerekiyor.

Belgenin IssueDate değeri ile ClosureDate arasındaki ilişki belirleyici. Süre, kapanan mükellefe 7 gün daha tarih sınırı olmadan e-Fatura veya e-İrsaliye düzenleneceği anlamına gelmiyor.

Nevi değişikliğinde HR-XML gönderilmesi gerekmiyor

İşlem türü 058 veya 094 olduğunda, nevi değişikliği sonucunda NewIdentifier alanındaki yeni VKN veya TCKN, eski neviye bağlı özel entegratör hesaplarına Başkanlık tarafından bağlanıyor. Bu işlem için özel entegratörün Başkanlığa kullanıcı açma zarfı, yani HR-XML, göndermesi gerekmiyor.

İşlem tablosunda 058 "Nevi Değişikliği Halinde Terk", 094 "Nevi Değişikliği" olarak duruyor.

058, dolu olup 096 ve 083 dışında kalan kodlardan biri. NewIdentifier ve HR-XML kuralı, 7 günlük işleyişin yerine geçen genel kural değil. Kılavuz nevi değişikliğine ait ek işlemi ayrıca tanımlıyor.

Unvan değişiklikleri UserList üzerinden takip edilecek

Sicil işlem türü 016 veya 073 olduğunda kılavuz, unvan güncellemesini ayrıca yazıyor. GİB unvan değişikliğini yapıp UserList kaydını güncelliyor. Özel entegratör bu değişikliği izleyip kendi kullanıcı hesaplarındaki unvanı güncelliyor.

Tabloda 016 "Unvan Değişikliği", 073 "Mernisten Nüfus Durum Güncellemesi" olarak yer alıyor.

Yeniden açılan hesaplarda HR-XML kuralı daraltıldı

V1.0, UserTempList içinde olup hesabı yeniden açılan mükellefin eski bilgileriyle UserList içinde yayımlanacağını ve daha önce aynı özel entegratöre bağlı mükellef için yeniden HR-XML gönderilmeyeceğini genel olarak yazıyordu.

V1.1 bu açıklamayı RegistrationCode alanı boş olan kayıtlar için yapıyor. Bu kayıtlardaki mükellefin hesabı yeniden açılırsa kapanmadan önceki bilgileriyle UserList içinde yayımlanıyor. Özel entegratör yeniden kullanıcı açma işlemi yapmıyor.

RegistrationCode artık 6 haneli yapısıyla açıklanıyor

V1.1, RegistrationCode alanını 6 hane olarak tanımlıyor. İlk üç hane mükellef türü:

Son üç hane sicil işlem türü. Kılavuzdaki 103010 örneğinde 103 tüzel kişiyi, 010 "Resen Terk" işlem türünü gösteriyor.

V1.0 bu 6 haneli yapıyı açıklamıyordu. Örnek XML'de RegistrationCode için 861, RegistrationDescription için "bu bir denemedir" yazıyordu. V1.1 örneği 103010 ve "Resen Terk".

Kılavuz, son üç hane için şu işlem tablosunu veriyor. Bu yazının kuralları 096, 083, 058, 094, 016 ve 073 satırlarını kullanıyor.

* Kılavuzun işlem tablosu.

V1.1'de Status alanı 1, 3 ve 5 olarak açıklanıyor

V1.0, Status alanının yalnızca 1 geleceğini yazıyordu. V1.1 alanı 1, 3 ve 5 olarak açıklıyor.

507 Sıra No.lu Vergi Usul Kanunu Genel Tebliği, Güvenli Mobil Ödeme ve Elektronik Belge Yönetim Sistemi'ne ilişkin düzenlemeleri içeriyor. 509 Sıra No.lu Tebliğ ise e-Fatura, e-Arşiv Fatura ve e-İrsaliye dahil elektronik belge uygulamalarına ilişkin düzenlemeleri kapsıyor. Kılavuz, status değerini bu tebliğ numaralarıyla tanımlıyor.

V1.0 ile V1.1 arasındaki temel farklar

Sürüm tablosu değişikliği "USER TEMP LIST açıklamaları güncellendi" diye özetliyor. Yukarıdaki satırlar, V1.0 ve V1.1 metinlerinin yan yana okunmasından geliyor. Tablonun işaret ettiği iki bölüm 2.1 UserList ve 3. USER TEMP LIST.

UserList ve UserTempList test adresleri

V1.1 test ortamı için üç adres ekliyor. 2.1 UserList bölümünde GB ve PK listeleri, 3. USER TEMP LIST bölümünde UserTempList adresi var. V1.0'da bu adresler yoktu.

• https://merkeztest.gib.gov.tr/EFaturaMerkez/newUserPkListxml.zip
• https://merkeztest.gib.gov.tr/EFaturaMerkez/newUserGbListxml.zip
• https://merkeztest.gib.gov.tr/EFaturaMerkez/newUserTempListxml.zip

Geliştirmeler için son tarih 16 Kasım 2026

30 Eylül 2026 duyurusu V1.1 numarasını ayrıca yazmıyor. Duyuru, User List Kılavuzunun güncellendiğini ve kılavuzdaki açıklamalara yönelik geliştirmelerin 16 Kasım 2026 tarihine kadar yapılması gerektiğini söylüyor. V1.1 sürüm numarası ve 30 Eylül 2026 yayım tarihi kılavuzun sürüm tablosunda.

UserTempList akışını kullanan özel entegratörlerin Status, RegistrationCode, ClosureDate, IssueDate ve NewIdentifier kurallarını kendi sistemleriyle karşılaştırması gerekiyor. Hesap kapatma ve belge düzenleme kontrolleri bu açıklamalara göre güncelleniyor. GİB'in verdiği son tarih 16 Kasım 2026.

Resmi kaynak

* Duyuru tarihi 30.09.2026; geliştirme son tarihi 16.11.2026. V1.0 yayım tarihi 02.04.2026. Karşılaştırma iki kılavuzun metnine dayanır.