Zirve Müşavir programında mali mühür ile e-bildirge gönderirken 'PKCS11 kütüphanesi yüklenemedi' hatası veriyor, Java 32-bit mi 64-bit mi kurulu olmalı?

Zirve Müşavir ve benzeri yerel masaüstü muhasebe yazılımlarında yaşanan 'PKCS11 kütüphanesi yüklenemedi' hatası, doğrudan işletim sistemi mimarisi ile uygulama mimarisi arasındaki bit (x86 vs x64) uyuşmazlığından kaynaklanır. Sorunun teknik nedenini ve adım adım kesin çözümünü aşağıda bulabilirsiniz:

1. Temel Teknik Neden: 32-Bit (x86) Mimari Zorunluluğu

Kullandığınız işletim sistemi Windows 11 64-bit olsa dahi, Zirve Müşavir yazılımının çalıştırılabilir ana dosyası (ZirveMüsavir.exe) 32-bit (x86) mimaride derlenmiş bir uygulamadır. Windows işletim sistemi çekirdeği kuralları gereği, 32-bit bir işlem (process) belleğe 64-bit bir kütüphaneyi (DLL) veya 64-bit Java Sanal Makinesini (JVM) asla yükleyemez (bu durum işletim sistemi düzeyinde doğrudan 'BadImageFormatException' veya 'UnsatisfiedLinkError' ile sonuçlanır).

Siz sisteme 64-bit Java kurduğunuzda Zirve bunu göremez veya yüklemeye çalıştığında mimari uyuşmazlığı nedeniyle çöker. Bu nedenle Zirve Müşavir'in akıllı kartla haberleşebilmesi için KESİNLİKLE 32-bit (Windows x86) Java kurulu olmak zorundadır.

2. Adım Adım Kurulum ve Yapılandırma Rehberi:

• 1. Adım: 32-Bit Java (JRE) Kurulumu: Mevcut 64-bit Java'yı kaldırmanıza gerek yoktur (farklı 64-bit programlar kullanabilir). Ancak Oracle Java veya Adoptium/Temurin sitesinden 'Windows x86 Offline (32-bit)' JRE kurulum paketini (Örn: Java 8u202 veya üzeri 32-bit) indirip kurun. Kurulum bittiğinde C:\Program Files (x86)\Java\jre... dizininin oluştuğunu doğrulayınız.
• 2. Adım: AKİS 32-Bit PKCS#11 Kütüphanesini Doğrulayın: TÜBİTAK Kamu SM sürücü yükleme sayfasından kartınıza uygun en güncel AKİS yazılımını kurun. 64-bit Windows sistemlerde AKİS kurulumu kütüphaneleri iki ayrı dizine atar:
  • 64-bit uygulamalar için: C:\Windows\System32\akisp11.dll
  • 32-bit uygulamalar için: C:\Windows\SysWOW64\akisp11.dll
  Zirve 32-bit olduğu için kütüphaneyi C:\Windows\SysWOW64\akisp11.dll yolundan okumak zorundadır. Dosyanın bu klasörde var olduğunu kontrol edin.
• 3. Adım: Zirve Müşavir Kütüphane Yolu Tanımlaması: Zirve Müşavir programını açın -> Ayarlar / Genel Ayarlar -> E-İşlemler / Mali Mühür Tanımları menüsüne girin. PKCS11 Kütüphane Yolu alanına el ile veya 'Gözat' butonuna basarak doğrudan: C:\Windows\SysWOW64\akisp11.dll yolunu gösterin ve kaydedin.
• 4. Adım: Kart Tipi ve Donanım Sürücüsü: Eğer kullandığınız mühür Kamu SM'nin son yıllarda dağıttığı mavi USB token ise sürücü tipi AKİS'tir. Eğer eski tip beyaz kart kullanıyorsanız kart okuyucunuz Gemalto veya ACS olabilir; bu durumda kütüphane adı karta göre aetpkss1.dll veya acpkcs211.dll olabilir. Güncel çiplerin tamamı AKİS tabanlıdır.
• 5. Adım: Windows Akıllı Kart Hizmeti ve Yönetici İzni: Klavyeden Windows + R ile services.msc açın, 'Akıllı Kart' (Smart Card) servisinin çalıştığından ve başlangıç türünün 'Otomatik' olduğundan emin olun. Ardından Zirve Müşavir masaüstü kısayoluna sağ tıklayıp 'Yönetici olarak çalıştır' seçeneği ile programı başlatın.

Bu konfigürasyonu tamamladıktan sonra Zirve Müşavir PKCS#11 kütüphanesini anında tanıyacak, mali mühür PIN ekranı hatasız açılacak ve SGK e-Bildirge ile e-Beyanname onaylarınızı saniyeler içinde gönderebileceksiniz.