Hata Çözümleri · 14 dk okuma · 10 Eylül 2026 · Güncelleme 9 Eylül 2026

Şematron Kontrolünden Geçemedi Hatası Nasıl Çözülür?

Şematron hatasını çözmek için hata mesajını XML alanıyla eşleştirin, kaynak kaydı düzeltin ve yeniden gönderimden önce belge durumunu doğrulayın.

efaturakontor.com Editör Ekibie-Fatura & kontör uzmanlığı · İçerik mevzuat değişikliklerine göre güncellenir
Kısa cevap

Şematron kontrolünden geçemedi hatası, kaynak alan düzeltilip XML yeniden doğrulanarak çözülür. Bu hata, e-belge XML dosyasındaki bilgilerin ticari ve teknik kurallardan birini karşılamadığını gösterir. Hata, XML yapısı doğru görünse bile fatura türü, vergi, alıcı veya toplam alanlarındaki uyumsuzluk nedeniyle oluşabilir.

Şematron kontrolünden geçemedi hatası, kaynak alan düzeltilip XML yeniden doğrulanarak çözülür. Bu hata, e-belge XML dosyasındaki bilgilerin ticari ve teknik kurallardan birini karşılamadığını gösterir. Hata, XML yapısı doğru görünse bile fatura türü, vergi, alıcı veya toplam alanlarındaki uyumsuzluk nedeniyle oluşabilir.

Bu rehber, Şematron Kontrolünden Geçemedi Hatası Nasıl Çözülür? Neden Olur, Adım Adım Çözüm aramasını yapan işletme sahipleri, muhasebe çalışanları ve mali müşavirler için hazırlanmıştır. Her adım, hatayı bulmayı ve tekrar gönderimden önce doğrulamayı amaçlar.

Şematron kontrolünden geçemedi hatası ne anlama gelir?

Şematron kontrolünden geçemedi hatası, e-fatura XML içeriğinin tanımlı iş kurallarından en az birine uymadığı anlamına gelir. Sistem, belgeyi alıcıya iletmeden veya kabul sürecine taşımadan önce bu kuralları otomatik denetler.

XML şeması, dosyanın teknik yapısını ve veri tiplerini kontrol eder. Şematron ise alanların birbiriyle anlamlı ilişki kurup kurmadığını inceler. Bu nedenle XML dosyası açılabilirken yine de şematron doğrulamasından başarısız olabilir.

Şematron, XML belgesindeki alan ilişkilerini tanımlı iş kurallarıyla sınayan doğrulama yöntemi demektir. Örneğin istisna seçimi, ilgili kodun bulunmasını gerektiren bir denetimi tetikleyebilir; dosyanın açılması yeterli değildir.

Örneğin bir faturada satır tutarları doğru biçimde yazılmış olabilir. Ancak vergi toplamı, belge toplamı veya seçilen fatura profiliyle uyuşmuyorsa sistem şematron hatası üretebilir. Hesap ilişkisini ayrıca inceleyin.

Bu hata, her zaman vergi hesabının kesinlikle yanlış olduğunu göstermez. Alanın boş kalması, yanlış kodla gönderilmesi veya başka bir alanla çelişmesi de aynı sonucu doğurabilir.

Hata mesajında alan adı, kural açıklaması, XML yolu veya satır bilgisi bulunabilir. Bu bilgiler, bütün faturayı baştan incelemek yerine belirli bir alana odaklanmanızı sağlar. İncelemeyi buradan başlatın.

Belge taslak durumundaysa düzeltme doğrudan taslak üzerinde yapılabilir. Belge gönderimden sonra hata aldıysa yeni XML oluşturmak veya ERP kaydındaki kaynak alanı düzeltmek gerekebilir. Önce işlem durumunu doğrulayın.

Her teknik ret şematron hatası değildir. Şema doğrulaması, elektronik imza veya iletim sorunları ayrı inceleme gerektirir. Önce hatanın hangi doğrulama aşamasında üretildiğini belirleyin; uygun çözüm ancak bundan sonra seçilebilir.

Önce hata mesajının tamamını kaydedin, sonra ilgili faturanın belge türünü ve XML içeriğini karşılaştırın. Emin olunmayan vergi veya senaryo konularında güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

Şematron kontrolünden geçemedi hatası neden oluşur?

Şematron kontrolünden geçemedi hatası çoğunlukla eksik zorunlu alan, yanlış kod, tutarsız toplam veya uygun olmayan belge senaryosu nedeniyle oluşur. Aynı hata metni, farklı veri sorunlarını açıklayabildiği için ayrıntılı mesaj incelenmelidir.

