E-Ticaret Platform Entegrasyonu: Tüm Kanallar Tek Sistem

API, sistemler arasında anlık ve çift yönlü iletişim kurar; sipariş geldiğinde saniyeler içinde karşı tarafa yazabilir. XML veya CSV ise belirli aralıklarla üretilen dosyaların okunmasıdır; tedarikçi kataloğu gibi büyük ve seyrek değişen veriler için uygundur ama gecikmelidir. Stok ve sipariş için API, toplu ürün aktarımı için dosya tabanlı yöntem tercih edilir; çoğu projede ikisi birlikte kullanılır.

Webhook'ta olay gerçekleştiğinde platform sizi tetikler; sipariş oluştuğu anda entegrasyona bildirim düşer, gecikme saniyeler düzeyindedir. Periyodik senkronda ise sistem belirli aralıklarla (örneğin 15 dakikada bir) karşı tarafa sorar. Webhook daha hızlı ve daha az kaynak tüketir ama bildirim kaybına karşı yedek olarak periyodik kontrol de kurulur; sağlam kurgular ikisini birlikte çalıştırır.

Eşleştirme öncelik sırasıyla yapılır: önce barkod (GTIN/EAN), yoksa stok kodu (SKU), en son ad benzerliği denenir. Otomatik eşleşmeyen kayıtlar bir eşleştirme ekranında elle bağlanır. En sağlıklısı barkodun tüm kanallarda tek doğru kaynak olmasıdır; barkodsuz katalogla kurulan entegrasyonlar ilerleyen aylarda mutlaka stok karışıklığı üretir.

Her varyantın kendi barkodu ve kendi stok kartı olmalıdır. Ana ürün yalnızca gruplama amaçlıdır; stok düşümü her zaman varyant seviyesinde yapılır. 42 beden siyah ile 43 beden siyah tek karta bağlanırsa bir numara tükendiğinde diğeri de yanlışlıkla kapanır ya da tükenen numara satılmaya devam eder. Entegrasyon öncesi varyant yapısının düzeltilmesi çoğu projede ilk iştir.

Tek bir ana stok kaynağı belirlenir ve tüm kanallar oradan beslenir. Ek olarak kanallara güvenlik payı tanımlanır: eldeki 10 adetten pazaryerine 8 yansıtılır, böylece senkron gecikmesinde tampon oluşur. Hızlı tükenen ürünlerde bu pay büyütülür, sipariş anında stok rezervasyonu devreye alınır. Kampanya günlerinde senkron aralığı geçici olarak sıkılaştırılır.

Standart satış yapıyorsanız ve iş kurallarınız sıra dışı değilse hazır servis hızlı ve ekonomiktir. Özel iskonto mantığı, parti/seri takibi, B2B fiyat listeleri veya yüksek hacim varsa hazır çözümün limitlerine takılırsınız. Aylık abonelik yıllara yayıldığında tek seferlik geliştirme bedelini geçebilir; bu karşılaştırmayı üç yıllık toplam maliyet üzerinden yapın. Benzer bir karar analizini Shopify mi özel e-ticaret mi karşılaştırmasında bulabilirsiniz.

İkas, Ticimax, İdeasoft, T-Soft, WooCommerce, Shopify, OpenCart ve Magento gibi yaygın altyapıların tamamı entegrasyon için API sunar. Farklılık kapsamdadır: bazıları sipariş ve stok için zengin uç noktalar verirken, bazılarında kampanya veya kupon tarafı sınırlıdır. Kurulum öncesi platformun API dokümanı incelenip hangi verinin hangi yönde taşınabileceği netleştirilir; sınırlı uçlar için eklenti veya dosya tabanlı alternatif kurgulanır.

Engellemez ama tasarımı belirler. Limitler dakika veya saat başına istek sayısıyla tanımlıdır; 5.000 ürünlük katalog tek seferde değil partiler halinde güncellenir. Sadece değişen kayıtları taşıyan artımlı senkron, istek sayısını çoğu projede onda birine düşürür. Limit aşımı durumunda istek silinmez, kuyrukta bekletilip artan aralıklarla yeniden denenir.

Sipariş onaylandığında cari kart kontrol edilir, yoksa açılır; ardından satış faturası ve stok hareketi oluşturulur. Ödeme yöntemi, kargo bedeli, indirim ve KDV oranları ayrı satırlar olarak eşlenir. Pazaryeri satışlarında komisyon ve hakediş kayıtları da ayrıca işlenir. Logo, Mikro, Netsis ve Paraşüt aktarımının ayrıntıları ayrı rehberde anlatılıyor.

