🎈 Mikro E-Defter de Alınan Hata ve Çözümleri

 

                                                                             👇

 

 İlgili yevmiye numarası ile "Evrak Detaylı Standart Muhasebe Fişi" (081012) ekranını açarak,"Belge no" alannı kontrol ediniz.Belge no alanı boş olmalıdır. Belge no alanı boş ise ilgili fiş silinerek tekrar oluşturulmalıdır.

👇

 

Firma tanıtım kartında , e-defter/e-fatura parametreleri sekmesinde bulunan "Elektronik imza/mali mühür aracı sürücüsü" alanı " c:\windows\System32\akisp11.dll" şeklinde tanımlanmış olmalıdır.

 

      👇

İnternet saati ile işlem yapılan makinenin sistem saati arasında fark var ise bu hata ile karşılaşılmaktadır.Oluşturulan e-defter beratlarının GİB'e gönderilmesi veya sorgulanmasında,sistem saati güncel ve doğru zaman dilimi seçilmiş olmalıdır.Sistem saati güncelleme veya düzeltme adımları için bağlantıyı

    🚩Sistem saati güncellemek için tıklayınız

👇

GİB'den indirilen Zip'li dosyanın, XML olarak çıkartılmış hali dizin içerisinde olmayabilir.İlgili dönem klasörü kontrol edilmelidir.Zip'li dosyadaki XML'ler dönem klasöründeki dizine taşındığı takdirde hata düzelecektir.

👇

İlgili adres ve portlara erişim için gerekli izinler verilmiş olmalıdır. İşlem yapılan makineden https://firma.myedefter.com.tr:4443/ProductManagement/ adresine erişim sağlanabiliyor olmalıdır.

Firewall kullanılıyor veya sınırlamalar yapıldı ise:

·        GİB: uyg.edefter.gov.tr domain adresine https üzerinden 443 portu ile erişmektedir. Bu adres ve porta izin verilmelidir. Domain izni verilirken "*.edefter.gov.tr" şeklinde verilmelidir.

·        e-Defter oluşma ve saklama işleminde: http://portal.emikro.com.tr adresi ile de iletişim kurulması gereklidir. Bu iletişim için firma.myedefter.com.tr domain adresi https üzerinden 443 ve 4443 portlarından bağlantı kurulmaktadır. Domain izni verilirken "*.myedefter.com.tr" şeklinde verilmelidir.

Ayrıca saat ve tarih ayarlarının güncel olup olmadığını, İnternet saati ile Server saatinin aynı olması gerekmektedir.

👇

 

Firma temsilcileri bölümünden,sıfatı parametresinde "SM/SMM/YMM/Firma Yetkilisi" olacak şekilde  bir temsilci tanımı yapılmalı ve diğer sekmelerde yer alan bilgiler de doldurulmalıdır.(Nüfus,İletişim,İkametgah,Sözleşme bilgileri.)

👇

• 501220 numaralı kullanıcı tanımlamaları menüsünde, e-Mikro detayları sekmesinde kullanıcı adı ve şifresi alanlarının eksiksiz ve doğru şekilde tanımlanması gereklidir.  

• 501800 numaralı şube tanıtım kartı menüsünde, şube adı ve şube kodu alanlarının eksiksiz ve doğru şekilde tanımlanması gerekmektedir.

👇

e-Defter Exe'sini yönetici olarak kurunuz. Sonrasında;

 

32 bit için: Dosya yolu, "C:\Program Files (x86)\Common Files\Mikro" klasörününün içerisindeki "MikroBusiness.dll" ile başlayan dll dosyalarını programın çalıştığı dizine kopyalayınız.

64 bit için: "C:\Program Files\Common Files\Mikro" içerisindeki "MikroBusiness.dll" ile başlayan dll dosyalarını programın çalıştığı dizine kopyalayınız.

👇

Mikro Yazılım programı ile e-Defter programınızın sürüm tarihlerinin aynı olup olmadığı kontrol edilmelidir. (Alt+B Kısayolu ile açabilirsiniz) Ayrıca firma tanıtım kartındaki e-Defter/e-Fatura parametreleri sekmesindeki vergi detay alanının doğru tanımlanmış olup olmadığı kontrol edilmelidir.

 

