Sürüm Notları

Yürürlükte · Tarihsel Değişiklik Kaydı

14 Eylül 2026 GİB Değişiklikleri

14 Eylül öncesi ve sonrası kuralları karşılaştırın; entegrasyonunuzda işlem gerekip gerekmediğini doğrudan görün.

Durum ve kapsam

Nasıl okunmalı? “Zorunlu” olarak belirtilen yeni kurallar sağlanmazsa belge GİB veya platform doğrulamasından geçmez. “Portal için ek işlem yok” ifadesi, teknik XML/rapor alanının platform tarafından üretildiğini belirtir; kullanıcı yine belge ve alıcı bilgilerini doğru girmelidir.
BilgiDeğer
Yürürlük tarihi
DurumYürürlükte
Kapsame-Fatura, e-Arşiv Fatura, e-İrsaliye, e-Adisyon, e-Gider Pusulası, e-Müstahsil Makbuzu ve e-Serbest Meslek Makbuzu

Değişiklik karşılaştırması

Her teknik değişiklik ayrı satırda gösterilir. “Aksiyon yok” ifadesi, mevcut kullanımın geçerliliğini koruduğunu veya teknik dönüşümün platform tarafından yapıldığını belirtir.

Belge oluşturma ve doğrulama

Ürün / konu14 Eylül öncesi14 Eylül sonrasıEntegratör ve portal aksiyonuAyrıntı
e-Fatura
ENERJI / SARJ / SARJANLIK
Profil ve tip kontrol ediliyordu; hizmet dönemi, ESU rapor kimliği, alıcı plakası ve satır seri numarası bu kapsamda zorunlu değildi.Zorunlu: Her iki tipte başlangıç/bitiş tarih ve saati ile alıcı plakası gerekir. SARJ için GUID ve tarih taşıyan en az bir ESURaporID; SARJANLIK için her satırda dolu SerialID gerekir.Aksiyon gerekli
Entegratör: Bu alanları request/UBL içinde göndermeli.
Portal: Enerji faturası düzenleyen kullanıcı ekranda açılan dönem, plaka, ESU veya seri alanlarını doldurmalı. Platform biçim ve zorunluluk kontrolünü yapar.
Enerji faturası
e-Fatura ve e-İrsaliye
IDİS sevkiyat numarası
Yalnız SE- ve ardından yedi rakam kabul ediliyordu.SE-0000000 ve ES-0000000 biçimleri geçerlidir. Başka önek veya farklı hane sayısı geçersizdir.Mevcut kullanım geçerli
Entegratör: Mevcut SE- kullanımı geçerlidir; değişiklik zorunlu değildir. ES- artık kullanılabilir.
Portal: Aynı biçimlerden biri girilmeli; ek teknik işlem yoktur.
e-Fatura IDİS
e-İrsaliye
Araç ve dorse kimliği
Araç ve dorse kodları tek plaka kod listesinde değerlendirilebiliyor; plaka her irsaliyede zorunlu yorumlanabiliyordu.Araç alanı yalnız PLAKA/YABANCIPLAKA, dorse alanı yalnız dört dorse kodunu kabul eder. Araç plakası sürücü varsa zorunludur. Dorse opsiyoneldir; gönderilirse kodu ve biçimi geçerli olmalıdır.Taşıma bilgisi kullananlar
Entegratör: Araç ve dorseyi ayrı UBL/request alanlarına taşımalı; boş dorse nesnesi göndermemeli.
Portal: Araç ve dorse ayrı alanlardan, yerli/yabancı seçimine uygun girilmeli. Platform doğru şemayı uygular.
Araç ve dorse
e-Fatura
İstisna kodu 233
Kod genel ve istisna izin listelerinde bulunmadığı için reddediliyordu.233 geçerli istisna kodlarına ve ISTISNA bağlamına eklendi.Yeni kullanım seçeneği
Entegratör: Yalnız ilgili kamulaştırma istisnasında kullanabilir; diğer belgelerde aksiyon yok.
Portal: Kod güncel listeden seçilebilir.
Vergi kodları
e-Fatura / e-Arşiv
İstisna kodu 555
Kod bulunabiliyordu; profil/fatura tipi ve sıfır KDV kısıtları bugünkü açıklıkta uygulanmıyordu.Zorunlu: Yalnız izin verilen profil ve fatura tiplerinde kullanılabilir. 555 seçildiğinde belge ve satır KDV oranı/tutarı sıfır olamaz.555 kullananlar için gerekli
Entegratör: 555 kullanan eşlemeleri ve KDV hesaplarını kontrol etmeli.
Portal: Uygun olmayan kombinasyon platform tarafından engellenir; kullanıcı KDV'yi sıfır girmemeli.
Vergi kodları
e-Fatura / e-Arşiv
İstisna kodları 308, 339
Genel istisna kodları gibi değerlendirilebiliyordu.Zorunlu: Yalnız YATIRIMTESVIK veya tanımlı e-Arşiv YTB tiplerinde kullanılabilir. Harcama tipi 01 için 308, 02 için 339 beklenir.Bu kodları kullananlar için gerekli
Entegratör: Kodları normal ISTISNA akışından çıkarmalı ve doğru teşvik/YTB bağlamında göndermeli.
Portal: Doğru profil, tip ve harcama türü seçilmeli; platform uyumsuz seçimi reddeder.
Vergi kodları
e-Fatura
KAMU + IADE
IADE için izin verilen profiller arasında KAMU yoktu; birleşim reddediliyordu.KAMU + IADE kullanılabilir. KAMU profiline ait mevcut IBAN ve diğer zorunluluklar devam eder.Yeni kullanım seçeneği
Entegratör: Kamu iadesi üretilecekse bu birleşimi kullanabilir; diğer akışlarda aksiyon yok.
Portal: Kamu iadesinde profil ve tip seçilir; mevcut KAMU alanları yine doldurulur.
Fatura senaryoları
e-Arşiv Fatura
TEKNOLOJIDESTEK
Profil ile fatura tipi ilişkisi dolaylı kontrol ediliyordu.Zorunlu: InvoiceTypeCode=TEKNOLOJIDESTEK yalnız ProfileID=EARSIVFATURA ile kullanılabilir. Mevcut TELEFON/TABLET_PC ürün bilgileri de zorunluluğunu korur.Bu tipi kullananlar için gerekli
Entegratör: Bu tipte profili açıkça EARSIVFATURA göndermeli.
Portal: Uyumlu profil/tip seçilmeli; platform hatalı birleşimi engeller.
Özel tipler

