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.
| Bilgi | Değer |
|---|---|
| Yürürlük tarihi | |
| Durum | Yürürlükte |
| Kapsam | e-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 / konu | 14 Eylül öncesi | 14 Eylül sonrası | Entegratör ve portal aksiyonu | Ayrıntı |
|---|---|---|---|---|
e-FaturaENERJI / 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-FaturaKAMU + 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 FaturaTEKNOLOJIDESTEK | 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 / konu | 14 Eylül öncesi | 14 Eylül sonrası | Entegratör ve portal aksiyonu | Ayrı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 / konu | 14 Eylül öncesi | 14 Eylül sonrası | Entegratör ve portal aksiyonu | Ayrı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ü
| Kontrol | Beklenen sonuç |
|---|---|
| Request modelleri | Yeni 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 parametreleri | Eksik 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.