Logo Muhasebe Programında e-Fatura Gönderirken ‘Şema Kontrolü Başarısız’ Hatası Çözüm Rehberi

Soru: Logo Programında e-Fatura ve e-Arşiv Gönderirken ‘Şema Doğrulama Hatası’ Neden Alınır?

Cevap: Logo Go3, Tiger veya e-Devlet modülleri üzerinden Gelir İdaresi Başkanlığı (GİB) standartlarında e-Fatura veya e-Arşiv faturası kesilip ‘Paketle ve Gönder’ denildiğinde ekrana gelen ‘Şema Kontrolü Başarısız (Schematron Check Failed / XML Validation Error)’ uyarısı faturanın entegratör sunucusuna iletilmesini durdurur. Bu arıza, kesilen faturanın XML veri yapısındaki zorunlu alanlardan birinin boş bırakılması, hatalı karakter içermesi veya GİB in yayımladığı güncel UBL-TR şema standartlarına uymaması sebebiyle faturanın yasal onay mekanizması tarafından reddedilmesidir.

Şema Doğrulamasını Bozan Kritik Hatalar Nelerdir?

GİB schematron kuralları katı bir matematiksel doğrulamaya dayanır ve şu uyumsuzluklarda hata üretir:

• Vergi Kimlik Numarası (VKN) / TCKN Hataları: Şirketler için 10 haneli VKN nin, şahıslar için 11 haneli T.C. Kimlik Numarasının eksik yazılması veya modülo 10 algoritmasını karşılamaması. Yabancı müşterilere kesilen faturalarda standart 2222222222 kuralının işletilmemesi.
• Birim Kodu (Unit Code) Uyuşmazlığı: Faturadaki ürünün biriminin (Adet, Kilogram, Metre) uluslararası UN/ECE standardında olmaması (Örn: Adet için C62 veya NIU, Kilogram için KGM kodunun girilmemiş olması).
• Vergi Muafiyet Sebebi ve Kodu Eksikliği: %0 KDV li (İstisna) bir fatura kesilirken ilgili yasal KDV İstisna Kodunun (Örn: 301, 351 vb.) seçilmemesi veya açıklama alanının boş bırakılması.
• Yasaklı Karakterler: Adres, unvan veya açıklama satırlarında XML standartlarını bozan &, <, > gibi ham karakterlerin bulunması.

1. Adım: Hata Veren XML Düğümünün (Node) Teşhis Edilmesi

Hatanın hangi satırda olduğunu nokta atışı bulmak için:

1. Logo e-Fatura modülünde ilgili faturaya sağ tıklanır ve ‘Görsel İncele / UBL Göster’ seçeneği tıklanır.
2. Açılan hata günlüğü penceresinde kırmızı renkle belirtilen satır etiketi okunur (Örn: Element 'cbc:CityName' is missing veya cvc-pattern-valid: Value '123' is not valid).
3. Yukarıdaki örnekte CityName etiketinin hata vermesi, müşteri cari kartında ‘Şehir / İlçe’ alanının tamamen boş bırakıldığını gösterir.

2. Adım: Cari Kart ve Malzeme Kartı Parametrelerini Onarma

Teşhis edilen eksiklik Logo arayüzünden düzeltilir:

Düzeltme Adımları:
1. Ana Menü > Satış ve Dağıtım > Cari Hesaplar: İlgili müşterinin kartı açılır; Posta Kodu, Vergi Dairesi, Ülke (Türkiye), Şehir ve İlçe bilgileri eksiksiz doldurulur.
2. Stok / Malzeme Kartları: Faturadaki ürünün kartına girilir; 'Birimler' sekmesinde Ana Birimin evrensel e-Fatura birim kodu eşleştirmesi doğrulanır.
3. Fatura ekranına geri dönülür; fatura içine girilip 'F9 > Detaylar' penceresinden vergi muafiyet kodu teyit edilir ve kaydedilir.

3. Adım: Faturayı Yeniden Şematron Testinden Geçirme

Fatura tekrar seçilir, sağ tıklanıp ‘Durum Değiştir > Gönderilecek’ yapılır ve ardından ‘Zarf Ekle / Şema Kontrolü Yap’ butonuna basılır. Yeşil renkli ‘Şema Doğrulandı’ mesajı alındığı anda fatura GİB e sorunsuz teslim edilir.

Logo e-Fatura, e-İrsaliye, e-Defter geçiş süreçleri ve özel entegratör hata çözümlerinde BaykalSoft E-Dönüşüm Danışmanlığı birimimizle iletişime geçebilirsiniz.