ERP veya portal ekranındaki alanlar, XML içindeki karşılıklarına otomatik olarak dönüştürülür. Ekranda doğru görünen bir değer, dönüşüm sırasında boş kalabilir veya beklenen kod listesi dışında gönderilebilir.

  • Fatura profili, belge türü veya senaryo alanı işlemle uyumlu seçilmemiş olabilir.
  • Alıcının vergi kimlik bilgisi, adresi veya elektronik posta bilgisi eksik gönderilmiş olabilir.
  • Satır miktarı, birim fiyatı, iskonto tutarı ve satır toplamı birbirini doğrulamıyor olabilir.
  • Vergi türü, vergi oranı, muafiyet kodu veya tevkifat bilgisi yanlış eşleştirilmiş olabilir.
  • Belge tarihi, para birimi, kur bilgisi veya dönem alanı beklenen formatta olmayabilir.
  • Fatura numarası, UUID veya belge kimliği daha önce kullanılmış ya da hatalı üretilmiş olabilir.
  • Kimlik numarasının türü ile gönderilen değer arasında VKN veya TCKN uyumsuzluğu bulunabilir.
  • ERP entegrasyonundaki eski alan eşlemesi, güncel belge kuralına uygun XML üretmiyor olabilir.

Örneğin bir markette yalnızca yeni açılan stok kartlarının faturaları hata veriyorsa birim ve vergi eşlemesini karşılaştırın. Bütün belgeler etkileniyorsa ortak entegrasyon ayarlarını ve son güncellemeyi araştırın.

Hatanın kaynağı bazen faturanın içeriği değil, gönderim ortamıdır. Test ortamı ile gerçek ortamın tanımları, kullanıcı yetkileri veya cari kart eşleşmeleri farklı çalışabilir. Ancak yetki ve bağlantı hataları tek başına şematron ihlali sayılmaz.

Tekrar tekrar gönderim yapmak sorunu çözmez; her denemede aynı hatalı XML üretilebilir. Önce kaynak kaydı düzeltin, ardından yeni doğrulama çalıştırın ve gönderim sonucunu yeniden inceleyin.

Şematron hata mesajı ve hata kodu nasıl okunur?

Şematron hata mesajı, önce kuralın hangi alanı veya ilişkiyi denetlediğini belirleyerek okunmalıdır. Mesajın yalnızca ilk satırına değil, alan yolu, satır numarası ve açıklama bölümüne de bakın.

  1. Hata kodunu, tam açıklamayı ve varsa XML yolunu aynı dosyada kaydedin.
  2. Mesajdaki alanı portal veya ERP ekranında bulun ve ham XML karşılığını açın.
  3. İlgili alanın boş, yanlış kodlu veya başka bir toplamla çelişkili olup olmadığını inceleyin.
  4. Alanı oluşturan cari, stok, vergi ve belge ayarlarının kaynak kaydını kontrol edin.
  5. Değişiklikten sonra XML yeniden oluşturun ve yeni doğrulama sonucunu karşılaştırın.
  6. Hata sürerse XML ile hata ekranını birlikte entegratör desteğine iletin.

Mesajda bir XPath veya hiyerarşik alan yolu varsa, bu yol XML içindeki konumu gösterir. Böylece örneğin alıcı bilgisine mi, satır bilgisine mi, toplam bölümüne mi bakacağınız anlaşılır.

Örneğin hata mesajı cbc:InvoiceTypeCode alanını gösteriyorsa önce XML'deki fatura türü koduna bakın. cbc:ProfileID ise profil bilgisini temsil eder. Bu iki alanı birbirinin yerine değiştirmeyin; mesajdaki kuralı ilgili belge kılavuzuyla karşılaştırarak düzeltmeyi belirleyin ve yeni sonucu kaydedin.

Bazı ekranlar yalnızca genel bir şematron açıklaması gösterir. Bu durumda fatura türünü, profil bilgisini ve en son değiştirilen alanları birlikte incelemek gerekir. Ayrıntılı doğrulama raporunu destekten isteyin.

Yanlış: Hata kodunu görmeden faturanın bütün alanlarını rastgele değiştirmek çözüm sayılır. Doğru: Önce hatanın işaret ettiği alanı belirlemek, sonra ilgili kaynak veriyi kontrollü biçimde düzeltmektir.

Birden fazla hata varsa ilk hatayı düzeltip belgeyi yeniden doğrulayın. İlk kuralın düzeltilmesi, sonraki hataların görünür hale gelmesini sağlayabilir. Her denemede değişen alanları ayrıca not edin.

