e-Fatura Durum Kodları Ne Anlama Gelir? Zarf Durumu, Sistem Yanıtı ve Hata Kodları

e-Fatura durum kodu, faturanızı taşıyan zarfın GİB sisteminde hangi aşamada olduğunu gösteren dört haneli koddur. GİB’in Sistem Yanıtı kılavuzuna göre 1000 zarfın kuyruğa eklendiğini, 1200 GİB’de başarıyla işlendiğini, 1220 alıcının sisteminden sistem yanıtı beklendiğini, 1300 sürecin başarıyla tamamlandığını gösterir. 1100 zarfın işlendiğini; 1110–1195 arasındaki kodlar işleme hatasını gösterir.

Bu yazıdaki kod listesi ve açıklamalar GİB’in ebelge.gib.gov.tr’de yayımladığı “e-Fatura Uygulaması Sistem Yanıtı Şema Yapısı” kılavuzundan (v1.5, Kasım 2017) birebir alınmıştır; açıklamalar kılavuzdaki yazımla, çoğunlukla Türkçe karakter kullanılmadan verilmiştir. Her kod için ne anlama geldiğini ve sizin ne yapmanız gerektiğini sade bir dille ekledik. Son kontrol: 5 Kasım 2026.

Zarf, sistem yanıtı ve uygulama yanıtı nedir?

e-Fatura doğrudan alıcıya gitmez; bir zarfın içine konup GİB’in merkez sistemine gönderilir. GİB’in entegrasyon kılavuzu üç zarf türü tanımlar: faturayı gönderen tarafın zarfı (SENDERENVELOPE), alıcının yanıt zarfı (POSTBOXENVELOPE) ve durum bilgisini taşıyan sistem yanıtı zarfı (SYSTEMENVELOPE). Alıcının e-Fatura’yı teslim alan birimine posta kutusu denir.

Sistem yanıtı, zarfın durumunu gönderene bildiren mesajdır. Kılavuz bunu zaman uyumsuz (asenkron) bir belge olarak tarif eder; gönderen ayrıca zarfın durumunu sorgulayabilir. Durum kodları bu sistem yanıtlarının içinde gelir. Uygulama yanıtı ise başka bir şeydir: ticari fatura senaryosunda alıcının faturaya verdiği KABUL, RED ya da İADE cevabını taşıyan belgedir.

Fatura alıcıya nasıl ulaşır?

GİB’in entegrasyon kılavuzundaki temel fatura senaryosu beş adımdan oluşur. Durum kodları bu adımların hangisinde olduğunuzu söyler.

1. 1

   Gönderim

   Gönderen taraf UBL-TR biçimindeki faturayı zarfa koyar ve GİB’in merkez sistemine yollar.

2. 2

   Merkez kontrolü

   Merkez zarfı kuyruğa alır; şema ve schematron kontrollerini, imza ve mühürün varlığını, gönderici ve alıcı adresini kontrol eder ve gönderene sistem yanıtı döner.

3. 3

   Alıcıya iletim

   Kontrollerden geçen zarf alıcının posta kutusuna gönderilir.

4. 4

   Alıcı tarafı kontrolü

   Posta kutusu zarfı kendi kontrollerinden geçirir ve merkeze sistem yanıtı gönderir.

5. 5

   Sonuç

   Merkez bu yanıtı gönderene iletir; alıcı tarafı başarılıysa zarfın durumu 1300 olur.

Başarılı gönderimde kodlar hangi sırayla gelir?

Kılavuza göre merkezde zarfın durumu önce 1000 “ZARF KUYRUGA EKLENDI”, sırası gelince 1100 “ZARF ISLENIYOR” olur. Kontrollerden hatasız geçerse 1200 “ZARF BASARIYLA ISLENDI” olur. Zarf alıcının posta kutusuna gönderilince, posta kutusundan sistem yanıtı gelene kadar durum 1220 “HEDEFTEN SISTEM YANITI GELMEDI” olarak görünür.

Alıcı taraf zarfı başarıyla işleyip 1200 kodlu yanıt dönerse merkezdeki durum 1300 “BASARIYLA TAMAMLANDI” olur. Kısacası 1200 yalnız GİB’in kendi kontrollerinden geçildiğini gösterir; sürecin sonu 1300’dür. Alıcı taraf başarısız bir kod dönerse durum 1230 olur.

