e-Fatura XML Kontrol – Hataları Göndermeden Bul

XML ya da ZIP dosyasını bırak; zorunlu alanlar, kimlik numaraları, KDV ve toplamlar tek tek denetlenir, her bulgu satır numarasıyla gösterilir. Dosya cihazından çıkmaz.

XML girer, ✓ çıkar
En fazla ⁦25 MB⁩
Üyeliksiz
Cihazında çalışır

53 e-Fatura XML Kontrol

01 Seç
02 İşle
03 İndir

Cihazında işlenir · yükleme yok

XML

Seçilen dosya

Boyut: Hazır

Canlı durum

Dosya okunuyor

Sonuç

Rapor hazır.

0belge kontrol edildi

0 BSunucuya gönderilen verin: 0 bayt · işlem cihazında yapıldıNeden 0: bu sayfanın güvenlik kuralı veri göndermeyi tarayıcı düzeyinde engeller; işlem bu sekmede yapılır. CSP · connect-src 'none' · form-action 'none'

Dönüştürülemedi.

Bu bir ön kontroldür: GİB onayı ya da imza doğrulaması değildir. Faturan hiçbir yere gönderilmez.

XML ya da ZIP bırak. Her belge için hata, uyarı ve bilgi notlarını satır numarası ve öğe yoluyla gösterir; kuralın kaynağını da yazar.

İşlem bu sekmede, cihazında yapılır.
Hata çıkmaması GİB'de kabul edileceği anlamına gelmez; imza doğrulanmaz.
Hiçbir dosya sunucumuza gönderilmez; sekmeyi kapatınca her şey silinir.

Önce bir .xml ya da .zip dosyası seç

Aşamalar

Dosya okunuyor
Faturalar denetleniyor
Dosya hazırlanıyor

Sırada ne var?

Faturayı PDF'e çevir

Dosyan cihazından çıkmaz
Sunucuya yükleme yok
Ücretsiz, üyeliksiz

e-Fatura XML kontrolü neyi gösterir, neyi göstermez?

e-Fatura, e-Arşiv ve e-İrsaliye belgelerinin aslı UBL-TR biçiminde bir XML dosyasıdır. Muhasebe programında, ERP'de ya da elle hazırlanan XML'deki küçük bir hata (yanlış fatura numarası biçimi, eksik muafiyet kodu, tutmayan bir toplam) entegratörde ya da GİB'de ret olarak geri döner. Bu araç XML'i göndermeden önce okur ve sorunları tek tek listeler.

