E-fatura portal GİB teknik hata kodu nasıl çözülür?

GİB E-Fatura Portalı Teknik Hata Kodları ve Çözüm Yolları

E-fatura gönderiminde GİB (Gelir İdaresi Başkanlığı) portalı kaynaklı teknik hatalar, sistem entegrasyonu, veri formatı veya GİB altyapısından kaynaklanabilir. Bu tür hatalarla karşılaşıldığında izlenmesi gereken sistematik bir yol vardır.

1. İlk Kontrol ve Temel Çözümler

• Hata Kodunu ve Mesajını Tam Olarak Tespit Edin: Hatanın çözümü, aldığınız spesifik hata koduna (örneğin, 1000 serisi, 2000 serisi) ve mesajına bağlıdır. Bu kodu not alın.
• GİB Teknik Destek ve Canlı Sistem Durumu Sayfasını Kontrol Edin: GİB, zaman zaman bakım veya kesinti yaşayabilir. GİB resmi sitesinde veya e-fatura portal giriş sayfasında yer alan "Sistem Durumu" bildirimlerini kontrol edin. Genel bir kesinti varsa, GİB'in düzeltmesini beklemek gerekir.
• Fatura XML Dosyasını Doğrulayın (Validate Edin): Hatanın en yaygın sebebi, UBL-TR formatına veya şemaya (XSD) uygun olmayan XML dosyalarıdır. Faturanızı oluşturan yazılımınızın veya entegratörünüzün en güncel GİB şemalarını kullandığından emin olun. XML'i bir doğrulama aracından (validator) geçirin.
• Zaman Damgası ve Elektronik İmza Kontrolü: Faturaya iliştirilen zaman damgasının (timestamp) süresinin geçmediğinden ve elektronik imzanın geçerli olduğundan emin olun.
• Gönderim Limiti (Quota) Kontrolü: GİB, gönderim hacmine göre dakikalık/saatlik gönderim limitleri koyabilir. Yoğun gönderim yapıyorsanız, limiti aşmış olabilirsiniz. Gönderim hızınızı düşürüp tekrar deneyin.

2. Sistematik Sorun Giderme Adımları

• Yazılım/Entegratör Firma ile İletişime Geçin: Aldığınız hata kodunu, hatanın oluştuğu zamanı ve fatura örneğini (kişisel verileri maskeleyerek) yazılım sağlayıcınıza iletin. Bu hataların çoğu, entegratör firmanın güncellemesi veya müdahalesi ile çözülür.
• GİB Test Ortamında (Beta) Deneme Yapın: Canlı sisteme gönderim yapmadan önce, aynı faturayı GİB'in test ortamında (beta.gib.gov.tr) gönderip aynı hatayı alıp almadığınızı kontrol edin. Bu, sorunun sizin tarafınızdan mı yoksa genel sistemden mi kaynaklandığını anlamanıza yardımcı olur.
• GİB Başvuru Merkezi (ALO 189) ve Destek Sistemi: Sorun devam ederse, GİB Başvuru Merkezi'ni (ALO 189) arayabilir veya GİB İletişim Merkezi (İVD) üzerinden bir destek talebi oluşturabilirsiniz. Talebinizde hata kodunu, tarih-saat bilgisini, vergi kimlik numaralarını ve mümkünse hata alınan XML'i ekleyin. Bu, en resmi yoldur.
• Mükellef Hizmetleri Ofisine Başvuru: Dijital kanallardan çözülemeyen durumlarda, bağlı olduğunuz vergi dairesindeki Mükellef Hizmetleri Ofisi'ne giderek durumu bildirebilirsiniz.

3. Sık Karşılaşılan Teknik Hata Örnekleri ve Olası Sebepleri

• "Geçersiz İmza" veya "Zaman Damgası Hatası": E-imza sertifikanızın süresi dolmuş, iptal edilmiş olabilir veya imzalama işlemi teknik bir hatadan kaynaklanıyor olabilir.
• "Şema Validasyon Hatası": Fatura XML'inizde GİB'in beklediği formatta olmayan bir alan (yanlış tarih formatı, eksik zorunlu alan, hatalı karakter) var demektir.
• "Alıcı Bulunamadı" veya "Alıcı Etkin Değil": Faturayı gönderdiğiniz müşterinin vergi kimlik numarası hatalı olabilir veya alıcı, e-fatura veya e-arşiv sistemine kayıtlı/etkin olmayabilir.
• "Sistem Hatası" veya "Beklenmeyen Hata" (Genellikle 1000+ Kodları): Bu genellikle GİB sunucu tarafındaki geçici bir soruna işaret eder. Bir süre bekleyip tekrar denemek veya sistem durumunu kontrol etmek gerekir.

Önemli Uyarı: Teknik hatalar nedeniyle faturalar zamanında iletilemezse, bu faturaların ortalama vergi oranı üzerinden KDV beyan edilmesi ve ödenmesi gerekebilir (VUK Geçici 33. Madde). Sorun çözüldüğünde fatura gönderimi yapılır ve bir sonraki beyannamede mahsup işlemi gerçekleştirilir. Bu süreci takip etmek ve gecikme durumunda gerekli vergisel düzeltmeleri yapmak mükellefin sorumluluğundadır.

Not: Bu bilgiler genel rehberlik amaclıdır. Özel durumunuz ve aldığınız spesifik hata kodu için yazılım sağlayıcınız ve/veya GİB'den teknik destek almanız önerilir.