Cari Plus ile e-Fatura ve e-Arşiv Fatura Süreçlerinde XML ve UBL Teknik Formatları: KOBİ'ler İçin Kapsamlı Rehber
e-Fatura ve e-Arşiv Fatura Teknik Altyapısı: XML ve UBL Standartlarına Giriş
Dijital dönüşümün finansal süreçlere en somut yansıması olan e-Fatura ve e-Arşiv Fatura, Gelir İdaresi Başkanlığı (GİB) tarafından belirlenen katı teknik standartlara tabidir. Bu standartların temelinde, faturaların insan tarafından okunabilir görsel tasarımından ziyade, sistemler arası veri alışverişini mümkün kılan yapılandırılmış veri formatları yatar. İşletmelerin faturalarını GİB’e başarıyla iletebilmesi ve ticari partnerleriyle sorunsuz entegrasyon kurabilmesi için bu iki temel formatı anlaması kritik önem taşır: XML (Extensible Markup Language) ve UBL (Universal Business Language).
XML, hem insanlar hem de makineler tarafından okunabilen, verileri hiyerarşik bir ağaç yapısında etiketlerle tanımlayan bir işaretleme dilidir. Türkiye'deki e-fatura sisteminin ilk yıllarında temel format olarak kullanılan XML, fatura üzerindeki her bir veri alanının (örneğin; fatura numarası, tarih, vergi kimlik numarası, mal/hizmet kalemi, birim fiyat) belirli etiketler arasında konumlandırılması prensibine dayanır. Bu yapı, verinin standart bir şablonda tutulmasını sağlarken, farklı muhasebe yazılımları arasında veri alışverişini mümkün kılar.
UBL ise, XML'in sunduğu bu yapılandırılmış veri temeli üzerine inşa edilmiş, uluslararası ticarette ortak bir dil oluşturmayı hedefleyen daha kapsamlı bir standartlar kütüphanesidir. OASIS tarafından geliştirilen UBL, fatura, irsaliye, sipariş gibi farklı ticari belgeler için önceden tanımlanmış şablonlar sunar. GİB, özellikle karmaşık ticari senaryoları ve uluslararası entegrasyonu desteklemek amacıyla UBL-TR standardını zorunlu hale getirmiştir. UBL-TR, UBL 2.1 sürümünün Türkiye'deki e-belge uygulamalarına uyarlanmış özel bir profilidir ve her bir fatura alanının hangi etiketle, hangi sırada ve hangi kurallarla kullanılacağını kesin olarak tanımlar. Bu sayede, bir Cari Plus kullanıcısının oluşturduğu fatura, alıcının kullandığı farklı bir ERP sistemi tarafından hatasız bir şekilde otomatik olarak işlenebilir hale gelir.
UBL 2.1 Formatının Yapısı ve e-Fatura Senaryolarındaki Rolü
UBL 2.1'in Temel Yapı Taşları
UBL 2.1 (Universal Business Language), e-Fatura süreçlerinde kullanılan uluslararası bir XML standardıdır. Bu formatın en kritik özelliği, fatura verilerini semantik olarak tanımlanmış etiketlerle taşımasıdır. Örneğin, <cbc:UUID> etiketi faturanın tekil kimliğini, <cac:AccountingSupplierParty> bloğu ise göndericiye ait tüm yasal bilgileri hiyerarşik bir yapıda barındırır. Bu yapı, Gelir İdaresi Başkanlığı'nın (GİB) belirlediği şemalarla tam uyumludur ve faturanın mali mühürle imzalanmadan önceki son teknik halini temsil eder.
Temel ve Ticari Fatura Senaryolarındaki Farklılıklar
UBL 2.1 formatı, farklı işletme ihtiyaçlarına yanıt vermek için çeşitli e-Fatura senaryolarını destekler. TEMELFATURA senaryosu, mal veya hizmet teslimi sonrası düzenlenen standart satış faturalarını kapsar ve UBL içindeki <cbc:ProfileID> alanı ile tanımlanır. Buna karşılık, TICARIFATURA senaryosu, özellikle büyük perakende zincirleri ve toptancılar arasında kullanılan, teslimat notu ve sipariş referansı gibi ek belgelerle ilişkilendirilmiş daha karmaşık bir yapıdır. Bu senaryoda, <cac:OrderReference> ve <cac:DespatchDocumentReference> gibi ek UBL blokları devreye girer. Cari Plus gibi entegre bir ön muhasebe yazılımı, bu senaryolar arasındaki geçişi otomatik yöneterek, işletmelerin fatura tipine göre doğru UBL şablonunu seçmesini ve manuel müdahale olmadan GİB'e iletmesini sağlar. Bu sayede, bir KOBİ'nin toptan satıştan perakende satışa geçerken teknik format değişikliğini düşünmesine gerek kalmaz; sistem, stok takibi ve cari yönetimi verilerinden gelen bilgilerle doğru UBL profilini otomatik oluşturur.
Cari Plus ile XML/UBL Fatura Oluşturma, Doğrulama ve Gönderim Süreçleri
XML ve UBL Formatlarında Fatura Oluşturma Adımları
Cari Plus üzerinde bir satış faturası oluşturduğunuzda, sistem arka planda bu veriyi Gelir İdaresi Başkanlığı’nın (GİB) kabul ettiği teknik formata dönüştürür. İster temel fatura (XML) ister ticari fatura (UBL 2.1) olsun, süreç sizin için tamamen otomatiktir. Sizin yapmanız gereken tek şey, müşteri bilgilerini ve ürün kalemlerini Cari Plus paneline doğru şekilde girmektir. Örneğin, bir toptan satış firmasında çalışan bir muhasebe uzmanı, farklı vergi oranlarına sahip onlarca ürünü tek bir faturada topladığında, yazılım tüm hesaplamaları ve şema eşleştirmelerini hatasız yapar.
Anlık Doğrulama ve Hata Önleme Mekanizması
Oluşturulan XML veya UBL dosyası, GİB’in entegratör sistemine gönderilmeden önce Cari Plus’ın dahili doğrulama motorundan geçer. Bu aşamada, Zarf ve Fatura şemalarına (xsd) uygunluk, zorunlu alanların (ETTN, senaryo kodu, vergi tutarları) varlığı ve matematiksel bütünlük kontrol edilir. Eğer bir eksiklik veya biçim hatası varsa, sistem faturayı göndermeden önce sizi uyarır. Bu sayede, “Geçersiz format” hatası alarak faturayı iptal etmek zorunda kalmazsınız. Manuel kontrollerle kaybedilen zaman ortadan kalkar.
Toplu Gönderim ve Entegratör İletişimi
Doğrulamadan başarıyla geçen faturalar, doğrudan entegratör servislerine iletilir. Cari Plus, bu iletişimi asenkron bir yapı ile yönetir; yani siz faturayı onayladıktan sonra işleminize devam edebilirsiniz. Sistem arka planda faturayı GİB’e iletir ve yanıtı (başarılı/başarısız) aldığında fatura durumunu otomatik günceller. Özellikle ay sonlarında yoğun fatura kesen KOBİ’ler için bu özellik, operasyonel hızı artırır ve e-Arşiv Fatura süreçlerinde yığılma yaşanmasını engeller. Tüm süreç, teknik detaylarla uğraşmanıza gerek kalmadan, mali mühür sertifikanızın güvenliği içinde tamamlanır.
KOBİ'ler İçin Teknik Format Uyumluluğunda Sık Karşılaşılan Hatalar ve Çözüm Yolları
Yaygın XML Şema Hataları
KOBİ'lerin e-Fatura ve e-Arşiv Fatura süreçlerinde en sık karşılaştığı teknik engellerin başında XML şema (XSD) doğrulama hataları gelir. Özellikle manuel veri girişi yapılan sistemlerde, zorunlu alanların boş bırakılması veya veri tiplerinin yanlış tanımlanması (örneğin, sayısal bir alana metin girilmesi) fatura reddine yol açar. Bu hatalar, Gelir İdaresi Başkanlığı (GİB) sisteminden dönen hata kodlarıyla tespit edilse de, teknik bilgisi sınırlı kullanıcılar için çözümü zaman alıcı olabilir.
UBL'de Senkronizasyon Problemleri
UBL 2.1 formatında ise en kritik hata kaynağı, cac:PartyIdentification ve cbc:ID gibi tarafları tanımlayan alanlardaki eksikliklerdir. Birçok işletme, müşterisinin vergi kimlik numarasını (VKN/TCKN) yanlış şemaya yerleştirerek gönderimin başarısız olmasına neden olur. Ayrıca, senaryo bazlı (Temel, Ticari, İhracat) etiket setlerinin karıştırılması, özellikle InvoiceTypeCode değerinin hatalı girilmesi, belgenin GİB tarafında geçersiz sayılmasına yol açar.
Pratik Çözüm ve Otomasyon
Bu hataların manuel olarak ayıklanması hem operasyonel hızı düşürür hem de mevzuata uyum riski doğurur. Cari Plus gibi entegre bir ön muhasebe yazılımı, fatura oluşturma anında şema kontrollerini otomatik yaparak kullanıcıyı uyarır. Sistem, zorunlu alanları önceden tanımlı kurallarla doldurur ve UBL şemasına tam uyumlu XML'i insan müdahalesine gerek kalmadan hazırlar. Böylece işletmeler, teknik detaylarla uğraşmak yerine doğrudan ticari operasyonlarına odaklanabilir ve reddedilen fatura oranını minimuma indirerek tahsilat süreçlerinde aksama yaşamaz.
Cari Plus Entegrasyonu ile e-Fatura Süreçlerinde Verimlilik ve Mevzuat Uyumu
Tek Panelden Uçtan Uca e-Belge Yönetimi
e-Fatura ve e-Arşiv Fatura süreçlerinde asıl verimlilik, fatura oluşturma anından başlayarak tahsilat aşamasına kadar tüm adımların birbiriyle konuşabilmesiyle sağlanır. Cari Plus özelinde bu bütünlük, XML ve UBL formatlarının arka planda otomatik işlenmesiyle mümkün hale gelir. Kullanıcı, manuel olarak bir şema doğrulaması yapmak veya teknik detaylarla uğraşmak zorunda kalmaz; sistem, oluşturulan her irsaliye veya siparişi doğrudan ilgili e-belge formatına dönüştürerek Gelir İdaresi Başkanlığı (GİB) sistemlerine iletir.
Mevzuat Değişikliklerine Anlık Uyum ve Güncelleme Avantajı
e-Belge mevzuatı dinamik bir yapıya sahiptir ve GİB tarafından yayınlanan yeni tebliğler, kullanılan XML şemalarında veya UBL 2.1 standartlarında güncellemeleri zorunlu kılabilir. Bulut tabanlı bir ön muhasebe yazılımı kullanmanın en kritik faydalarından biri, bu güncellemelerin sunucu tarafında anlık olarak uygulanmasıdır. Cari Plus, Solviera entegratörlüğünde çalışan altyapısı sayesinde, kullanıcıların herhangi bir paket kurulumu yapmasına gerek kalmadan güncel şema versiyonlarına otomatik geçiş yapar. Bu sayede işletmeler, format uyumsuzluğu nedeniyle fatura reddi veya idari para cezası gibi risklerden korunurken, e-Arşiv Fatura süreçlerinde kesintisiz bir operasyonel akış elde eder.
Stok ve Cari Modüllerle Veri Senkronizasyonu
Teknik format uyumluluğunun işletmeye yansıyan en büyük değeri, cari takibi ve stok yönetimi ile olan entegrasyonda ortaya çıkar. Cari Plus üzerinde kesilen bir e-Fatura, sadece GİB’e raporlanmakla kalmaz; aynı anda ilgili cari hesabın borç/alacak dengesini günceller ve stoktan düşüm işlemini gerçekleştirir. Bu derin senkronizasyon, mükerrer veri girişini ortadan kaldırarak hem operasyonel hızı artırır hem de stok maliyetlerinin ve cari risklerin anlık olarak izlenebilmesine olanak tanır. Sonuç olarak, teknik standartlara tam uyum, işletmenin finansal görünürlüğünü üst seviyeye taşıyan stratejik bir avantaja dönüşür.
Sıkça Sorulan Sorular
e-Fatura, Gelir İdaresi Başkanlığı (GİB) tarafından belirlenen standartlara uygun olarak elektronik ortamda düzenlenen ve GİB sistemine gönderilmesi zorunlu olan faturalardır. e-Arşiv Fatura ise aynı teknik altyapıyı kullanmakla birlikte, düzenlenen faturanın GİB'e gönderilmesi yerine doğrudan alıcıya iletilmesine olanak tanır. Temel fark, e-Fatura'nın GİB portali üzerinden onaylanması ve saklanması gerekirken, e-Arşiv Fatura'nın kendi arşivlenmesi yeterlidir.
XML, verilerin hiyerarşik ve yapılandırılmış bir şekilde etiketlerle tanımlanmasını sağlayarak sistemler arası veri alışverişini mümkün kılar. UBL ise XML tabanlı bir iş belgesi standardı olup, faturaların farklı sistemlerde sorunsuz işlenmesini sağlar. Bu standartlar sayesinde faturalar yalnızca görsel olarak değil, veri düzeyinde de anlaşılır ve otomatik işleme uygun hale gelir. GİB'in zorunlu kıldığı bu formatlar, e-fatura sürecinin temel taşını oluşturur.
Cari Plus, e-Fatura ve e-Arşiv Fatura süreçlerinde GİB tarafından zorunlu kılınan XML ve UBL formatlarını tam olarak destekler. KOBİ'lerin bu standartlara uygun fatura oluşturmasını, göndermesini ve almasını sağlar. Ayrıca, sistem entegrasyonu sayesinde kullanıcılar manuel müdahale olmadan faturalarını otomatik olarak ilgili formata dönüştürebilir ve GİB'e iletebilir.
UBL (Universal Business Language), işletmeler arası ticari belgelerin (fatura, sipariş, irsaliye gibi) standart bir XML şemasına göre oluşturulmasını sağlayan bir kütüphanedir. XML ise verileri etiketlerle tanımlayan genel bir işaretleme dilidir. UBL, XML'in üzerine inşa edilmiş, belirli belge türleri için önceden tanımlanmış bir yapı sunar. Yani XML bir dil, UBL ise bu dilde yazılmış bir sözlük veya şablon olarak düşünülebilir. e-Fatura'da UBL Profili (UBL-TR) kullanılır.
KOBİ'ler için en büyük zorluk, XML ve UBL gibi teknik standartlara hakim olmamak ve entegrasyon maliyetleridir. Fatura verilerinin doğru yapıda hazırlanması, özel alanların eksiksiz doldurulması ve GİB sistemine uygun iletilmesi gerekir. Ayrıca mevcut muhasebe programlarının e-fatura altyapısına uygun olmaması veya uyumluluk sorunları yaşanması da yaygındır. Cari Plus gibi çözümler, bu teknik detayları arka planda hallederek KOBİ'lerin iş yükünü azaltır.
GİB, e-Fatura ve e-Arşiv Fatura için zorunlu alanları UBL-TR şeması altında belirlemiştir. Bunlar arasında fatura numarası, düzenleme tarihi, gönderici ve alıcı bilgileri (vergi kimlik numarası, unvan, adres), mal/hizmet bilgileri, miktar, birim fiyat, KDV oranları ve toplam tutar gibi temel unsurlar bulunur. Ayrıca fatura türü (satış, iade, vb.) ve para birimi gibi alanlar da zorunludur. Eksik veya hatalı alanlar faturanın reddedilmesine neden olabilir.
Cari Plus, kullanıcıların e-fatura gönderebilmesi için öncelikle GİB'e kayıt yaptırmış olmasını gerektirir. Entegrasyon, Cari Plus'ın sağladığı API veya hazır modüller aracılığıyla yapılır. Kullanıcı fatura verilerini sisteme girdikten sonra, Cari Plus otomatik olarak faturayı XML/UBL formatına dönüştürür ve GİB'e iletir. Ayrıca gelen faturalar da otomatik olarak sisteme aktarılır. Kurulum sırasında teknik destek alınması önerilir.
XML e-faturada, UBL-TR standardına uygun olarak bir kök eleman (Invoice) altında çeşitli alt elemanlar bulunur. Bunlar: fatura kimlik bilgileri (ID, IssueDate, InvoiceTypeCode), taraflar (AccountingSupplierParty, AccountingCustomerParty), ödeme bilgileri (PaymentTerms), fatura kalemleri (InvoiceLine) ve toplam tutar (LegalMonetaryTotal) gibi ana bölümlerdir. Her bölümün kendi alt alanları vardır. Örneğin, her kalem için miktar, birim fiyat, KDV oranı gibi bilgiler girilir.
Evet, e-Arşiv Fatura'da da UBL kullanımı zorunludur. GİB, e-Arşiv Fatura belgelerinin de belirlenen UBL-TR şemasına uygun olarak hazırlanmasını şart koşar. e-Arşiv Fatura, e-Fatura'dan farklı olarak GİB'e gönderilmez ancak aynı teknik altyapıyı kullanır. Bu nedenle, faturaların hem görsel olarak okunabilir hem de UBL formatında veri içermesi gerekir. KOBİ'ler, bu standardı sağlamak için Cari Plus gibi uyumlu yazılımlar kullanabilir.
En yaygın hatalar arasında vergi kimlik numarası hataları, tarih formatı uyumsuzlukları, zorunlu alan eksiklikleri, KDV oranı yanlışlıkları ve UBL şemasına uygun olmayan yapı yer alır. Ayrıca GİB sunucu bağlantı sorunları veya mükellefiyet durumu hataları da görülebilir. Cari Plus, bu hataları kullanıcıya detaylı şekilde bildirir ve düzeltme imkanı sunar. Düzenli güncellemelerle uyumluluk sağlanır.
