CNB Yazılım CNB Yazılım Logo Yazılım Kurumsal İş Ortağı

Logo e-Defter Hataları ve Çözümleri: Oluşturma, İmzalama ve Gönderim

Ay sonu geldi, e-Defteri oluşturmak istediniz ama Logo “nolu fiş … zorunlu bir elemandır” diye uzun bir hata listesi verdi; ya da defter oluştu, imzalama aşamasında mali mühür görünmüyor; ya da her şey bitti, GİB’e gönderirken hata kodu aldınız. e-Defter hataları ilk bakışta karmaşık görünür, ama hemen hepsi hangi aşamada çıktığına bakılarak çözülebilir. Bu yazıda Logo Tiger, Logo GO ve Wings kullanıcılarının e-Defter oluşturma, imzalama ve gönderim aşamalarında en sık karşılaştığı hataları, nedenlerini ve çözümlerini anlatıyoruz.

Önce hatanın hangi aşamada çıktığına bakın

Aşama Tipik mesaj ve ilk bakılacak yer
Defter oluşturma “… nolu fiş : gl-cor:… zorunlu bir elemandır”, “müteselsil bir değere sahip olmalıdır”, “fişi olmayan satırlar bulundu” — sorun muhasebe fişlerinde veya hesap planındadır.
İmzalama “Sertifika seçiniz”, mali mühür görünmüyor, “imza değeri hesaplanamadı” — sorun mali mühür, kart okuyucu veya program sürümündedir.
GİB’e gönderme “Paket adı geçerli değil”, sayısal hata kodları (900 gibi), “e-defter uygulama rolü yok” — sorun GİB kaydında, önceki dönemlerde veya dosyada olabilir.
Berat Berat yüklenemedi, süre doldu — süre ve önceki ayların beratları kontrol edilir.

Defter oluşturma hataları: sorun fişlerdedir

Logo, e-Defteri oluştururken her muhasebe fişini GİB’in belirlediği kurallara göre kontrol eder. Bir fiş kurala uymuyorsa hata mesajında fiş numarası ve ihlal edilen kural yazar. Mesajdaki fiş numarasını not edip o fişi açmak, çözümün ilk adımıdır. En sık görülen mesajlar şunlardır:

“gl-bus:totalDebit … totalCredit elemanının değerine eşit olmalıdır”

Fişin borç ve alacak toplamları tutmuyor. Fişi açıp satırları kontrol edin. Bu hata ayrıca defteri oluşturan kullanıcının bazı hesaplara yetkisi olmadığında da çıkar: yetkisi olmayan hesapların satırları deftere yansımaz ve toplamlar tutmaz. Defteri tüm hesaplara yetkisi olan bir kullanıcıyla yeniden oluşturun.

“gl-cor:lineNumber müteselsil bir değere sahip olmalıdır”

Fiş satırlarının sırası bozulmuş. Çoğu durumda ilgili dönem için yevmiye madde numaralarını yeniden oluşturmak sorunu giderir. Sorun devam ediyorsa satır numaraları veritabanında düzeltilmelidir; bu işlem yedek alınarak ve uzman desteğiyle yapılmalıdır.

“gl-cor:lineNumberCounter zorunlu bir elemandır”

Fişin yevmiye madde numarası yok. Yevmiye madde numaralandırmasını dönem için yeniden çalıştırın.

“gl-cor:accountMainDescription zorunlu bir elemandır”

Fişte kullanılan hesabın bağlı olduğu ana hesabın açıklaması boş ya da alt hesap ile üst hesap arasındaki bağlantı hatalı. Hesap planında ilgili ana hesabın açıklamasını doldurun ve alt hesabın doğru ana hesaba bağlı olduğunu kontrol edin.

“gl-cor:accountMainID … en az 3 karakter olmalıdır”

Ana hesap kodu tekdüzen hesap planına uymuyor (3 karakterden kısa veya 4 karakterden uzun) ya da ana hesap bağlantısı eksik. Hesap kodunu ve bağlantısını düzeltin.

“documentType … ‘invoice’ olması durumunda documentNumber ve documentDate elemanları da olmalıdır”

Fiş fatura belge türüyle oluşmuş ama belge numarası veya tarihi boş. Genellikle fişin oluştuğu kaynak kayıtta (fatura, banka fişi vb.) belge numarası ya da tarihi eksiktir. Toplu muhasebeleştirmeyle birden fazla kaynaktan oluşan fişlerde de görülür. Kaynak kaydı düzeltip fişi yeniden muhasebeleştirin; e-Defter parametrelerinde belge numarası ve tarihinin hangi alandan okunduğunu da kontrol edin.

“gl-cor:enteredBy zorunlu bir elemandır”

Fişi kaydeden kullanıcının adı ve soyadı tanımlı değil ya da o kullanıcı sistemden silinmiş. Sistem İşletmeni’nde kullanıcı tanımlarında ad ve soyad alanlarını doldurun.

“gl-cor:amount elemanı 0’dan büyük bir değer almalıdır”

