GİB Durum Kodları
E-fatura ya da e-arşiv faturası gönderdiniz ve karşınıza sayısal bir kod çıktı. Ne anlama geliyor? Belgeyi yeniden mi göndermeniz gerekiyor, yoksa beklemek mi yeterli? GİB durum kodları, Gelir İdaresi Başkanlığı’nın (GİB) e-belge sistemine gönderilen zarflar için döndürdüğü yanıt kodlarıdır. Her kod, belgenizin o anki durumunu ve yapmanız gereken işlemi gösterir.
Bu rehberde tüm GİB durum kodlarını kategorilere ayırarak açıkladık: Kodun anlamı, bekleme mi gerekiyor yoksa harekete mi geçmeniz gerekiyor ve yeniden gönderim gerekiyorsa adım adım nasıl yapılacağı. Ayrıca yıldız (*) işaretli kodların neden özel dikkat gerektirdiğini de açıklıyoruz.
Kurumsoft Notu: Bu listede yer alan durum kodları GİB’in resmi e-Fatura uygulamasına aittir ve Logo Connect Cloud kullanıcıları için de geçerlidir. Sık karşılaştığınız bir hata kodunuz varsa Kurumsoft danışmanlarına danışabilirsiniz.
Bu rehber şunları kapsıyor:
1. Bekleme Kodları — İşlem Sürüyor
Bu kodlar geldiğinde herhangi bir işlem yapmanıza gerek yoktur. GİB sistemleri zarfı kuyruğa almış ya da işliyor demektir. Durum kodunun güncellenmesini bekleyin.
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| *1000 | Zarf Kuyruğa Eklendi | Durum kodunun güncellenmesini bekleyin. |
| *1100 | Zarf İşleniyor | Durum kodunun güncellenmesini bekleyin. |
2. Hata Kodları — Fatura Yeniden Gönderilmeli
Aşağıdaki kodlar geldiğinde fatura veya belgenin yeniden gönderilmesi gerekir. Yıldız (*) işaretli kodlarda aynı ETTN ile yeniden gönderim yapılamaz; yeni bir fatura oluşturulması gerekir. Yıldızsız kodlarda ise aynı ETTN ile yeniden gönderim mümkündür.
Zarf ve Dosya Hataları (1110–1145)
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| 1110 | ZIP Dosyası Değil | Faturalar yeniden gönderilmeli. |
| 1111 | Zarf ID Uzunluğu Geçersiz | Faturalar yeniden gönderilmeli. |
| 1120 | Zarf Arşivden Kopyalanamadı | Faturalar yeniden gönderilmeli. |
| 1130 | ZIP Açılamadı | Faturalar yeniden gönderilmeli. |
| 1131 | ZIP Bir Dosya İçermeli | Faturalar yeniden gönderilmeli. |
| 1132 | XML Dosyası Değil | Faturalar yeniden gönderilmeli. |
| 1133 | Zarf ID ve XML Dosyasının Adı Aynı Olmalı | Faturalar yeniden gönderilmeli. |
| 1140 | Döküman Ayrıştırılamadı | Faturalar yeniden gönderilmeli. |
| 1141 | Zarf ID Yok | Faturalar yeniden gönderilmeli. |
| 1142 | Zarf ID ve ZIP Dosyası Adı Aynı Olmalı | Faturalar yeniden gönderilmeli. |
| 1143 | Geçersiz Versiyon | Faturalar yeniden gönderilmeli. |
Şema ve Doğrulama Hataları (1150–1163)
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| 1150 | Schematron Kontrol Sonucu Hatalı | Faturalar yeniden gönderilmeli. (Belgedeki hata düzeltilmeli.) |
| 1160 | XML Şema Kontrolünden Geçemedi | Faturalar yeniden gönderilmeli. |
| 1161 | İmza Sahibi TCKN/VKN Alınamadı | Faturalar yeniden gönderilmeli. |
| 1162 | İmza Kaydedilemedi | Faturalar yeniden gönderilmeli. |
| 1163 | Gönderilen Zarf Sistemde Daha Önce Kayıtlı Olan Bir Fatura İçeriyor | Faturalar yeniden gönderilmeli. |
Yetki ve İmza Hataları (1170–1177)
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| 1170 | Yetki Kontrol Edilemedi | Faturalar yeniden gönderilmeli. |
| 1171 | Gönderici Birim Yetkisi Yok | Faturalar yeniden gönderilmeli. |
| 1172 | Posta Kutusu Yetkisi Yok | Faturalar yeniden gönderilmeli. |
| 1175 | İmza Yetkisi Kontrol Edilemedi | Faturalar yeniden gönderilmeli. |
| 1176 | İmza Sahibi Yetkisiz | Faturalar yeniden gönderilmeli. |
| 1177 | Geçersiz İmza | Faturalar yeniden gönderilmeli. (Zarftaki imza hatası düzeltilmeli.) |
Adres ve Kullanıcı Hataları (1180–1183)
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| 1180 | Adres Kontrol Edilemedi | Faturalar yeniden gönderilmeli. |
| 1181 | Adres Bulunamadı | Faturalar yeniden gönderilmeli. |
| 1182 | Kullanıcı Eklenemedi | Faturalar yeniden gönderilmeli. |
| 1183 | Kullanıcı Silinemedi | Faturalar yeniden gönderilmeli. |
Sistem Hataları (1190–1195)
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| 1190 | Sistem Yanıtı Hazırlanamadı | Faturalar yeniden gönderilmeli. |
| 1195 | Sistem Hatası | Faturalar yeniden gönderilmeli. (Belgede değişiklik yapılmadan yeniden gönderin.) |
3. Gönderim Sorunları (1210–1230)
Bu kodlar zarfın GİB sistemine ulaştıktan sonra hedefe iletiminde sorun yaşandığını gösterir.
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| *1210 | Döküman Bulunan Adrese Gönderilemedi | GİB’in yeniden gönderme denemesi sonlanmasını bekleyin. 1215 kodu gelirse faturalar yeniden gönderilmeli. |
| 1215 | Doküman Gönderimi Başarısız — Tekrar Gönderme Sonlandı | Faturalar yeniden gönderilmeli. |
| *1220 | Hedeften Sistem Yanıtı Gelmedi | 1230 kodu gelirse faturalar yeniden gönderilmeli. |
| 1230 | Hedeften Sistem Yanıtı Başarısız Geldi | Faturalar yeniden gönderilmeli. |
4. Başarılı İşlem Kodları
Bu kodlar geldiğinde belgeniz başarıyla işlenmiş ya da tamamlanmıştır. Herhangi bir işlem yapmanıza gerek yoktur.
| Kod | Açıklama | Yapılacak İşlem |
|---|---|---|
| 1200 | Zarf Başarıyla İşlendi | İşlem gerekmez. |
| *1300 | Başarıyla Tamamlandı | İşlem gerekmez. |
5. Yıldız (*) İşaretli Kodlar — Dikkat!
Durum kodu listesinde bazı kodların başında (*) işareti bulunur. Bu işaretin önemi şudur:
- Yıldız (*) varsa: İlgili durum kodu alındığında, satış faturasının aynı ETTN ile yeniden gönderimne izin verilmez. Zorunlu durumlarda yeni bir fatura oluşturup göndermeniz gerekir. (Bkz. Senaryo A)
- Yıldız (*) yoksa: Aynı ETTN ile yeniden gönderim mümkündür. (Bkz. Senaryo B)
1000 ve 1100 gibi bekleme kodlarındaki yıldız, “bu süreçte yeniden gönderme” uyarısı niteliğindedir. 1300 başarı kodundaki yıldız ise işlemin nihai olarak tamamlandığını ifade eder.
6. Yeniden Gönderim Adımları
Senaryo A — Yıldızlı (*) kodlarda yeniden gönderim (yeni ETTN ile)
- Connect > Diğer İşlemler > Arşiv bölümünden ilgili fatura paketlerini çıkartın.
- Ticari ürün tarafında ilgili faturayı çıkartın, yeni fatura oluşturun ve kaydedin.
- Kaydedilen yeni satış faturasını gönderin.
Senaryo B — Yıldızsız kodlarda yeniden gönderim (aynı ETTN ile)
- Connect > Çalışma Parametreleri > Döküman Parametreleri bölümüne girin. “Paketleri gruplayıp birleştir” seçeneğinin işaretli olduğundan emin olun.
- Connect > Diğer İşlemler > Arşiv bölümünden ilgili fatura paketlerini çıkartın.
- Hata belge veya zarftan kaynaklanıyorsa (örneğin: 1150 Schematron Hatası, 1177 Geçersiz İmza gibi) ilgili hatayı düzeltin. Hata bir sistem hatasıysa (örneğin 1195) belgede değişiklik yapmayın.
- Satış faturasını yeniden gönderin.