🧠 Bu İçeriği Yapay Zekâ (AI) ile Özetleyin:
e-Fatura durum kodları, gönderdiğiniz veya aldığınız elektronik faturanın Gelir İdaresi Başkanlığı (GİB) sisteminde hangi aşamada olduğunu gösteren teknik geri bildirimlerdir. Bu kodlar sayesinde fatura GİB’e ulaştı mı, kontrolden geçti mi, alıcıya iletildi mi, reddedildi mi gibi kritik sorulara hızlıca yanıt bulabilirsiniz.
Bu yazıda; en sık görülen e-fatura durum kodları, yaygın e-fatura hata kodları, bu kodların neden oluştuğu ve pratik çözüm adımları anlaşılır şekilde açıklanmıştır. (İçerik, entegrasyon kullanan işletmelerin süreçlerini hızlandırmasına yardımcı olacak şekilde hazırlanmıştır.)
e-Fatura Nedir ve Durum Kodları Neyi İfade Eder?
e-Fatura, kağıt faturayla aynı hukuki geçerliliğe sahip, dijital ortamda oluşturulan ve GİB sistemi üzerinden alıcıya iletilen fatura türüdür. Fatura GİB’e gönderildiğinde sistem, faturayı teknik kontrollerden geçirir ve her aşama için bir durum kodu üretir.
Bu kodlar genellikle şu tür bilgileri verir:
- Fatura GİB’e ulaştı mı?
- Zarf (paket) yapısı doğru mu?
- Fatura alıcıya iletildi mi?
- Alıcı kabul etti mi / reddetti mi?
- Sistemsel bir sorun var mı?
Önemli nokta: Durum kodları otomatik oluşur ve kullanıcı tarafından değiştirilemez. Siz yalnızca kodu okuyarak doğru aksiyonu alırsınız.
e-Fatura ve GİB Sistemi Arasındaki İlişki
e-Fatura akışı basitçe şöyle işler:
- Fatura (XML) oluşturulur
- “Zarf” içine paketlenir (teknik gönderim paketi)
- GİB’e iletilir
- GİB teknik kontroller yapar
- Uygunsa alıcıya iletir
- Alıcı kabul/ret yanıtı verir
- Sistem durum kodlarını günceller
Bu nedenle durum kodları, hem teknik takip hem de muhasebesel doğrulama için “kontrol paneli” gibi çalışır.
Durum Kodu ile Hata Kodu Arasındaki Fark Nedir?
Bu iki kavram sık karıştırılır:
- Durum kodları: Sürecin “hangi aşamada” olduğunu anlatır.
- Hata kodları: Müdahale gerektiren “neden”i veya teknik sorunu işaret eder.
Örnek:
- 1200 → Başarıyla teslim edildi (durum)
- 1163 → Zarf reddedildi (hata/durum mesajı gibi görünse de pratikte “müdahale” gerektirir)
Kısacası: Durum kodu “nerede?”, hata kodu “neden takıldı?” sorusuna cevap verir.
En Sık Karşılaşılan e-Fatura Durum Kodları ve Anlamları
Aşağıdaki kodlar, sahada en sık karşılaşılan örneklerdir:
1160 – Fatura Alıcıya Ulaşmadı
Fatura GİB’de işlem görmüş olabilir ancak alıcıya iletim aşamasında bekliyordur.
Ne yapmalısınız?
- Alıcının e-fatura mükellefi olup olmadığını kontrol edin
- Alıcının sisteminde geçici problem olup olmadığını sorun
- Aynı faturayı hemen yeniden göndermeyin (çakışma yaratabilir)
1163 – Zarf Reddedildi
Fatura GİB’e ulaşmış olsa bile “zarf/paket” yapısında hata olduğu için reddedilir.
En yaygın sebepler
- XML şema uyumsuzluğu / eksik alan
- Zarf yapısının standartlara uymaması
- UUID / ETTN çakışması (daha önce gönderilmiş aynı kayıt)
Çözüm
- XML’i doğrulayın (şema, alanlar, karakterler)
- Aynı belgeyi “aynı ETTN/UUID” ile tekrar göndermeyin
- Hata düzeltilip yeni ETTN/UUID ile yeniden oluşturun
1170 – Alıcı Tarafından Kabul Edilmedi
Fatura alıcıya ulaşmıştır ama alıcı tarafından reddedilmiştir.
Ne yapmalısınız?
- Alıcıdan ret gerekçesini isteyin
- Gerekliyse düzeltme/iptal prosedürünü uygulayın
- Muhasebe kayıtlarını ret durumuna göre güncelleyin
1195 – Sistem Hatası
Gönderim sırasında sistemsel/altyapısal sorunlar yaşandığını gösterir.
Ne yapmalısınız?
- Kısa süre sonra tekrar deneyin (özellikle yoğunluk/bakım anlarında olur)
- Sorun devam ediyorsa entegrasyon sağlayıcınızdan log isteyin
- GİB servislerinde genel kesinti olup olmadığını kontrol edin
1200 – Fatura Başarıyla Teslim Edildi
En “rahat” kod: Fatura başarıyla iletilmiştir ve süreç tamamlanmıştır.
Ne anlama gelir?
- Fatura yasal olarak geçerlidir
- Muhasebeleştirme sürecine alınabilir
- Ek işlem gerekmeyebilir
1210 – GİB Tarafından Onay Bekliyor
Fatura GİB’e iletilmiştir ancak henüz işleme alınmamış/sıradadır.
Öneriler
- Bir süre sonra tekrar kontrol edin (yoğunluk olabilir)
- Sistem saat senkronizasyonu gibi teknik detayları kontrol edin
- Uzun sürüyorsa log ile teknik destek alın
1215 – Alıcı Tarafından Kabul Bekliyor
GİB onayı sonrası alıcı tarafın yanıtı bekleniyor olabilir.
Öneriler
- Alıcı tarafın onay/ret süreçlerini öğrenin
- Uzun beklemede alıcıyla iletişime geçin
- Süreç kilitlenmiş görünüyorsa entegrasyon loglarıyla destek isteyin
1220 – Alıcı Tarafından Kabul Edildi
Alıcı faturayı onaylamıştır; işlem tamamlanmıştır.
1230 – GİB Tarafından Onaylandı
GİB teknik kontrolleri geçti; alıcıya iletim süreci ilerler/ilerlemiştir.
Teknik Terimler: ETTN, UUID ve “Ziplendi” Ne Demek?
ETTN Nedir?
ETTN, her e-faturaya özel üretilen benzersiz kimlik numarasıdır. Bir fatura hakkında işlem yaparken (kontrol, hata takibi, yeniden gönderim) en çok ETTN üzerinden ilerlenir.
UUID Nedir?
UUID, özellikle e-belgelerde benzersiz tanımlayıcı olarak kullanılan kimliktir. Entegrasyon sistemlerinde çakışma yaşanmaması için kritiktir.
“Ziplendi” Ne Anlama Gelir?
Fatura XML dosyası, GİB’e gönderim öncesi teknik gereklilik olarak ZIP formatında sıkıştırılır. Zipleme aşamasında bozulma/eksik içerik olursa zarf hataları tetiklenebilir.
Yaygın e-Fatura Hata Kodları ve Çözüm Önerileri
Aşağıdaki kodlar, pratikte en çok müdahale gerektirenler arasındadır:
1120 – Teknik Geçersizlik
Neden olur?
- XML standart dışı
- Zorunlu alan eksik
- Hatalı etiket/özel karakter
Çözüm
- XML şema kontrolü yapın
- Alanları (VKN/TCKN, tarih, para birimi, matrah vb.) doğrulayın
1141 – Zarf İçerik Uyumsuzluğu
Neden olur?
- Zarftaki belge sayısı/başlık bilgisi uyuşmaz
- Paket bozulmuş olabilir
Çözüm
- Zarfı yeniden oluşturun
- Entegrasyon loglarında “document count / envelope mismatch” detayını arayın
1163 – Zarf Reddedildi
Yukarıdaki bölümde detaylı: sorunu çözmeden tekrar göndermeyin; yeniden üretim yapın.
1215 – Kabul Bekliyor (Süre Aşıldı / Takılı Kaldı)
Neden olur?
- Alıcı taraf işlem yoğunluğu
- Sistem gecikmesi
- Entegrasyon tarafında durum güncellenememesi
Çözüm
- Alıcıyla teyitleşin
- Entegrasyon sağlayıcınızdan akış loglarını isteyin
- Gerekirse destek talebi oluşturun
e-Fatura Yeniden Gönderme Kuralları ve Doğru Yaklaşım
Her hatada “tekrar gönder” yapmak doğru değildir.
Altın kural:
- ETTN/UUID çakışması olan bir faturayı aynı kimlikle yeniden göndermeye çalışmak çoğu zaman yeni hatalar üretir.
GİB Tarafından Reddedilen Fatura Yeniden Gönderilir mi?
Evet, ancak genellikle şu şartlarla:
- Hata nedeni giderilmiş olmalı
- Fatura yeniden üretilmeli (yeni ETTN/UUID ile)
- Muhasebe kayıtları iptal/düzeltme prosedürlerine göre yönetilmeli
- Log kayıtları saklanmalı
Hatalı Durumda Uygulanacak Kısa Plan
- Kod ne? (1163 mü, 1120 mi, 1215 mi?)
- XML ve kimlik bilgileri (VKN, UUID, ETTN) doğru mu?
- Hata giderildi mi?
- Gerekirse yeni belge üret → yeniden gönder
- Kayıtları muhasebe ile tutarlı şekilde güncelle
Dopigo e-Fatura Entegrasyonu ile Süreçleri Otomatikleştirin
e-Fatura durum kodları ve hata kodlarıyla uğraşırken en büyük ihtiyaç, e-fatura akışını tek panelden takip etmek, hataları hızlıca görmek ve süreçleri otomatikleştirmektir. İşte bu noktada Dopigo e-fatura entegrasyonu, e-ticaret yapan işletmeler ve muhasebe süreçlerini dijitalleştirmek isteyen firmalar için ciddi kolaylık sağlar.
Dopigo e fatura entegrasyonu ile:
- Siparişten faturaya giden süreci otomatikleştirebilir,
- e-Fatura/e-Arşiv belgelerini daha düzenli yönetebilir,
- Durum kodlarını takip ederek hataları erken fark edebilir,
- Manuel işlem yükünü azaltıp zaman kazanabilirsiniz.
Özellikle yoğun sipariş alan işletmelerde, manuel fatura süreçleri hem zaman kaybettirir hem de hata riskini artırır. Dopigo entegrasyonu sayesinde süreçler daha kontrol edilebilir ve sürdürülebilir hâle gelir.