GİB e-Fatura Durum Kodları: Detaylı Rehber
E-fatura gönderimi sırasında Gelir İdaresi Başkanlığı (GİB) tarafından iletilen durum kodları, faturanın başarıyla iletilip iletilmediğini veya işlem sırasında bir hata olup olmadığını gösteren kritik bilgilerdir. Muhasebeciler, KOBİ’ler ve yazılım geliştiriciler için bu kodların anlamlarını bilmek, e-fatura sürecini doğru takip etmek için önemlidir. Bu rehberde, GİB e-fatura durum kodlarının ne olduğunu, nasıl çalıştığını ve yaygın kodların anlamlarını ele alacağız.
e-fatura durum kodları nedir?
E-fatura durum kodları, elektronik faturanın GİB sistemine iletilmesiyle birlikte oluşan ve faturanın işlem durumunu gösteren sayısal kodlardır. Bir e-faturayı GİB portalı üzerinden veya özel entegratör aracılığıyla gönderdiğinizde, sistem tarafından her aşamada bir durum kodu üretilir. GİB’in tanımladığı toplam 36 farklı e-fatura durum kodu bulunmaktadır. Bu kodlar, faturanın sorunsuz gönderilip gönderilmediğini ya da bir hatayla karşılaşılıp karşılaşılmadığını hızlıca anlamanızı sağlar.
Durum kodları ne anlama gelir?
Her durum kodu, e-fatura sürecinin belirli bir aşamasını veya sonucunu temsil eder. Örneğin, bazı kodlar fatura gönderiminin normal seyrinde ilerlediğini, bazıları ise bir hata oluştuğunu belirtir. Genel olarak:
-
1000 ve 1100 serisi kodlar, faturanın GİB sistemine ulaştığını ve işlenmekte olduğunu gösteren kodlardır (örn. 1000: Zarf kuyruğa eklendi, 1100: Zarf işleniyor).
-
1200 ve sonrası kodlar ise gönderim ve teslimat sonuçlarına dair kodlardır. Bu aralıkta, faturanın başarılı şekilde iletildiğini veya alıcı tarafında yaşanan sorunları belirten kodlar bulunur (örn. 1200 başarı, 1300 teslim edildi).
Durum kodları sayesinde bir e-faturanın hangi aşamada olduğunu ve sonraki adımda ne yapılması gerektiğini anlayabiliriz. Kodun anlamını bilmek, e-faturanızın durumunu doğru yorumlayarak gerektiğinde müdahale etmenizi sağlar.
GİB durum kodları nasıl çalışır?
E-fatura gönderildiğinde GİB sistemi faturayı bir zarf içinde alır ve işlemeye başlar. 1000 kodu (kuyruğa eklendi) verilir ve teknik kontroller başlar. GİB bu aşamada zarfın formatını, ID bilgilerini, fatura XML’inin doğruluğunu ve e-imza/yetki geçerliliğini kontrol eder. Eğer herhangi bir kontrolde sorun çıkarsa, ilgili hata kodu üretilir ve işlem durur (örn. format hatasında 1110, şema uyumsuzluğunda 1160 kodu).
Kontrollerden başarıyla geçildiğinde GİB 1200 kodunu atar ve faturayı alıcının posta kutusuna iletmeye çalışır. Alıcı sistem sorunsuzsa kısa sürede 1300 kodu (başarılı) oluşturulur. Eğer alıcı tarafında bir sorun varsa GİB 1210 kodunu üretir ve faturayı toplam 5 kez (ilk gönderim + 4 tekrar) göndermeyi dener. Yine başarısız olursa 1215 kodu (gönderim sonlandırıldı) atanır. Fatura alıcıya ulaştıktan sonra alıcının sistem yanıtı beklenir; bu bekleme sürecinde durum 1220 kodunda kalabilir. Alıcıdan olumlu yanıt gelirse kod 1300’e, olumsuz yanıt gelirse 1230’a güncellenir.
GİB durum kodları, faturanın gönderimden teslimine kadar her adımı otomatik olarak kaydeder. Kodlar GİB tarafından belirlenip gönderici sisteme iletilir ve portalda veya entegratör yazılımında görüntülenebilir.
E-fatura durum kodları nasıl alınır?
E-fatura durum kodlarını görüntülemek için kullandığınız sistemin arayüzünü kullanabilirsiniz. GİB Portalı üzerinden gönderilen faturalarda, “Gönderilen Faturalar” listesinde her bir faturanın yanında durum kodu veya bir zarf simgesi yer alır. Özel entegratör yazılımlarında da benzer şekilde, fatura listelerinde veya fatura detay ekranlarında durum kodu otomatik olarak gösterilir. Entegratör sistemleri GİB ile entegre olduğundan kodları anlık olarak alır; kullanıcılar panel üzerinden faturalarının durumunu gerçek zamanlı takip edebilir.
E-fatura durum kodları ve anlamları
GİB, e-fatura süreçlerinde karşılaşılabilecek her durum için özel kodlar ve açıklamalar tanımlamıştır. Aşağıda, e-fatura durum kodlarının tam listesi ve anlamlarını içeren detaylı bir tablo yer alacaktır:
| GİB DURUM KODU | KOD ADI | AÇIKLAMA | SEBEBİ | ÇÖZÜMÜ | YAPILMASI GEREKENLER |
| 1000 | ZARF KUYRUĞA EKLENDİ | Gönderici birim, içinde FATURA bulunan bir zarf hazırlar ve Merkez Birim’e (GİB) iletir. Bu zarf, Merkez Birim tarafından kuyruğa alınır ve durumu “ZARF KUYRUĞA EKLENDİ” olarak güncellenir |
GİB’teki yoğunluk
|
Durum kodunun güncellenmesi
beklenmelidir
|
|
| 1100 |
ZARF İŞLENİYOR
|
Merkez Birimde kuyruğa alınan zarf, sırası geldiğinde işleme alınır ve zarfın durumu “ZARF İŞLENİYOR” olarak güncellenir. “1000” ve “1100” statülerindeki zarf GİB’e iletilmiştir. Bu aşamalarda Gönderici Birim, Merkez’den durum sorgulaması yapar; yanıt olarak bu iki durum kodundan biri dönerse, faturanın ERP statüsü “GİB’e gönderildi” olur. |
GİB’teki yoğunluk
|
Durum kodunun güncellenmesi
|
|
| 1110 |
ZIP DOSYASI DEĞİL
|
NOT: Zarf gönderim sürecinde çeşitli işlemler ile şema ve schematron kontrollerinden geçer. Gönderilen zarf, GİB’in belirlediği standartlara uymadığı için hata alınırsa, ilgili durum kodları kaydedilir. Faturanın yer aldığı zarf, GİB’de işlenirken bu hata kodlarından biri alınırsa, faturanın statüsü “GİB’de işlenemedi” olarak güncellenir ve süreç burada sonlandırılır | Zarfın formatı “.ZIP” değilse hata meydana gelir. |
Gönderilen zarf formatı “.ZIP” olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.)
|
| 1111 |
ZARF ID UZUNLUĞU GEÇERSİZ
|
NOT: Zarf gönderim sürecinde çeşitli işlemler ile şema ve schematron kontrollerinden geçer. Gönderilen zarf, GİB’in belirlediği standartlara uymadığı için hata alınırsa ilgili durum kodları kaydedilir. Faturanın yer aldığı zarf GİB’de işlenirken bu hata kodlarından biri alınırsa, faturanın statüsü “GİB’de işlenemedi” olarak güncellenir. Süreç bu noktada sonlanır ve işlem alıcıya iletilmeden burada durur. |
ZARF ID uzunluğu 32 karakterden farklıysa ilgili hata alınır.
|
ZARF ID uzunluğu 32 karakter olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1120 |
ZARF ARŞİVDEN KOPYALANAMADI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1130 |
ZIP AÇILAMADI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Zarf okunamadığı durumlarda ilgili hata alınır.
|
GİB sisteminde geçici bir aksaklık yaşanıyor olabilir ya da zarf dosyasında bir hata bulunabilir. Dosya içeriği kontrol edilmelidir; aksi takdirde hata mevcutsa, ilgili faturalar yeni bir zarf oluşturularak tekrar gönderilmelidir. |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1131 |
ZIP BİR DOSYA İÇERMELİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Zarf içerisinde dosya bulunmadığında ilgili hata alınır.
|
Zarf içerisinde dosya (Fatura, uygulama yanıtı,sistem yanıtı) olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1132 |
XML DOSYASI DEĞİL
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
(Fatura ,U&S Yanıtı), .XML formatında değilse sistem tarafından ilgili hata üretilir.
|
(Fatura &US Yanıtı) .XML formatında olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1133 |
ZARF ID VE XML DOSYASININ ADI
AYNI OLMALI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | ZARF ID (sh:DocumentIdentification) ile XML dosya adı (xxxxxxxx.xml) aynı karakter dizisini içermiyorsa, ilgili hata alınır |
ZARF ID (<sh:DocumentIdentification>) ile XML ID(xxxxxxxx.xml) aynı karakter dizinine sahip olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1140 |
DOKUMAN AYRIŞTIRILAMADI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Zarf içindeki faturalar doğru şekilde ayrıştırılamadığında, ilgili hata alınır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | |
| 1141 |
ZARF ID YOK
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Zarf ID alanı boş ise ilgili hata alınır.
|
Zarf ID alanı boş olmamalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1142 |
ZARF ID VE ZIP DOSYASI ADI AYNI
OLM
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Zarf ID ve ZIP dosyası adı aynı değil ise ilgili hata alınır.
|
Zarf ID ve ZIP dosyası adı aynı olmalıdır. Faturalar yeniden gönderilmeli.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1143 |
GEÇERSİZ VERSİYON
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1150 |
SCHEMATRON KONTROL SONUCU
HATA
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
GİB tarafından belirlenen standartlara uygun olması gereken bilgiler hatalı girildiğinde, ilgili hata alınır.
|
Bilgiler gözden geçirilerek, GİB’in belirlediği standartlara uygun şekilde düzeltilmelidir. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1160 |
XML SEMA KONTROLÜNDEN
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | GİB şema kontrollerinden geçebilen bir faturanın alıcının sisteminde de XML kontrollerinden geçebilmesi gerekir. Alıcıyı uyarınız |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | |
| 1161 |
İMZA SAHİBİ TCKN/VKN ALINAMADI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1162 |
İMZA KAYDEDİLEMEDİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Hatasız gönderim için gönderim öncesi “imza doğrulama” kontrolü yapılmalıdır. |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | |
| 1163 |
GÖNDERİLEN ZARF SİSTEMDE DAHA
ÖNCE KAYITLI OLAN BİR FATURAYI
İÇERMEKTEDİR
|
Merkez birim, zarfı posta kutusuna gönderir. Gönderim başarılı ise, sistem yanıtı gelene kadar zarfın merkezdeki durum kodu 1220 “HEDEFTEN SİSTEM YANITI GELMEDİ” olarak kalır. Bu zarftaki faturaların herhangi biri yeni bir zarf ile tekrar gönderilirse, yeni gönderilen zarf 1163 “GÖNDERİLEN ZARF SİSTEMDE DAHA ÖNCE KAYITLI OLAN BİR FATURAYI İÇERMEKTEDİR” durum kodunu içeren sistem yanıtını alacaktır. NOT: 1300 durum kodu almış zarflar da tekrar gönderildiğinde aynı hata alınır. |
Merkez birim, zarfı posta kutusuna iletir. Gönderim başarılıysa, kutudan sistem yanıtı alınana kadar zarfın Merkez’deki durum kodu 1220 “HEDEFTEN SİSTEM YANITI GELMEDİ” olarak kalır. Bu zarftaki faturaların herhangi biri yeni bir zarf ile tekrar gönderilirse, yeni gönderilen zarf 1163 “GÖNDERİLEN ZARF SISTEMDE DAHA ÖNCE KAYITLI OLAN BİR FATURAYI İÇERMEKTEDİR” durum kodunu içeren sistem yanıtını alacaktır. | 1163 “GÖNDERİLEN ZARF SİSTEMDE FATURAYI DAHA ÖNCE KAYITLI OLAN BİR İÇERMEKTEDİR” durumu, aynı fatura numarası veya ETTN numarasıyla daha önce gönderim (yükleme) yapılmışsa ortaya çıkar; yani farkında olmadan aynı fatura veya ETTN numarası ile ikinci kez gönderim yapmaya çalışıyor olabilirsiniz |
Faturalar yeniden gönderilmemeli
|
| 1170 |
YETKİ KONTROL EDİLEMEDİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1171 |
GÖNDERİCİ BİRİM YETKİSİ YOK
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Gönderici birim etiketinde “GB” yerine “PK” tanımlanmış olabilir.
|
Gönderici birin etiketinde “GB” tanımlı olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1172 |
POSTA KUTUSU YETKİSİ YOK
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Posta kutusu etiketinde “PK” yerinde “GB” tanımlanmış olabilir.
|
Posta kutusu etiketinde “PK” tanımlı
olmalıdır.
|
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1175 |
İMZA YETKİSİ KONTROL EDİLEMEDİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
“İmza yetkisi kontrol edilemedi” yanıtı, imzanın yetersiz olduğu anlamına gelmez; bu hata, müşterinin ek kontrol talep ettiği durumlarda ortaya çıkar. |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | |
| 1176 |
İMZA SAHİBİ YETKİSİZ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1177 |
İMZA SAHİBİ YETKİSİZ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
İmza doğrulama geçersizdir.
|
İmza doğrulaması geçersizdir. Hatasız gönderim sağlamak için, gönderim öncesinde “imza doğrulama” kontrolü yapılmalıdır. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1180 |
ADRES KONTROL EDİLEMEDİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1181 |
ADRES BULUNAMADI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. |
Etiket bilgisi ve VKN eşleşmesi yapılamıyor.
|
Alıcının VKN/TCKN ve etiket bilgilerinin güncel olduğundan emin olunuz (etiket veya yöntem değişikliği olabilir). Göndericinin VKN/TCKN ve etiket bilgilerinin de güncel olduğunu doğrulayınız (etiket veya yöntem değişikliği yapılmış olabilir). |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) |
| 1182 |
KULLANICI EKLENEMEDİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1183 |
KULLANICI SİLİNEMEDİ
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1190 |
SİSTEM YANITI HAZIRLANAMADI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1195 |
SİSTEM HATASI
|
NOT: Zarf gönderim sürecinde çeşitli işlemlerden geçer ve şema ile schematron kontrollerine tabi tutulur. Eğer gönderilen zarf, GİB’in belirlediği standartlara uygun değilse, sistem tarafından ilgili durum kodları üretilir. Faturanın yer aldığı zarfın GİB’de işlenmesi sırasında bu hata kodlarından biri alınırsa, faturanın durumu “GİB’de işlenemedi” olarak güncellenir. Bu durumda süreç sonlandırılır ve işlem alıcı tarafa iletilmeden bu aşamada durur. | Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1200 |
ZARF BAŞARIYLA İŞLENDİ
|
Zarf işlenmiş, kontrollerden geçmiş ve merkez sistemde bir hata almamışsa zarfın durumu “ZARF BAŞARIYLA İŞLENDİ” olmaktadır.Bu aşamada, zarfın durumu sistem yanıtı ile Gönderici Birime iletilir. GİB’den 1200 durum kodu “Zarf Başarıyla İşlendi” mesajı alındığında, ERP statüsü “GİB’de işlendi – Alıcıya gönderilecek” olarak güncellenir. Aynı statü kodu alıcı tarafından gönderildiğinde ise, bu zarfın alıcı tarafında başarıyla işlendiği anlamına gelir. |
|||
| 1210 |
DOKUMAN BULUNAN ADRESE
|
yapılmaktadır
ChatGPT:Zarf merkezde işlendikten sonra alıcıya gönderilir. Gönderim sırasında herhangi bir sorun oluşur ve zarf gönderimi başarısız olursa, göndericiye 1210 durum kodu ile bildirim yapılır. Merkez birim, zarfı toplamda dört kez göndermeyi dener; ilk gönderim, göndericinin ilettiği ve GİB’den geçerek alıcıya iletildiği zamandır. 1210 durumu alındığında, GİB aynı zarfı üç kez daha göndermeyi dener. Bu üç deneme, saat 06:00 ile 18:00 arasında sırasıyla gerçekleştirilir. |
GİB’in tekrar gönderim denemesi başarılı olursa, 1300 “BAŞARIYLA TAMAMLANDI” durum kodu alınır. Eğer denemeler sonunda gönderim başarısız kalırsa ve 1215 süresi sona ererse, “DOKÜMAN GÖNDERİMİ BAŞARISIZ, TEKRAR GÖNDERME SONLANDI” durum kodu alınır. |
1210 durumunun 1215, 1220, 1230 ya da
1300 durumuna dönmesi beklenmelidir
|
|
| 1215 |
DOKÜMAN GÖNDERİMİ BAŞARISIZ.
TEKRAR
GÖNDERME SONLANDI
|
Gönderim sırasında bir hata oluşursa, 1210 durum kodu alındığı andan itibaren Merkez birim aynı zarfı dört kez, her seferinde iki saat ara ile ve toplamda sekiz saat içinde tekrar göndermeyi dener. Son denemede (dördüncü deneme) zarf hala başarıyla iletilemezse, zarfın durumu 1215 “DOKÜMAN GÖNDERİMİ BAŞARISIZ. TEKRAR GÖNDERME SONLANDI” durum kodunu alır. 1215 durum kodu alındıktan sonra, ilgili zarftaki faturalar aynı Fatura ID’si ile yeniden gönderilebilir. |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1220 |
HEDEFTEN SİSTEM YANITI GELMEDİ
|
Zarf merkezde işlendikten sonra alıcıya gönderilir. Gönderim başarılı ise, alıcıdan merkeze sistem yanıtı gelene kadar zarfın merkezdeki durumu 1220 “HEDEFTEN SİSTEM YANITI GELMEDİ” olarak kalır ve buna bağlı olarak faturanın ERP statüsü “Alıcıya gönderildi” olmaktadır. | 1220 “HEDEFTEN SISTEM YANITI GELMEDI” durum kodunda alıcı zarfı sistemine aldığını GİB’e bildirmiş ancak zarfı sorunsuzca işleyip işleyemediğine dair olumlu ya da olumsuz bir yanıt dönmemiştir. |
Bu durumda GİB yanıt dönmeyen mükelleflere otomatik uyarı maili atar.Bu durumdaki zarfların içindeki faturaların tekrar gönderilmesi mükerrer gönderim olacağından, ikinci kez gönderilmemelidir. |
1220 durumunun beklenmelidir.
1230 ve ya 1300 durumuna dönmesi
NOT 1: İki gün içerisinde durum kodu
güncellenmez ise; bu konuda alıcı ile
iletişime geçilebilir.
NOT 2: Gönderici ve alıcı taraf da ilgili faturayı muhasebe
kayıtlarına geçirebilir.
|
| 1230 |
HEDEFTEN SİSTEM YANITI BAŞARISIZ
GELDİ
Z
|
Zarfın başarısız işlendiğine dair bir kod alınması durumunda, merkezde 1220 durum koduyla bekleyen zarfın yeni durumu 1230 “HEDEFTEN SİSTEM YANITI BAŞARISIZ GELDİ” olur.1230 durum kodu aynı Fatura ID’si ile tekrar alındıktan sonra, ilgili zarftaki faturalar yeniden gönderilebilir. Bu nedenle fatura iptal süreçleri başlatılmaz. Gönderici birim merkeze sorgu gönderdiğinde faturanın ERP statüsü “Alıcıda işlenemedi” olarak güncellenir. |
Faturalar yeniden gönderilmeli (Faturanın aynı ETTN ile tekrar gönderimine izin verilir.) | ||
| 1300 |
BAŞARIYLA TAMAMLAND
|
Hedeften 1200 “ZARF BAŞARIYLA İŞLENDİ” sistem yanıtı geldiğinde, merkezde 1220 durum koduyla bekleyen zarfın yeni durumu 1300 “BAŞARIYLA TAMAMLANDI” olur. Buna göre gönderici birim, merkeze sorgu gönderdiğinde faturanın ERP statüsü “Alıcıda işlendi” olarak güncellenir. |
Diğer kodlara ait liste için https://developer.nilvera.com/kod-listeleri adresini ziyaret edebilirsiniz.
1200 durum kodu nedir?
1200 durum kodu, zarfın GİB tarafından başarıyla işlendiğini ve teknik açıdan bir sorun olmadığını gösterir. Fatura gönderiminde tüm dosya ve içerik kontrolleri sorunsuz geçerse ve GİB faturayı alırsa 1200 kodu atanır. Bu kod, faturanızın GİB tarafında kabul edildiğini ifade eder. Ancak 1200, teslimatın tamamlandığı anlamına gelmez; faturanın alıcıya iletilmesi ve alıcıdan yanıt gelmesi süreci devam etmektedir.
1210 durum kodunun anlamı nedir?
1210 durum kodu, “Belge alıcıya iletilemedi” hatasını ifade eder. Yani faturanız, GİB tarafından alıcı posta kutusuna gönderilirken ilk denemede başarısız olmuştur. Bu durumda GİB sistemi otomatik olarak yeniden gönderim denemeleri yapar (toplam 5 deneme). 1210 kodu genellikle kısa süre içinde değişir:
-
Eğer nihayetinde teslimat başarılı olursa kod 1300 olarak güncellenir.
-
Tüm denemeler başarısız olursa kod 1215 değerine döner (gönderim başarısız oldu) ve faturanın tekrar gönderilmesi gerekir.
-
Alıcıya ulaşır ancak alıcı sisteminden hemen yanıt alınamazsa kod 1220 olarak kalır (yanıt bekleniyor).
1210 kodu geçici bir hata durumudur ve sistemin kendi kendine çözmeye çalıştığı bir aşamayı gösterir. Bu kodla karşılaştığınızda, GİB’in yapacağı güncellemeyi beklemeli ve hemen manuel müdahalede bulunmamalısınız.
1220 durum kodu neyi ifade eder?
1220 durum kodu, “Hedeften sistem yanıtı gelmedi” anlamına gelir. Bu kod, faturanın alıcıya başarıyla ulaştığını ancak alıcı sisteminden GİB’e henüz bir yanıt dönmediğini gösterir. Bir başka deyişle, fatura alıcının kutusundadır fakat alıcı taraf henüz “kabul” veya “red” bilgisini iletmemiştir.
1220 kalıcı bir kod değildir; geçici bir bekleme durumunu ifade eder. Bu kod, çoğunlukla kısa süre içinde 1300 (alıcı onayladı) veya 1230 (alıcı sistemde hata/ret) koduna güncellenir. GİB, 1220 kodunun en fazla 48 saat bu şekilde kalmasını öngörür; iki gün içinde durum değişmezse alıcıyla iletişime geçerek sorunun araştırılması tavsiye edilir. Bu süre dolmadan 1220 kodunu gördüğünüzde, hemen faturayı tekrar göndermeye kalkışmayın. Çoğu durumda alıcı sistem yanıtı geldiğinde kod otomatik olarak güncellenecektir.
1230 ve 1300 durum kodları hakkında bilgi
1230 ve 1300 kodları, e-fatura sürecinin alıcı tarafındaki nihai sonucunu gösterir:
-
1230 kodu, alıcı tarafın faturaya ilişkin olumsuz bir sistem yanıtı verdiğini gösterir. Bu, alıcının sisteminde faturayı işleyemediği veya alıcı tarafından reddedildiği anlamına gelebilir. 1230 kodu alındığında, gerekli düzeltmeler yapıldıktan sonra faturanın yeniden gönderilmesi gerekir.
-
1300 kodu, faturanın başarıyla alıcıya ulaştığını ve sürecin sorunsuz tamamlandığını belirtir. 1300 kodunu gördüğünüzde, e-faturanız alıcı tarafından teslim alınmış ve işlem tamamlanmıştır; artık ek bir işlem yapmanıza gerek yoktur.
E-fatura gönderiminde sık karşılaşılan hata kodları
Hata alınan durum kodları nelerdir?
E-fatura gönderirken karşılaşılabilecek bazı hata kodlarına örnek verelim: 1110 kodu “ZIP dosyası değil” anlamına gelir ve zarfın formatıyla ilgili sorunu gösterir. 1160 kodu “XML şema kontrolünden geçemedi” olup fatura verisinin standartlara uymadığını belirtir. 1210 kodu, faturanın alıcıya iletilemediğini (GİB sisteminin tekrar denediğini) ifade eder. 1230 kodu ise alıcı tarafın faturayı sistemsel olarak işleyemediğini (hata veya ret) gösterir. Bu kodlarla karşılaştığınızda, sorunu tespit edip düzeltmeli ve faturayı yeniden göndermelisiniz.
Fatura belgesi olan zarfın durumu nasıl kontrol edilir?
Gönderdiğiniz bir e-faturanın durumunu, onun bulunduğu zarfın durumu üzerinden takip edebilirsiniz. Bunu kontrol etmenin yolları şunlardır:
-
GİB Portalı Üzerinden: e-Fatura Portalı’nda “Gönderilen Faturalar” bölümünde, ilgili faturanın satırında durumunu gösteren bir ibare veya zarf simgesi bulunur. Bu simgeye tıklayarak zarfa ait güncel durum kodunu ve açıklamasını görebilirsiniz. Örneğin, zarfın hâlâ GİB’de işlenmekte olduğunu veya alıcıya ulaştığını bu şekilde öğrenebilirsiniz.
-
Entegratör Yazılımı Üzerinden: Özel entegratör kullanıyorsanız, ilgili fatura kaydının detaylarında veya listede “Durum” alanında zarf durumunu görebilirsiniz. Entegratör sistemleri GİB’den aldığı kodu anlık olarak yansıtır; faturanın durumunu panelinizden gerçek zamanlı takip edebilirsiniz.
Durum kodu güncellenmezse ne yapılmalı?
Bazen bir e-faturanın durum kodu beklenenden uzun süre aynı kalabilir. Örneğin, fatura gönderildikten sonra kodun 1220 olarak kalıp uzun süre 1300’e geçmemesi (yani alıcıdan yanıt gelmemesi) durumunda aşağıdaki adımları izleyin:
-
Bir süre bekleyin: Özellikle 1220 kodunda, GİB en fazla 2 güne kadar beklemenizi önermektedir. Hemen aynı faturayı tekrar göndermeyin; süreç otomatik olarak ilerleyebilir.
-
İletişim ve kontrol: Süreç uzuyorsa alıcıya faturanın ulaşıp ulaşmadığını sorun, gerekirse entegratör firmanızdan destek isteyerek durumu kontrol ettirin.
-
Tekrar gönderimi değerlendirin: Eğer kod 1215 gibi sonlandırıcı bir hata kodunda kaldıysa (yani GİB artık bu faturayı iletmeyi denemeyi bıraktıysa), faturayı aynı bilgilerle yeniden göndermeniz gerekebilir. Bu noktada kodların başındaki “” işaretine dikkat edin: Başında * işareti olan kodlar (ör. 1210, 1220*) sürecin devam ettiğini gösterir ve bu durumda aynı ETTN ile yeniden gönderim yapılmamalıdır; * işareti olmayan hata kodlarında (ör. 1215, 1230) ise tekrar gönderim mümkündür.
GİB tarafından sağlanan durum kodları
GİB tarafından tanımlanan durum kodları listesi, e-fatura sürecinde karşılaşılabilecek hemen her senaryoyu kapsar. Bu kodların sistemde nasıl kullanıldığı ve gerektiğinde nasıl güncellendiği konusunda bazı önemli noktalar şöyle:
GİB durum kodları nasıl güncellenir?
E-fatura durum kodları, GİB’in merkezi sistemi tarafından otomatik olarak güncellenir. Kullanıcılar kodları elle değiştiremez; süreç ilerledikçe GİB yeni durumu sisteme yansıtır ve gönderici tarafa iletir. GİB, faturayı her işleyişinde durum kodunu belirler ve anında gönderici sisteme iletir. Entegratör yazılımları kod değişikliklerini otomatik olarak alır veya sık aralıklarla sorgular; portal kullanıcıları da sayfayı yenileyerek güncel kodu görebilir.
Merkez birimde bekleyen zarfın durumu nasıl kontrol edilir?
“Merkez birimde bekliyor” durumu, fatura zarfının henüz alıcıya ulaşmadığı ve GİB sisteminde beklediği anlamına gelir. Bu durumda yapabileceğiniz tek şey beklemektir; genellikle kısa süre içinde zarf ya alıcıya ulaşıp 1300 koduna döner ya da başarısız olup bir hata koduna dönüşür.
GİB sistem yanıtı ne zaman gelir?
GİB’in e-fatura için verdiği durum kodlarının oluşma süresi, işlemin aşamalarına göre değişir. İlk kodlar (1000, 1100, 1200) genellikle gönderimle eş zamanlı veya dakikalar içinde oluşur. Teslimat ve yanıt kodları (1210, 1220, 1230, 1300) ise alıcı tarafın durumuna bağlı olarak biraz daha uzun sürede gelebilir. Çoğunlukla aynı gün içinde, hatta birkaç dakika veya saat içinde 1300 kodu görülür. Alıcı sisteminde aksaklık varsa nihai kodun alınması birkaç saat, en fazla bir gün uzayabilir.
E-fatura uygulamasında durum kodlarının önemi
E-fatura durum kodları, elektronik fatura uygulamasında gönderilen her faturanın takibini mümkün kılan temel araçlardır. Bu kodlar sayesinde dijital ortamda iletilen bir faturanın akıbetini anlık olarak öğrenebilir ve gerekiyorsa müdahale edebilirsiniz.
Durum kodları neden önemlidir?
-
Yasal kanıt ve uyum: 1300 kodu, faturanın alıcı tarafından alındığının resmi bir kanıtıdır ve olası uyuşmazlıklarda objektif bir kayıt görevi görür. Hata kodlarının takibi ise faturaların gerçekten alıcıya ulaştığını doğrulayarak mevzuata uyum sağlamanıza yardımcı olur.
-
Hızlı müdahale olanağı sağlar: Bir hata kodu (örneğin 1215 veya 1230) alındığında bunu erken fark etmek, sorunu derhal düzeltip faturayı yeniden göndermenizi sağlar. Durum kodlarını düzenli izleyerek, faturanın iletilmediği durumları zamanında tespit edip gerekli aksiyonları alabilirsiniz.
E-fatura sisteminde durum kodları nasıl takip edilir?
E-fatura durum kodlarını sağlıklı takip edebilmek için gönderdiğiniz faturaların durumlarını düzenli aralıklarla kontrol etmelisiniz. Henüz 1300 kodu almamış (örneğin 1220 kodunda bekleyen) faturaları belirleyerek zamanında aksiyon alın. Ayrıca birçok entegratör yazılımı, hata kodu alan veya durumu uzun süre güncellenmeyen faturaları filtreleyip uyarı vermektedir. Bu özelliklerden yararlanarak olası sorunları hızlıca fark edebilirsiniz.
Durum kodlarının fatura sürecine etkisi nedir?
Her bir durum kodu, ilgili e-faturanın sürecini doğrudan etkiler. 1300 kodu alınmadıkça fatura alıcıya resmi olarak ulaşmış sayılmaz; dolayısıyla 1300 kodu olmayan (örneğin hata kodunda kalan) bir faturada tahsilat veya yasal süreler başlamaz. Ayrıca herhangi bir hata kodu belirdiğinde, o faturanın süreci sizin müdahaleniz olmadan ilerlemez. Faturayı düzeltip yeniden göndermedikçe veya alıcıyla sorunu çözmedikçe süreç tamamlanmayacaktır.
