e-Fatura Atölyesi
e-Fatura, e-Arşiv & VUK Muhasebe Atölyesi
Muhasebe & Teknik • 2026-10-14 (Güncellendi: 2026-10-28) • 7 dk okuma • Doğrulanmış Rehber • 0 Yorum

e-Faturada Kuruş Yuvarlama ve Matrah Farkları: Schematron Hatalarından Kaçınma Yolları

Muhasebecilerin, ERP yöneticilerinin ve e-ticaret faturalama ekiplerinin en çok başını ağrıtan teknik problemlerin başında, faturanın satır tutarlarının toplamı ile dip toplamdaki KDV veya genel toplam arasındaki 1 ya da 2 kuruşluk uyuşmazlıklar gelir. Kağıt fatura döneminde göz ardı edilebilen veya elle düzeltilebilen kuruş farkları, e-Fatura ve e-Arşiv dünyasında GİB'in katı UBL-TR Schematron algoritmalarına takılmakta ve faturanın '1200, Şema Hatası (Schematron Error)' koduyla reddedilmesine neden olmaktadır. Bu teknik makalede yuvarlama farklarının neden oluştuğunu ve ERP sistemlerinizde bu hatayı kalıcı olarak nasıl önleyeceğinizi açıklıyoruz.

1. Hatanın Kök Nedeni: Kayan Noktalı Sayılar ve İki Basamak Kuralı

UBL-TR 1.2.1 standartları gereğince e-Fatura XML dokümanında birim fiyatlar (PriceAmount) 4 veya daha fazla ondalık basamak içerebilirken; satır net tutarı (LineExtensionAmount), vergi tutarı (TaxAmount) ve ödenecek genel tutar (PayableAmount) kesinlikle 2 ondalık basamak (kuruş) olmak zorundadır. Konuyla ilgili teknik gereksinimler ve mevzuat adımları için Dövizli e-Fatura Düzenleme rehberimizden de faydalanabilirsiniz.

Örneğin; birim fiyatı 12.3456 TL olan bir üründen 3 adet satıldığında:

  • Ham Satır Toplamı: 12.3456 * 3 = 37.0368 TL
  • 2 Basamağa Yuvarlama (Midpoint Rounding): 37.04 TL
  • Eğer sistem satır satır KDV hesaplayıp toplarsa farklı, dip toplam üzerinden KDV hesaplarsa 1 kuruş farklı bir sonuç çıkabilmektedir.

2. GİB Schematron Matematiksel Kuralı

GİB schematron kuralları şu eşitliği tavizsiz arar:

Genel Toplam = Satırlar Toplamı, Toplam İskonto + Toplam Artırım + Toplam Vergiler

Eğer faturadaki XML satırları toplandığında çıkan değer ile TaxInclusiveAmount veya PayableAmount arasında 0.01 TL bile fark varsa fatura sunucudan geri döner. Konuyla ilgili teknik gereksinimler ve mevzuat adımları için e-Fatura ve e-Arşiv Fatura Zorunluluk Hadleri rehberimizden de faydalanabilirsiniz.

3. 1 Kuruşluk Yuvarlama Farklarını Önleme Yöntemleri

  1. Satır Bazında Yuvarlama (Line-Level Rounding): ERP yazılımınızı her bir satırın KDV'sini hesapladığı anda virgülden sonra 2 basamağa standart matematiksel yuvarlama (Round Half Up) yapacak şekilde ayarlayın. Dip toplamları bu yuvarlanmış satırların toplamından türetin.
  2. Yuvarlama Tutarı (RoundingAmount) Alanının Kullanımı: UBL-TR standardında faturanın dip toplamında <cac:LegalMonetaryTotal> altında <cbc:RoundingAmount> adında özel bir XML etiketi mevcuttur. Eğer fatura toplamında +/- 0.01 veya 0.02 TL'lik kaçınılmaz bir fraksiyon oluşuyorsa, bu fark RoundingAmount alanına yazılarak faturanın şemayı başarıyla geçmesi sağlanabilir.
  3. İskonto Dağıtım Algoritması: Dip toplamda yapılan genel ciro iskontolarını satırlara eşit dağıtırken oluşan artık kuruşları son satıra ekleyerek dengeyi sağlayın.

4. Özel Entegratör Düzeltme Filtreleri