GİB e-Fatura durum kodları tablosu

Aşağıdaki liste GİB’in Sistem Yanıtı kılavuzundaki “Durum Kodları ve Açıklamaları” tablosunun tamamıdır. Üçüncü sütundaki gruplama okumayı kolaylaştırmak için eklendi; GİB’in resmî sınıflaması değildir.

1100–1200 arası hatalar: fatura gitti mi, ne yapmalı?

Kılavuz açık: işlenme sırasındaki hatalara ait kodlar 1100 ile 1200 arasındadır; böyle bir hata olursa zarfın durumu sistem yanıtıyla gönderene bildirilir ve gönderimde bir sonraki aşamaya geçilmez. Yani 1110–1195 arasındaki kodlardan birini görüyorsanız fatura alıcıya ulaşmamıştır. Hatanın nedenini giderip faturayı yeniden zarflayarak göndermek gerekir.

En sık karşılaşılanlar içerik hatalarıdır: 1150 belge GİB’in kural (schematron) kontrolünden, 1160 XML şema kontrolünden geçemediğinde gelir. Bunlar çoğunlukla eksik ya da biçimi hatalı bir alandan kaynaklanır. 1161–1177 arası imza ve yetkiyle, 1180–1181 alıcı adresiyle ilgilidir; örneğin alıcının e-Fatura posta kutusu adresi bulunamamıştır.

Her hata sizin hatanız değildir. GİB, 10 Eylül 2022’de 1120 “ZARF ARSIVDEN KOPYALANAMADI” hatası alan paketler için mükelleflerin belgeleri yeniden göndermesine gerek olmadığını, zarfların sisteme yeniden alınıp 1000 olarak güncelleneceğini duyurmuştu. 22 Haziran 2021’de de döviz kuru alanıyla ilgili bir kontrol nedeniyle 1150 alan faturaların sorunun giderildiğini ve yeniden zarflanarak gönderilebileceğini açıklamıştı. Hata alınca önce ebelge.gib.gov.tr duyurularına bakmak zaman kazandırır.

1163: aynı fatura ikinci kez gönderilirse

1163 “GONDERILEN ZARF SISTEMDE DAHA ONCE KAYITLI OLAN BIR FATURAYI ICERMEKTEDIR” kodu, sistemde zaten kayıtlı bir faturanın yeni bir zarfla tekrar gönderildiğini söyler. Kılavuza göre zarf 1220 durumundayken ya da 1210 sonrası yeniden deneme sürerken faturalardan biri yeni bir zarfla gönderilirse yeni zarf 1163 alır.

Bu kod genellikle panikle yapılan ikinci gönderimin sonucudur. Doğru tepki yeni bir fatura numarası ya da yeni ETTN ile faturayı yeniden kesmek değil, ilk zarfın durumunu izlemektir. Aksi hâlde alıcıda aynı satış için iki ayrı fatura oluşabilir.

1210, 1215, 1220 ve 1230: alıcıya ulaşmayan zarflar

1210 “DOKUMAN BULUNAN ADRESE GONDERILEMEDI”, merkezin zarfı alıcının posta kutusuna iletemediğini gösterir. Kılavuza göre merkez aynı zarfı dört kez, ikişer saat arayla, toplam sekiz saat içinde yeniden göndermeyi dener. Denemelerden biri başarılı olursa durum 1220’ye geçer; dördüncü denemede de başarısız olursa 1215 “DOKUMAN GONDERIMI BASARISIZ. TERKAR GONDERME SONLANDI” olur. 1215’ten sonra zarftaki faturalar aynı Fatura ID’siyle yeniden gönderilebilir.

1220 bir hata değil, bekleme durumudur: zarf alıcıya gitmiş, alıcı tarafın yanıtı beklenmektedir. Alıcı taraf başarısız işlendiğini bildirirse durum 1230 olur ve kılavuza göre faturalar yine aynı Fatura ID’siyle yeniden gönderilebilir. Uzun süre 1220’de kalan zarflar için entegratörünüze başvurun; GİB, Aralık 2024’teki altyapı geçişinde sistem yanıtı gönderilmemiş 1220 zarflarının durumunun 1300 olarak güncelleneceğini duyurmuştu.