Fatura türü ve senaryo bilgisi şematron kontrolünü nasıl etkiler?

Fatura türü ve senaryo bilgisi, şematron kontrolünün beklediği alanları doğrudan belirler. E-Fatura, e-Arşiv Fatura, ihracat veya özel işlem senaryoları aynı alan kombinasyonunu kullanmayabilir. Kodları ayrıca doğrulayın.

Önce alıcının elektronik belge kapsamını ve işlem türünü doğrulayın. Ardından portalda veya ERP kaydında belge türü, profil ve senaryo seçimlerinin aynı işleme işaret ettiğini kontrol edin.

Profil, e-belgenin uygulanacağı işlem akışını tanımlayan kod bilgisi demektir. Fatura türü ise satış, iade veya başka işlem niteliğini belirtir. Bu nedenle profil ile tür aynı alan değildir.

e-Fatura düzenlerken alıcının kayıtlı kullanıcı bilgisi, alias ve kimlik numarası önem taşır. e-Arşiv sürecinde ise alıcıya ilişkin farklı bilgi akışı bulunabilir; ilgili ayrımı e-Arşiv Fatura açıklamasında da kontrol edebilirsiniz.

Yanlış: İşlem e-Fatura olarak düzenlenecekken yalnızca alıcının e-posta adresini yazarak e-Arşiv seçmek her durumda doğrudur. Doğru: Alıcının kayıt durumu ve işlemin hukuki niteliği kontrol edilerek uygun belge türü seçilmelidir.

Yanlış: Temel veya ticari profil seçimini yalnızca müşterinin isteğine göre değiştirmek yeterlidir. Doğru: İşlem akışı, yanıt beklentisi ve işletmenin muhasebe süreciyle uyumlu profil kullanılmalıdır. Seçimi kayda geçirin.

Fatura türünü değiştirmek, önceki belgenin bütün alanlarını otomatik olarak düzeltmez. Belgeyi yeni türle oluşturduktan sonra satır, vergi, alıcı ve toplam bölümlerini yeniden doğrulayın. Kopyalanan alanları atlamayın.

Örneğin iade faturası hazırlayan bir market, önceki satış taslağını kopyaladığında eski tür kodunu taşıyabilir. İade bağlantılarını kontrol etmeden yalnızca başlığı değiştirmek, XML içeriğinin doğru oluşmasını sağlamaz.

Hangi senaryonun uygulanacağından emin değilseniz mali müşavirinizden işlem bazında görüş alın. Teknik ekran açıklamaları için e-Fatura ürün sayfasındaki kapsam bilgilerini ve güncel GİB duyurularını karşılaştırın.

Vergi ve KDV alanları şematron kontrolünde nasıl düzeltilir?

Vergi ve KDV alanları, satır hesapları ile belge toplamlarının birbirini doğrulaması sağlanarak düzeltilir. Vergi tutarı, vergi matrahı, oran, muafiyet ve tevkifat bilgilerinin işlemle uyumlu olması gerekir.

Önce her satırın miktar, birim fiyat ve iskonto sonrası tutarını kontrol edin. Ardından satırların vergi matrahlarını toplayın ve belge genelindeki vergi toplamıyla karşılaştırın. Hesaplamayı satırlardan başlatın.

Örneğin üç ürünün vergisiz birim fiyatı 200 TL ise başlangıç tutarı 600 TL'dir. Satırda 60 TL iskonto varsa net tutar 540 TL olur; hesaplanan vergi bu matrahla karşılaştırılmalıdır.

Bu örnek, yalnızca basit satır iskontosunu anlatır. Belge geneli iskontolar, ek bedeller veya tevkifat varsa hesap zinciri ayrıca kurulmalıdır. Sabit bir toplam formülünü bütün işlem türlerine uygulamayın.

Vergiden istisna bir işlemde yalnızca oranı sıfırlamak yeterli olmayabilir. Uygun muafiyet kodu veya açıklaması gerekiyorsa, bu alanların mevzuata ve işlem türüne göre doldurulması gerekir. Gerekçeyi mutlaka doğrulayın.

Tevkifat bulunan belgelerde normal vergi toplamı, tevkifat tutarı ve ödenecek toplam ayrı ilişkiler kurabilir. ERP ayarındaki tevkifat kodu ile faturadaki işlem bilgisinin aynı olduğundan emin olun.

