API entegrasyonu, iki veya daha fazla yazılımın API (uygulama programlama arayüzü) adı verilen tanımlı kapılar üzerinden birbirine otomatik veri göndermesidir. Böylece e-ticaret siparişi anında ERP'ye aktarılır, stok her iki tarafta güncellenir, fatura entegratöre, gönderi kargoya iletilir. Doğru kurulmuş entegrasyon çift veri girişini ve gecikmeyi ortadan kaldırır.
Bu rehberde API entegrasyonunun nasıl çalıştığını, hangi yöntemin ne zaman seçileceğini, Türkiye'de en sık kurulan bağlantıları ve sağlam bir entegrasyon projesinin 8 adımını anlatıyoruz.
API entegrasyonu neden gerekir? Birbirinden kopuk sistemler
Orta ölçekli bir şirkette bugün genellikle birkaç ayrı yazılım yan yana çalışır: ERP veya muhasebe programı, e-ticaret sitesi ya da B2B bayi portalı, bir veya birkaç pazaryeri paneli, e-Fatura/e-İrsaliye entegratörü, kargo firmasının ekranı ve bankanın internet şubesi. Her biri kendi işinde iyidir; sorun, aralarındaki boşluktur. İK tarafında sık kurulan bağlantılardan biri de PDKS bordro entegrasyonu olarak bilinen puantaj-bordro akışıdır.
O boşluğu genellikle insanlar doldurur. Satış operasyonundaki bir çalışan pazaryerinden siparişleri Excel'e indirir, ERP'ye tek tek girer; depo stok sayısını akşam e-ticaret paneline elle günceller; muhasebe banka ekstresini indirip tahsilatları cari kartlarla eşleştirir. Gün içinde stokta görünen ürün aslında satılmış, sistemde "gönderildi" görünen sipariş aslında depoda bekliyor olabilir. Yöneticinin gördüğü rapor ise hangi sistemden alındığına göre değişir.
Entegrasyonsuzluğun maliyeti
Türkiye'de işletmelerin önemli bir kısmı hâlâ entegre bir çekirdek sistemden yoksun. TÜİK Girişimlerde Bilişim Teknolojileri Kullanım Araştırması, 2025 verisine göre 10 ve daha fazla çalışanı olan girişimlerin %28,3'ü ERP, %12,0'ı CRM ve yalnızca %6,5'i iş zekası (BI) yazılımı kullanıyor. Bu tablo, pek çok şirkette verinin hâlâ tablolar, e-postalar ve ayrı programlar arasında elle taşındığına işaret ediyor.
Buna karşılık bağlanması gereken dijital kanal sayısı hızla artıyor:
TÜİK Girişimlerde Bilişim Teknolojileri Kullanım Araştırması, 2026 verisine göre internet veya EDI (elektronik veri değişimi) üzerinden satış yapan girişimlerin oranı 2024'te %13,6 iken 2025'te %17,1'e yükseldi; 250 ve üzeri çalışanlı girişimlerde oran %29,7.
Resmî belge tarafında da tablo aynı. Gelir İdaresi Başkanlığı 2025 Yılı Faaliyet Raporu verisine göre e-İrsaliye uygulamasından yararlanan mükellef sayısı 2024'teki 402.985'ten 2025 sonunda 632.288'e çıktı. Her yeni e-belge yükümlülüğü, ERP ile entegratör arasında bir veri akışı daha demek.
Bu akışlar elle yürüdüğünde maliyet üç yerde ortaya çıkar: çalışan zamanında (aynı verinin birden çok kez yazılması), hatada (yanlış stok, yanlış fiyat, eksik fatura) ve karar hızında (yöneticinin güncel olmayan veriyle karar vermesi). Birden çok sistemin verisini raporlama için tek yerde toplamak ise veri ambarı ve ETL konusudur.
API entegrasyonu nasıl çalışır, hangi yöntem ne zaman kullanılır?
API'yi bir restorandaki garson gibi düşünebilirsiniz: mutfağa (sisteme) doğrudan girmezsiniz, garsona (API'ye) tanımlı bir sipariş verirsiniz ve tanımlı bir cevap alırsınız. Sistemin sahibi hangi verinin, kime, hangi yetkiyle açılacağını API üzerinden belirler.
Her entegrasyon aynı yöntemle kurulmaz. En yaygın seçenekler:
| Yöntem | Nasıl çalışır? | Uygun olduğu durum | Dikkat edilecek nokta |
|---|---|---|---|
| REST API (istek-cevap) | Bir sistem diğerine "şu siparişi ver/kaydet" der | Sipariş, cari, stok gibi kayıt bazlı işlemler | Kota ve hata durumlarının yönetimi |
| Webhook (olay bildirimi) | Bir olay olduğunda sistem diğerine kendiliğinden haber verir | Yeni sipariş, ödeme onayı, kargo durumu | Kaçan bildirimlerin tekrar denenmesi |
| Zamanlanmış dosya aktarımı | Belirli saatlerde CSV/XML dosyası taşınır | API'si olmayan eski sistemler (kalıcı çözüm için bkz. eski yazılım modernizasyonu), toplu fiyat listeleri | Gecikme; gün içi güncellik yok |
| EDI / standart belge | Taraflar standart formatta belge alışverişi yapar | Büyük tedarikçi ve zincir mağazalarla ticaret (EDI nedir) | Format uyumu ve test süreci |
| Ekran otomasyonu (RPA) | Bot, insanın kullandığı ekranı kullanır | API'si hiç olmayan, değiştirilemeyen sistemler | Ekran değişince bakım gerekir |
Kalıcı ve yüksek hacimli akışlarda API ve webhook birlikte en sağlam yapıyı kurar. API'si olmayan sistemlerde ekran otomasyonunun ne zaman mantıklı olduğunu RPA nedir yazımızda anlattık. Yeni bir paket yazılım seçerken de belgelenmiş ve sürümlenen bir API sunup sunmadığını mutlaka sorun; entegrasyon yeteneği, özel yazılım mı hazır paket mi kararının en belirleyici ölçütlerinden biridir.
Türkiye'de en sık kurulan entegrasyonlar
- ERP ↔ e-ticaret ve pazaryerleri: Sipariş ERP'ye düşer, stok ve fiyat tüm kanallarda tek kaynaktan güncellenir. Ayrıntıları pazaryeri entegrasyonu ve B2B e-ticaret ERP entegrasyonu rehberlerinde.
- ERP ↔ e-Fatura / e-Arşiv / e-İrsaliye entegratörü: Belge ERP'de oluşur, entegratöre iletilir, durum bilgisi geri döner. Ayrıntılarını e-Fatura entegrasyonu rehberimizde ele alıyoruz.
- ERP ↔ banka: Hesap hareketleri otomatik alınır, tahsilatlar cari hesaplarla eşleştirilir. Eşleştirme kurallarını banka mutabakatı otomasyonu yazısında anlattık.
- Sipariş ↔ kargo: Gönderi kaydı otomatik açılır, takip numarası müşteriye ve sisteme döner. Aynı bilgi, "siparişim nerede?" diye soran müşteriye WhatsApp chatbot üzerinden de verilebilir.
- CRM ↔ ERP: Satışın gördüğü müşteri bakiyesi ve sipariş durumu ile muhasebenin gördüğü aynı olur. Satış tarafının kurgusunu CRM ve satış hunisi rehberimizde anlattık.
- Üretim ve saha sistemleri ↔ ERP: Üretim, depo ve saha verisi ERP'ye gerçek zamanlı akar; araç konumu, kilometre ve yakıt verisi de filo yönetim sistemi üzerinden aynı akışa katılır. Üretim sahası ile ERP arasındaki katmanları tanımlayan ISA-95 modelini ve MES'in bu akıştaki yerini MES nedir, ERP'den farkı ne yazısında anlattık.
ERP'nin bu yapının merkezinde neden durduğunu KOBİ'ler için ERP rehberimizde anlattık. Sektöre özgü akışlar da aynı mantıkla kurulur; örneğin hastane sıra ve randevu yönetimi HBYS'deki randevu verisini çağrı ekranlarına bağlar.
Sağlam bir entegrasyon projesi için 8 adım
- Veri sahibini belirleyin. Her veri türü için tek bir "doğru kaynak" seçin: fiyatın sahibi ERP mi, e-ticaret paneli mi? Bu karar verilmeden kurulan entegrasyon, iki sistemin birbirinin verisini ezmesiyle sonuçlanır.
- Akışları çizin. Hangi olay (yeni sipariş, iade, stok değişimi) hangi sistemden hangisine, hangi sıklıkla gidecek — bir sayfalık bir akış şeması yeterlidir.
- Alan eşleştirmesini yazılı yapın. Ürün kodu, birim, KDV oranı, cari kodu gibi alanların iki taraftaki karşılıkları tabloya dökülmelidir.
- Hata ve tekrar deneme kuralı koyun. Karşı sistem cevap vermezse ne olacak? Kayıt kuyrukta bekletilip tekrar denenmeli, belirli sayıda denemeden sonra sorumluya bildirilmelidir.
- Mükerrer kaydı önleyin. Aynı siparişin iki kez aktarılmaması için her kayda benzersiz bir referans verilmelidir. Kaynak sistemlerde zaten biriken mükerrer kartları temizlemek ise ayrı bir iştir; veri kalitesi ve mükerrer kayıt yazımızda ele aldık.
- Kayıt ve izleme kurun. Her aktarımın ne zaman, hangi sonuçla yapıldığı görülebilmeli; "sipariş neden ERP'ye düşmedi?" sorusu dakikalar içinde cevaplanabilmelidir.
- Test ortamında gerçek senaryolarla deneyin. İade, kısmi sevkiyat, iptal ve fiyat değişikliği gibi istisnalar canlıya geçmeden test edilmelidir.
- Sahiplik ve bakım planı yapın. Karşı taraf API sürümünü değiştirdiğinde entegrasyonu kim güncelleyecek? Bu soru sözleşmede cevaplanmalıdır.
Entegrasyonun bağladığı ERP, CRM, WMS ve bayi portalı gibi sistemlere dair rehberler Yazılım Geliştirme yazılarımızda bir arada.
Güvenlik: her entegrasyon yeni bir kapıdır
API entegrasyonu verinin şirket dışına ve dışarıdan içeriye aktığı yeni bir yol açar. Bu yolu kimin, hangi yetkiyle kullandığı açık değilse risk de büyür. Verizon 2026 Data Breach Investigations Report verisine göre üçüncü tarafın dahil olduğu ihlaller bir yılda %60 artarak toplam ihlallerin %48'ine ulaştı.
Temel kurallar basittir: API anahtarları kodun içine ya da e-postaya yazılmaz, güvenli bir kasada saklanır; her entegrasyon yalnızca ihtiyaç duyduğu veriye erişir; anahtarlar düzenli yenilenir; iş ortağıyla ilişki bittiğinde erişim hemen kapatılır. Kişisel veri aktaran entegrasyonlar KVKK (6698 sayılı Kişisel Verilerin Korunması Kanunu) kapsamında veri envanterinde gösterilmelidir.
Otomotiv yan sanayinde entegrasyonun en yoğun hâli ana sanayiyle yapılan mesaj alışverişidir; DELFOR ve DESADV akışlarını otomotiv EDI entegrasyonu rehberimizde ayrıca ele aldık.
Digital Bridge'de bu işi nasıl yapıyoruz?
- Mevcut sistemlerin haritasını çıkarıyoruz. API ve sistem entegrasyonu hizmetimiz kapsamında hangi yazılımların kullanıldığını, hangilerinin API sunduğunu ve verinin bugün elle nerede taşındığını birlikte listeliyoruz.
- Doğru yöntemi seçiyoruz. API varsa doğrudan bağlantı, yoksa zamanlanmış aktarım ya da ekran otomasyonu kuruyoruz. Makine, terminal ve sensör gibi donanım tarafındaki bağlantıları sistem entegrasyonları kapsamında aynı ekiple ele alıyoruz; yazılım ve donanım aynı ekipten geldiği için arada sorumluluk boşluğu kalmıyor.
- Tek veri akışı tasarlıyoruz. Birden çok sistemin aynı iş sürecinde birlikte çalışması gerekiyorsa entegre yazılım sistemleri yaklaşımıyla sipariş, stok ve fatura akışını baştan sona kurguluyoruz. Satış kanalı tarafında e-ticaret ve B2B platformlarını ERP'ye bağlıyoruz. Smart ailesinin e-ticaret ürünü SmartSales ise vitrini, pazar yerlerini ve ürün feed'ini aynı katalogdan besler; headless API'sinde okuma ve yönetim jetonları ayrıdır ve yönetim jetonu yalnız katalog ile stok yazar.
- Güvenliği baştan ekliyoruz. Anahtar yönetimi, yetki sınırları ve kayıt tutma yapısını siber güvenlik danışmanlığı ilkeleriyle tasarlıyoruz.
- E-postayla gelen belgeleri de akışa katıyoruz. Tedarikçi faturaları e-postayla geliyorsa Smart360 ailesindeki SmartMail, ekteki fatura PDF'inden tutar, KDV, tarih, belge ve vergi numarası gibi alanları dosya indirilmeden çıkarır; ek tek tıkla SmartFiles alanına kaydedilir.
- Sonucu görünür kılıyoruz. Entegre veriyi yönetimin tek ekranda izleyebilmesi için BI dashboard çalışmalarıyla birleştirebiliyoruz.
Kapsamı, aşamaları ve bedeli yazılı teklifte netleştiriyoruz; hazır paket dayatmıyoruz.
Entegrasyonu hangi süreçten başlatacağınızı belirlemek için süreç otomasyonu önceliklendirme matrisimizden yararlanabilirsiniz.
Sonraki adım
İlk adım olarak bir kâğıda şirketinizde kullanılan tüm yazılımları yazın ve aralarında elle taşınan veriyi oklarla gösterin. En çok ok alan sistem, entegrasyona nereden başlanacağını gösterir. Bu şemayla iletişim sayfamızdan bize ulaşın; hangi bağlantının en hızlı getiriyi sağlayacağını birlikte belirleyelim.