E-Fatura durum kodları, gönderdiğiniz faturanının Gelir İdaresi Başkanlığı (GİB) sistemlerindeki ilerleyişini, alıcıya iletimini ve olası hataları gösteren sayısal işaretlerdir. Kodu doğru okuyup doğru aksiyonu hemen almak, gecikmeleri ve iade süreçlerini en aza indirir. Bu rehberde en sık görülen GİB durum/hata kodlarını, anlamlarını ve “ne yapmalı?” adımlarını tek sayfada bulacaksınız.
İçindekiler
E-Fatura Sürecinin Kısa Özeti (Zarf → GİB → Alıcı)
E-Fatura, teknik olarak bir zarf içinde GİB’e iletilir; GİB kontrolleri (şema/şematron vb.) geçildikten sonra alıcı sisteme aktarılır. Başarılı akışta tipik sıra 1000 → 1100 → 1200 → 1300 tur. Arada oluşan hatalar 11xx–12xx bandındaki kodlarla bildirilir.
En Yaygın E-Fatura Durum Kodları (Kısa Tablo)
- 1000 – ZARF KUYRUĞA EKLENDİ: Zarf GİB’e ulaştı, kuyruğa alındı. Aksiyon: Bekleyin; yoğunlukta süre uzayabilir.
- 1100 – ZARF İŞLENİYOR: GİB şema/şematron kontrollerini yapıyor. Aksiyon: Sonraki koda geçişi izleyin.
- 1150 – SCHEMATRON HATALI / 1160 – XML ŞEMA HATASI: Yapısal uyumsuzluk. Aksiyon: XML/şematronu düzeltip aynı ETTN ile yeniden gönderin (çoğu senaryoda izinlidir).
- 1181–1183 – Kimlik/etiket vb. sorunlar: Alıcı VKN/etiket eksik olabilir. Aksiyon: Alıcı bilgilerini güncelleyip tekrar deneyin.
- 1195 – SİSTEM HATASI: GİB tarafında geçici hata. Aksiyon: Kısa süre sonra tekrar deneyin; çoğunlukla aynı ETTN ile gönderim mümkün.
- 1200 – ZARF BAŞARIYLA ALICIYA İLETİLDİ: GİB’den alıcı sisteme gönderildi. Aksiyon: Alıcı işlemlerini bekleyin.
- 1210 – DOKÜMAN BULUNAN ADRESE GÖNDERİLEMEDİ: GİB alıcıya iletimi dener. Aksiyon: Otomatik tekrarları bekleyin; sonuç 1300 ya da 1215 olabilir.
- 1215 – TEKRAR GÖNDERME SONLANDI: GİB 3–4 deneme sonunda başaramadı. Aksiyon: Kontrol edip yeniden gönderin (genelde aynı ETTN ile).
- 1220 – HEDEFTEN SİSTEM YANITI GELMEDİ / 1230 – BAŞARISIZ YANIT: Alıcı sistem yanıt veremedi/başarısız. Aksiyon: Bir süre sonra tekrar gönderin; entegratör ile kontrol.
- 1300 – BAŞARIYLA TAMAMLANDI: Alıcı sisteme kabul edildi. Aksiyon: Süreç tamam.
Detaylı Kod Rehberi ve “Ne Yapmalı?”
1000 – ZARF KUYRUĞA EKLENDİ
Faturayı içeren zarfınız GİB’e ulaştı ve kuyruğa alındı. Özellikle yoğun saatlerde bu aşama uzayabilir. ERP/entegratör panelinde işlem kaydını bekletin; erken müdahale gerekmez.
1100 – ZARF İŞLENİYOR
GİB kontrolleri (şema, şematron, boyut, mime vb.) çalışıyor. Bu aşamada oluşan teknik uyumsuzluklar 11xx/1150/1160 serisinde hataya düşer.
ZIP/XML Kimlik Hataları (1110–1143 Örnekleri)
- 1110 – ZIP DOSYASI DEĞİL, 1130 – ZIP AÇILAMADI, 1131 – ZIP BİR DOSYA İÇERMELİ
- 1132 – XML DOSYASI DEĞİL, 1133 – ZARF ID & XML ADI AYNI OLMALI
- 1140 – DOKÜMAN AYRIŞTIRILAMADI, 1141 – ZARF ID YOK, 1142 – ZARF ID & ZIP ADI AYNI OLMALI, 1143 – GEÇERSİZ VERSİYON
Aksiyon: Paketleme kurallarını kontrol edin; zarf ID–XML/ZIP adı eşleşmelerini düzeltin, doğru UBL/versiyonla yeniden gönderin.
Şema/Şematron Hataları (1150–1160)
1150 – Schematron ve 1160 – XML Şema hataları format uyumsuzluğuna işaret eder. Örneğin zorunlu alanların boş kalması, alan tiplerinin/uzunluklarının kural dışı olması.
Aksiyon: Hata satırını logdan/entegratörden okuyup aynı ETTN’le düzeltme sonrası gönderin (entegratörler sıklıkla izin verir).
Alıcı/Etiket Hataları (1181–1183)
VKN/TCKN, etiket (GB/SB) veya posta kutusu bilgileri hatalı/eksik olabilir.
Aksiyon: Alıcı bilgilerini doğrulayın; özellikle alıcı etiket statüsünün güncel olduğundan emin olun.
GİB Tarafı Sistem Hataları (1190–1195)
1190 – Sistem yanıtı hazırlanamadı, 1195 – Sistem hatası gibi kodlar çoğunlukla geçicidir.
Aksiyon: Kısa bir bekleme sonrası tekrar deneyin; sorun tekrar ediyorsa entegratör destek kaydı açın.
1200 – ZARF BAŞARIYLA İLETİLDİ
GİB, zarfı alıcı sisteme aktardı. Bu, çoğu senaryoda alıcının okuduğu/anladığı anlamına gelmez; tamamlanma 1300 ile teyit edilir.
1210 – DOKÜMAN BULUNAN ADRESE GÖNDERİLEMEDİ → 1215/1220/1230
GİB, alıcıya iletirken sorun yaşarsa 1210 döner ve otomatik tekrar dener. Sonuçlar:
- 1300’e dönerse: Başarıyla tamamlandı.
- 1215 olursa: Tüm tekrarlar başarısız, tekrar gönderim sonlandı.
- 1220 ya da 1230: Alıcıdan yanıt gelmedi/başarısız geldi.
Aksiyon: 1210’da bir süre izleyin; 1215/1230 olduysa alıcı/entegratörle iletişim kurup yeniden gönderim yapın.
1300 – BAŞARIYLA TAMAMLANDI
Alıcı sistem faturayı başarıyla aldı. Uyuşmazlıklarda alıcı ERP’si/genel iş akışı tarafı ayrıca incelenmelidir.
Hızlı Teşhis Akışı (Pratik Rehber)
- 1000/1100’de takılıyorsa: GİB yoğunluğu veya paketleme/şematron hatası olabilir. Log’a bakın.
- 1150/1160: Şema/şematronu düzeltin → aynı ETTN ile tekrar gönderin.
- 118x: VKN/etiket doğrulayın; alıcı statüsünü kontrol edin.
- 1210: GİB tekrarlarını bekleyin; 1215 olursa yeniden gönderin.
- 1220/1230: Alıcı sistemi kaynaklı olabilir; karşı taraf/entegratör ile senkron olun.
- 1300: Süreç tamam. İç teyit/uzlaşmazlıklar alıcı tarafında çözümlenir.
2025 İçin En İyi Uygulamalar
- ETTN ve log disiplini: Her gönderimde ETTN–durum kodu–zaman damgasını kayıtlayın.
- Tekrar politikası: 1210/1215 senaryolarında entegratörünüzün retry kurallarını bilin.
- Şema/şematron güncelliği: Entegratörünüzün UBL-TR sürümleriyle uyumunu takip edin.
- Alıcı etiket kontrolü: Büyük alıcılarda dönemsel değişiklikler olabilir; listeyi sık güncelleyin.
- Uyarı/Alarm: 11xx/12xx kodlarında e-posta/Slack alarmı kurarak bekleme sürelerini azaltın.
Örnek Senaryolar
1) 1195 → 1000 → 1200 → 1300
GİB geçici hatası (1195) sonrası zarf tekrar kuyruğa girer ve başarıyla tamamlanır. Manuel müdahale gerekmez.
2) 1150/1160 (Şematron/Şema Hatası)
XML’de eksik zorunlu alan → Düzelt → Aynı ETTN ile tekrar gönder → 1200 → 1300.
3) 1210 → 1215
GİB, alıcı sisteme 3–4 kez denedi; başarısız oldu ve denemeleri sonlandırdı. Kontrol edip tekrar gönderin; alıcı sistem erişilebilirliğini doğrulayın.
Mini Sözlük
- ETTN: E-Fatura’nın tekil kimliği (UUID).
- UBL-TR: Türkiye’de e-belgelerin XML standardı.
- Şema/Şematron: Yapısal ve kural bazlı geçerlilik kontrolleri.
Sonuç
E-Fatura durum kodları, süreci saniyeler içinde teşhis etmenizi sağlar. 1000–1100–1200–1300 başarı zinciri hedeflenirken; 1150/1160 (format), 118x (alıcı), 1195 (geçici sistem) ve 1210/1215/1220/1230 (iletişim) kodları için bu rehberdeki “ne yapmalı?” adımlarını uygulayın. Basit kayıt/otomasyon ve taze alıcı bilgileriyle hata oranınız belirgin biçimde düşer.