Yanlış: Kuruş farkını gidermek için toplam vergi tutarını elle değiştirmek her zaman güvenlidir. Doğru: Yuvarlama ayarını, satır hesaplarını ve XML üretim kuralını birlikte kontrol ederek farkın kaynağını düzeltmektir.

Para birimi yabancıysa kur alanı ve para birimi kodu da incelenmelidir. Ekrandaki Türkçe gösterim ile XML içindeki sayısal değerlerin aynı hesaplamayı temsil edip etmediğini kontrol edin.

KDV oranı, istisna veya tevkifat uygulamasının güncel mevzuata uygunluğu konusunda rakam ezberine güvenmeyin. Mevzuat ve uygulama bilgileri yıllık güncellenebildiği için güncel GİB duyurusunu ve mali müşavirinizi kontrol edin.

Cari ve alıcı bilgileri şematron kontrolünden neden geçmez?

Cari ve alıcı bilgileri, kimlik numarası, kimlik türü, adres ve elektronik belge kayıtları birbiriyle eşleşmediğinde şematron kontrolünden geçmeyebilir. Alıcı kartındaki tek bir eski bilgi, XML içinde tutarsızlık oluşturabilir.

Önce alıcının VKN veya TCKN bilgisini resmi cari kayıttan doğrulayın. Ardından bu numaranın XML içinde doğru kimlik türüyle ve beklenen alıcı tarafı alanında yer aldığını kontrol edin.

E-Fatura alıcısında kayıtlı kullanıcı sorgusu, alias ve şirket unvanı birbirini desteklemelidir. Unvanın ekranda farklı görünmesi her zaman hata değildir; asıl önemli olan kimlik ve sistem eşleşmesidir.

Alias, e-Fatura iletiminde kullanılan elektronik posta kutusu etiketi demektir. Normal e-posta adresiyle aynı bilgi değildir. Alıcının birden fazla etiketi bulunuyorsa işlem için kullanılacak etiketi karşı tarafla doğrulayın ve güncel kayıtlı kullanıcı sorgusuyla karşılaştırın.

Adres, il, ilçe, ülke, posta kodu veya sokak bilgileri belge türüne ilişkin kurallar kapsamında zorunlu olabilir. Eksik adresi rastgele tamamlamak yerine müşteriden güncel resmi bilgileri isteyin.

Örneğin bir eczane, ilaç tedarikçisine e-fatura gönderirken eski cari karttaki VKN bilgisini kullanırsa sistem alıcı eşleşmesi hatası verebilir. Eczane, yeni cari kart açmadan önce tedarikçinin güncel bilgilerini doğrulamalıdır. İade işlemlerinde de aynı kontrol gerekir.

Yanlış: Cari kartta kayıtlı e-posta adresinin doğru olması, VKN ve alias bilgisinin de doğru olduğunu kanıtlar. Doğru: Kimlik, kayıt durumu, adres ve elektronik belge bilgilerinin ayrı ayrı doğrulanmasıdır.

Alıcı bilgisi hatası sürerse faturayı yeniden göndermeden önce karşı işletmeden güncel unvan, vergi numarası ve kayıtlı elektronik belge bilgilerini alın. Çelişki varsa mali müşavirinizle ve entegratörünüzle birlikte ilerleyin.

Tarih, numara ve XML alanları nasıl kontrol edilir?

Tarih, numara ve XML alanları; belge tarihi, fatura numarası, UUID, para birimi ve sayısal biçim açısından birlikte kontrol edilir. Bu alanlar, belgenin kimliğini ve hesaplamaların nasıl yorumlanacağını belirler.

Belge tarihi ile ERP kayıt tarihi farklı olabilir, fakat XML üretim kuralı beklenen tarih biçimini kullanmalıdır. Tarih alanının boş, gelecek dönemle uyumsuz veya hatalı biçimde gönderilmediğini kontrol edin.

Fatura numarası daha önce kullanılmışsa belge kimliği çakışabilir. UUID veya benzeri benzersiz kimlik alanının her yeni belge için doğru üretildiğini ve kopyalanmış taslaktan taşınmadığını inceleyin.

XML içindeki sayısal alanlarda ondalık ayracı, negatif değer, boş alan ve gereksiz karakter kullanımı sorun çıkarabilir. Portalda görülen 1.250 değeri, XML içinde 1250 veya 1.25 olarak farklı anlamlara dönüşebilir.

