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
- 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.
- 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. - İ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:PayableRoundingAmountelemanı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ır | Matrah toplamını satırların toplamına eşitleyin |
| TaxAmount (KDV Tutarı) | Matrah x KDV Oranı yuvarlaması | ±0.02 TL tolerans | KDV'yi satır bazında değil dip toplamda yuvarlayın |
| PayableAmount (Ödenecek Tutar) | Matrah + KDV, İskonto | Tam kuruş eşitliği şarttır | AllowanceCharge alanıyla yuvarlama farkını dengeleyin |