Mikro e-Defter Hata 2000 – Kontrol ve Çözüm Adımları

Mikro e-Defter uygulamasında Hata 2000, tek bir nedene bağlı olmayan; e-Defter dosyalarının oluşturulması, kontrol edilmesi, imzalanması veya GİB sistemleriyle iletişim kurulması sırasında ortaya çıkabilen genel bir hata durumudur.

Hata ile karşılaşıldığında aşağıdaki kontrollerin sırasıyla yapılması önerilir.

1. Sistem tarih ve saatini kontrol edin

• Windows sistem tarihinin doğru olduğundan emin olun.
• Sistem saatinin güncel olup olmadığını kontrol edin.
• Saat diliminin Türkiye/İstanbul (UTC+03:00) olarak seçildiğini kontrol edin.
• Tarih, saat veya saat dilimindeki yanlışlıklar elektronik imza ve e-Defter süreçlerinde sorun oluşturabilir.
• Özellikle sunucu ve istemci bilgisayarların tarih ve saat bilgilerinin birbiriyle uyumlu olması kontrol edilmelidir.

2. İlgili e-Defter dönem klasörünü kontrol edin

• İlgili ay/döneme ait e-Defter klasörünün mevcut ve erişilebilir olduğundan emin olun.
• Mikro uygulamasının bu klasöre okuma, yazma ve değiştirme yetkisinin bulunması gerekir.
• Gerekli durumlarda klasör ve alt klasörler için kullanıcı/uygulama erişim yetkileri kontrol edilmelidir.
• Klasör yolunun mümkün olduğunca kısa ve sade tutulması önerilir.
• Klasör ve dosya adlarında Türkçe karakterlerden, özel karakterlerden ve gereksiz uzun klasör yollarından kaçınılmalıdır.
• Dosya yolunun, kullanılan Windows, Mikro ve ilgili e-Defter bileşenlerinin desteklediği sınırlar içerisinde olması gerekir.

3. GİB servislerine erişimi kontrol edin

• Windows Güvenlik Duvarı, antivirüs veya kurumsal güvenlik yazılımlarının Mikro e-Defter bileşenlerinin internet erişimini engellemediğinden emin olun.
• İnternet servis sağlayıcısı veya modem/router üzerinde bulunan Aile Güvenliği, Güvenli İnternet, içerik filtreleme veya benzeri erişim kısıtlamalarının GİB servislerine erişimi engellemediği kontrol edilmelidir.
• Proxy kullanılıyorsa gerekli bağlantı izinleri kontrol edilmelidir.
• GİB servislerine HTTPS/TCP 443 üzerinden erişimin açık olması gerekir.
• GİB servis adreslerine erişimin DNS, firewall veya kurumsal güvenlik politikaları nedeniyle engellenmediği kontrol edilmelidir.
• Kurumsal ağlarda internet erişimi doğrudan değil, proxy veya güvenlik cihazı üzerinden sağlanıyorsa ilgili kurallar ayrıca kontrol edilmelidir.

4. Sertifika ve elektronik imza bileşenlerini kontrol edin

• Kullanılan elektronik sertifikanın geçerli olduğu kontrol edilmelidir.
• Sertifikanın süresinin dolmadığından emin olun.
• Sertifikanın bilgisayar tarafından doğru şekilde görüldüğü kontrol edilmelidir.
• Kullanılan e-imza/mali mühür bileşenlerinin ve sürücülerinin doğru ve güncel olması gerekir.
• İmzalama işlemi sırasında sertifika veya imza bileşeninden kaynaklanan bir hata olup olmadığı kontrol edilmelidir.
• Sertifikanın farklı bir bilgisayarda veya ilgili imza uygulamasında doğru şekilde çalışıp çalışmadığı gerektiğinde test edilmelidir.

5. Mikro ve e-Defter sürümünü kontrol edin

• Kullanılan Mikro sürümünün güncel ve ilgili GİB e-Defter paketleriyle uyumlu olduğu kontrol edilmelidir.
• e-Defter mevzuatında veya GİB e-Defter paketlerinde yapılan değişiklikler sonrasında eski bileşenlerle işlem yapılması hata oluşturabilir.
• Mikro e-Defter bileşenleri ile kullanılan diğer yardımcı bileşenlerin sürüm uyumluluğu kontrol edilmelidir.