Kontrol alanıBakılacak bilgiTipik sorunİlk işlem
Belge tarihiİşlem ve dönem bilgisiBoş veya uyumsuz tarihKaynak kaydı doğrulayın.
Fatura numarasıSeri ve sıra bilgisiTekrar eden numaraNumara kuralını inceleyin.
UUIDBenzersiz belge kimliğiKopyalanmış kimlikYeni XML üretin.
Para birimiBelge ve satır para birimiUyumsuz kodKur ayarını kontrol edin.
Sayısal biçimMiktar, fiyat ve toplamOndalık dönüşüm hatasıHam XML değerini inceleyin.

UUID, e-belgeyi ayırt eden benzersiz kimlik demektir. Aynı belgenin teknik yeniden iletiminde kimliği gelişigüzel değiştirmeyin. Yeni belge düzenlenip düzenlenmeyeceğini, mevcut işlem durumu ve entegratörün yeniden gönderim yöntemi belirler. Tablodaki öneriyi mevcut belge durumuyla birlikte değerlendirin.

İşletme yazılımındaki ekran ile ham XML arasında fark varsa sorunu XML üreten eşlemede arayın. Özellikle kopyalanan taslaklar, manuel değiştirilen numaralar ve farklı para birimli faturalar dikkat gerektirir.

Şematron kontrolünden geçemedi hatası e-fatura portalında nasıl çözülür?

Şematron kontrolünden geçemedi hatası, portalda önce hata detayından okunur, sonra taslak veya kaynak kayıt düzeltilerek yeniden doğrulanır. Portalın menü adları değişebilse de izlenen mantık genellikle aynıdır.

İlk olarak giden kutusu, taslaklar veya hata alan belgeler bölümünden ilgili faturayı açın. Belgenin durumunu ve hata kodunu kaydetmeden yeni bir kopya oluşturmayın; aksi halde hangi kaydın sorunlu olduğu karışabilir.

Portal düzenlemeye izin veriyorsa hatalı alanı düzeltin ve belgeyi kaydedin. Düzenleme mümkün değilse, kaynak ERP kaydını düzelterek yeni bir taslak oluşturun; eski hatalı belgeyi başarılı gönderilmiş gibi işaretlemeyin.

Yeni taslakta belge türü, alıcı bilgisi, satır tutarları, vergi alanları ve toplamları yeniden kontrol edin. Ardından portalın doğrulama veya ön izleme adımını çalıştırın. Ön izleme tek başına teknik doğrulama değildir.

Doğrulama tamamlanmadan gönderim düğmesine tekrar tekrar basmayın. Gelen ve giden belgelerin her biri 1 kontör düşürdüğü için, hatalı belgeyi düzeltmeden yapılan tekrarlı denemeleri panelinizden ayrıca takip edin. Her başarısız denemenin ayrıca kontör düşürdüğü varsayılmamalıdır.

Portal kullanırken alanın hangi XML etiketine dönüştüğünü göremiyorsanız hata ekranının görüntüsünü ve belge numarasını kaydedin. Gerekirse sık sorulan sorular sayfasındaki ilgili açıklamaları ve entegratör desteğini inceleyin.

Ücretsiz e-fatura portalı kullanılıyorsa taslak, gelen kutusu ve giden kutusu ayrımını özellikle kontrol edin. Belgenin saklanması, gönderilmesi ve şematron doğrulamasından geçmesi farklı işlemlerdir. Sonucu ayrı izleyin.

İmzalanmış XML dosyasını metin düzenleyicide değiştirip yeniden yüklemeyin; içerik değişikliği imzayı geçersiz kılabilir. Gönderim sonucu belirsizse önce durum sorgulayın. Belge başarılı işlenmişse taslak düzeltme yerine, işlem türüne uygun iptal veya itiraz sürecini değerlendirin.

Gelen ve giden belgelerde şematron hatası nasıl ayrılır?

Giden belgede şematron hatasının ilk sorumluluk noktası, faturayı oluşturan işletmenin ERP veya portal kaydıdır. Gelen belgede görülen benzer hata ise çoğunlukla gönderen sistemin ürettiği XML ile ilgilidir.

Giden faturada gönderen taraf; alıcı kimliği, belge profili, vergi alanları ve toplamları düzeltmelidir. Belge alıcıya ulaşmadan hata alıyorsa alıcıdan yanıt beklemek yerine kendi kaynak kaydınızı inceleyin.

Gelen belgede alıcı taraf XML içeriğini değiştiremez. Belge hiç ulaşmadıysa gönderen işletmenin veya onun özel entegratörünün hatayı düzeltmesi gerekir. Alıcıdaki görüntüleme sorunu ise ayrıca değerlendirilmelidir.