GİB raporu ve alıcı kimliği

Ürün / konu14 Eylül öncesi14 Eylül sonrasıEntegratör ve portal aksiyonuAyrıntı
e-Arşiv Fatura
Rapor paketi v1.1_8
SARJ kaydında tek esuRaporID taşınabiliyordu. YTBTEVKIFAT ve YTBTEVKIFATIADE rapor tipi listesinde yoktu.Birden fazla ESU rapor kimliği taşınabilir. İki YTB tipi rapora eklendi; bu tiplerde yatırım teşvik belgesi numarası ve tarihi zorunludur.Bu tipleri kullananlar için gerekli
Entegratör: Belge birden fazla ESU raporuna bağlıysa tüm kimlikleri; YTB tiplerinde numara ve tarihi göndermeli.
Portal: İlgili belge bilgileri girilir; teknik GİB rapor XML'ini platform oluşturur.
e-Arşiv raporu
e-Arşiv Fatura
Rapor alıcısı
tuzelKisi ve gercekKisi ayrı ayrı opsiyoneldi; ikisi birden veya hiçbiri üretilebiliyordu.Zorunlu: VKN varsa yalnız tuzelKisi, TCKN varsa yalnız gercekKisi üretilir. İki dalın birlikte veya boş olması geçersizdir.Ek teknik işlem yok
Entegratör: Geçerli 10 haneli VKN veya 11 haneli TCKN göndermeli; rapor dalını ayrıca üretmez.
Portal: Alıcı kimliği doğru girildiğinde platform doğru dalı üretir.
Alıcı eşlemesi
e-Adisyon
Rapor alıcısı
Eski rapor modelinde tuzelKisi ve gercekKisi ayrı opsiyonel alanlardı; uygulama kimlik uzunluğuna göre ilgili alanı dolduruyordu.Zorunlu: Yeni tek seçimli yapıda VKN için yalnız tuzelKisi, TCKN için yalnız gercekKisi üretilir; iki dal birlikte oluşturulamaz.Ek teknik işlem yok
Entegratör: Geçerli VKN/TCKN göndermesi yeterlidir; rapor XML alanı göndermez.
Portal: Platform alıcı kimliğinden doğru rapor dalını üretir.
Alıcı kimliği
e-Müstahsil Makbuzu
Rapor alıcısı
Eski rapor modelinde tuzelKisi ve gercekKisi ayrı opsiyonel alanlardı; uygulama kimlik uzunluğuna göre ilgili alanı dolduruyordu.Zorunlu: Yeni tek seçimli yapıda VKN için yalnız tuzelKisi, TCKN için yalnız gercekKisi üretilir; iki dal birlikte oluşturulamaz.Ek teknik işlem yok
Entegratör: Geçerli VKN/TCKN göndermesi yeterlidir; rapor XML alanı göndermez.
Portal: Platform alıcı kimliğinden doğru rapor dalını üretir.
Alıcı kimliği
e-Serbest Meslek Makbuzu
Alıcı ve hata kodları
VKN ve TCKN uzunluk kontrolleri ayrı dallardaydı; TCKN uzunluk hatası için SMM018 tanımlıydı.VKN/TCKN yalnız rakamlardan oluşmalıdır. Rakam dışı değer SMM016; 10 veya 11 hane dışında kalan değer SMM017 döndürür. Bu kontrolde SMM018 artık dönmez. Raporda VKN yalnız tuzelKisi, TCKN yalnız gercekKisi oluşturur.Hata eşlemesi güncellenmeli
Entegratör: Hata eşlemesini SMM016/SMM017 için güncellemeli ve geçerli kimlik göndermeli.
Portal: Kullanıcı doğru kimliği girmeli; doğrulama ve rapor dalı platform tarafından uygulanır.
Kimlik ve hatalar

