E-Fatura Durum Kodları Nedir, Ne Anlama Gelir?
E-fatura durum kodları, faturanın içine konduğu elektronik zarfın Gelir İdaresi Başkanlığı (GİB) sistemindeki işlem aşamasını gösteren dört haneli kodlardır. Kodların tamamı GİB'in "e-Fatura Uygulaması EK-2 Sistem Yanıtı Şema Yapısı" kılavuzunda tanımlanıyor ve 1000 ile 1300 arasında 37 ayrı zarf durum kodları yer alıyor. Başarılı bir gönderimde zincir 1000 - 1100 - 1200 - 1220 - 1300 şeklinde ilerliyor; arada oluşan aksaklıklar ise 1100 - 1200 bandındaki e-fatura hata kodları ile bildiriliyor. Kodun anlamını doğru okumak, faturanın nerede takıldığını saniyeler içinde tespit etmenizi ve mükerrer gönderim gibi maliyetli hataların önüne geçmenizi sağlıyor.
|
Bir Bakışta E-Fatura Durum Kodları ● Resmî dayanak: Kodlar GİB'in EK-2 Sistem Yanıtı Şema Yapısı kılavuzunda tanımlıdır; e-fatura durum kodları 2026 yılında da aynı yapıyla işlemektedir. ● Başarı zinciri: 1000 (zarf kuyruğa eklendi) - 1100 (zarf işleniyor) - 1200 (zarf başarıyla işlendi) - 1220 - 1300 (başarıyla tamamlandı). ● Hata bandı: 1100 ile 1200 arasındaki kodlar hatayı gösterir; bu durumda zarf bir sonraki aşamaya geçmez. ● 1210 mekaniği: Merkez birim, zarfı ikişer saat arayla dört kez, toplam sekiz saat içinde tekrar göndermeyi dener. ● Mükerrer gönderim riski: 1215 alınmadan aynı faturayı yeni bir zarfla göndermek 1163 hatasını doğurur. ● 1220 bir hata değildir: Bekleme durumudur; alıcıdan yanıt geldiğinde 1300 ya da 1230'a döner. ● Tekrar gönderim: 1215 ve 1230 sonrasında fatura aynı Fatura ID'siyle yeniden gönderilebilir. ● Kod ≠ ticari kabul: 1300, belgenin alıcı sistemine ulaştığını gösterir; kabul veya red ayrı bir belgeyle bildirilir. |
E-Fatura Durum Kodu Nedir?
E-fatura durum kodu, GİB Merkez biriminin gönderilen zarfa verdiği ve zarfın o andaki durumunu bildiren sayısal yanıttır. Kağıt faturanın zarfa konup postaya verilmesi gibi, e-faturalar da XML formatında hazırlanıp ZIP yapısındaki bir "zarf" içinde iletiliyor. Sistemde üç rol söz konusu: faturayı oluşturan Gönderici Birim, iletimi denetleyen Merkez ve belgeyi teslim alan Posta Kutusu.
Bu kodların işlevi üç başlıkta toplanıyor:
● Aşamayı gösterir. Belgenin gönderim zincirinin hangi adımında olduğunu bildirir.
● Hatanın kaynağını işaret eder. Format, şema, imza, yetki ya da adres kaynaklı sorunları ayrıştırır.
● Aksiyonu belirler. Beklenecek mi, düzeltilip yeniden gönderilecek mi sorusunu yanıtlar.
E-Fatura Durum Kodları Nasıl İlerler?
E-fatura durum kodları, zarfın GİB'e ulaşmasıyla başlayıp alıcı sisteme teslimiyle biten beş aşamalı bir zincirde ilerler: Kuyruğa alınma, işlenme, kontrollerin geçilmesi, yanıt bekleme ve tamamlanma. Her aşamada Merkez birim, gönderici tarafa yeni bir sistem yanıtı üretiyor.
● Gönderici Birim, faturayı zarfa koyup Merkez'e iletiyor; zarf kuyruğa alınıyor ve 1000 durum kodu oluşuyor.
● Sırası gelen zarf işleme giriyor, durum 1100 oluyor. Bu aşamada şema ve şematron kontrolleri yapılıyor.
● Kontrollerden sorunsuz geçen zarf 1200 durum kodu alıyor ve alıcının posta kutusuna gönderiliyor.
● Alıcıdan yanıt beklenirken durum 1220 olarak kalıyor.
● Alıcı sistemden 1200 yanıtı dönerse zarf 1300 koduna, farklı bir kod dönerse 1230 koduna geçiyor.
Not: İşlenme sırasındaki hatalara ait kodlar 1100 ile 1200 arasındadır. Bu bantta bir hata oluştuğunda zarf bir sonraki aşamaya geçmez; hata düzeltilmeden belge alıcıya ulaşmaz.
E-Fatura Durum Kodları ve Anlamları
E-fatura durum kodları ve anlamları, GİB'in resmî kılavuzunda beş grupta toplanıyor: Süreç ve başarı kodları, zarf ve format hataları, şema-şematron-imza hataları, yetki-adres-sistem hataları ile gönderim ve teslim kodları.
Süreç ve Başarı Kodları
|
Kod |
Anlamı |
Ne ifade eder? |
|
1000 |
Zarf Kuyruğa Eklendi |
Zarf GİB'e ulaştı, işlenmek üzere sıraya alındı |
|
1100 |
Zarf İşleniyor |
Şema ve şematron kontrolleri sürüyor |
|
1200 |
Zarf Başarıyla İşlendi |
Kontroller geçildi, belge alıcıya iletiliyor |
|
1300 |
Başarıyla Tamamlandı |
Zarf alıcı sistemine sorunsuz ulaştı |
Zarf ve Format Hata Kodları
|
Kod |
Anlamı |
|
1110 |
Zip Dosyası Değil |
|
1111 |
Zarf ID Uzunluğu Geçersiz |
|
1120 |
Zarf Arşivden Kopyalanamadı |
|
1130 |
Zip Açılamadı |
|
1131 |
Zip Bir Dosya İçermeli |
|
1132 |
XML Dosyası Değil |
|
1133 |
Zarf ID ve XML Dosyasının Adı Aynı Olmalı |
|
1140 |
Doküman Ayrıştırılamadı |
|
1141 |
Zarf ID Yok |
|
1142 |
Zarf ID ve Zip Dosyası Adı Aynı Olmalı |
|
1143 |
Geçersiz Versiyon |
Bu grupta en sık görülen kod, zarf kimliğinin 32 karakter olmaması nedeniyle oluşan 1111 zarf id uzunluğu geçersiz uyarısıdır.
Şema, Şematron ve İmza Hata Kodları
|
Kod |
Anlamı |
|
1150 |
Schematron Kontrol Sonucu Hatalı |
|
1160 |
XML Şema Kontrolünden Geçemedi |
|
1161 |
İmza Sahibi TCKN/VKN Alınamadı |
|
1162 |
İmza Kaydedilemedi |
|
1163 |
Gönderilen Zarf Sistemde Daha Önce Kayıtlı Olan Bir Faturayı İçermektedir |
|
1164 |
Gönderilen Zarf Sistemde Daha Önce Kayıtlı Olan Bir Belgeyi İçermektedir |
|
1175 |
İmza Yetkisi Kontrol Edilemedi |
|
1176 |
İmza Sahibi Yetkisiz |
|
1177 |
Geçersiz İmza |
Yetki, Adres ve Sistem Hata Kodları
|
Kod |
Anlamı |
|
1170 |
Yetki Kontrol Edilemedi |
|
1171 |
Gönderici Birim Yetkisi Yok |
|
1172 |
Posta Kutusu Yetkisi Yok |
|
1180 |
Adres Kontrol Edilemedi |
|
1181 |
Adres Bulunamadı |
|
1182 |
Kullanıcı Eklenemedi |
|
1183 |
Kullanıcı Silinemedi |
|
1190 |
Sistem Yanıtı Hazırlanamadı |
|
1195 |
Sistem Hatası |
1181 adres bulunamadı kodu genellikle alıcının etiketinin, VKN'sinin ya da TCKN'sinin değişmiş olduğuna işaret eder.
Gönderim ve Teslim Kodları
|
Kod |
Anlamı |
|
1210 |
Doküman Bulunan Adrese Gönderilemedi |
|
1215 |
Doküman Gönderimi Başarısız, Tekrar Gönderme Sonlandı |
|
1220 |
Hedeften Sistem Yanıtı Gelmedi |
|
1230 |
Hedeften Sistem Yanıtı Başarısız Geldi |
|
1235 |
Fatura İptal'e Konu Edildi |
En Sık Karşılaşılan E-Fatura Hata Kodları ve Çözümleri
Sahada en çok karşılaşılan GİB durum kodları 1150, 1163, 1210, 1215 ve 1220 olarak öne çıkıyor. Bu kodların bir kısmı belgenin şemaya uygun oluşturulmamasından, bir kısmı ise mükellefiyet ya da imza doğrulamasındaki uyuşmazlıktan kaynaklanıyor. Hangi grupta olduğunu bilmek çözüm süresini kısaltıyor; kimi hata faturanın yeniden düzenlenmesini gerektirirken kimi yalnızca alan düzeltmesiyle kapanıyor.
|
Kod |
Ne demek? |
Ne yapmalı? |
|
1150 hata kodu |
Fatura, GİB'in belirlediği kurallara uymuyor |
Şematron logundaki alanları düzeltip aynı ETTN ile yeniden gönderin |
|
1160 hata kodu |
XML, şema kontrolünden geçemedi |
Belgeyi UBL-TR şemasına uygun hale getirip tekrar gönderin |
|
1163 hata kodu |
Aynı fatura daha önce sisteme kaydedilmiş |
Tekrar göndermeyin; mevcut zarfın durumunu takip edin |
|
1195 hata kodu |
GİB tarafında geçici sistem sorunu |
Kısa bir bekleme sonrası aynı ETTN ile yeniden deneyin |
|
1210 durum kodu |
Zarf alıcı adrese iletilemedi |
Bekleyin; Merkez dört kez tekrar dener |
|
1215 hata kodu |
Dört denemenin ardından gönderim sonlandırıldı |
Faturayı aynı Fatura ID'siyle yeniden gönderin |
|
1220 durum kodu |
Alıcıdan yanıt henüz gelmedi |
Tekrar göndermeyin; 1300 ya da 1230'a dönmesini bekleyin |
|
1230 durum kodu |
Alıcı sistem zarfı başarısız işledi |
Aynı Fatura ID'siyle yeniden gönderin |
Kritik uyarı: 1210 kodunun alındığı andan itibaren Merkez birim, aynı zarfı ikişer saat arayla dört defa, toplam sekiz saat içinde tekrar göndermeyi dener. 1215 kodu düşmeden faturayı yeni bir zarfla göndermek, sistemin 1163 hata kodu vermesine yol açar.
E-Fatura Durum Sorgulama Nasıl Yapılır?
E-fatura durum sorgulama işlemi GİB Portal, özel entegratör paneli ya da web servis üzerinden yapılır. Entegrasyon kullanan mükellefler, gönderdikleri zarfın durumunu web servisin getApplicationResponse metodunu çağırarak da öğrenebilir.
● GİB Portal: "Gönderilen Faturalar" listesinde her belgenin yanında zarf durumu görünür.
● Entegratör paneli: Kod, fatura detay ekranına anlık olarak yansır; e-fatura zarf durumu sorgulama bu ekrandan yapılır.
● ETTN ile takip: e-fatura ettn sorgulama sayesinde belge, evrensel tekil numarası üzerinden geçmişe dönük olarak izlenir.
Durum Kodu ile Uygulama Yanıtı Arasındaki Fark Nedir?
Durum kodu belgenin teknik iletim aşamasını, e-fatura uygulama yanıtı ise faturanın ticari olarak kabul edilip edilmediğini gösterir. İkisi sık karıştırılsa da farklı süreçlere aittir.
|
Kriter |
Durum Kodu |
Uygulama Yanıtı |
|
Neyi bildirir? |
Zarfın sistemdeki işlem aşamasını |
Faturanın kabul, red ya da iade edildiğini |
|
Kim üretir? |
GİB Merkez birimi ve posta kutusu |
Faturayı alan mükellef |
|
Hangi senaryoda? |
Tüm senaryolarda |
Ticari fatura senaryosunda |
|
Süre |
Otomatik ve anlık |
Faturanın iletiminden itibaren 8 gün |
Temel fatura senaryosunda sistem içinden kabul ya da red yanıtı gönderilemez. Türk Ticaret Kanunu'nun 21/2 maddesi uyarınca, faturayı alan taraf sekiz gün içinde itiraz etmezse içeriği kabul etmiş sayılır.
Turkcell e-Şirket ile E-Fatura Süreçlerinizi Tek Panelden Yönetin
Durum kodlarını takip etmek, doğru altyapıyla birlikte rutin bir işe dönüşür. Turkcell e-Şirket'in bulut tabanlı e-Fatura çözümüyle gönderdiğiniz her belgenin durum kodunu anlık görebilir; e-Fatura, e-Arşiv Fatura, e-İrsaliye ve e-Defter süreçlerinizi tek kullanıcı adıyla tek panelden yönetebilirsiniz. Belgeleriniz GİB standartlarında üretilir, mevzuat değiştikçe sistem uyumu kendiliğinden sağlanır.
Ayrıntılı bilgi almak ve hemen başvurmak için Turkcellesirket.com adresini ziyaret edebilir ya da 0850 277 77 72 numaralı çağrı merkezinden bize ulaşabilirsiniz.
Sıkça Sorulan Sorular
E-Fatura Başarıyla Tamamlandı Ne Demek?
1300 durum kodu, zarfın alıcı sistemine sorunsuz ulaştığı ve gönderim sürecinin bittiği anlamına gelir. e-fatura başarıyla tamamlandı ne demek sorusunun yanıtı budur. Bu kod, alıcının faturayı ticari olarak kabul ettiğini göstermez.
E-Fatura 1220 Hata Kodu Ne Anlama Gelir?
1220 kodu, zarfın alıcıya iletildiğini ancak alıcı sistemden henüz yanıt gelmediğini bildirir. Kodun açık adı hedeften sistem yanıtı gelmedi şeklindedir. Bir hata değil, bekleme durumudur; faturayı tekrar göndermek yerine kodun 1300 ya da 1230'a dönmesini beklemek gerekir.
1215 Hata Kodu Alan Fatura Tekrar Gönderilir mi?
Evet. 1215 kodu düştükten sonra ilgili zarftaki faturalar aynı Fatura ID'siyle yeniden gönderilebilir. Portal kullanıcıları ise zarf listeleme ekranındaki tekrar gönder seçeneğini kullanır.
E-Fatura 1163 Hata Kodu Neden Alınır?
Bu kod, gönderilen zarfın sistemde daha önce kayıtlı bir faturayı içerdiğini bildirir. En yaygın nedeni, 1220 ya da 1300 durumundaki bir faturanın yeni bir zarfla ikinci kez gönderilmesidir.
Schematron Kontrol Sonucu Hatalı Ne Demek?
Schematron kontrol sonucu hatalı uyarısı, faturanın GİB'in belirlediği kural setine uymadığını gösterir ve 1150 koduyla bildirilir. Şematron logundaki alanlar düzeltildikten sonra belge aynı ETTN ile yeniden gönderilir.
1200 ile 1300 Durum Kodu Arasındaki Fark Nedir?
Zarf başarıyla işlendi anlamına gelen 1200, belgenin GİB kontrollerini geçtiğini gösterir. 1300 ise zarfın alıcı sistemine ulaştığını ve sürecin tamamlandığını bildirir. Yani 1200 ara aşama, 1300 nihai sonuçtur.
Hangi Durum Kodlarında Fatura Yeniden Gönderilmelidir?
1215 ve 1230 kodlarında fatura aynı Fatura ID'siyle yeniden gönderilir. Format, şema ve imza hatalarında ise belge düzeltilip tekrar iletilir. Buna karşılık 1163, 1220 ve 1300 kodlarında yeniden gönderim yapılmaz.
E-Arşiv ve E-İrsaliyede Aynı Kodlar Kullanılır mı?
e-İrsaliye, e-Fatura ile aynı zarf altyapısını kullandığından e-irsaliye durum kodları bu listeyle aynıdır. e-Arşiv Fatura ise zarf yerine rapor yapısıyla çalışır; bu nedenle e-arşiv durum kodları farklı bir mantığa, GİB'e gönderilen günlük rapor sürecine dayanır.
Bu içerik genel bilgilendirme amaçlıdır. Kod tanımları GİB'in e-Fatura Uygulaması Sistem Yanıtı Şema Yapısı kılavuzuna dayanmaktadır; güncel teknik kılavuzlar için ebelge.gib.gov.tr adresini takip etmeniz önerilir.