Gelen belgenin durumunu, gönderenin bildirdiği hata ile karıştırmayın. Sistem durumu, uygulama yanıtı, ticari yanıt ve teknik doğrulama aynı anlama gelmez. İlgili durumun açıklamasını kendi sisteminizden doğrulayın.

Bir tedarikçinin faturası sürekli hatalı geliyorsa hata ekranını, belge numarasını ve gönderen bilgilerini saklayın. Tedarikçiden XML doğrulamasını yenilemesini ve kendi entegratöründen teknik inceleme istemesini talep edin.

Örneğin bir market, tedarikçiden PDF aldığında faturanın elektronik iletiminin tamamlandığını varsaymamalıdır. Önce belge numarasıyla kendi gelen kutusunu sorgulamalı, ardından tedarikçiden gönderim durumunun ayrıntısını yazılı olarak istemelidir.

Belge gelen kutusundaysa fakat muhasebe aktarımı başarısızsa, sorun yerel içe aktarma eşlemesinde olabilir. Bu karşı durumda tedarikçiden yeni fatura istemek yerine, alınan XML ile aktarım günlüğünü karşılaştırın.

e-Arşiv belgelerinde alıcı kutusu ve e-Fatura gelen kutusu aynı çalışma mantığına sahip değildir. Belge türünü önce doğrulayın; gerekli ayrım için e-Arşiv Fatura bilgilerini inceleyin. Kutu adlarına güvenmeyin.

Gelen ve giden işlemde kontör düşümü, belge akışının teknik hata durumuyla karıştırılmamalıdır. Kontör hareketini panelden izleyin ve hata devam ederken aynı içeriği gereksiz biçimde yeniden göndermeyin.

ERP ve özel entegratör kaynaklı şematron hatası nasıl çözülür?

ERP veya özel entegratör kaynaklı şematron hatası, aynı faturanın portalda manuel oluşturulduğunda geçip ERP’den üretildiğinde kalmasıyla anlaşılabilir. Bu durumda kaynak verinin yanında alan eşlemesi veya XML üretim kuralı incelenmelidir. Portal varsayılanlarının aynı olup olmadığını da araştırın.

Önce ERP sürümü, belge profili, vergi kodu eşlemesi ve cari kart aktarımını kontrol edin. Eski bir entegrasyon kuralı, portalda zorunlu hale gelen bir alanı XML içine hiç yazmayabilir.

Test ve gerçek ortam ayarlarını karşılaştırın. Kullanıcı, şirket, şube, seri, vergi tanımı veya alıcı alias bilgisi yalnızca bir ortamda güncellenmişse hata sadece belirli belgelerde görülebilir.

Alan eşlemesi, kaynak verinin XML etiketine nasıl aktarılacağını belirleyen tanım demektir. Örneğin stok birimi değişmişken aktarım tablosu eski kodu kullanabilir. Düzeltmeden sonra aynı senaryoyu doğrulama ortamında çalıştırın; sorunsuz bir belge türünü de sınayarak değişikliğin etkisini kontrol edin.

Uzman notu: Destek kaydına yalnızca hata ekranını değil, belge numarasını, işlem zamanını, XML yolunu ve mümkünse hatalı alanın kaynak değerini ekleyin. Karşılaştırmayı gerçek alıcıya deneme faturası göndermeden yapın.

Aynı veriyle manuel portal faturası başarılı, ERP faturası başarısızsa iki XML çıktısını karşılaştırın. Farklı olan alan, entegrasyon sağlayıcısına aktarılacak ilk teknik inceleme noktasıdır. Karşılaştırılan taslakları gerçek gönderime açmayın.

Her iki ortamda da aynı hata oluşuyorsa önce belge içeriğini, mevzuata uygun senaryoyu ve vergi hesabını inceleyin. Teknik destek, yanlış ticari tercihi tek başına düzeltemez.

Destek talebinde müşteri bilgilerini gereksiz biçimde paylaşmayın. Ancak hata kodu, XML alan yolu, belge türü, gönderim zamanı ve kullanılan ortam bilgisi teknik teşhis için yeterli olabilir.

Şematron kontrolü için hangi gönderim öncesi kontrol listesi kullanılmalı?

