Üçüncü Parti Entegrasyon İhtiyacı Olan E-Ticaret Platformları İçin API Geliştirme
Ödeme, kargo, pazar yeri, ERP ve e-fatura ayrı ayrı doğru çalışıyor olabilir; ama aralarını insan taşıyorsa sipariş hacmi arttıkça hata da artar. Bu servisleri tek bir entegrasyon katmanında birleştiriyoruz: sipariş düşer, ödeme doğrulanır, fatura kesilir, kargo etiketi çıkar.
- Idempotent sipariş işleme
- İmzalı webhook doğrulaması
- Logo ERP çözüm ortağı
- OpenAPI + Postman teslimi
Sorun sipariş almak değil; siparişi taşımak.
E-ticarette entegrasyon ihtiyacı çoğunlukla ciro büyüdüğünde değil, kanal sayısı arttığında ortaya çıkıyor. Her yeni kanal, aynı işi bir kez daha yapmak anlamına geliyor.
- Gün altı panel arasında geçiyorMağaza paneli, pazar yeri paneli, kargo paneli, ödeme paneli, ön muhasebe. Aynı sipariş bilgisi gün içinde birkaç kez elle taşınıyor.
- Aynı ürün iki kanalda birden satılıyorStok kanal başına ayrı tutulunca son adet iki yerde birden satılıyor. Sonuç: iptal, iade ve pazar yerinde performans kaybı.
- Fatura kesimi gün sonuna kalıyorSiparişler akşam toplu işleniyor. Bir kayıt atlandığında fark ancak mutabakat sırasında, günler sonra ortaya çıkıyor.
- Ödeme bildirimi kaçtığında sipariş asılı kalıyorBanka ya da gateway bildirimi ulaşmazsa sipariş 'ödeme bekliyor' durumunda donuyor. Müşteri arayana kadar kimse fark etmiyor.
- Kargo takibi müşteriye elle yazılıyorTakip numarası panelden kopyalanıp e-postaya yapıştırılıyor. Yoğun günde bu iş tek başına bir kişinin mesaisini dolduruyor.
- Yeni kanal açmak korkutucu hale geliyorHer yeni pazar yeri, mevcut operasyona bir panel daha ekliyor. Büyüme kararı teknik değil, insan gücü sorununa dönüşüyor.
Sipariş düşer, gerisi kendiliğinden yürür.
Entegrasyon katmanı sipariş yaşam döngüsündeki her adımı sıraya koyar; her adımın kendi doğrulaması, yeniden denemesi ve kaydı vardır. İnsanın devreye girdiği tek yer, kural dışı kalan işlerdir.
- Sipariş alınırMağaza veya pazar yerinden gelen sipariş tek formata çevrilir; kanal farkı entegrasyon katmanının içinde kalır.
- Ödeme doğrulanırGateway bildirimi imzasıyla birlikte doğrulanır; işlem anahtarı kaydedilir, aynı bildirim ikinci kez işlenmez.
- Stok düşülürRezervasyon anında yapılır ve kalan miktar tüm satış kanallarına iletilir.
- ERP'ye yazılırSipariş cari ve ürün eşleşmesiyle ERP'ye aktarılır; fatura belgesi tek kaynaktan üretilir.
- Kargo etiketi üretilirSeçilen kargo firmasında gönderi oluşturulur, takip numarası siparişe işlenir.
- Müşteri bilgilendirilirDurum değişiminde e-posta veya SMS tetiklenir; iade talebi de aynı akışın tersinden ilerler.
Kapsamınızı ve senkron sıklığınızı seçin
Hangi servisleri bağlayacağınızı işaretleyin, her biri için senkron sıklığını belirleyin. Ekranda kapsamın büyüklüğünü, kaç akışın anlık çalışması gerektiğini ve hangi seçimlerin risk taşıdığını görün. Hiçbir veri kaydedilmez.
Her akışın anlık olması gerekmez. Yanlış olduğunda doğrudan satışa zarar veren veriler anlık, diğerleri periyodik çalışabilir.
Kritik akışların hepsi önerilen sıklıkta. Kalan kararlar alan eşlemesi ve iade senaryolarında yoğunlaşacak.
- Servis başına bağlayıcı ve hata yönetimi
- İmza doğrulamalı webhook uçları
- Idempotency anahtarı ile mükerrer koruması
- OpenAPI dokümantasyonu ve Postman koleksiyonu
- Akış izleme panosu ve uyarı kuralları
- Sandbox ortamında kabul testi
Buradaki uç nokta sayısı, seçtiğiniz servislerin tipik entegrasyon yüzeyinden türetilen örnek bir büyüklük göstergesidir; süre, fiyat veya teslim taahhüdü değildir. Gerçek kapsam, servislerin dokümantasyonu ve iade/iptal senaryolarınız incelendikten sonra netleşir.
Aşırı satışın kaynağı stok değil; stoğun kaç yerde tutulduğu.
Kanal başına ayrı stok tutmak, düşük hacimde yönetilebilir görünür. Ürün çeşidi ve kanal sayısı arttığında ise aynı adedin iki yerde satılması istisna olmaktan çıkar.
Çözüm, stoğu tek bir havuzda tutup her kanalın oradan okumasıdır. Satış olduğunda rezervasyon anında düşülür, kalan miktar tüm kanallara iletilir. Kanal başına güvenlik payı tanımlamak da mümkündür: örneğin son bir adedi yalnız kendi mağazanıza bırakabilirsiniz. Stok verisinin sahibi ERP ise okuma oradan yapılır; Logo ERP çözüm ortaklığı kapsamında bu bağlantıyı kuruyoruz.
Alan eşleme, birim çevrimi ve senkron sıklığı kararlarını ayrıntılı anlatan Logo ERP entegrasyonu: e-ticaret ve B2B rehberimiz projeye başlamadan önce okunmaya değer. OpenCart tabanlı mağazalarda aynı yaklaşımı kendi ürünümüz OpencartExtra üzerinde uyguluyoruz; B2B ve teklif tarafında ise TYS devreye giriyor. Operasyon ekranlarına ihtiyaç duyulduğunda web yazılım geliştirme tarafıyla birlikte planlıyoruz.
Pazar yerlerinin kendi güncelleme gecikmeleri devrede kaldığı için hiçbir kurulum aşırı satışı sıfırlayacağını söyleyemez. Hedef, riski yönetilebilir bir seviyeye indirmek ve olay gerçekleştiğinde hangi kanalda ne olduğunu kayıttan görebilmektir.
Para ve stok hareketinde geri alınamayan işler var.
E-ticaret entegrasyonunu diğerlerinden ayıran şey, hataların doğrudan tahsilata ve müşteri deneyimine dokunması. Bu yüzden akışları baştan 'ikinci kez gelirse ne olur' sorusuna göre kuruyoruz.
- İmza doğrulamaGelen her ödeme bildirimi, servisin paylaştığı anahtarla doğrulanır. İmzası geçersiz çağrı sipariş durumunu değiştiremez.
- Idempotency anahtarıHer sipariş ve ödeme olayı benzersiz anahtarla kaydedilir; tekrar gelen aynı olay yeni kayıt açmaz.
- Kuyruk ve hız sınırıKarşı servisin kota sınırına uygun hızda gönderim; yoğunlukta sipariş kaybı yerine kontrollü gecikme.
- Mutabakat raporuGün sonunda kanal, ödeme ve ERP kayıtlarını karşılaştıran fark listesi; eksik kalan kayıt gözden kaçmaz.
Bu davranışların tamamı kabul kriterlerine yazılır ve canlıya alınmadan önce sandbox ortamında gerçek senaryolarla test edilir. Ödeme tarafında test kartlarıyla başarısız, iptal ve kısmi iade akışları da denenir.
Örnek bir ilk faz: ödeme, kargo ve ERP
Aşağıdaki plan üç servisin bağlandığı tipik bir ilk faz için hazırlanmış örnektir. Sizin planınız kapsam netleştikten sonra çıkar ve sözleşmede yazılı tarihe bağlanır.
| Hafta | Ne yapılır | Hafta sonunda elinizde ne olur |
|---|---|---|
| 1. hafta | Servis envanteri ve test hesapları | Servis listesi, sandbox erişimleri |
| 2. hafta | Sipariş modeli ve alan eşleme | Ortak sipariş şeması, eşleme tablosu |
| 3. hafta | Ödeme entegrasyonu | 3D Secure akışı, imzalı webhook |
| 4. hafta | ERP bağlantısı | Cari/ürün okuma, sipariş yazma |
| 5. hafta | Kargo ve bildirim | Etiket, takip, müşteri e-postası |
| 6. hafta | İade ve kural dışı senaryolar | İptal, kısmi iade, hata listesi |
| 7. hafta | Yük ve kabul testi | Kuyruk davranışı, kabul raporu |
| 8. hafta | Canlı geçiş ve izleme | Pano, uyarı kuralları, devir |
İlk faz kapandıktan sonra pazar yeri ve B2B kanalları aynı katmana eklenir; sipariş modeli tek kez tanımlandığı için her yeni kanal öncekinden kısa sürer.
- HizmetAPI GeliştirmeHizmetin tamamı: kapsam, süreç, teslimatlar ve teknoloji yığını.
- HizmetLogo ERP Çözüm OrtaklığıSipariş, fatura ve cari tarafındaki ERP bağlantısı.
- HizmetWeb Yazılım GeliştirmeEntegrasyon katmanının üstüne oturan operasyon ekranları.
- HizmetTeknik DanışmanlıkKanal ve altyapı kararlarında bağımsız değerlendirme.
- ProjeOpencartExtraOpenCart tabanlı mağazalar için geliştirdiğimiz kendi ürünümüz.
- ProjeTYS — Teklif Yönetim SistemiLogo entegre teklif ve sipariş akışı; kendi ürünümüz.
- RehberLogo ERP entegrasyonu: e-ticaret ve B2B rehberiAlan eşleme, senkronizasyon ve sık yapılan hatalar.
- RehberSızma testi (pentest) nedir?Ödeme akışı olan sistemlerde güvenlik doğrulaması.
Sık sorulanlar
Servis listesi, stok senkronu, ERP akışı, mükerrer bildirim ve yoğunluk yönetimi hakkında en çok sorulanlar.
Hangi servisten başlayacağımızı birlikte belirleyelim
Kanallarınızı, bugün elle yaptığınız adımları ve iade senaryolarınızı anlatın; ilk görüşmede operasyonu en çok yavaşlatan akışı tespit edip gerçekçi bir ilk faz kapsamı çıkaralım. Keşif görüşmesi ücretsizdir ve sizi bağlamaz.
- ✓ Keşif görüşmesi ücretsiz
- ✓ Kapsam netleşmeden fiyat vermiyoruz
- ✓ Sandbox ortamında kabul testi
Sipariş akışını panel gezmekten kurtaralım
Ödeme, kargo, pazar yeri ve ERP bağlantılarını tek katmanda toplayıp her adımı kayıtlı, yeniden denenebilir ve izlenebilir hale getiriyoruz.