👇

Yetersiz bellek alanından dolayı bu hata alınmaktadır. Beyan amaçlı e-defteri oluştururken parametreler ekranında bulunan "Dosyalama periyodu" alanında "vereceğim boyuta göre dosyalama seçeneği" sekmesinde 20 MB yazarak dosyalama boyutunu seçip defteri oluşturabilirsiniz.

👇

Uyarı veren yevmiye kaydına ulaşıp hataya sebep olan karakterler düzenlenmelidir.Defteri yeniden oluştururken "xml uyumluluk raporu" sekmesi işaretlenmeli ve defter oluşturulmalıdır.

👇

Yevmiye kaydındaki alt hesabın adı zorunlu uyarısı ile karşılaşıldığında ilgili modül "Evrak Detaylı Standart Muhasebe Fişi (081012)" içerisinden Hesap Kodu karşılığına gelen Hesap Adı alanının boş olduğunu göreceksiniz. Hesap Tanıtım kartından veya ilgili modül içerisinden hesabın adının tanımlanması gerektiğinin uyarısını vermektedir.

👇

Mikro e-Defter uygulamasında karşılaştığınız "File can not be read" (Dosya okunamıyor) uyarısı, genellikle yazılımın işlem yapmaya çalıştığı XML dosyalarına veya sertifika bileşenlerine erişememesinden kaynaklanır.

 

Bu sorunun çözümü için şu adımları sırasıyla kontrol etmelisiniz:

 

1. Dosya ve Klasör İzinleri (En Sık Rastlanan Neden)

• Mikro, e-Defter dosyalarını oluştururken ilgili veri dizinine (genellikle C:\Mikro\v16-17\E_DEVLET veya tanımladığınız e-Defter klasörü) yazma ve okuma yetkisine ihtiyaç duyar.

• Çözüm: e-Defter dosyalarının kaydedildiği klasöre sağ tıklayın > Özellikler > Güvenlik sekmesine gelin. Burada kullandığınız Windows kullanıcısına veya "Everyone" grubuna "Tam Denetim" yetkisi verin.

• Yönetici Olarak Çalıştır: Mikro e-Defter uygulamasını sağ tıklayıp "Yönetici olarak çalıştır" seçeneğiyle açarak yetki kısıtlamalarını aşmayı deneyin.

2. Java ve Akis Kart Sürücü Uyumluluğu

• Hata, mali mühür sertifikasının okunması sırasında kullanılan DLL dosyalarının veya Java bileşenlerinin eksikliğinden kaynaklanabilir.

• Java Güncelliği: Bilgisayarınızda Java'nın güncel ve sistem mimarinize (32 bit/64 bit) uygun olduğundan emin olun.

• DLL Kaydı: Eğer sistem akisp11.dll veya MikroBusiness.dll gibi dosyaları okuyamıyorsa, bu dosyaların C:\Windows\SysWOW64 veya ilgili Mikro dizininde olduğundan emin olun.

3. Dosyalama Periyodu ve Boyut Ayarları

          Bazen defter boyutu çok büyük olduğunda sistem dosyayı bellekten okuyamaz ve bu hatayı verebilir.

• Çözüm: e-Defter parametreleri ekranında "Dosyalama Periyodu" alanında "Vereceğim boyuta göre dosyalama" seçeneğini seçip boyutu 20 MB olarak belirleyerek tekrar deneyin.

4. Bozuk veya Eksik XML Dosyaları

          Eğer bir önceki aydan kalan veya o an oluşturulan XML dosyası fiziksel olarak zarar görmüşse Mikro bu hatayı üretir.

• Çözüm: e-Defter klasörünüzdeki ilgili aya ait geçici dosyaları (eğer berat oluşmadıysa) temizleyip defteri yeniden oluşturmayı deneyin.

          Özetle: İlk olarak klasör yetkilerini kontrol edip programı yönetici olarak çalıştırmak vakaların %80'inde kesin çözümdür. Sorun devam ederse Java ve Akis sürücülerini yeniden kurmak gerekebilir.