Gönderim öncesi kontrol listesi, şematron hatalarını belge gönderilmeden önce yakalamak için kullanılır. Liste, yalnızca muhasebe çalışanının değil, faturayı oluşturan satış veya operasyon personelinin de anlayacağı alanlardan oluşmalıdır.

  • Belgenin e-Fatura veya e-Arşiv türünün işlemle uyumlu seçildiğini doğrulayın.
  • Alıcının VKN veya TCKN, unvan, adres ve elektronik belge bilgilerinin güncel olduğunu kontrol edin.
  • Belge profili ve senaryo seçiminin işlem türüyle çelişmediğini inceleyin.
  • Her satırda miktar, birim, fiyat, iskonto ve satır toplamının birlikte hesaplandığını doğrulayın.
  • Vergi türü, oran, muafiyet veya tevkifat alanlarının mali müşavir onaylı bilgiyle eşleştiğini kontrol edin.
  • Belge ve satır para birimi ile varsa kur bilgisinin aynı hesaplamayı gösterdiğini inceleyin.
  • Vergi toplamı, genel toplam ve ödenecek tutarın satır hesaplarıyla uyumlu olduğunu doğrulayın.
  • Fatura numarası ve UUID bilgilerinin daha önce kullanılan bir belgeyle çakışmadığını kontrol edin.
  • Şüpheli bir mevzuat veya senaryo durumunda gönderimden önce güncel GİB duyurusunu inceleyin.

Örneğin küçük bir kafe, kurumsal müşterisine e-fatura düzenlerken önce müşterinin kayıt durumunu kontrol etmelidir. Sonra kahve, yiyecek ve hizmet satırlarının vergi bilgilerini ayrı ayrı doğrulamalıdır.

Kafedeki görevli yanlışlıkla muafiyet seçerse yalnızca oranı değiştirmek yeterli olmayabilir. İşlem gerçekten muaf değilse kaynak ayar düzeltilmeli, doğru vergi bilgisi mali müşavirle teyit edilmelidir. Şablonu da güncelleyin.

Kontrol listesi, hukuki inceleme veya teknik doğrulamanın yerine geçmez. Kafe sorumlusu kontrol tarihini ve düzeltilen alanı kaydetmelidir. Böylece aynı hatanın sonraki vardiyada yeniden oluşup oluşmadığı somut kayıtlarla izlenebilir.

Listeyi her gönderimde uygulamak zamanla standart işlem haline gelir. Özellikle yeni personel, yeni şube veya yeni ERP tanımı kullanıldığında kontrol listesi atlanmamalıdır. Sonucu kayda geçirin.

Özet: 5 maddede şematron kontrolünden geçemedi hatası çözümü

Şematron kontrolünden geçemedi hatası, hata mesajı okunup ilgili XML alanı, kaynak kayıt ve belge senaryosu birlikte düzeltilerek çözülür. Rastgele yeniden gönderim yerine aşağıdaki beş adımı izleyin.

  • Hata kodunu, açıklamasını, XML yolunu ve ilgili belge numarasını birlikte kaydedin.
  • Fatura türünü, profili, alıcı kimliğini ve senaryoyu işlemin gerçek niteliğiyle karşılaştırın.
  • Satır tutarlarını, vergi hesaplarını, para birimini ve genel toplamı yeniden doğrulayın.
  • Tarih, numara, UUID ve sayısal XML biçiminin beklenen alan kurallarına uyduğunu kontrol edin.
  • Hata sürerse XML çıktısını, kaynak ERP kaydını ve ekran görüntüsünü entegratör desteğine iletin.

Bu adımlar, hem giden e-fatura hatalarını hem de hatalı gelen belge bildirimlerini ayırmanıza yardımcı olur. Alıcı tarafın değiştiremeyeceği XML sorunlarında gönderen işletmeyle koordinasyon kurun. Durumu birlikte doğrulayın.

Örneğin hatası giderilen bir market faturasında kapanış ölçütü yalnızca ön izlemenin açılması değildir. Yeni doğrulamanın başarılı olması ve gönderim durumunun ayrıca teyit edilmesi gerekir. Sonuç beklemedeyse ikinci fatura düzenlemeyin; mevcut belge üzerinden durum sorgusunu sürdürün.

Vergi oranı, istisna, tevkifat veya belge senaryosu konusunda kesin bilgi bulunmuyorsa güncel GİB duyurusunu ve mali müşavirinizi kontrol edin. Yıllık güncellenen mevzuat bilgileri, eski uygulama notlarıyla karıştırılmamalıdır.

Teknik destek için hata kodunu saklayarak iletişim kanalından başvurabilir, gönderim öncesi belge kontrollerini işletmenizin standart sürecine ekleyebilirsiniz. Başvuruda daha önce denediğiniz düzeltmeleri sırasıyla açıkça belirtin.