Her bulgunun yanında kaynağı yazar. GİB şematronu etiketli kurallar GİB'in e-Fatura Paketi'nde yayımladığı UBL-TR şematronundan ve kod listesinden alınmıştır (fatura no biçimi, ETTN, senaryo ve fatura tipi listeleri, 0 KDV'de muafiyet sebebi, döviz kuru zorunluluğu, toplamlarda en çok 2 kuruş hanesi gibi). GİB kılavuzu etiketliler GİB'in kılavuzlarında yazan ama şematronda karşılığı olmayan kurallardır. Hesap kontrolü ve genel kontrol ise bizim kontrollerimizdir: GİB şematronu tutar hesabını denetlemez, biz kalem tutarı, KDV, iskonto, tevkifat ve ödenecek tutarın birbirini tutup tutmadığına bakarız.

Hata çıkmaması faturanın GİB'de kabul edileceği anlamına gelmez. Araç mali mührü ya da e-imzayı doğrulamaz, yalnız var olup olmadığına bakar. Fatura GİB'e ya da başka bir yere gönderilmez; XML tarayıcında, senin cihazında okunur.

e-Fatura XML'ini 3 adımda kontrol etme

Dosyaları bırak: Bir ya da birden çok .xml dosyası, ya da portaldan indirdiğin ZIP. ZIP içindeki klasörler ve ZIP içindeki ZIP (bir düzey) okunur.
Kontrol et'e bas: Her belge için hata, uyarı ve bilgi notları çıkar. Her bulgu satır numarasını ve XML'deki yerini (ör. /Invoice/cac:InvoiceLine[2]/cbc:LineExtensionAmount) gösterir.
Raporu al: TXT raporunu indir ya da “Yazdır / PDF” ile kaydet; hataları düzeltip dosyayı yeniden kontrol et.

Ne zaman işine yarar?

Entegratöre göndermeden önce: Kendi yazılımınla ürettiğin XML'de ret sebebini önceden görmek.
Reddedilen faturayı anlamak: Ret mesajı kısa olduğunda hatanın hangi satırda olduğunu bulmak.
Muhasebe ofisleri: Müşteriden gelen toplu XML'lerde tutmayan toplamları, aynı ETTN'yi ya da yanlış VKN'yi ayıklamak.
Yazılım geliştiriciler: Yeni bir fatura tipi (tevkifat, istisna, döviz) eklerken çıktıyı hızlıca denetlemek.
Gelen faturayı incelemek: Satıcıdan gelen XML'de iskonto ve KDV hesabının doğru olup olmadığına bakmak.

Kurallar, kaynaklar ve sınırlar

Kaynak: GİB şematronu ve kod listesi, ebelge.gib.gov.tr'de yayımlanan e-Fatura Paketi'nin 2026-07-01 tarihli sürümüdür. Kılavuz kuralları UBL-TR Fatura Kılavuzu, Kod Listeleri, e-Fatura Entegrasyon Kılavuzu ve e-Arşiv Teknik Kılavuzu'ndandır. GİB kuralları değişirse araç güncellenene kadar fark olabilir.
Tüm şematron değil: Şematronun bir bölümü uygulanır (biçim, kod listeleri, taraf kimliği, imza öğesi, muafiyet ve tevkifat kuralları); ihracat, HKS, kamu, ilaç ve yolcu beraberi senaryolarına özgü ayrıntılı kurallar uygulanmaz.
Hesap kontrolü: Kalem tutarı = miktar × birim fiyat − iskonto + artırım; vergi = matrah × oran; toplamlar 1 kuruşa kadar yuvarlama farkıyla karşılaştırılır. Tevkifatlı faturada vergi toplamının tevkifat düşülerek yazılması, iskontonun toplamda ayrıca düşülmesi gibi yaygın yazımlar hata sayılmaz, bilgi notu olarak gösterilir.
VKN / TCKN: Uzunluk ve rakam kuralları GİB şematronundandır. Kontrol hanesi hesabı yaygın bilinen algoritmalarla yapılan genel kontroldür; GİB kuralı değildir ve uymazsa yalnız uyarı verilir.
İmza ve görünüm: Mali mühür / e-imza doğrulanmaz, yalnız var olup olmadığına ve sertifika içerip içermediğine bakılır. Gömülü XSLT çalıştırılmaz; içinde dış dosya çağrısı, betik ya da dış adres olup olmadığına bakılır.
Güvenlik ve gizlilik: Dosya sunucuya yüklenmez; sayfa ağ bağlantısını kapatan bir güvenlik politikasıyla gelir. DOCTYPE / ENTITY içeren XML okunmaz (XML bombası koruması). Sınırlar: dosya başına 25 MB, en çok 200 dosya ve 1000 belge.

Gizlilik ve otomatik silme

Bu araç dosyanızı sunucumuza göndermez: bütün işlem tarayıcınızda, cihazınızda yapılır. Sayfa, dosya içeriğinin dışarıya gönderilmesini teknik olarak engelleyen bir güvenlik politikasıyla (Content-Security-Policy) sunulur; bu sayfada analiz ya da reklam betiği çalışmaz.

Sonuç dosyası da cihazınızda oluşturulur ve yalnızca siz indirirsiniz. Sekmeyi kapattığınızda ya da “Yeni dosya” dediğinizde tarayıcı belleğinden silinir. Sunucumuzda bu işlemle ilgili dosya adı ya da içerik kaydı tutulmaz.

Ayrıntılar için Gizlilik Politikası'nı okuyun

Sıkça Sorulan Sorular

Bu araç faturamın GİB'de kabul edileceğini garanti eder mi?

Hayır. Araç GİB şematronunun bir bölümünü ve tutar hesaplarını denetler. Hata çıkmaması faturanın kabul edileceği anlamına gelmez; son kontrolü entegratörün ya da GİB'in sistemi yapar. İmza da doğrulanmaz.

Faturam bir sunucuya gönderiliyor mu?

Hayır. XML ve ZIP dosyaları tarayıcında, senin cihazında okunur. Sayfa ağ bağlantısını kapatan bir güvenlik politikasıyla gelir; fatura GİB'e, entegratöre ya da bize gönderilmez.

“GİB şematronu” ile “genel kontrol” arasındaki fark ne?

GİB şematronu etiketli bulgular GİB'in yayımladığı UBL-TR şematronunda ya da kod listesinde bulunan kurallardır. Genel kontrol ve hesap kontrolü bizim eklediğimiz kontrollerdir: örneğin toplamların birbirini tutması ya da VKN kontrol hanesi. Bunlar GİB kuralı değildir ama ret ya da yanlış ödeme riskine işaret edebilir.

Fatura numarası hangi biçimde olmalı?

GİB şematronuna göre 16 karakter: 3 büyük harf ya da rakam, 4 haneli yıl ve 9 haneli sıra numarası, örneğin ABC2026000000001. Araç ayrıca numaradaki yılın düzenleme tarihiyle aynı olup olmadığına bakar.

KDV'si 0 olan faturada ne gerekir?

GİB şematronuna göre belge düzeyinde KDV tutarı 0 olan alt toplamda muafiyet sebebi yazılmalıdır (iade, ihraç kayıtlı, özel matrah, SGK ve konaklama vergisi tipleri hariç). Sebep yazıldığında kodu da GİB kod listesinde olmalıdır. İstisna olmayan 0 KDV'li durumlar için kod listesi 351 kodunu gösterir.