GİB kullanıcı hesabı

Ürün / konu14 Eylül öncesi14 Eylül sonrasıEntegratör ve portal aksiyonuAyrıntı
e-Gider Pusulası
erreceipt hesabı
erreceipt kullanıcı hesabı alias listelerinde bulunmuyordu.Zorunlu: Hesap alias'ı erreceipt olmalı; AuthorizedWorkScope gönderilmemeli ve seçenek kodu yalnız 171, 172, 173 veya 174 olmalıdır. VBT akışı 172 kullanır.Yalnız GİB kullanıcı zarfı üretenler
Doğrudan GİB kullanıcı zarfı üreten entegratör: Zarfı yeni kurala göre güncellemeli.
VBT API ve portal kullanıcısı: Ek işlem yok; teknik kullanıcı zarfını platform yönetir.
Kullanıcı hesabı

Geçiş ve destek kontrolü

KontrolBeklenen sonuç
Request modelleriYeni alanlar ve nesne yapıları güncel ürün rehberindeki biçimle gönderilir.
Ayrıntı → güncelleme çevrimiŞema ve değer çiftleri kaybolmadan korunur.
Portal parametreleriEksik parametre uyarısı bulunmaz; özel tip alanları seçime göre görünür.
Hata kayıtlarıKodun yanında mesaj metni ve ilgili alan yolu da saklanır.
Eski örnekler: 14 Eylül öncesine ait request kopyaları güncel sözleşme olarak kullanılmamalıdır. Yeni geliştirme ve düzeltmeler bağlantı verilen ürün rehberleri üzerinden yapılmalıdır.