e-Fatura XML Maskeleme

Nasıl çalışır?

e-Fatura ve e-Arşiv fatura dosyaları, UBL-TR standardında XML biçiminde tutulur ve göründüğünden çok daha fazla kişisel veri içerir. Satıcı ve alıcının vergi kimlik numarası veya T.C. kimlik numarası, unvanı, adresi, telefonu, e-postası ve zaman zaman IBAN bilgisi bu dosyalarda açıkça yer alır. Faturaları bir mali müşavirle, denetçiyle veya bir muhasebe yazılımıyla paylaşırken bu tanımlayıcıların maskelenmesi, veri minimizasyonu ilkesinin doğrudan bir uygulamasıdır.

Bu araç, yüklediğiniz XML dosyasının tamamını tarar ve içindeki sayısal-biçimli kişisel verileri (VKN, TCKN, IBAN, telefon, e-posta, kart) tespit edip maskeler. XML etiketlerinin adları ve belgenin yapısı korunur; yalnızca değerlerin içindeki hassas kısımlar yıldızla değiştirilir. Böylece çıktı hâlâ okunabilir bir XML metni olarak açılır, ancak kişisel veriler okunamaz hale gelir. Dosyayı yükleyebilir veya XML içeriğini doğrudan yapıştırabilirsiniz.

UBL-TR faturalarda cac:AdditionalDocumentReference altındaki cbc:EmbeddedDocumentBinaryObject alanı, faturanın görüntü şablonunu (XSLT) veya bir PDF/görsel eki base64 olarak taşır ve alıcı bilgileri bu içerikte de bulunabilir. Araç bu içeriği çözer: XSLT, XML, HTML veya düz metinse içindeki kişisel verileri maskeleyip yeniden base64'e kodlar. PDF veya görsel gibi ikili eklerdeki bilgiler tarayıcıda güvenilir biçimde maskelenemediğinden bu eklerin içeriği boşaltılır ve araç ekranda "gömülü PDF/görsel eki kaldırıldı" uyarısı gösterir. Bu yüzden maskeli XML'i görüntüleyicide açtığınızda şablon veya ek görünümü eksik olabilir.

Vergi kimlik numarası ve T.C. kimlik numarası doğrulama algoritmalarıyla ayrıştırıldığı için fatura numarası, ETTN ya da tarih gibi diğer sayısal alanlarla karışma olasılığı düşüktür ama sıfır değildir. VKN, e-Fatura'daki schemeID='VKN' gibi yakınındaki bir etiketle birlikte aranır; etiketsiz geçen 10 haneli vergi numaraları maskelenmez. Yine de e-Fatura yapısı serbest metin alanları (açıklama, not) da içerdiğinden, bu alanlardaki ad-soyad veya adres gibi bilgileri çıktı üzerinde elle kontrol etmeniz önerilir. Araç, kaç adet ve hangi türde verinin maskelendiğini özet olarak gösterir.

Tipik kullanım senaryoları arasında; bir fatura örneğini eğitim veya dokümantasyon amacıyla paylaşmak, bir entegrasyon hatasını yazılım firmasına iletmek için örnek XML göndermek, ya da bir denetim sürecinde numune belge sunmak yer alır. Bu durumların hepsinde, gerçek mükellef bilgilerini ifşa etmeden belgenin yapısını ve mantığını aktarabilirsiniz.

e-Fatura XML'i çözümlemek yerine yalnızca okunabilir biçimde görüntülemek isterseniz e-Fatura XML Görüntüleyici sayfası; faturayı satıcı, alıcı ve kalem düzeninde gösterir. Maskeleme ise bunun tamamlayıcısıdır: görüntülemek yerine, belgeyi başkasına güvenle iletmek istediğinizde kullanılır. İki araç birlikte, e-belge akışında hem inceleme hem paylaşım ihtiyacını karşılar.

e-Fatura dosyaları mevzuat gereği belirli süre saklanmak zorundadır. Maskeleme orijinal dosyanızı değiştirmez, yalnızca paylaşacağınız kopya için maskelenmiş bir çıktı üretir. Belgenin içeriği değiştiği için maskeli kopyada e-imza ve mali mühür doğrulaması başarısız olur; bu kopya yasal olarak geçerli bir e-Fatura değildir, resmi bir işleme konu edilemez. Saklama ve ibraz yükümlülükleriniz için orijinal, maskesiz dosyayı korumaya devam edin.