Evet. Alıcının vergi numarası GİB mükellef listesinde varsa e-Fatura, yoksa e-Arşiv olarak kesilir; bu ayrım entegrasyonda otomatik yapılır. Belge sipariş onayı veya kargo çıkışı anında üretilecek şekilde ayarlanabilir. İade halinde iade faturası veya gider pusulası akışı da tanımlanmalıdır. Teknik detaylar GİB e-Fatura API entegrasyonu rehberinde yer alıyor.

Sipariş hazırlandı durumuna geçtiğinde kargo firmasının servisine gönderi kaydı açılır, takip numarası ve barkod geri döner. Etiket depoda basılır, numara müşteriye SMS veya e-posta ile iletilir. Kargo firması teslim durumunu geri bildirdiğinde sipariş otomatik kapanır. Birden fazla kargo firması kullanılıyorsa desi, il ve tutar kurallarına göre otomatik firma seçimi de kurgulanabilir.

İade talebi kanaldan düştüğünde ürün fiziksel olarak gelene kadar stok artırılmaz; teslim alındı onayıyla stok geri girer. Aynı anda iade faturası veya fatura iptali muhasebeye yazılır ve ödeme iadesi kaydı oluşur. İptalde ise sipariş henüz sevk edilmediği için stok rezervasyonu serbest bırakılır. Bu akış kurulmazsa stok ve muhasebe birkaç ay içinde birbirinden kopar.

Ödeme geçidi genelde e-ticaret platformunun kendi kurulumundadır, ancak mutabakat tarafı entegrasyonu ilgilendirir. Ödeme sağlayıcısının hakediş raporu ile siparişlerin eşleştirilmesi, komisyon ve taksit farklarının muhasebeye ayrı kalem olarak yazılması otomatikleştirilebilir. Böylece ay sonunda banka hesabına geçen tutar ile sistem kayıtları arasındaki fark elle aranmaz.

Tek platform ile tek muhasebe programı arasındaki temel akış genelde 2-4 hafta içinde canlıya alınır. Çok kanallı yapı, ERP bağlantısı, e-fatura ve kargo birlikte ele alındığında süre 6-12 haftaya çıkar. Süreyi asıl uzatan teknik bağlantı değil katalog temizliği ve karşı sistemin test ortamının hazır olmasıdır; bu iki iş paralel yürütülürse takvim belirgin şekilde kısalır.

Hayır. Geliştirme ve testler ayrı ortamda yapılır, canlı sistem çalışmaya devam eder. Devreye alma pilot ürün grubuyla başlar, sınırlı kategoriyle canlıya çıkılır ve eski süreç bir süre paralel yürütülür. Rakamlar tuttuğunda tüm katalog geçer. Kampanya dönemlerine denk gelen geçişler bilinçli olarak ertelenir.

Aktarımlar şifreli bağlantıyla yapılır, API anahtarları kod içinde değil ortam değişkenlerinde tutulur. Personele rol bazlı yetki verilir: depo yalnızca sipariş, muhasebe yalnızca belge tarafını görür. Müşteri verisi yalnızca işin gerektirdiği alanlarla taşınır, saklama ve silme süreleri KVKK'ya uygun tanımlanır ve tüm aktarımlar izlenebilir şekilde loglanır.

Süreç, mevcut kataloğun ve bağlanacak sistemlerin çıkarıldığı bir eşleştirme analiziyle başlıyor; bu aşamada eşleşmeyen ürünler ve mükerrer kayıtlar raporlanıyor. Ardından ara katman geliştiriliyor (bkz. omnichannel e-ticaret altyapımız Edge Core Suite), 30-50 ürünle pilot koşu yapılıyor ve eski süreçle paralel karşılaştırma dönemine geçiliyor. Teslimatta kaynak kod Git deposuyla, kurulum notlarıyla birlikte devrediliyor. Kapsam ve altyapı seçenekleri için e-ticaret çözümleri sayfasına göz atabilirsiniz.

Önce satış kanalını kurup ilk siparişleri almak, sonra hacim oluştukça entegrasyonu eklemek daha sağlıklıdır. Günde birkaç sipariş alan bir mağazada elle giriş yönetilebilir; sipariş sayısı günlük 20-30'u geçtiğinde entegrasyon zorunlu hale gelir. Kuruluş adımları için e-ticaret sitesi nasıl açılır rehberine bakabilirsiniz.