e-Fatura Süreçlerinde Manuel Giriş ve Şematron Krizlerine Son Verin
Türkiye'de e-Fatura mükellefi olan orta ve büyük ölçekli işletmeler, ayda binlerce alış ve satış faturası yönetir. Ancak faturanın GİB (Gelir İdaresi Başkanlığı) üzerinden özel entegratöre ulaşması sürecin sadece ilk adımıdır. Asıl operasyonel darboğaz, gelen faturanın ERP sistemine işlenmesi, sipariş emriyle teyit edilmesi, ambar irsaliyesiyle denkleştirilmesi ve yasal muhasebe hesaplarına doğru kodlanmasında ortaya çıkar.
Piyasadaki standart bulut entegratör portalları, yalnızca PDF görüntüleme ve onay kutucuğu sunar. Faturadaki onlarca kalem malzemenin stok kodları (SKU), tevkifat oranları (cac:WithholdingTaxTotal), KDV istisna maddeleri (cbc:TaxExemptionReasonCode) ve döviz kurları muhasebe çalışanları tarafından ERP ekranlarına elle tek tek yazılır. Bu manuel süreç; yanlış vergi beyanlarına, cezai yaptırımlara ve milyonlarca liralık mükerrer ödemelere kapı aralar.
e-Fatura ERP entegrasyonu özel yazılımı geliştiren Appsoni; UBL-TR 1.2.1 şematron kural motoru, 3 yönlü otomatik mutabakat (PO-GRN-INV), asenkron kuyruk tamponu ve resmi ERP API sürücüleriyle e-Fatura operasyonunuzu sıfır hatalı, tam otomatik bir kurumsal altyapıya dönüştürür.
Kurumsal e-Fatura Entegrasyon Mimarisi ve Asenkron Veri Akışı
Appsoni e-Fatura entegrasyon motoru, özel entegratörlerin REST/SOAP API'leri ile şirket içi ERP veritabanları arasında yüksek güvenlikli, çift yönlü bir işlem hattı kurar:
[GİB / Özel Entegratör API: QNB eFinans, Sovos/Foriba, Uyumsoft, Edm]
│ (REST JSON / Webhook Event: Status 1300 / 1215 - HTTPS Port 443)
▼
[Appsoni e-Fatura Entegrasyon Gateway & Şematron Doğrulayıcı]
│ (UBL-TR 1.2.1 XML Schematron XSLT Validation + XMLDSig İmza Kontrolü)
▼
[Redis Idempotency Filtresi (IDEMP_INV_GIB_<UUID> - 72 Saat TTL)]
│ (Mükerrer Fatura Kaydını ve Çift Muhasebeleşmeyi Önleme)
▼
[RabbitMQ Mesaj Kuyruğu (q.invoice.incoming.process - AMQP Port 5672)]
│ (Asenkron İşleme, Yük Dengeleme ve Rate Limiting)
▼
[3 Yönlü Otomatik Eşleştirme Motoru (Three-Way Matching Worker)]
├─ PO Teyidi: Satın Alma Sipariş No (`PO_NUMBER`) ve Fiyat Kontrolü
├─ GRN Teyidi: Ambar Mal Kabul İrsaliyesi (`DISPATCH_REF`) ve Miktar Kontrolü
└─ Tolerans Kontrolü: Fatura Dip Toplamı (Maksimum ±0.02 TL Yuvarlama Farkı)
│
├─── Başarılı Eşleşme ───────────────────────┐
▼ ▼
[ERP Konnektör Katmanı (Edge Service)] [İstisna ve Red Havuzu]
(Logo Objects / Mikro COM / SAP BAPI) (Fiyat/Miktar Farkı > %0.5)
▼ ▼
[ERP Veritabanı (ACID Transaction)] [Mali İşler & Satın Alma Alarmları]
(Otomatik Fatura + Muhasebe Mahsup Fişi) (Teams / SMS / 8 Günlük Yasal Süre Takibi)
UBL-TR 1.2.1 Standardı ve ERP Alan Eşleme Şeması
Entegrasyon katmanımız, GİB UBL-TR XML hiyerarşisindeki her düğümü kurumsal ERP sistemlerinin (Logo, Mikro, SAP) ilişkisel tablolarıyla birebir eşler:
| UBL-TR 1.2.1 XML Düğümü |
ERP Karşılığı (Logo / Mikro / SAP) |
Veri Tipi |
Örnek Parametre |
Operasyonel İş Kuralı ve Açıklama |
cbc:UUID |
LG_001_01_INVOICE.GUID / SAP BKTXT |
String(36) |
4a8f9c21-7b3e-4d89-9a12-8e123456789a |
Faturanın evrensel tekil kimliği; mükerrer kayıt kontrol anahtarı |
cbc:ID |
INVOICE.FICHENO / EVRAK_SERI_SIRA |
String(16) |
GIB2026000018420 |
16 haneli yasal fatura numarası (3 hane seri + 4 yıl + 9 sıra) |
cbc:ProfileID |
INVOICE.PROFILE_ID |
Enum |
TICARIFATURA |
Fatura senaryosu (TEMELFATURA, TICARIFATURA, IHRACAT, KAMU) |
cbc:InvoiceTypeCode |
INVOICE.TRCODE |
Enum |
SATIS |
Fatura türü (SATIS, IADE, TEVKIFAT, ISTISNA, OZELMATRAH) |
cac:AccountingSupplierParty |
LG_001_CLCARD.TAXNR / SAP KUNNR |
String(11) |
1234567890 |
Satıcı VKN/TCKN bilgisi ile ERP cari kart tekil eşleştirmesi |
cac:InvoiceLine/cbc:ID |
STLINE.LINENO_ |
Integer |
1 |
Fatura kalem sıra numarası |
cac:Item/cbc:Name |
ITEMS.NAME / STOK_ISIM |
String(100) |
Paslanmaz Çelik Flanş DN50 PN16 |
Tedarikçi ürün tanımı |
cac:Item/cac:SellersItemIdentification |
ITEMS.CODE / STOK_KODU |
String(24) |
STK.FLANS.DN50.01 |
ERP malzeme kartı kodu eşleme tablosu (Cross-Reference) |
cac:InvoiceLine/cbc:InvoicedQuantity |
STLINE.AMOUNT / STOK_MIKTAR |
Decimal(18,4) |
150.0000 |
Faturadaki teslim edilen ürün miktarı |
cac:Price/cbc:PriceAmount |
STLINE.PRICE / BIRIM_FIYAT |
Decimal(18,4) |
245.5000 |
Satır net birim fiyatı (Vergiler hariç) |
cac:TaxCategory/cbc:Percent |
STLINE.VAT_RATE / KDV_ORANI |
Decimal(5,2) |
20.00 |
Yasal KDV oranı yüzdesi (%0, %1, %10, %20) |
cac:WithholdingTaxTotal/Percent |
INVOICE.WITHHOLDING_RATE |
String(10) |
9/10 |
Tevkifat oranı (GİB Tevkifat Kodu: 601, 608, 622 vb.) |
cbc:TaxExemptionReasonCode |
INVOICE.EXEMPTION_CODE |
String(4) |
301 |
KDV İstisna Muafiyet Kodu (11/1-a Mal İhracatı istisnası) |
cac:OrderReference/cbc:ID |
ORFICHE.FICHENO / SIPARIS_NO |
String(20) |
SIP-2026-9921 |
Satın alma sipariş referansı; 3-way matching bağlantısı |
cac:DespatchDocumentReference |
DISPATCH.FICHENO / IRSALIYE_NO |
String(16) |
IRS202600008412 |
Mal kabul irsaliyesi referansı; ambar hareket bağlantısı |
cac:LegalMonetaryTotal/PayableAmount |
INVOICE.NETTOTAL / GENEL_TOPLAM |
Decimal(18,2) |
44190.00 |
Ödenecek net genel toplam tutar |
cbc:DocumentCurrencyCode |
INVOICE.CURR_TRANS / DOVIZ_CINSI |
String(3) |
TRY |
Fatura para birimi (TRY, USD, EUR, GBP) |
LG_001_EMF (Muhasebe Fişi) |
GL_ACCOUNT_CODE |
String(30) |
153.01.001 / 191.01.020 |
Tek düzen hesap planı borç/alacak muhasebe kodları |
Örnek GİB UBL-TR Gelen Fatura Entegrasyon Yükü
Entegratörden çekilen ve ERP sistemine işlenmek üzere ayrıştırılan örnek JSON entegrasyon veri paketi:
{
"integration_event": "INCOMING_INVOICE_PROCESSED",
"idempotency_key": "IDEMP_INV_GIB_4a8f9c21-7b3e-4d89-9a12-8e123456789a",
"uuid": "4a8f9c21-7b3e-4d89-9a12-8e123456789a",
"invoice_number": "GIB2026000018420",
"issue_date": "2026-10-20",
"issue_time": "09:30:00+03:00",
"profile_id": "TICARIFATURA",
"invoice_type": "TEVKIFAT",
"currency": "TRY",
"supplier": {
"vkn_tckn": "3240581920",
"title": "Marmara Endüstri Metal San. ve Tic. A.Ş.",
"erp_card_code": "320.01.TED.00412"
},
"matching_metadata": {
"po_reference": "SIP-2026-9921",
"grn_reference": "IRS202600008412",
"matching_status": "MATCHED_AUTO_APPROVED",
"price_variance_percentage": 0.0,
"quantity_variance_percentage": 0.0
},
"financial_totals": {
"line_extension_amount": 36825.0,
"tax_exclusive_amount": 36825.0,
"tax_inclusive_amount": 44190.0,
"payable_amount": 37561.5,
"withholding_amount": 6628.5,
"withholding_tax_code": "601",
"withholding_ratio": "9/10"
},
"accounting_gl_distribution": [
{ "account": "153.01.HAMMADDE", "debit": 36825.0, "credit": 0.0 },
{ "account": "191.01.KDV20", "debit": 7365.0, "credit": 0.0 },
{ "account": "360.01.TEVKIFAT_KDV", "debit": 0.0, "credit": 6628.5 },
{ "account": "320.01.TED.00412", "debit": 0.0, "credit": 37561.5 }
]
}
Hata Senaryoları, SLA Kısıtları ve İstisna Protokolleri
Appsoni e-Fatura entegrasyon motorunda her hata senaryosu yasal mevzuata ve operasyonel SLA eşiklerine göre otomatik yönetilir:
ERR_GIB_1215_SCHEMATRON_VALIDATION_FAILED (Şematron Kural İhlali):
Fatura UBL-TR kurallarına aykırı bir tevkifat kodu veya vergi oranı içerdiğinde tetiklenir. Sistem faturayı GİB kuyruğuna iletmeden önce durdurur; faturayı kesen muhasebeciye hatanın kaynaklandığı XML satırını ve çözüm önerisini anlık ekranda gösterir.ERR_THREE_WAY_MATCHING_VARIANCE_EXCEEDED (Fiyat/Miktar Tutarsızlığı):
Fatura birim fiyatı, ERP'deki onaylı satın alma sipariş fiyatından %0.5'ten fazla yüksekse veya teslim alınan ambar miktarını aşıyorsa fatura otomatik durdurulur. Sistem faturayı STATUS = REVIZYON_BEKLIYOR moduna alır ve Satın Alma Şefine onay linki gönderir.ERR_GIB_1163_DUPLICATE_ENVELOPE (Mükerrer Zarf Hatası):
Aynı fatura ID veya UUID değeriyle daha önce GİB'e zarf gönderilmişse oluşur. Redis Idempotency katmanımız aynı faturanın ikinci kez ERP veya GİB'e iletilmesini engelleyerek mükerrer yevmiye kaydını %100 önler.ERR_ERP_DEADLOCK_ON_INVOICE_INSERT (ERP Veritabanı Kilitlenmesi):
Ay sonlarında aynı anda yüzlerce fatura muhasebeleşirken MS SQL veya Oracle tarafında oluşan Deadlock hatalarında sistem Exponential Backoff (3 deneme: 10s, 30s, 90s) ile işlemi güvenle tamamlar.- 8 Günlük Yasal Süre Eskalasyon Alarmı (TICARIFATURA SLA):
Gelen ticari faturalarda sistem 5. güne kadar aksiyon alınmamışsa Kategori 1 Alarm, 7. günde ise Finans Direktörü ve Genel Müdüre acil eskalasyon bildirimi açar.
Kurumsal Roller ve Operasyonel Onay Matrisi
| Kurumsal Rol |
Sorumluluk ve Görev Tanımı |
Sistem Yetkileri ve Onay Mekanizması |
| Mali İşler Direktörü (CFO) |
Şirket geneli vergi stratejisi, nakit çıkış onayı ve yasal denetim uyumu |
Riskli veya yüksek tutarlı (ör. >250.000 TL) faturaların ödeme blokajını kaldırma yetkisi |
| Muhasebe Müdürü / Mali Müşavir |
Tek düzen hesap planı doğruluğu, KDV/tevkifat beyanname mutabakatı |
Özel hesap kodlama kuralları tanımlama, şematron istisna onayları |
| Satın Alma Şefi |
Tedarikçi sözleşme fiyatları, birim fiyat toleransları ve iade faturaları |
Fiyat farkı çıkan faturaları onaylama veya tedarikçiye iade/red talebi başlatma |
| Depo ve Mal Kabul Sorumlusu |
Fiziksel ürün sayımı, irsaliye teslim teyidi ve hasar kayıtları |
Zebra el terminali üzerinden irsaliye-fatura miktar teyidi ve kabul kaydı |
| ERP Sistem Yöneticisi |
Entegratör API anahtarları, mTLS sertifikaları ve veritabanı sağlığı |
Servis çalışma süresi (Uptime) takibi, DLQ kuyruk yönetimi ve API yetkilendirmesi |
Donanım ve Entegrasyon Cihaz Altyapısı
e-Fatura entegrasyonu, şirketinizin sahadaki depo ve operasyon donanımlarıyla tam senkronize çalışır:
- Endüstriyel El Terminalleri (Honeywell CK65, Zebra TC57): Depo personeli gelen mal kabul paletindeki e-İrsaliye karekodunu okuttuğunda ilgili e-Fatura ERP'de otomatik olarak irsaliye ile eşleşir.
- 2D Karekod Okuyucular (Datalogic Gryphon GD4500): Muhasebe masasında basılı veya dijital fatura karekodu okutulduğunda sistem saniyeler içinde GİB UBL-TR kaydını ekrana getirir.
- Endüstriyel Etiketleme Yazıcıları (Zebra ZT411): Mal kabulü tamamlanan faturalı ürünler için lot/seri numaralı ERP stok etiketlerini basar.
- Güvenli HSM ve Mali Mühür Sunucuları: GİB doğrudan entegrasyonu kullanan büyük işletmelerde yerel donanımsal güvenlik modülleri (HSM) üzerinden e-İmza atımı sağlar.
5 Aşamalı Anahtar Teslim Kurulum Metodolojisi
| Proje Fazı |
Kapsam ve Mühendislik Çalışmaları |
Tamamlanma Süresi |
Teslim Edilecek Doğrulama Çıktısı |
| 1. Süreç ve ERP Analizi |
Mevcut özel entegratör API'leri, ERP fatura tipleri, tevkifat modelleri ve muhasebe kodlarının tespiti |
3 İş Günü |
e-Fatura Entegrasyon Teknik Şartnamesi |
| 2. Şematron & Kuyruk Kurulumu |
UBL-TR 1.2.1 doğrulama motoru, RabbitMQ ve Redis mikroservislerinin devreye alınması |
4 İş Günü |
Ön Doğrulama Altyapı Kabul Belgesi |
| 3. Çift Yönlü ERP Sürücüsü |
Logo Objects / Mikro COM / SAP BAPI üzerinden fatura ve mahsup fişi yazma servislerinin kodlanması |
8 İş Günü |
UAT Test Ortamı Canlı Entegrasyon Paketi |
| 4. UAT ve Stres Testleri |
10.000 adet karmaşık (tevkifatlı, istisnalı, dövizli) fatura simülasyonu ve 3-way matching doğrulaması |
3 İş Günü |
%99.98 Eşleşme Doğruluk Raporu |
| 5. Canlıya Geçiş ve SLA Başlangıcı |
Canlı fatura akışının başlatılması, muhasebe ekibi eğitimi ve 7/24 telemetri izleme başlangıcı |
2 İş Günü |
Canlı Sistem Kabul Tutanağı |
e-Fatura ERP Entegrasyonunuzu Güvenle Başlatın
e-Fatura süreçlerinizi manuel veri girişinden, vergi cezalarından ve geciken onaylardan kurtarmak için Appsoni uzmanlığıyla tanışın. Mevcut ERP ve entegratör altyapınızı inceleyelim; işletmenize özel, hatasız ve tam otomatik e-Fatura entegrasyon mimarisini hayata geçirelim.