Fişte tutarı sıfır veya negatif olan bir satır var. Satırı düzeltin ya da silin. Benzer şekilde “entryHeader en az iki entryDetail içermelidir” mesajı boş veya tek satırlı bir fişe işaret eder.

“Fişi olmayan satırlar bulundu”

Veritabanında, fişi silinmiş ama satırları kalmış muhasebe kayıtları var. Bu satırlar ekranda görünmez ama e-Defter kontrolünde yakalanır. Temizlenmesi veritabanı üzerinde işlem gerektirir; mutlaka yedek alınarak ve bu konuda deneyimli bir uzman tarafından yapılmalıdır.

İmzalama hataları: mali mühür ve sürüm

Mali mühür görünmüyor veya “sertifika seçiniz” uyarısı

“İmza değeri hesaplanamadı”

Bu uyarı, Kamu SM’nin yeni ürettiği EC-384 (eliptik eğri) algoritmalı mali mühürlerle imzalama yapılırken eski Logo sürümlerinde çıkıyordu. Logo, Eylül 2025 tarihli 3.03 sürümüyle bu mühürlerle e-Defter imzalama desteği ekledi. Mührünüz yakın zamanda yenilendiyse ve bu uyarıyı alıyorsanız önce Logo sürümünüzü güncelleyin.

Java ile ilgili hatalar

İmzalama bileşeni Java’ya ihtiyaç duyuyorsa, bilgisayarda birden fazla Java sürümü kurulu olması bileşenin yanlış sürümü kullanmasına yol açabilir. Gereksiz eski sürümleri kaldırmak veya doğru sürümü göstermek çoğu zaman sorunu çözer.

GİB’e gönderme hataları

“Paket adı (…zip) geçerli değil”

Logo’nun sürüm notlarında, e-Defterin GİB’e gönderim aşamasında alınan bu uyarı için iyileştirme yapıldığı belirtiliyor. Bu uyarıyı alıyorsanız önce programınızı güncel sürüme yükseltin.

“Paketin adındaki VKN/TCKN … e-defter uygulama rolü yok”

Bu vergi numarası için GİB e-Defter uygulamasında kayıt görünmüyor ya da programdaki firma bilgilerinde vergi numarası yanlış girilmiş. Firma tanımındaki VKN/TCKN’yi ve e-Defter başvurunuzun tamamlandığını kontrol edin.

Hata kodu 900 ve diğer sayısal kodlar

Sayısal kodlar tek başına bir şey söylemez; asıl bilgi kodun yanındaki açıklama metnindedir. Sık görülen iki durum şunlardır: dönemin ilk defterinde girilen başlangıç tarihinin dönem başlangıcıyla uyuşmaması ve önceki ayların beratlarının eksik olması veya GİB onaylı beratların programa alınmamış olması. Bu yüzden bir aya ait gönderim hata verdiğinde önce önceki ayların beratlarının yüklü ve onaylı olduğunu kontrol edin.

Berat süreleri ve dikkat edilmesi gerekenler

Beratı yüklenmiş bir dönemde hata fark ederseniz izlenecek yol hatanın türüne ve süreye göre değişir; düzeltme kaydı mı yapılacağına yoksa GİB’e başvuru mu gerektiğine mali müşavirinizle birlikte karar verin.

Her ay e-Defter öncesi kontrol listesi

  1. Dönemin tüm fişlerinin girildiğini ve fiş tarihlerinin doğru olduğunu kontrol edin.
  2. Yevmiye madde numaralarını oluşturun.
  3. Logo’nun e-Defter kontrol raporunu çalıştırıp çıkan fişleri düzeltin.
  4. Defteri tüm hesaplara yetkili bir kullanıcıyla oluşturun.
  5. Mali mührün takılı ve geçerli olduğunu, Logo sürümünüzün güncel olduğunu kontrol edin.
  6. Önceki ayların beratlarının yüklü ve GİB onaylı olduğundan emin olun.

CNB Yazılım nasıl yardımcı olur?

e-Defter oluşturma, imzalama ve gönderim hatalarını uzaktan bağlanarak inceliyor; veritabanı düzeltmesi gereken durumlarda yedek alarak güvenle müdahale ediyoruz. Hata mesajının ekran görüntüsünü destek@cnbyazilim.com.tr adresine göndermeniz yeterli. Ürün bilgisi için e-Defter ve e-Defter Saklama sayfalarımıza, yıl sonu işlemleri için Logo’da yeni döneme geçiş yazımıza bakabilirsiniz.

Berat süreleri GİB e-Defter sıkça sorulan sorular sayfasına göre yazılmıştır. Hata mesajlarının metni Logo sürümüne göre küçük farklılıklar gösterebilir.

Yeni Nesil ERP Dönüşümü

Logo Edge'e geçişinizi birlikte planlayalım

Mevcut sisteminizi risk almadan yeni nesil mimariye taşıyın. Lisans hesabından veri aktarımına kadar işletmeniz için en uygun yol haritasını birlikte hazırlayalım.