GİB, e-fatura ve e-arşiv faturalarda QR kod kullanımını zorunlu hale getirdi. Bu karekod, faturanın özet verilerini (UUID, belge numarası, tarih, alıcı-vardi bilgileri, vergi tutarları) içinde barındırır ve denetim sürecini hızlandırır. İşletmenin bu yükümlülüğe uyum sağlaması için doğru içerikte QR kod üretmesi ve fatura şablonuna yerleştirmesi gerekir.
Türkiye'de e-fatura sistemine geçen işletme sayısı 2023 itibarıyla 500.000'i aşmış durumda. Bu büyümenin doğal sonucu olarak Gelir İdaresi Başkanlığı (GİB), faturaların doğrulanabilirliğini artırmak için QR kod zorunluluğunu devreye soktu. Faturaya eklenen bu küçük kare, mali mühür ve UUID gibi verileri saniyeler içinde doğrulama imkanı sunuyor.
Bu makalede, E-Fatura QR Kod zorunluluğunun neyi gerektirdiğini, hangi işletmeleri kapsadığını ve uyum için hangi pratik adımları atman gerektiğini öğreneceksin. GİB'nin yayınladığı tebliğlerdeki teknik gereksinimleri sade bir dille açıklayacağız. Ayrıca tryqrcode.com üzerinden kayıt olmadan URL tabanlı QR kod oluşturarak fatura sürecini nasıl hızlandırabileceğini göstereceğiz.
E-Fatura QR Kod Nedir ve Neden Zorunlu?
E-Fatura QR Kod, bir elektronik faturanın özet bilgilerini içeren ve faturanın görsel şablonuna yerleştirilen iki boyutlu bir barkod türüdür. GİB, bu uygulamayı faturaların otantikliğini doğrulamak ve vergi denetimlerini hızlandırmak amacıyla zorunlu kıldı. Karekod ile QR kod arasındaki terminolojik farkları merak ediyorsan, karekod nedir başlıklı rehberimizde bu kavramları detaylıca inceledik.
QR kod zorunluluğu, faturanın basılı veya dijital kopyasında taranabilir bir doğrulama katmanı oluşturur. Mali müşavirlerin ve denetim elemanlarının, fatura verilerini manuel olarak kontrol etmesi yerine doğrudan karekodu tarayarak belgeyi doğrulaması mümkün olur. Bu da denetim süresini önemli ölçüde kısaltır.
GİB'nin e-fatura QR kod zorunluluğu, faturanın mali mührünü ve özet verilerini tek bir taranabilir koda gömerek denetim sürecini dakikalardan saniyelere indirir.
Uygulama, 2020 yılında yayınlanan 5070 sayılı Elektronik İmza Kanunu ve ilgili tebliğlerle temellendirildi. GİB, e-fatura portalı üzerinden gönderilen tüm faturaların görsel taslaklarında QR kod alanının bulunmasını şart koştu. E-arşiv faturalar için de aynı kural geçerli.
2026'te Türkiye'de e-fatura kullanıcılarının QR kod entegrasyonunu tamamlayan oran
(EDI.COM)
GİB QR Kod Düzenlemesi Hangi İşletmeleri Kapsıyor?
GİB QR Kod zorunluluğu, e-fatura sistemine geçmek durumunda olan tüm mükellefleri kapsar. E-fatura uygulamasına geçiş sınırı, yıllık cirosu 1 milyon TL ve üzeri olan işletmeler için belirlenmiştir. Bu sınırın altında olan işletmeler de gönüllü olarak e-fatura sistemine dahil olabilir ve bu durumda aynı QR kod yükümlülüğüne tabi olur.
Düzenleme kapsamında özel entegratörler (Portül, Uyumsoft, Logo, Mikro vb.) aracılığıyla fatura kesen şirketler de QR kod entegrasyonunu sağlamak zorunda. E-fatura uygulamasına dahil olduktan sonra kâğıt fatura kesme hakkı ortadan kalktığı için, dijital faturalarda QR kod olmadan gönderilen belgeler geçersiz sayılır.
| İşletme Türü | E-Fatura Zorunlu mu? | QR Kod Gerekli mi? |
|---|---|---|
| Yıllık ciro > 1M TL | Evet, zorunlu | Evet |
| Yıllık ciro < 1M TL | Gönüllü katılım | Evet (eğer dahilse) |
| Kamu kurumları | Evet, zorunlu | Evet |
| Serbest meslek sahipleri | Evet, belirli şartlarla | Evet (eğer dahilse) |
Anahtar çıkarım: E-fatura sistemine bir kez dahil olan işletme, cirosu ne olursa olsun QR kod zorunluluğundan muaf tutulamaz. Gönüllü katılım da aynı kurallara tabidir.
E-fatura kapsamı dışında kalan ve klasik kâğıt fatura kesmeye devam eden küçük işletmeler için şu an için bir QR kod yükümlülüğü bulunmuyor. Ancak Türkiye QR kod trendleri 2026 rehberimizde değindiğimiz gibi, GİB'in kâğıt faturaları da kademeli olarak dijitalleştirme planı sürüyor. İleride bu kapsamın genişlemesi bekleniyor.
E-Arşiv Fatura QR: Kural Aynı mı, Farklı mı?
E-Arşiv Fatura QR, e-fatura QR kod uygulamasıyla aynı teknik gereksinimlere dayanır. E-arşiv, e-fatura sistemine kayıtlı alıcılara veya e-fatura mükellefi olmayan alıcılara gönderilen faturaların elektronik ortamda muhafaza edilmesini ve ibraz edilmesini sağlayan bir uygulamadır. E-arşiv faturalarında da QR kod bulundurmak zorunludur.
Aradaki temel fark, e-arşiv faturalarının alıcısının e-fatura mükellefi olmaması durumunda PDF olarak gönderilebilmesidir. Bu PDF'in içinde de QR kod yer almalı ve tarandığında fatura özet verilerine erişim sağlamalıdır. İkincil bir fark ise e-arşiv raporlarının GİB'e ayrıca bildirilmesi gerekliliğidir; bu bildirimde QR kod verisi referans olarak kullanılır.
Uygulamada karşılaşılan yaygın bir sorun, e-arşiv PDF'inde QR kodun düşük çözünürlükte basılmasıdır. Müşteri faturayı çıktı aldığında veya e-posta ilettiğinde karekod okunamaz hale geliyor. Denetim sırasında bu durum, faturanın geçerliliğinin sorgulanmasına yol açabiliyor.
E-arşiv faturalarında QR kodun çıktı alındıktan sonra bile okunabilir kalması için minimum 150 DPI çözünürlükte ve en az 2x2 cm boyutta tasarlanması gerekir.
Unutma: E-arşiv faturası oluştururken QR kodu fatura şablonunun sağ üst veya sol alt köşesine yerleştir. Bu konumlandırma, GİB denetimlerinde standart olarak kabul görür ve tarayıcılar tarafından daha güvenilir okunma sağlar.
E-arşiv uygulaması hakkında uluslararası bir perspektif edinmek istersen, Sovos'un Türkiye e-faturalandırma rehberi vergi uyumu süreçlerini karşılaştırmalı olarak ele alıyor.
QR Kod İçinde Hangi Veriler Bulunur?
GİB tebliğlerine göre, vergi fatura QR kodu içinde belirli veri alanlarının bulunması zorunludur. Bu veriler, faturanın kimliğini ve mali içeriğini tanımlayan özet bilgilerdir. QR kod okunduğunda, bu veriler bir JSON veya XML yapısında çözümlenir ve denetim yazılımları tarafından otomatik doğrulanır.
Zorunlu veri alanları şunlardır: Fatura UUID'si (evrensel benzersiz tanımlayıcı), belge numarası, fatura tarihi, satıcı VKN/TCKN, satıcı unvanı, alıcı VKN/TCKN, alıcı unvanı, mal/hizmet bedeli, toplam vergi tutarı ve ödenecek tutar. Bu alanların eksik veya hatalı olması, faturanın GİB tarafından reddedilmesine neden olur.
| Veri Alanı | Açıklama | Zorunlu mu? |
|---|---|---|
| UUID | Faturaya özgü evrensel kimlik | Evet |
| Belge No | Fatura seri ve sıra numarası | Evet |
| Fatura Tarihi | Düzenleme tarihi (YYYY-MM-GG) | Evet |
| Satıcı VKN/TCKN | Satıcının vergi kimlik numarası | Evet |
| Ödenecek Tutar | Vergi dahil toplam tutar | Evet |
QR kodun içeriği, GİB'nin e-faturalandırma teknik özellikleri belgesinde ayrıntılı olarak tanımlanmıştır. Bu belge, veri alanlarının sırasını, kodlama biçimini (UTF-8) ve hata düzeltme seviyesini (Level M) belirler.
E-Fatura QR Kodu Nasıl Oluşturulur?
E-Fatura QR Kod oluşturma süreci, teknik bilgi gerektiren bir adımdır. Ancak adımları sırayla takip edersen, süreci sorunsuz yönetebilirsin. İşletmeler genellikle üç yöntemden birini kullanır: özel entegratör yazılımı, kendi geliştirilen yazılım veya online QR kod araçları.
Özel entegratörler (Uyumsoft, Portül, Logo vb.) fatura oluşturma sürecinin bir parçası olarak QR kodu otomatik üretir ve fatura şablonuna yerleştirir. Bu durumda ekstra bir işlem yapman gerekmez. Ancak kendi ERP sisteminizden fatura üretiyorsan, QR kod verisini GİB formatına göre hazırlayıp bir QR kod üretici ile görselleştirmen gerekir.
Test aşamasında QR okuyucu aracımızı kullanarak, oluşturduğun QR kodun veri bütünlüğünü doğrulayabilirsin. Tarayıcıdan çalışır, uygulama gerektirmez. Eğer faturanın UUID'sine bağlı bir URL üzerinden sorgulama sayfası tasarlıyorsan, tryqrcode.com ile kayıt olmadan URL QR kodu oluşturup bu bağlantıyı faturaya gömebilirsin.
E-fatura QR kodu üretirken hata düzeltme seviyesi M (%15) kullanılmalıdır. Bu seviye, faturanın çıktı alındığı veya e-posta ile iletildiği durumlarda bile kodun okunabilirliğini korur.
Yaygın Hatalar ve Denetim Riskleri
İşletmeler e-fatura QR kodu uygulamasında düzenli olarak belirli hataları tekrarlıyor. Bu hataların büyük kısmı, teknik entegrasyonun detaylarına dikkat edilmemesinden kaynaklanıyor. Denetim sırasında bu eksiklikler, faturanın geçersiz sayılmasına ve cezai yaptırıma yol açabiliyor.
QR kodun içindeki verilerin GİB formatına uygun olması şarttır. Yanlış alan sırası, eksik UUID veya hatalı kodlama, kod taramada başarılı görünse bile GİB denetiminde geçersiz sayılır.
Uygulayıcı gözlemine göre, QR kodu ürün ambalajına veya etikete ekleyen işletmeler ile e-fatura QR kodu ekleyen işletmelerin karşılaştığı sorunlar farklı. E-faturada en sık bildirilen hata, UUID alanının yanlış kopyalanması veya büyük/küçük harf duyarlılığının ihmal edilmesidir. İkinci yaygın hata, vergi tutarı alanının KDV dahil değil KDV hariç tutar olarak girilmesidir.
Üçüncü ve en kritik hata ise QR kodu faturaya raster görüntü (PNG) yerine vektör (SVG) formatında eklememek. Raster görüntüler, fatura şablonu ölçeklendiğinde veya yazıcı çözünürlüğü değiştiğinde pikselleşir. Bu da karekodun okunamaz hale gelmesine neden olur. Vektör formatı, her çözünürlükte netlik korur.
Anahtar çıkarım: E-fatura QR kodunu SVG formatında üret ve şablona vektör olarak ekle. PNG formatı, yazıcı çözünürlüğüne göre bozulur ve denetimde okunamazlık riski yaratır.
3 Adımlı QR Yayımlama Akışı
Vergi uyumu sürecini yönetmek için adlandırılmış bir çerçeve kullanmak, hataları azaltır ve takibi kolaylaştırır. Aşağıdaki "3 Adımlı QR Yayımlama Akışı", e-fatura ve e-arşiv fatura QR kodu entegrasyonu için tekrarlanabilir bir yöntem sunar. Her adım bağımsızdır ve bir önceki adımın çıktısını giriş olarak alır.
Fatura UUID, belge numarası, tarih, VKN/TCKN ve vergi tutarlarını GİB JSON şemasına göre topla. Her alanın formatını kontrol et: tarih YYYY-MM-GG, tutarlar nokta virgül ayrımıyla.
Derlenen veriyi bir QR kod üretici ile görselleştir. Hata düzeltme seviyesi M, modül boyutu en az 4 piksel. Çıktıyı SVG olarak al ve şablon ölçeklenmesine hazırla.
SVG dosyasını fatura XSLT/PDF şablonuna en az 2x2 cm boyutta yerleştir. Test faturası gönder, QR kodu tarayıcı ile oku ve veri bütünlüğünü doğrula.
Bu çerçeve, e-fatura ve e-arşiv faturaları için aynı şekilde uygulanır. E-arşiv faturalarında ek olarak, gönderilen PDF'in dosya boyutunun QR kodun kalitesini düşürmediğinden emin ol. Bazı e-posta istemcileri, PDF sıkıştırması uygulayarak QR kodun çözünürlüğünü bozabilir.
Tarım ve Gıda Sektöründe Ek Karekod Yükümlülükleri
Vergi fatura QR kodu zorunluluğunun dışında, bazı sektörlerde ek karekod yükümlülükleri bulunuyor. Tarım ve Orman Bakanlığı, gıda ürünlerinin izlenebilirliğini sağlamak için Tarım Bakanlığı işletme karekod sistemi kapsamında ayrı bir karekod uygulaması yürütüyor. Bu sistem, gıda güvenliği ve ürün takibi için tasarlanmıştır.
Gıda üreticileri ve ithalatçıları, ürün ambalajlarına Bakanlık tarafından tanımlanan izlenebilirlik karekodu eklemek zorunda. Bu karekod, e-fatura QR kodundan tamamen farklı veriler içerir: parti numarası, üretim tarihi, GTIN, işletme kodu gibi izlenebilirlik verileri. İki karekod birbirine karıştırılmamalıdır.
Vergi denetiminde geçerli olan e-fatura QR kodu ile gıda izlenebilirliğinde kullanılan Bakanlık karekodu farklı amaçlara hizmet eder ve farklı veri setleri içerir. Aynı faturada veya ambalajda her iki kod ayrı ayrı yer almalıdır.
Gıda sektöründe faaliyet gösteren bir işletmeysen, hem e-fatura QR kodu hem de Bakanlık izlenebilirlik karekodu yükümlülüklerini aynı anda yönetmen gerekir. Bu iki sistemi karıştırmak, hem vergi denetiminde hem de gıda denetiminde sorun yaratır.
E-Fatura QR Kod Sık Sorulan Sorular
E-fatura QR kod zorunluluğu hakkında en çok sorulan soruları ve doğrudan cevaplarını aşağıda bulabilirsin.
QR kod e-faturada nereye yerleştirilir?
GİB, QR kodun fatura şablonunda belirli bir konum zorunluluğu getirmemiştir. Ancak uygulama standardı olarak sağ üst veya sol alt köşe tercih edilir. Önemli olan, kodun taranabilir boyutta (en az 2x2 cm) ve diğer metinlerle çakışmadan yerleştirilmesidir.
E-fatura QR kodu hangi formatta oluşturulur?
QR kod verisi GİB tarafından tanımlanan JSON formatında hazırlanır. Görsel çıktı ise SVG (vektör) formatında üretilmeli ve fatura şablonuna bu formatla eklenmelidir. PNG formatı önerilmez çünkü ölçekleme sırasında kalite kaybı yaşar.
QR kodu olmayan e-fatura geçerli sayılır mı?
Hayır. GİB tebliğlerine göre QR kod içermeyen e-fatura veya e-arşiv faturası geçersizdir. Alıcı tarafından reddedilebilir ve denetimde cezai yaptırıma yol açar. Özel entegratörler bu kodu otomatik üretir, ancak kendi sisteminizden fatura kesiyorsan entegrasyonu kendin sağlaman gerekir.
QR kodu kendim mi oluşturmalıyım, yoksa entegratör mü yapar?
Özel entegratör kullanıyorsan (Uyumsoft, Portül, Logo vb.), QR kod otomatik olarak fatura sürecinin bir parçası olarak üretilir. Kendi ERP veya muhasebe yazılımından fatura gönderiyorsan, QR kod verisini GİB formatına göre hazırlayıp bir QR kod üretici ile görselleştirmen gerekir. Bu durumda tryqrcode.com üzerinden ücretsiz QR kod aracı ile kayıt olmadan kod oluşturabilir, şablonuna entegre edebilirsin.
E-fatura ve e-arşiv faturada QR kodunu saniyeler içinde üret, şablonuna entegre et. tryqrcode.com'da kayıt olmadan, ücretsiz, tarayıcıdan çalışır.
Hemen Ücretsiz QR Kod Oluştur