İhtiyaç duyarsanız efaturakontor.com'da e-Fatura, e-Arşiv, e-İrsaliye, e-SMM, e-MM ve e-Bilet belgelerinde geçerli 100'den 500.000 kontöre kadar havuz paketlerini inceleyebilirsiniz. Ücretsiz e-fatura portalı, Sovos altyapısına aynı gün tanımlama ve 12-18 ay kullanım süresi seçenekleriyle sunulur.

Sık Sorulan Sorular

Şematron kontrolünden geçemedi hatası ne demektir?

Şematron kontrolünden geçemedi hatası, e-belge XML içeriğinin tanımlı iş kurallarından birine uymadığını gösterir. XML dosyası teknik olarak açılabilir; ancak vergi toplamı, alıcı bilgisi, fatura profili, tarih veya senaryo alanları birbirini doğrulamıyor olabilir. Hata kodunu ve XML alan yolunu inceleyerek hangi bilginin düzeltilmesi gerektiğini belirleyin. Dosyanın açılması veya ön izlemenin görünmesi, şematron doğrulamasının başarılı olduğunu kanıtlamaz.

Şematron kontrolünden geçemedi hatası neden oluşur?

Hata genellikle eksik zorunlu alan, yanlış fatura senaryosu, uyumsuz VKN veya TCKN bilgisi, hatalı vergi kodu, toplam tutar farkı, para birimi sorunu ya da tekrar eden belge kimliği nedeniyle oluşur. Portal ekranında doğru görünen bir veri, ERP'den XML'e dönüşürken boş veya farklı kodla gönderilebilir. Bu nedenle kaynak kaydı da kontrol edilmelidir. Mükerrerlik, yetki ve iletim hatalarının şematron ihlalinden farklı olabileceğini unutmayın; ayrımı tam hata açıklamasından yapın.

Şematron hata kodu nasıl okunur ve düzeltilir?

Önce hata kodunu, tam açıklamayı ve varsa XML yolunu kaydedin. Mesajın işaret ettiği alanı portal veya ERP ekranında bulun, ham XML karşılığını inceleyin ve alanı oluşturan cari, vergi veya belge ayarını düzeltin. XML'i yeniden oluşturup doğrulayın. Hata sürerse belge numarası ve XML alan bilgisiyle özel entegratör desteğine başvurun. Gönderim sonucu belirsizse yeniden iletimden önce belge durumunu sorgulayın; yeni kimlik üretmek tek başına çözüm değildir.

E-Fatura ve e-Arşiv senaryosu şematron hatasına neden olur mu?

Evet, yanlış belge türü veya profil seçimi şematron hatasına neden olabilir. E-Fatura alıcının kayıt durumu, alias bilgisi ve işlem senaryosuyla birlikte değerlendirilir. e-Arşiv akışı aynı değildir. Belgeyi göndermeden önce alıcının elektronik belge kapsamını, işlem türünü ve seçilen senaryoyu kontrol edin; emin değilseniz mali müşavirinizden görüş alın. İade gibi özel işlemlerde kopyalanan taslağın alanlarını da yeniden doğrulayın.

Gelen e-faturada şematron kontrolü hatası varsa alıcı ne yapmalı?

Gelen belgenin XML içeriğini alıcı taraf genellikle değiştiremez. Belge ulaşmadan hata oluştuysa gönderen işletmenin ERP veya özel entegratör kaydını düzeltmesi gerekir. Hata ekranını, belge numarasını ve gönderen bilgilerini saklayıp karşı tarafa iletin. Gelen kutusu durumu ile teknik doğrulama mesajını birbirine karıştırmayın. Belge kutuda görünmesine rağmen muhasebe aktarımı başarısızsa, sorun alıcının yerel eşlemesinde olabilir; bu durumda aktarım günlüğü de incelenmelidir.

Şematron hatası düzelmiyorsa entegratöre hangi bilgiler gönderilmeli?

Destek kaydına hata kodunu, tam hata açıklamasını, belge numarasını, işlem zamanını, belge türünü, kullanılan ortamı ve varsa XML alan yolunu ekleyin. Hatalı alanın ERP ekranındaki kaynak değerini de belirtin. Mümkünse çalışan bir belge ile hatalı belge arasındaki farkı paylaşın; gereksiz kişisel veya ticari verileri göndermeyin. Karşılaştırma için gerçek alıcıya deneme faturası göndermeyin; taslak çıktılarından veya doğrulama ortamından yararlanın.

Kontöre mi ihtiyacınız var?

Tüm e-belgelerde geçerli havuz kontör, ücretsiz portal, aynı gün tanımlama. Sovos altyapısı.

Paketleri Gör
WhatsApp Hemen Ara