5. Mikro programınızın son sürüm versiyonda olduğundan emin olunuz.

👇

Bu hata, Mikro'da defter oluşturma (XML üretme) aşamasından ziyade, imzalama/mühürleme aşamasındaki bir eksikliği gösterir. Teknik olarak e-Defterin imza yapısındaki (XAdES) bir sertifika bilgisinin XML içerisine yazılamadığını söyler.

Görseldeki "Hata :ds:KeyInfo elemanı içerisindeki ds:KeyValue elemanı zorunlu bir elemandır" uyarısı, imzalama kütüphanelerinin güncel olmamasından kaynaklanır.

Çözüm Yolu: Bu hatayı gidermek için Mikro Yazılım'ın en güncel sürümüne geçmek veya güncel e-Defter dosyalarını sistem dizinine tekrar kopyalamak genellikle sorunu çözer.

Bu Hatanın Kesin Çözüm Adımları:

1. Mali Mühür / Sertifika Okuma Sorunu:

 

Sistem o an mali mühürün içindeki "Public Key" (Açık Anahtar) bilgisini okuyup XML'e gömemiyor.

Çözüm: Akis Kart İzleme aracını açın, sertifikanın göründüğünden ve "çalışıyor" olduğundan emin olun. Kartı çıkarıp farklı bir USB portuna takarak işlemi tekrarlayın.

 

2. Java ve Kütüphane Çakışması:

 

Mikro, imzalama yaparken bilgisayardaki Java kütüphanelerini kullanır.
Çözüm: Bilgisayarınızdaki tüm Java sürümlerini kaldırıp, Mikro'nun önerdiği güncel 32-bit (veya sisteminize uygun 64-bit) Java sürümünü temiz bir şekilde kurun.

 

3. Mikro e-Defter Parametreleri:

Ayarlar: e-Defter parametreleri ekranında "İmza Tipi" veya "Sertifika Kullanım Tipi" seçeneklerini kontrol edin. Eğer "Akis" seçiliyse ve hata alıyorsanız, (varsa) "Windows Sertifika Deposu" seçeneğini deneyin.

 

4. Zaman Damgası Sunucusu:

E-Defter gönderimlerinde zaman damgası kullanımı, defterin oluşturulduğu ana dair değişmez bir kanıt sunar. Ancak "KeyInfo" hatası alındığında, bu sunucu ile sertifika arasındaki iletişim kopmuş demektir.

 

• Zaman Damgası Sunucusu Ayarları: Mikro içerisindeki Zaman Damgası Sunucusu adresinin güncel (genellikle Kamu SM veya ilgili özel entegratör adresi) olduğu kontrol edilmelidir.

 

• KeyInfo (ds:KeyValue) İlişkisi: Bu hata, mali mühürün içindeki "Açık Anahtar" bilgisinin zaman damgası sunucusu tarafından doğrulanıp XML'e gömülemediğini gösterir.

 

Kritik Çözüm:

• İmzalama kütüphanelerini (DLL) güncelleyin. 
• Güvenlik duvarınızın (Firewall) zaman damgası sunucusu adresine giden trafiği engellemediğinden emin olun.
• Sertifika kullanım tipini değiştirerek (Akis yerine Windows Sertifika Deposu) sistemin anahtarı daha kolay okumasını sağlayın.

Özetle: Bu durum bir yazılım hatası değil, tamamen sertifikanın yetkiyle okunamaması ve zaman damgası sunucusuyla eşleşememesi sorunudur. Mikro'yu mutlaka Yönetici Olarak Çalıştırarak bu engelleri aşabilirsiniz. 

 

 💬 Mikro defter oluşturma sürecinde teknik yapılandırma ile ilgili dikkat edilmesi gereken "key" eşleşmeleri;

          ✅Versiyon Eşleşmesi (Key-Value): 

          Mikro program sürümü ile e-defter oluşturma exe'sinin sürümü aynı olmalıdır.

 İmzalama sihirbazına bağlanılamadı. Lütfen imzalama sihirbazını   açtığınızdan  emin olun ve tekrar deneyin.
 

