Hedef kitle: e-Fatura portalında belge yükleyen mali müşavir ofisleri ve muhasebe ekipleri
Soru: e-Fatura yüklerken hata alırsam sorunun kaynağını nasıl ayırırım?
e-Fatura yükleme hatasında ilk yapılacak işlem, hata mesajını genel “portal çalışmıyor” notuyla geçmek değil, dosyanın hangi aşamada reddedildiğini ayırmaktır. GİB e-Fatura Portalı Kullanım Kılavuzu, portal dışındaki harici programlarla oluşturulan faturaların UBL-TR formatına uygun hazırlanmış, mali mühürle onaylanmış ve standart ZIP dosyası içinde yüklenmiş olması gerektiğini açıklar.
Kontrol sırası şöyle uygulanabilir: Önce XML dosyasının fatura olup olmadığı ve doğru şema bilgilerini taşıyıp taşımadığı kontrol edilir. İkinci olarak XSLT görüntüsüyle XML içeriğinin aynı bilgileri gösterip göstermediği incelenir; görüntüdeki bilgiyle XML farklıysa asıl veri XML’dir. Üçüncü adımda dosyanın mali mühürle onaylı olup olmadığı doğrulanır. Dördüncü adımda ZIP paketi açılıp içinde beklenen dosya yapısı görülür. Beşinci adımda aynı UUID veya fatura numarasının daha önce yüklenip yüklenmediği kontrol edilir.
Örnek: Kullanıcı “fatura görünüyor ama yüklenmiyor” diyorsa PDF görüntüsünün açılması yeterli değildir. XML şema kontrolünden geçmiyorsa portal yüklemesi hata verebilir. Benzer şekilde mühürsüz XML, görüntü olarak doğru olsa bile resmi e-fatura niteliği kazanmaz.
İlgili iç bağlantı: Neden E-İmza Atamıyorum?. Resmi kaynak: GİB e-Fatura Portalı Kullanım Kılavuzu. Son kontrol tarihi: 31.10.2026, Türkiye.
Bu rehberde amaç yazılım özelliği anlatmak değil, mali müşavir ofisinde hata kaynağını belge türüne göre sınıflandırmaktır. Hata ekranı, dosya adı, UUID ve işlem saati aynı notta tutulursa resmi veya teknik destek görüşmesi daha verimli ilerler ve mükerrer yükleme riski düşer.