Pek çok modern özel entegratör (Logo, Uyumsoft vb.), ERP'den gelen XML paketini GİB'e iletmeden önce otomatik bir 'Schematron Ön Kontrolü' çalıştırır. Eğer 1 kuruşluk kayma tespit edilirse sistem faturayı reddetmek yerine RoundingAmount alanını otomatik güncelleyerek faturanın hatasız iletilmesini sağlar. Entegratör panelinizden bu ayarın açık olduğundan emin olun.

Sonuç

Kuruş yuvarlama farkları çözümsüz bir hata değil, salt bir matematiksel konfigürasyon meselesidir. Muhasebe ve ERP yazılımınızdaki yuvarlama kurallarını UBL-TR standartlarıyla eşitleyerek 1200 şema hatalarına tamamen son verebilirsiniz.

2026 UBL-TR 1.2.1 Şematron Güncellemesi: Tolerans ve Yuvarlama

Gelir İdaresi Başkanlığı'nın UBL-TR 1.2.1 paketinde kuruş yuvarlama hatalarına (1163 Zarf Hatası) karşı uyguladığı güncel kurallar şunlardır:

  • cac:TaxSubtotal Toleransı: Kalem bazlı hesaplanan KDV tutarları toplamı ile fatura alt toplamındaki KDV tutarı arasında en fazla ±0.05 TL (5 Kuruş) yuvarlama farkına izin verilir.
  • cbc:LineExtensionAmount Hassasiyeti: Birim fiyat 4 veya 6 basamaklı girilse dahi satır toplam tutarı (Line Amount) mutlaka virgülden sonra 2 basamağa yuvarlanmalıdır.
  • Yuvarlama Tutarı Alanı: Yuvarlama kaynaklı kuruş farkları faturanın cac:LegalMonetaryTotal / cbc:PayableRoundingAmount elemanında açıkça beyan edilmelidir.

E-Faturada Kuruş Yuvarlama ve Matrah Farkları Tablosu Nasıl Uygulanır?

Birim fiyat çarpımlarında oluşan 1-2 kuruşluk yuvarlama sapmalarını ve Schematron reddini önleme tablosu:

Kuruş Yuvarlama ve GİB Matrah Tolerans Parametreleri

UBL XML AlanıOlası Hata KaynağıGİB Kabul ToleransıÇözüm ve Yuvarlama Metodu
LineExtensionAmount (Satır Tutarı)Birim Fiyat x Miktar yuvarlaması±0.01 TL (1 Kuruş)Birim fiyatta en az 4 ondalık basamak kullanın (Örn: 12.3456 TL)
TaxExclusiveAmount (Matrah Toplamı)Satır matrahlarının toplamıKuruş farkı olmamalıdırMatrah toplamını satırların toplamına eşitleyin
TaxAmount (KDV Tutarı)Matrah x KDV Oranı yuvarlaması±0.02 TL toleransKDV'yi satır bazında değil dip toplamda yuvarlayın
PayableAmount (Ödenecek Tutar)Matrah + KDV, İskontoTam kuruş eşitliği şarttırAllowanceCharge alanıyla yuvarlama farkını dengeleyin
Featured Snippet (Sıfırıncı Sıra) Özeti: Kuruş hatalarından kaçınmak için birim fiyatlar XML'de en az 4 haneli (0.0001) tanımlanmalı ve KDV hesaplaması dip toplam üzerinden yapılmalıdır.
E. Çetin

E. Çetin VUK 509 UZMANI

E-Fatura & GİB Entegrasyon Mimarı

Mali Teknoloji Uzmanı | GİB E-Fatura & E-Arşiv Danışmanı

Gelir İdaresi Başkanlığı (GİB) e-Fatura, e-Arşiv, tevkifat oranları ve özel entegratör API mimarileri üzerine kurumsal danışmanlık veren mali teknoloji uzmanı.

← Tüm Rehberlere Dön

Yorumlar & Topluluk Deneyimleri Henüz Yorum Yok

Bu rehberle ilgili sorularınızı veya saha tecrübelerinizi paylaşın.

Yorum Yaz ↓

Henüz Yorum Yapılmamış

Bu rehber hakkındaki deneyimlerinizi veya teknik sorularınızı aşağıdaki formu kullanarak ilk siz paylaşın.

Bir Yorum Bırakın

Düşünceleriniz diğer okuyucular ve uzmanlar için değerlidir.

Bilgileriniz korunur. Yorumlar editoryal inceleme sonrası kalıcı olarak onaylanır.

İlginizi Çekebilecek Diğer Rehberler

Tümünü Gör →