✅MikroBusiness.dll Hatası ve Çözümü

Mikro e-Defter uygulamasını çalıştırdığınızda veya berat oluşturma aşamasında sistem kütüphane dosyalarını bulamadığında hata verebilir.

Hata Kaynağı: Genellikle MikroBusiness.dll dosyasının programın çalıştığı dizinde olmaması veya Windows tarafından engellenmesidir.

 

Kesin Çözüm:Güncel DLL dosyalarını Mikro kurulum klasörüne kopyalayın. Dosyaya sağ tıklayıp "Engellemeyi Kaldır" (Unblock) seçeneğini işaretleyin.Programı mutlaka "Yönetici Olarak Çalıştır" moduyla açın.

 

 ✅Zaman Damgası Kontörü Hakkında

E-Defter süreçlerinde zaman damgası kullanımı zorunlu olmasa da, özellikle sistem saatinden kaynaklı hataları önlemek için tercih edilir.

 

Uyarı: Zaman damgası kullanıyorsanız, kontörünüzün bitmediğinden ve sunucu adresinin güncel olduğundan emin olmalısınız. Kontör bittiğinde sistem "imzalama yapılamadı" uyarısı döndürecektir.

 

👇

Bu görselde alınan hata e-dönüşümlere başvuru sırasında karşılaşılan bir diğer sorunlardan biridir. Bu hatanın geçiş yolları şu şekildedir;

👉 Tarayıcı Uyumsuzluğu:

Bazı imzalama sihirbazları sadece belirli tarayıcılarda (örneğin Google Chrome, Microsoft Edge, Firefox, Opera..) tam performanslı çalışır.

Çözüm: İşlemi Microsoft Edge üzerinden ve tarayıcıyı "Yönetici Olarak Çalıştır" diyerek açtıktan sonra tekrar deneyin.

👉 Java Erişimi ve Güvenlik Engeli

İmzalama araçları genellikle Java altyapısını kullanır. Tarayıcınız veya antivirüs programınız bu servisin yerel ağ üzerinden (localhost) haberleşmesini engelliyor olabilir.

Çözüm: Antivirüs programınızı geçici olarak devre dışı bırakın ve tarayıcı ayarlarından 127.0.0.1 veya localhost bağlantılarına izin verildiğinden emin olun.

👇

    

 Bu hata ilgili muhasebe fişi evrağındaki belge numarası "0" olarak kaldığı için bu hata ile  karşılaşmaktayız.Evrağa girip belge numarasındaki "0" ı silip yeniden kaydettiğinizde sorun   çözülmüş olacaktır.

👇

Mali mühür süreniz ile akis sürümünüz uyuşmuyor olabilir. 2025 yılı mali mühürleri genelde Akis 6.3.1 sürümü ile defter gönderimi sağlanabilir ve mikro parametrelerinden eski nesil imzalama seçilebilir.

 Yeni mali mühürlerde yeni nesil imzalama ile Akis 6.5.4 sürümü kurularak işlem gerçekleştirilebilir. Mühür ayrıca kullanılmaması durumunda Bulut imzalama ile mühürsüz işlem yapılabilir. Bulut imzalamada alınan sorunlar için doğru Java kurulumu ve Mikro programınızda son sürümde olmaya dikkat etmelisiniz.

Versiyon Uyumu: Mühür sertifikası ile sürücü (Akis) arasındaki versiyon uyuşmazlığından kaynaklanır. 2025 yılı geçiş sürecinde olduğumuz için Akis sürümünüzü mühür nesline göre kontrol etmeniz kritiktir.

👇

Hatanın Temel Sebepleri

 

