Entegrasyon, işletmenizin kullandığı yazılımların birbirine otomatik veri aktarmasıdır. Bir sipariş geldiğinde faturanın kesilmesi, kargo kaydının açılması, stokun pazaryerlerinde güncellenmesi ve ekibe bildirim gitmesi, ayrı ayrı entegrasyonlarla elle iş yapmadan gerçekleşir. Bu rehber, en sık ihtiyaç duyulan entegrasyonları ve her biri için hazırladığımız ayrıntılı yazıları tek yerde topluyor.
Entegrasyon Türleri
| Tür | Nasıl çalışır | Örnek |
|---|---|---|
| REST API | Yazılımınız servisin adreslerine HTTP istekleri gönderir | Paraşüt, Trendyol, Discord |
| SOAP web servis | XML tabanlı, tanım dosyası (WSDL) ile çağrılan servis | Yurtiçi, Aras, PTT, Ticimax |
| Webhook | Bir olay olunca karşı tarafın adresine veri gönderilir | Discord bildirimi, form ve CRM |
| Dosya ve XML | Düzenli üretilen dosya karşı tarafça okunur | Cimri ürün XML'i, banka ekstresi, Luca Excel |
| Protokol ile kurum bağlantısı | Kamu kurumları arasında sözleşmeyle kurulan veri paylaşımı | UYAP kurum entegrasyonları |
Konu Konu Entegrasyon Rehberleri
Muhasebe
- Paraşüt entegrasyonu: API v4, OAuth2, fatura ve e-Fatura akışı, hazır e-ticaret bağlantıları.
- Luca entegrasyonu: Excel aktarım, başka programdan geçiş, e-Dönüşüm ve Luca Portal.
Banka ve Ödeme
- Garanti BBVA entegrasyonu: Sanal POS, 3D Secure, API Store ve hesap hareketlerinin muhasebeye aktarımı.
- iyzico ödeme entegrasyonu: Ödeme formu, 3D Secure ve webhook.
E-ticaret, Pazaryeri ve Kargo
- Ticimax entegrasyonu: Web servis, tedarikçi XML ve hazır bağlantılar.
- Pazaryeri entegrasyonu: Trendyol, Hepsiburada, n11, Amazon, Çiçeksepeti ve Pazarama.
- Kargo entegrasyonu: Yurtiçi, Aras, PTT, DHL eCommerce ve desi hesabı.
- Cimri entegrasyonu: Mağaza kaydı ve ürün XML dosyası.
Müşteri ve Ekip İletişimi
- CRM entegrasyonu: HubSpot, Zoho, Bitrix24 ve Salesforce ile API, webhook ve Zapier.
- Discord entegrasyonu: Webhook bildirimi, bot ve Discord ile giriş.
Hukuk
- UYAP entegrasyonu: Kurum protokolleri, Avukat Portalı ve büro yazılımları.
Firma ve Platform Bazında Rehberler
Pazaryerleri
Kargo Firmaları
CRM
Örnek Akış: Siparişten Teslimata
- Müşteri sitenizden ya da pazaryerinden sipariş verir; sipariş pazaryeri API'sinden çekilir.
- Ödeme sanal POS üzerinden alınır.
- Fatura ön muhasebe API'siyle otomatik kesilir.
- Gönderi kargo web servisinde açılır, barkod basılır.
- Müşteri kaydı CRM'e yazılır, ekibe Discord'dan bildirim gider.
Entegrasyon Projesine Başlamadan Önce
- Hazır bağlantıya bakın: Kullandığınız altyapı veya yazılımın hazır entegrasyonu varsa önce onu değerlendirin.
- Tek kaynak belirleyin: Stok, fiyat ve müşteri bilgisinin hangi sistemde "asıl" tutulduğuna karar verin.
- Test ortamı isteyin: Canlı veriyle deneme yapmayın; servis test ortamı sunuyorsa önce orada çalışın.
- Sınırları öğrenin: Her servisin istek sınırı vardır. Yöntemler için istek sınırı rehberine bakın.
- Anahtarları koruyun: API anahtarı, şifre ve webhook adreslerini sunucuda gizli tutun. Ayrıntılar REST API güvenliği yazısında.
- Hata kaydı tutun: Başarısız aktarımları kaydedin ve yeniden deneme mekanizması kurun; sessizce kaybolan sipariş en pahalı hatadır.
Sık Sorulan Sorular
API ile web servis arasındaki fark nedir?
Günlük kullanımda ikisi de bir yazılımın başka bir yazılıma programla bağlanması anlamına gelir. "Web servis" ifadesi Türkiye'de çoğunlukla SOAP tabanlı eski servisler için, "API" ise REST tabanlı servisler için kullanılır.
Entegrasyon için yazılımcı gerekir mi?
Hazır entegrasyonlarda genellikle gerekmez; panelden API bilgilerini girmek yeterlidir. Özel bir akış, kendi yazılımınız veya hazır bağlantısı olmayan bir servis için geliştirici gerekir.
Webhook ne zaman tercih edilir?
Bir olay olduğunda karşı tarafa anında haber vermek gerektiğinde. Karşı taraf webhook sunmuyorsa belirli aralıklarla sorgulama yapılır.