SFA Nedir? Gelir Operasyonlarını Büyütme Rehberi
20 Şubat 2026
ÖZET
e-Fatura ERP entegrasyonu, sadece bir IT projesi değil, finansal süreklilik teminatıdır. Başarılı bir entegrasyon; doğru veri eşleşmesi (mapping), kapsamlı schematron testleri ve güçlü bir hata yakalama mekanizması gerektirir. Bu rehber, ERP sisteminizden GİB sistemlerine giden yolda veri kaybını sıfıra indirmeyi hedefler. Uni-Dox gibi bir ara katman çözümü, ERP güncellemelerinden etkilenmeyen sürdürülebilir bir mimari kurmanızı sağlar.
Bir işletme için en kritik an, faturanın kesildiği ve tahsilat sürecinin başladığı andır. Ancak, veri dönüşümündeki milisaniyelik bir hata operasyonu kilitler. Sonuçta, tırlar kapıda bekler ve tahsilat gecikir. Bu nedenle, yöneticiler entegrasyonu teknik bir iş değil, hayati bir güvenlik protokolü olarak yönetir.
Bu rehber, e-Fatura ERP entegrasyonunu adım adım planlamanız, UBL hatalarını minimize etmeniz ve canlıya geçiş sürecini risk almadan yönetmeniz için hazırlanmıştır.
Entegrasyon Mimarisi: Veri Nasıl Akmalı?
Entegrasyon mimarisini kurgularken ERP’nin ana işlevini koruyun. GİB, mükelleflere üç temel yöntem sunar. Ancak, kurumsal firmalar sürdürülebilirlik adına Özel Entegrasyon modelini tercih eder.
Bu mimaride veri akışı şu sırayı izler:
- ERP Tetiklemesi: Muhasebe departmanı faturayı ERP içinde onaylar.
- Veri Dönüştürme (Mapping): Ara katman yazılımı (Örn: Uni-Dox e-Dönüşüm), ERP’den çıkan ham veriyi (JSON, XML veya DB tablosu) alır ve GİB uyumlu UBL-TR formatına çevirir.
- İmzalama ve Zarf: Sistem, faturayı mali mühür ile imzalar ve bir “Zarf” içine koyar.
- Gönderim: Özel entegratör, zarfı GİB sistemine iletir.
Veri Alanları ve Mapping (UBL-TR Standartları)
Entegrasyonun kalbi “Mapping” aşamasıdır. ERP veritabanınızdaki alanların, UBL-TR şemasındaki karşılıklarını birebir eşleştirmeniz gerekir. Yanlış eşleştirme, şema hatası (Schematron failure) almanıza ve faturanın reddedilmesine yol açar.
Aşağıdaki tablo, temel veri alanları için yapmanız gereken eşleştirmeleri gösterir:
| ERP Veri Alanı (Kaynak) | UBL-TR Karşılığı (Hedef) | Açıklama ve Kural |
|---|---|---|
| Müşteri VKN / TCKN | cac:PartyIdentification | 10 veya 11 hane kontrolü yapılmalı. |
| Fatura Numarası | cbc:ID | 3 hane önek + yıl + seri no formatı (GİB-2026…). |
| Fatura Tarihi | cbc:IssueDate | YYYY-MM-DD formatında olmalı. |
| Mal/Hizmet Adı | cac:Item / cbc:Name | Ürün adı ERP’den olduğu gibi çekilmeli. |
| Vergi Türü Kodu | cbc:TaxTypeCodecac:TaxTotalcac:TaxSubtotalcac:TaxCategorycac:TaxScheme | 0015 (KDV) gibi kodlar doğru atanmalı. |
Buna ek olarak, özellikle ihracat faturalarında GTİP kodları ve teslim şekli gibi alanların eksiksiz gitmesi zorunludur. e-Fatura modülünüz, bu alanları ERP’den otomatik çekerken validasyon uygulamalıdır.
Test Senaryoları: Neyi Kontrol Etmelisiniz?
Kodlamayı bitirmek, işin sadece yarısıdır. Gerçek başarı, kapsamlı bir test süreci ile gelir. Test ortamında “Happy Path” (sorunsuz senaryo) dışında, hatalı durumları da simüle etmelisiniz.
Entegrasyon ekibinizin test etmesi gereken senaryolar:
- Zorunlu Alan Testi: VKN, Adres veya Vergi Dairesi eksik olduğunda sistemin faturayı göndermeden önce sizi uyarması gerekir.
- Matematiksel Doğrulama: Satır toplamları, vergi tutarları ve genel toplam arasındaki kuruş farklarını (rounding errors) sistem otomatik düzeltmelidir.
- İstisna Testleri (Edge Cases): Türkçe karakter içeren unvanlar, Tevkifatlı fatura senaryoları, İade süreçleri.
- Zarf Durum Testleri: Giden faturanın “1300 – Başarıyla Tamamlandı” kodunu alıp almadığını simüle edin.
Hata Yönetimi ve Loglama
GİB sunucuları yada karşı taraf her zaman yanıt vermez. Bu yüzden, “Gönder ve Unut” riskini almayın. Aksine, entegrasyonu asenkron kurgulayın. Böylece, sistem her adımı anlık kaydeder.
Etkili bir hata yönetim sistemi şunları yapar: Log Detayı, Otomatik Tekrar (Retry) ve Alarm Mekanizması. Bu sayede IT ekibiniz, sorunun ERP’de mi, entegratörde mi yoksa GİB tarafında mı olduğunu saniyeler içinde tespit eder.
Canlıya Geçiş (Go-Live) Planı
Testler başarıyla tamamlandıktan sonra canlıya geçiş süreci başlar. Bu aşama, operasyonun durmaması için askeri bir disiplinle yönetilmelidir.
- Veri Yedekleme: ERP ve mevcut e-Dönüşüm veritabanının tam yedeğini alın.
- Zamanlama: Geçişi fatura trafiğinin en az olduğu saatlerde (genellikle gece yarısı) planlayın.
- Yetki Kontrolü: Mali Mühür ve API anahtarlarının üretim (production) ortamı için geçerli olduğunu doğrulayın.
- İlk Fatura Takibi: Canlı ortamda kesilen ilk 5 faturayı GİB portalından manuel teyit edin.
- Rollback Planı: İşler ters giderse, eski sisteme 15 dakika içinde dönebilecek altyapıyı hazır tutun.
Sıkça Sorulan Sorular (SSS)
ERP entegrasyonu ne kadar sürer?
e-Fatura ERP entegrasyonu, projenin kapsamına göre 2 ile 4 hafta arasında tamamlanır. Süreç; analiz, veri eşleştirme (mapping), test ve canlıya geçiş aşamalarını kapsar.
Hangi veriler eşleşmeli?
ERP ile e-Fatura sistemi arasında; Vergi Kimlik Numarası (VKN), Fatura Tarihi, Fatura Numarası, Mal/Hizmet Adı, Birim Fiyat ve Vergi Oranları (KDV vb.) birebir eşleşmelidir. Bu alanlar UBL-TR standartlarına uygun formatta taşınır.
UBL hataları nasıl yönetilir?
UBL hataları, gönderim öncesi validasyon (doğrulama) araçlarıyla engellenir. Sistem, eksik veya hatalı veri (örneğin hatalı VKN) tespit ettiğinde faturayı GİB’e göndermez ve kullanıcıya düzeltmesi için hata kodu iletir.
Test ortamı gerekir mi?
Kesinlikle. IT ekipleri, canlı veriyi riske atmamak için mutlaka bir test ortamı (sandbox) kullanır. Geliştiriciler; satış, iade ve tevkifat senaryolarını önce bu alanda doğrular, böylece GİB standartlarına tam uyumlu sistemi güvenle canlıya taşır.
Canlıya geçişte riskler nelerdir?
Süreçteki ana tehlikeler; fatura numarası çakışması, veri kaybı ve bağlantı kopmasıdır. Bu nedenle, sistem yöneticileri tam veri yedeği alarak olası kayıpları engeller. Ayrıca, operasyon ekipleri geçişi işlem hacminin en düşük olduğu saatlerde gerçekleştirir ve riskleri minimuma indirir.
Ücretsiz Demo Talebi ile Tüm Sorularınızı Giderin
ERP altyapınızı riske atmayın. GİB standartlarına tam uyumlu ve sürdürülebilir bir sistemi güvenle inşa edin. Bu kritik süreci güvenle yönetmek için uzman desteğini hemen başlatın.
