GİB durum kodları nasıl okunmalı?
GİB durum kodu, e-Fatura zarfının kuyruğa alınmasından alıcı sistemde tamamlanmasına kadar hangi aşamada olduğunu gösterir. Her kod kalıcı bir hata anlamına gelmez; 1000, 1100, 1210 ve 1220 gibi ara durumlarda zarfı yeniden göndermek yerine sonraki durum yanıtı beklenmelidir.
GİB durum ve hata kodları tablosu
Aşağıdaki tablo, yaygın zarf durumlarını kısa açıklamaları ve uygulanabilecek temel işlemle birlikte gösterir. Yeniden gönderim kararı vermeden önce mevcut zarfın son durumunu ve alıcı etiketini kontrol edin.
| Kod | Durum | Açıklama / olası neden | Önerilen işlem |
|---|---|---|---|
| 1000 | Zarf kuyruğa eklendi | Zarf, GİB işleme kuyruğuna alındı. | Durumun güncellenmesini bekleyin; yeniden göndermeyin. |
| 1100 | Zarf işleniyor | GİB zarf üzerindeki teknik kontrolleri sürdürüyor. | İşlem tamamlanana kadar bekleyin; yeniden göndermeyin. |
| 1110 | ZIP dosyası değil | Gönderilen paket beklenen ZIP biçiminde değil. | Belgeyi geçerli bir ZIP paketi olarak hazırlayıp yeniden gönderin. |
| 1111 | Zarf ID uzunluğu geçersiz | Zarf kimliği beklenen 32 karakterlik yapıya uymuyor. | Zarf kimliğini düzeltip paketi yeniden oluşturun. |
| 1120 | Zarf arşivden kopyalanamadı | Paket işleme alanına alınırken kopyalama sorunu oluştu. | Paketi yeniden oluşturun; sorun sürerse entegratör kayıtlarını kontrol edin. |
| 1130 | ZIP açılamadı | Arşiv bozuk, okunamıyor veya geçici bir sistem sorunu var. | ZIP bütünlüğünü doğrulayın, paketi yeniden oluşturup gönderin. |
| 1131 | ZIP bir dosya içermeli | Zarfın içinde işlenecek belge bulunamadı. | Fatura, uygulama yanıtı veya sistem yanıtı XML'ini pakete ekleyin. |
| 1132 | XML dosyası değil | Paket içindeki belge XML biçiminde değil. | Belgeyi geçerli XML biçiminde üretip yeniden gönderin. |
| 1133 | Zarf ID ve XML dosya adı farklı | Zarf kimliği ile içindeki XML dosyasının adı eşleşmiyor. | Kimlik ve dosya adını eşitleyip yeniden gönderin. |
| 1140 | Doküman ayrıştırılamadı | Zarf içindeki belgeler işlenmek üzere ayrıştırılamadı. | XML ve paket yapısını doğrulayıp zarfı yeniden üretin. |
| 1141 | Zarf ID yok | Zarfın belge kimliği alanı bulunmuyor. | Zorunlu zarf kimliğini ekleyip yeniden gönderin. |
| 1142 | Zarf ID ve ZIP dosya adı farklı | Zarf kimliği ile ZIP dosyasının adı eşleşmiyor. | Zarf kimliği ile ZIP adını eşitleyin. |
| 1143 | Geçersiz versiyon | Belge desteklenmeyen bir zarf veya doküman sürümüyle üretildi. | Güncel, desteklenen sürümle yeniden oluşturun. |
| 1150 | Schematron kontrol sonucu hatalı | Belge, GİB iş kurallarından en az birini karşılamıyor. | Hata ayrıntısındaki iş kuralını düzeltip yeniden gönderin. |
| 1160 | XML şema kontrolünden geçemedi | XML yapısı ilgili UBL-TR şemasına uygun değil. | XML'i güncel şemaya göre doğrulayıp hatalı alanları düzeltin. |
| 1161 | İmza sahibi TCKN/VKN alınamadı | İmza sertifikasındaki kimlik bilgisi okunamadı. | Sertifika ve imzalayan kimliğini kontrol edip yeniden imzalayın. |
| 1162 | İmza kaydedilemedi | Elektronik imza işlenirken veya kaydedilirken hata oluştu. | İmzayı doğrulayın, belgeyi yeniden imzalayıp gönderin. |
| 1163 | Zarf daha önce kayıtlı fatura içeriyor | Aynı fatura kimliği veya ETTN daha önce sisteme kaydedilmiş olabilir. | Yeniden göndermeyin; önce mevcut faturanın zarf durumunu sorgulayın. |
| 1170 | Yetki kontrol edilemedi | Gönderici veya alıcı yetkisi doğrulanamadı. | Etiket ve yetki bilgilerini kontrol ettikten sonra yeniden deneyin. |
| 1171 | Gönderici birim yetkisi yok | Gönderici etiketi gönderici birim etiketi olmayabilir. | Gönderimde güncel GB etiketini kullanın. |
| 1172 | Posta kutusu yetkisi yok | Alıcı etiketi posta kutusu etiketi olmayabilir. | Alıcı için güncel PK etiketini kullanın. |
| 1175 | İmza yetkisi kontrol edilemedi | İmzalayanın yetkisi doğrulanırken sorun oluştu. | Sertifika ve yetki kaydını kontrol edip tekrar deneyin. |
| 1176 | İmza sahibi yetkisiz | Belge, işlem için yetkili olmayan bir sertifikayla imzalanmış. | Yetkili sertifikayla yeniden imzalayıp gönderin. |
| 1177 | Geçersiz imza | Belgenin elektronik imzası doğrulanamadı. | İmza bütünlüğünü kontrol edin ve belgeyi yeniden imzalayın. |
| 1180 | Adres kontrol edilemedi | Gönderici veya alıcı etiket adresi doğrulanamadı. | Güncel kullanıcı ve etiket listesinden adresleri kontrol edin. |
| 1181 | Adres bulunamadı | VKN/TCKN ile etiket bilgisi eşleşmiyor veya etiket güncel değil. | Taraf bilgileri ile GB/PK etiketlerini güncelleyip yeniden gönderin. |
| 1182 | Kullanıcı eklenemedi | Kullanıcı kaydı oluşturulurken teknik veya veri kaynaklı sorun oluştu. | Kayıt bilgilerini doğrulayın; sorun sürerse destek kaydı açın. |
| 1183 | Kullanıcı silinemedi | Kullanıcı kaydı kaldırılırken işlem tamamlanamadı. | Güncel kullanıcı durumunu kontrol edin; gerekirse destek kaydı açın. |
| 1190 | Sistem yanıtı hazırlanamadı | Zarf için sistem yanıtı üretilemedi. | İşlem kayıtlarını kontrol edin ve yanıtı yeniden oluşturmayı deneyin. |
| 1195 | Sistem hatası | GİB veya entegrasyon katmanında genel bir teknik hata oluştu. | Durumu izleyin; sorun sürerse entegratör veya GİB desteğine başvurun. |
| 1200 | Zarf başarıyla işlendi | Zarf merkezi sistemde veya alıcı tarafında başarıyla işlendi. | Yeniden göndermeyin; gerekiyorsa sonraki durum yanıtını bekleyin. |
| 1210 | Doküman adrese gönderilemedi | Belge alıcı adresine ilk denemede iletilemedi; tekrar denemeleri sürüyor. | GİB'in tekrar denemeleri sonuçlanana kadar bekleyin. |
| 1215 | Doküman gönderimi başarısız | Tekrar gönderme denemeleri tamamlandı ancak belge alıcıya iletilemedi. | Son durumu doğruladıktan sonra faturayı yeniden gönderin. |
| 1220 | Hedeften sistem yanıtı gelmedi | Belge alıcıya ulaştı ancak olumlu veya olumsuz sistem yanıtı alınmadı. | Yeniden göndermeyin; alıcıyla görüşüp 1230 veya 1300 durumunu bekleyin. |
| 1230 | Hedeften başarısız sistem yanıtı geldi | Alıcı sistem zarfı işleyemediğini bildirdi. | Yanıttaki hatayı düzeltip son durum kontrolünden sonra yeniden gönderin. |
| 1300 | Başarıyla tamamlandı | Zarf süreci başarıyla tamamlandı. | İşlem gerekmez; aynı faturayı yeniden göndermeyin. |
Tekrar gönderimden önce kontrol edin
Zarf ID, fatura numarası, ETTN, gönderim zamanı ve alıcı GB/PK etiketini birlikte kaydedin. Özellikle 1163 ve 1220 durumlarında kontrolsüz yeniden gönderim mükerrer belge riskine yol açabilir; entegratör ekranındaki son yanıtı esas alın.
Bu içerik genel bilgilendirme amaçlıdır. Mevzuat ve teknik sürüm bilgileri uygulama öncesinde resmi, güncel kaynaklardan doğrulanmalıdır.