6102 SAYILI TTK & 7201 SAYILI TEBLİGAT KANUNU ISSN-EDİSYON // 2026
KEP Akademisi
Yazılım & API • 2026-09-22 • 6 dk okuma • Doğrulanmış Rehber • 0 Yorum

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.
İlgili Kılavuz: Şirket çalışanlarına resmi bildirim gönderiminin yasal boyutunu KEP ile Fesih Bildirimi Rehberimizden inceleyebilirsiniz.
Resmî Mevzuat & Tebliğ Dayanağı

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 KriterManuel Web Portal KullanımıERP KEP API Entegrasyonu
Gönderim Hızıİleti başına 2-3 DakikaSaniyede 50+ Toplu İleti
Hata PayıYanlış dosya veya adres ekleme riski yüksek%0 (Veritabanından otomatik çekilir)
Delil SaklamaManuel indirme ve klasörleme gerektirirERP veri tabanında otomatik indeksleme
Maliyet / ZamanYoğun personel iş gücüTam otomatik arka plan servisi

En Sık Karşılaşılan 3 Uygulama Hatası ve Çözüm Yolları

1 API Entegrasyonunda e-İmza Donanımını (HSM) Hesaba Katmamak

Sunucu tabanlı toplu imzalama için USB token yerine Donanımsal Güvenlik Modülü (HSM) gerekir.

2 KEP API Test Ortamını Atlayıp Doğrudan Canlıya Geçmek

Hatalı bir döngü yazılımı binlerce çalışana mükerrer KEP atıp ciddi kota maliyeti doğurabilir.

3 Sunucu Zaman Senkronizasyonunu (NTP) İhmal Etmek

ERP sunucusu ile KEP sunucusunun zaman damgaları uyuşmazsa API iletileri reddedilir.

Perakende Zinciri Vakası: 15.000 Mağaza Mutabakatının API ile 1 Saatte Tamamlanması

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.
İlgili Rehber & Dizin: KEP API desteği sunan resmi hizmet sağlayıcılarının listesi ve detayları için: KEP Entegratörleri ve Sağlayıcı Rehberi sayfamızı inceleyebilirsiniz. Dizine Git →
Av. S. Gökmen

Av. S. Gökmen (Hukuk Danışmanı)

Bilişim & Ticaret Hukuku Danışmanı

İstanbul Barosu | Bilişim Hukuku Komisyonu | KEP & UETS Uzmanı

Kayıtlı Elektronik Posta (KEP) mevzuatı, UETS elektronik tebligat ve elektronik delil hukuku alanında uzman avukat ve yasal uyum danışmanı.

← Tüm Rehberlere Dön

Yorumlar & Topluluk Deneyimleri Henüz Yorum Yok

Bu rehberle ilgili sorularınızı veya saha tecrübelerinizi paylaşın.

Yorum Yaz ↓

Henüz Yorum Yapılmamış

Bu rehber hakkındaki deneyimlerinizi veya teknik sorularınızı aşağıdaki formu kullanarak ilk siz paylaşın.

Bir Yorum Bırakın

Düşünceleriniz diğer okuyucular ve uzmanlar için değerlidir.

Bilgileriniz korunur. Yorumlar editoryal inceleme sonrası kalıcı olarak onaylanır.

İlginizi Çekebilecek Diğer Rehberler

Tümünü Gör →