Sürüm güncellemesi sırasında

Gerekli durumlarda yeni sürüm yüklenmeden önce Common Files\Mikro klasöründeki mevcut bileşenlerin eski sürümden kalmış dosyalar nedeniyle sorun oluşturup oluşturmadığı kontrol edilmelidir.

Mikro’nun ilgili sürüm güncelleme prosedürüne göre, istemci bilgisayarda kullanılan Common Files\Mikro bileşenlerinin güncel sürümle uyumlu olması sağlanmalıdır.

Not: Klasör içeriğinin silinmesi veya başka bir klasöre kopyalanması, yalnızca kullanılan Mikro sürümünün kurulum/güncelleme prosedürü bunu gerektiriyorsa uygulanmalıdır. Standart dışı dosya silme işlemleri yapılmadan önce mevcut kurulumun yedeğinin alınması önerilir.

6. Yevmiye kayıtlarını ve belge tipi bilgilerini kontrol edin

Özellikle hata belirli bir dönemin e-Defteri oluşturulurken meydana geliyorsa aşağıdaki bilgiler kontrol edilmelidir:

• Yevmiye kayıtları
• Belge türü
• Belge numarası
• Belge tarihi
• Hesap bilgileri
• Vergi bilgileri
• Zorunlu alanlar
• Kayıtlarda kullanılan karakterler

Yevmiye dökümünde belge tipi bilgisinin doğru tanımlanmış olması özellikle önemlidir.

Eksik veya standartlara uygun olmayan kayıtlar e-Defter XML’inin oluşturulması veya doğrulanması sırasında hataya neden olabilir.

Ayrıca bazı durumlarda kayıt içerisinde bulunan uyumsuz karakter setleri veya özel karakterler, beklenen hata/uyarı mesajının oluşmasını da engelleyebilir. Bu nedenle özellikle sorun belirli bir kayıtta ortaya çıkıyorsa ilgili yevmiye kayıtlarının içerikleri ayrıca incelenmelidir.

7. XML ve şematron kontrollerini yapın

Oluşturulan e-Defter XML dosyaları üzerinde aşağıdaki kontroller yapılmalıdır:

• XML yapısının geçerli olması
• XML karakter kodlamasının uygun olması
• Geçersiz XML karakterlerinin bulunmaması
• Türkçe karakterlerin doğru kodlanması
• İlgili e-Defter XSD/şema kurallarına uygunluk
• Şematron kontrollerinin başarılı olması

Windows bölgesel dil ayarı ile XML karakter kodlaması birbirinden farklı konulardır.

Windows tarafında bölgesel ayarların Türkiye/Türkçe olarak yapılandırılması önerilir. XML tarafında ise kullanılan karakter kodlamasının ve karakterlerin e-Defter standardına uygun olması gerekir.

Özellikle e-Defter XML’i oluşturulurken kullanılan veriler içerisinde XML tarafından desteklenmeyen kontrol karakterleri veya hatalı/uyumsuz karakterler bulunmadığı kontrol edilmelidir.

8. Güvenlik yazılımlarını kontrol edin

Bazı durumlarda aşağıdaki güvenlik uygulamaları e-Defter dosyasının oluşturulmasını, imzalanmasını veya GİB’e gönderilmesini engelleyebilir:

• Windows Defender
• Antivirüs
• Endpoint Security
• Firewall
• EDR (kurumsal uç nokta güvenlik yazılımı)
• Proxy
• Kurumsal web filtreleme sistemleri

Hata devam ediyorsa ilgili güvenlik yazılımının Mikro ve e-Defter bileşenlerini engelleyip engellemediği kontrol edilmelidir.

Özellikle güncelleme sonrasında ortaya çıkan hatalarda, güvenlik yazılımının yeni oluşan uygulama veya bileşenleri engelleyip engellemediği ayrıca değerlendirilmelidir.

9. Bilgisayar ve sunucu ortamını kontrol edin

Mikro uygulaması sunucu üzerinde çalışıyorsa aşağıdaki kontroller ayrıca yapılmalıdır:

• Sunucunun tarih/saat ayarları
• Kullanıcı yetkileri
• Paylaşımlı klasör erişimleri
• Ağ bağlantısı
• DNS çözümlemesi
• İnternet erişimi
• Güvenlik duvarı kuralları
• Proxy yapılandırması
• Uygulamanın çalıştığı Windows kullanıcı hesabının yetkileri

Terminal bilgisayardan erişilebilen bir klasörün, sunucu üzerindeki servis veya uygulama hesabı tarafından erişilebilir olması her zaman garanti değildir.

Bu nedenle uygulamanın gerçekten hangi Windows kullanıcısı veya servis hesabı ile çalıştığı gerektiğinde kontrol edilmelidir.

10. Hatanın hangi aşamada oluştuğunu belirleyin

Sorunun kaynağını belirlemek için Hata 2000’ün hangi aşamada oluştuğu tespit edilmelidir:

• e-Defter oluşturulurken mi?
• XML oluşturulurken mi?
• XML kontrolünde mi?
• İmzalama aşamasında mı?
• Berat oluşturulurken mi?
• GİB’e gönderim sırasında mı?
• GİB’den cevap alınırken mi?

Bu ayrım, hatanın kayıt/XML kaynaklı mı, bilgisayar/sertifika kaynaklı mı veya GİB bağlantısı kaynaklı mı olduğunun belirlenmesine yardımcı olur.

11. Sorunun kapsamını belirleyin

Hata devam ediyorsa problemin tek bir kullanıcıya, bilgisayara, döneme veya firmaya özgü olup olmadığı kontrol edilmelidir.

Aşağıdaki karşılaştırmalar yapılabilir:

• Aynı işlem başka bir bilgisayarda çalışıyor mu?
• Aynı kullanıcı ile farklı bilgisayarda sorun devam ediyor mu?
• Aynı bilgisayarda farklı kullanıcı ile sorun oluşuyor mu?
• Farklı bir e-Defter döneminde aynı hata oluşuyor mu?
• Aynı dönemde başka bir firma için işlem yapılabiliyor mu?
• Sorun yalnızca belirli bir yevmiye kaydında mı oluşuyor?
• GİB’e erişim başka bir ağ bağlantısından sağlanabiliyor mu?

Bu kontroller sorunun veri, kullanıcı, bilgisayar, ağ veya sunucu kaynaklı olduğunun ayrıştırılmasına yardımcı olur.

Kısaca Kontrol Listesi

Hata 2000 ile karşılaşıldığında:

☐ Sistem tarih ve saati doğru mu?
☐ Saat dilimi UTC+03:00 İstanbul mu?
☐ Sunucu ve istemci tarih/saatleri uyumlu mu?
☐ Mikro/e-Defter sürümü güncel mi?
☐ e-Defter bileşenleri sürümle uyumlu mu?
☐ Sertifika/mali mühür geçerli mi?
☐ İmza bileşenleri ve sürücüleri çalışıyor mu?
☐ İlgili dönem klasörüne okuma/yazma/değiştirme yetkisi var mı?
☐ Klasör yolu kısa ve sade mi?
☐ Türkçe/özel karakter içeren klasör yolları mevcut mu?
☐ XML dosyasında geçersiz karakter var mı?
☐ XML/XSD/şematron kontrolleri başarılı mı?
☐ Yevmiye kayıtlarında belge tipi ve zorunlu alanlar doğru mu?
☐ Yevmiye kayıtlarında uyumsuz karakter bulunuyor mu?
☐ Antivirüs/Defender/Firewall engellemesi var mı?
☐ Aile Güvenliği/Güvenli İnternet/içerik filtrelemesi bağlantıyı engelliyor mu?
☐ GİB servislerine HTTPS/TCP 443 erişimi açık mı?
☐ Proxy/DNS kaynaklı bağlantı problemi var mı?
☐ Sunucu üzerindeki uygulama hesabının gerekli klasör ve ağ erişimleri var mı?
☐ Hata hangi işlem aşamasında oluşuyor?
☐ Hata başka bir bilgisayarda da oluşuyor mu?
☐ Hata başka bir e-Defter döneminde de oluşuyor mu?
☐ Sorun belirli bir yevmiye kaydına bağlı mı?