👉Akis Kart Sürücüsü Uyumsuzluğu: Kullanılan mali mühürün nesli ile bilgisayarda yüklü olan Akis (akisp11.dll) sürümünün birbiriyle tam eşleşmemesi.

 👉İmza Parametresi Hatası: Mikro içerisindeki e-Defter parametrelerinde imzalama tipinin (Eski Nesil / Yeni Nesil) yanlış seçilmesi.

 👉Java Bellek Sorunları: Java'nın imzalama kütüphanesini (PKCS#11) çalıştırırken tahsis ettiği bellek miktarının, yeni nesil mühürlerdeki daha uzun anahtar yapılarını karşılayamaması.

 

Kesin Çözüm Adımları

 

         ✅Sürücü Güncellemesi:

Eğer mühür yeni ise (2025 ve sonrası), bilgisayardaki Akis sürümünü 6.5.4 veya üzerine güncelleyin.

Eski mühürlerde 6.3.1 sürümü daha kararlı çalışabilmektedir.

 

✅Mikro Parametre Ayarı:

Mikro programında e-Defter parametreleri ekranına gidin.

 

✅İmzalama Tipi seçeneğini, mevcut ayarın tam tersiyle (Eski ise Yeni, Yeni ise Eski) değiştirerek tekrar deneme yapın.  

 

✅DLL Dosyası Kontrolü:

akisp11.dll dosyasının hem C:\Windows\System32 hem de C:\Windows\SysWOW64 klasörlerinde doğru sürümlerle yer aldığından emin olun.

 

 ✅Yönetici Yetkisi:

Programın PKCS#11 kütüphanesine tam erişim sağlayabilmesi için Mikro'yu mutlaka "Yönetici Olarak Çalıştır" moduyla açın.

         👇

Mikro yazılımında çalışma amaçlı defter oluştururken karşılaştığınız image_b1eaf7.jpg görselindeki hatalar, defterin teknik yapısı ile içerdiği verilerin dönem bilgilerinin uyuşmadığını gösterir.

Bu hataların detaylı açıklamaları ve çözüm yolları şunlardır:

1. Defterde en az 1 gl-cor:entryHeader elemanı olmalıdır.

Anlamı: Oluşturulmaya çalışılan defter dosyasının içinde hiçbir muhasebe kaydı (yevmiye maddesi) bulunamadığını ifade eder.
Nedeni: Seçilen tarih aralığında sisteme girilmiş, onaylanmış veya deftere aktarılmaya hazır bir muhasebe fişi olmayabilir.
Çözüm: İlgili ay için fişlerin muhasebeleştiğinden ve mizanınızın boş olmadığından emin olun. Eğer fişler varsa, entegrasyon ayarlarını kontrol ederek verilerin e-Defter modülüne doğru aktarıldığını teyit edin.

2. Dosya adındaki dönem ile periodCoveredStart'taki dönem bilgisi aynı olmalıdır.

Anlamı: Defter dosyasının ismi (örneğin Eylül ayı için "09") ile dosyanın içindeki başlangıç tarihi bilgisinin birbiriyle örtüşmediğini söyler.
Nedeni:Sistem tarihinin veya e-Defter parametrelerindeki dönem başlangıç ayarlarının yanlış olması.
Önceki aylardan kalan "taslak" veya "geçici" dosyaların klasörde birikmesi sonucu oluşan isim çakışmaları.
Çözüm:
e-Defter parametreleri ekranından çalışma yaptığınız dönemi (ay/yıl) kontrol edin.
image_bdcb23.png dosyasında önerildiği gibi; e-Defter klasöründeki ilgili aya ait geçici dosyaları (berat oluşmadıysa) temizleyip defteri yeniden oluşturmayı deneyin.

Genel Tavsiye

Bu tip teknik şema hataları genellikle veri eksikliğinden veya yazılım sürümü uyumsuzluğundan kaynaklanır. image_bdbcd9.png ve image_bd5f02.png görsellerinde vurgulandığı üzere, bu işlemleri yaparken Mikro programınızın en güncel sürümde olduğundan emin olmalı ve yazılımı mutlaka "Yönetici Olarak Çalıştır" moduyla başlatmalısınız.

 

Sorularınız, karşılaştığınız teknik sorunlar ve destek talepleriniz için aşağıya yorum bırakabilirsiniz