Fatura keserken "Gönderim başarısız" yanıtı aldığınızda genelde işin sonu değil, hızlı bir çözüm var. GİB'in hata kodları standart; anlaşıldığında çözüm pratik.
Aşağıda Hesapdar müşteri desteğinin en sık karşılaştığı 15 hata kodunu ve çözümlerini listeliyoruz.
VKN ve müşteri hataları
Hata 9999: "Alıcı e-fatura mükellefi değil"
Anlamı: Girdiğiniz VKN'ye sahip kişi e-fatura mükellefi olarak GİB veri tabanında kayıtlı değil.
Çözüm:
- VKN'yi tekrar kontrol edin, tipografik hata var mı?
- Müşteri gerçekten e-fatura mükellefi değilse e-arşiv fatura kesin.
- Hesapdar'da fatura türünü "E-Arşiv" olarak değiştirin, süreç otomatik düzelir.
Hata 1190: "VKN/TCKN doğrulanamadı"
Anlamı: VKN 10 hane değil veya TCKN 11 hane değil.
Çözüm:
- VKN 10 haneli sayı olmalı.
- TCKN 11 haneli sayı olmalı.
- Başında 0 varsa doğru (ama VKN tipik olarak sıfırla başlamaz).
- Hesapdar girdi kutusuna yapıştırdığınızda boşluk/tire otomatik temizlenir; ama elle yazıyorsanız kontrol edin.
Hata 9998: "Alıcı VKN'si ile fatura rolü uyumsuz"
Anlamı: Müşteri hem e-fatura hem e-arşiv rolünde tanımlı; hangisini seçeceğiniz ortada kalmış.
Çözüm:
- Hesapdar otomatik olarak müşterinin aktif rolünü seçer. Hâlâ hata alıyorsanız müşteriyi "Yeniden sorgula" ile GİB'den tazelttirin.
- Nadiren GİB'de tanımlama geçici gecikme yaşar; 15 dk sonra tekrar deneyin.
Zarf ve format hataları
Hata 2100: "Zarf formatı hatalı"
Anlamı: Fatura XML'i GİB'in beklediği UBL-TR 2.1 formatına tam uymuyor. Hesapdar'da bu hatayı neredeyse hiç alamazsınız; ama özel entegrasyon yapıyorsanız karşılaşabilirsiniz.
Çözüm:
- UBL-TR 2.1 şemasına göre validasyon yapın.
- Tarih formatları ISO 8601 (YYYY-MM-DD) olmalı.
- Sayısal alanlarda ondalık ayırıcı nokta (.) olmalı, virgül (,) olmamalı.
Hata 2200: "XML imzası doğrulanamadı"
Anlamı: Mali mühür ile imzalanmış XML kontrol edilemedi.
Çözüm:
- Mali mühür kartı okutucuya takılı mı kontrol edin.
- Mali mühür sertifikanızın süresi dolmuş olabilir (3 yıllık geçerlilik). e-Güven veya TÜBİTAK'tan yenileyin.
- Hesapdar bulut imzalı kullanıyorsa bu hata oluşmaz, panelin "Bulut İmza" modunu aktif edin.
Hata 2201: "Sertifika zaman damgası geçersiz"
Anlamı: İmza zaman damgası, sertifikanın geçerlilik süresi dışında.
Çözüm:
- Bilgisayar saat ve tarihi doğru mu? Bazen saat ayarı 1 yıl önceden veya sonradan kalmış oluyor.
- Sertifika süresi dolmuşsa yenileyin.
KDV ve tutar hataları
Hata 3001: "KDV oranı geçersiz"
Anlamı: Girilen KDV oranı %1, %10, %20 veya %0 dışında.
Çözüm:
- 2026 itibarıyla yürürlükteki oranlar: %1, %10, %20, %0 (istisna).
- %18 yok; 2023'ten itibaren %20 oldu.
- %8 yok; 2023'ten itibaren %10 oldu.
- Eski şablonunuzu kontrol edin, güncel oranı seçin.
Hata 3050: "Tutar negatif olamaz"
Anlamı: Fatura tutarı negatif girilmiş.
Çözüm:
- Satış faturası pozitif olmalı.
- İade faturası kesmek istiyorsanız "Fatura Türü" alanında "İade Faturası" seçin; panel negatif tutarı otomatik yönetir.
Hata 3100: "KDV tutarı matrahla uyumsuz"
Anlamı: Hesaplanan KDV tutarı, matrah × oran sonucuyla uyuşmuyor.
Çözüm:
- Matrah × (KDV oranı / 100) = KDV tutarı.
- Yuvarlama farkı 0.01 TL'den fazla ise hata olur.
- Hesapdar otomatik hesaplar; manuel müdahale etmediyseniz bu hatayı görmezsiniz. Eğer excel'den toplu yükleme yapıyorsanız satır bazında formülle doğrulayın.
Belge ve numaralandırma hataları
Hata 4001: "Fatura numarası daha önce kullanılmış"
Anlamı: Aynı fatura numarası bu seri için ikinci kez kullanılıyor.
Çözüm:
- Her fatura için seri ve sıra numarası benzersiz olmalı.
- Hesapdar otomatik sıra numarası üretir; hata nadir. Ama bazen manuel girdiyseniz yanlış numarayı yazabilirsiniz.
- Panelde "Otomatik numara" modunu aktif bırakın.
Hata 4010: "Fatura tarihi gelecek tarihli olamaz"
Anlamı: Fatura tarihi bugünden sonra girilmiş.
Çözüm:
- Bugünün tarihi veya geçmiş bir tarih kullanın.
- Ay sonu fatura kesim pratiğinde "bu ayki son fatura" için bugün kullanılır; sonraki ayın 1'i istenmez.
Hata 4020: "Fatura tarihi geçmiş dönem"
Anlamı: Fatura tarihi 5 günden daha eski.
Çözüm:
- E-fatura, düzenleme tarihinden itibaren 7 gün içinde GİB'e iletilmelidir.
- Daha eski tarihli fatura keseceksiniz (yasal olarak özel durum varsa) yazılı GİB onayı gerekir.
- Genelde bugünün tarihiyle kesilir; müşteriye "fatura tarihi" olarak farklı bir tarih istiyorsa "belge tarihi" notu eklenir.
Bağlantı ve operasyon hataları
Hata 9000: "GİB servisine ulaşılamıyor"
Anlamı: GİB altyapısında geçici kesinti.
Çözüm:
- 5-15 dakika bekleyin, tekrar deneyin.
- Hesapdar otomatik retry yapar; panelde "Beklemede" olarak görünür, servis açıldığında otomatik iletilir.
- Uzun süreli kesinti (> 1 saat) durumunda status.gib.gov.tr sayfasını kontrol edin.
Hata 9001: "Entegratör servisinde hata"
Anlamı: Hesapdar ile GİB arasındaki altyapı entegratöründe (örn. QNB E-Solutions) problem.
Çözüm:
- Hesapdar destek ekibi bu durumu otomatik izler, çözüm 5-10 dk.
- Kritik bir fatura ise destek ekibine ulaşın.
Hata 9100: "Kontör tükendi"
Anlamı: Aylık/yıllık fatura kontörünüz bitti.
Çözüm:
- Panelden ek kontör paketi satın alın (1 dakika içinde aktif olur).
- Büyük bir paket aylık faturanız sınırını aşmışsa bir üst pakete geçmek daha ekonomik olabilir.
Ne zaman destek arayabilirim?
Yukarıdaki çözümler işe yaramazsa 7/24 destek aktif:
- Canlı sohbet: Panelden sağ alt köşe
- Telefon: +90 850 309 8467
- E-posta: destek@hesapdar.com
Ortalama yanıt süresi 4 dakika, çözüm süresi 1 saat.
Sonraki adım
Detaylı hata kodu dokümantasyonu ve canlı hata çözüm rehberi için Hesapdar Yardım Merkezi sayfasına göz atın. Hâlâ takıldıysanız destek ekibine yazın, çoğu hata 5 dakikada çözülüyor.