Uygulama yanıtı: KABUL, RED, İADE ve 8 gün

Durum kodu teknik teslimi anlatır; ticari anlaşmazlığı anlatmaz. Ticari fatura senaryosunda alıcının posta kutusu faturayı KABUL, RED ya da İADE etme hakkına sahiptir ve bunu uygulama yanıtıyla bildirir. GİB’in entegrasyon kılavuzuna göre uygulama yanıtı faturayı aldıktan sonra sekiz gün içinde gönderilmeli, sekiz günden sonra gönderilmesi ve birden fazla kez gönderilmesi engellenmelidir; gönderen taraf da sekiz günden sonra gelen yanıtı kabul etmemeli ve birden fazla yanıt gelirse ilkini esas almalıdır.

Temel fatura senaryosunda uygulama yanıtı yoktur. GİB’in portal kullanıcılarına yönelik dokümanı, 8 gün içinde kabul ya da red mesajı gönderilmeyen ticari faturaların kabul edilmiş sayılacağını hatırlatır. RED yanıtı gelen bir faturada sonraki adımlar e-Fatura iptali ve itiraz yazımızda.

Durum kodunu nereden görürsünüz, destek isterken ne verirsiniz?

GİB Portal kullanıyorsanız gönderdiğiniz faturaları “zarf bazında” ve “fatura bazında” listeleyebilirsiniz; GİB’in portal dokümanı, hata alan zarflar için zarf bazında listelemedeki hata ayrıntısına bakılmasını önerir. Entegratör kullanıyorsanız kod genellikle gönderim listesinde ya da fatura detayında görünür.

Sorunu çözemezseniz destek talebinde şu bilgileri yazılı verin; GİB’in portal dokümanı da aynı listeyi ister: göndericinin VKN ya da TCKN’si, alıcının VKN ya da TCKN’si, zarf numarası, fatura numarası ve ekranda gördüğünüz hata ayrıntısı. Bu bilgiler olmadan yapılan “fatura gitmedi” bildirimi çoğu zaman ikinci bir yazışma gerektirir.

Entegratör panelindeki “kuyrukta, işleniyor, başarılı, hata” ne demek?

Çoğu entegratör ve yazılım GİB kodlarını kendi kelimeleriyle gösterir. Genel olarak “kuyrukta” 1000’e, “işleniyor” 1100’e, “GİB’e iletildi” ya da “alıcıya gönderildi” 1200 ve 1220’ye, “tamamlandı” ya da “başarılı” 1300’e, “hata” ise 1110–1195 arası kodlara ya da 1210, 1215, 1230’a karşılık gelir. İfadeler entegratörden entegratöre değişir; şüphede kaldığınızda ekrandaki sayısal kodu bu tabloyla karşılaştırın.

Bu kodlar e-Fatura zarfları içindir. e-Arşiv fatura alıcıya GİB zarfıyla gönderilmez; e-Arşiv için gördüğünüz “gönderildi, raporlandı” gibi durumlar entegratörünüzün kendi ifadeleridir. e-Arşiv faturada uygulama yanıtı da yoktur; itiraz, Tebliğde sayılan yollarla yapılır.

TicariHub’da gönderim hatası ve tekrar deneme

TicariHub faturayı sizin bağladığınız entegratör hesabından gönderir ve 1163 türü mükerrer gönderimleri önlemek için iki önlem alır: bir faturanın ETTN’si ilk denemede üretilir ve tekrar denemelerde aynı kalır; yeniden göndermeden önce entegratöre belgenin oluşup oluşmadığı sorulur. Çift tıklama ya da zaman aşımı sonrası tekrar gelen istek ikinci bir fatura açmaz ve aynı siparişe ikinci fatura kesilmez.

Otomatik fatura açıksa art arda üç sistemik hatada otomatik kesim durur ve bildirim gider; hata alan faturalar fatura sağlık sayfasında listelenir. e-Fatura (ticari) belgesi uygulama içinden iptal edilmez; TicariHub bu durumda 8 gün içinde alıcı RED’i ya da GİB e-Fatura İptal/İtiraz Portalı yolunu gösterir.