Kurumsal ERP ve Muhasebe Yazılımlarına KEP API Entegrasyonu Nasıl Yapılır?
Büyük ölçekli kurumlarda her gün gelen onlarca resmi tebligatı ve gönderilen yüzlerce ihtar/bordro iletisini web arayüzünden manuel yönetmek operasyonel riskler doğurur. KEP API entegrasyonu, tüm bu süreçleri şirketin ana ERP sistemine bağlar.
1. KEP API Mimarisi Nasıl Çalışır?
KEP sağlayıcıları (TÜRKKEP, TNB KEP, PTT vb.), kurumsal müşterilerine güvenli mTLS (çift taraflı SSL) sertifikası ile korunan SOAP veya RESTful web servisleri sunar. İstemci uygulama, HSM (Donanımsal Güvenlik Modülü) üzerinde barındırılan kurumsal e-mühür veya yetkili e-imza ile iletileri imzalar ve KEP sunucusuna iletir. Konuyla ilgili teknik gereksinimler ve mevzuat adımları için Şirket Sözleşmelerinde KEP Şartı rehberimizden de faydalanabilirsiniz.
2. En Popüler Kullanım Senaryoları
- Otomatik Bordro Dağıtımı: İK yazılımı ay sonunda hesaplanan tüm PDF bordroları her çalışanın bireysel KEP adresine otomatik gönderir ve teslim delillerini veritabanına işler.
- Gelen Tebligat Yönlendirme: Şirket KEP kutusuna düşen bir mahkeme veya icra tebligatı anında hukuk departmanı avukatlarına bilet (ticket) olarak atanır.
- Cari Mutabakat ve İtiraz: Fatura uyuşmazlıklarında ERP üzerinden tek tıkla resmi KEP itirazı oluşturulur.
Teknik Dökümanlar:
Vergi Usul Kanunu ve BTK KEP Teknik Kriterler Tebliği: Şirketlerin muhasebe, ERP ve İK yazılımları üzerinden doğrudan KEP iletisi gönderip alabilmesi için BTK yetkili KEPHS'ler tarafından sunulan REST/SOAP API standartlarına uyulması zorunludur. Konuyla ilgili teknik gereksinimler ve mevzuat adımları için Şirketler İçin KEP Kullanımı rehberimizden de faydalanabilirsiniz.
RESTful & SOAP Web Servis Mimarisi: Otomatik İleti ve Delil Toplama
Günde yüzlerce fatura itirazı, cari mutabakat veya bordro gönderen işletmeler için KEP web portalına tek tek manuel giriş yapmak operasyonel felakettir. KEP API entegrasyonu sayesinde ERP yazılımı (SAP, Logo Tiger, Netsis, Mikro vb.), fatura veya bordro onaylandığı anda otomatik olarak e-İmzalı KEP iletisi üretir ve arka planda KEPHS sunucularına iletir. Dönen teslim delili (delil.xml) otomatik olarak ERP veri tabanına işlenir ve ilgili faturanın veya çalışanın kartına kalıcı olarak iliştirilir.
Manuel KEP Kullanımı vs. KEP API Entegrasyonu
| Operasyonel Kriter | Manuel Web Portal Kullanımı | ERP KEP API Entegrasyonu |
|---|---|---|
| Gönderim Hızı | İleti başına 2-3 Dakika | Saniyede 50+ Toplu İleti |
| Hata Payı | Yanlış dosya veya adres ekleme riski yüksek | %0 (Veritabanından otomatik çekilir) |
| Delil Saklama | Manuel indirme ve klasörleme gerektirir | ERP veri tabanında otomatik indeksleme |
| Maliyet / Zaman | Yoğun personel iş gücü | Tam otomatik arka plan servisi |
En Sık Karşılaşılan 3 Uygulama Hatası ve Çözüm Yolları
Sunucu tabanlı toplu imzalama için USB token yerine Donanımsal Güvenlik Modülü (HSM) gerekir.
Hatalı bir döngü yazılımı binlerce çalışana mükerrer KEP atıp ciddi kota maliyeti doğurabilir.
ERP sunucusu ile KEP sunucusunun zaman damgaları uyuşmazsa API iletileri reddedilir.
Türkiye genelinde 1.200 mağazası bulunan bir zincir market, her ay tedarikçilerine gönderdiği BA/BS mutabakat mektuplarını KEP API entegrasyonuna bağlamıştır. Önceden 4 personelin 10 günde bitirdiği mutabakat ve ihtar gönderimi, Logo ERP üzerinden 45 dakika içinde otomatik tamamlanmış ve tüm teslim delilleri sisteme işlenmiştir.
Uygulama ve Denetim Kontrol Listesi (Checklist)
- Mevcut muhasebe/ERP yazılımınızın KEP modülü lisansını ve yeteneklerini kontrol edin.
- Çalıştığınız KEPHS'den API dokümantasyonunu, test hesaplarını ve API anahtarlarını temin edin.
- Toplu gönderimler için sunucu tabanlı Kurumsal e-İmza (HSM) sertifikasını temin edin.
- Test ortamında (Sandbox) örnek ileti, ek dosya ve delil dönüşüm senaryolarını test edin.
- Canlıya geçiş sonrası delil.xml dosyalarının ERP yedekleme planına dahil edildiğinden emin olun.