Online satış yapan bir işletmede aynı ürün iki yerde yaşar: muhasebe ve stok takibinin yapıldığı ticari yazılımda ve müşterinin gördüğü e-ticaret sitesinde. İki taraf elle güncellendiğinde stokta olmayan ürün satılır, fiyat farkı oluşur, siparişler faturaya geç döner. E-ticaret sitesi ile ticari yazılım entegrasyonu bu iki dünyayı otomatik olarak konuşturur. Bu yazıda entegrasyonun neleri otomatik hale getirdiğini, hangi yöntemlerin kullanıldığını ve projeye başlamadan önce yapılması gereken hazırlığı anlatıyoruz.
Entegrasyon neyi otomatik hale getirir?
Stok
Ticari yazılımdaki depo miktarları belirli aralıklarla siteye aktarılır. Stoğu biten ürün satışa kapanır, yeniden gelen ürün açılır. Birden fazla depo varsa hangi depoların "satılabilir stok" sayılacağı baştan tanımlanmalıdır.
Fiyat
Satış fiyatları, fiyat listeleri ve kampanya fiyatları ticari yazılımdan siteye taşınır. Döviz bazlı fiyatlanan ürünlerde kur dönüşümünün hangi tarafta yapılacağı ve yuvarlama kuralları netleştirilmelidir.
Sipariş → sipariş fişi veya fatura
Sitede oluşan sipariş, ticari yazılıma sipariş fişi, irsaliye veya fatura olarak aktarılır. Kargo ücreti, indirim kuponu ve ödeme yöntemi (kredi kartı, havale, kapıda ödeme) gibi kalemlerin ticari yazılımda hangi hesaplara ve hizmet kartlarına düşeceği tanımlanır.
Cari hesap
Yeni müşteri için otomatik cari kart açılır veya vergi numarası, T.C. kimlik numarası ya da e-posta ile mevcut cari eşleştirilir. Bireysel ve kurumsal müşterilerin fatura bilgileri doğru alanlara yazılmalıdır; aksi halde e-fatura/e-arşiv sürecinde hata çıkar.
Ürün bilgileri
Ürün adı, barkod, marka, kategori ve birim gibi temel bilgiler ticari yazılımdan siteye aktarılabilir. Açıklama, görsel ve SEO alanları ise çoğunlukla sitede yönetilir; hangi alanın "ana kaynağının" hangi sistem olduğu baştan karara bağlanmalıdır.
Entegrasyon yöntemleri: XML, API ve veritabanı
| Yöntem | Nasıl çalışır? | Artısı | Dikkat edilecek nokta |
|---|---|---|---|
| XML/CSV dosyası | Ticari yazılımdan periyodik dosya üretilir, site dosyayı okur | Kurulumu basit, düşük maliyetli | Genelde tek yönlü; büyük katalogda dosya ağırlaşır |
| API (REST/SOAP) | Bir ara servis iki sistemin API'leriyle konuşur | Çift yönlü, kontrollü, değişen kayıt bazında | Ticari yazılımın API/lisans durumu kontrol edilmeli |
| Doğrudan veritabanı | Ara servis ticari yazılımın veritabanını okur | Hızlı ve esnek okuma | Yazma işlemleri riskli; sürüm güncellemelerinde yapı değişebilir |
Logo, Netsis, ETA, Akınsoft gibi ticari yazılımların her birinin dış sistemlerle veri alışverişi için sunduğu yöntem, sürüme ve lisans paketine göre farklılık gösterir. Pratikte sağlıklı yaklaşım çoğunlukla şudur: okuma (stok, fiyat) için hızlı ve kontrollü bir yöntem, yazma (sipariş, cari, fatura) için ise ticari yazılımın desteklediği resmi aktarım yolu.
Entegrasyon projesi nasıl ilerler?
Sağlıklı bir entegrasyon projesi genellikle şu adımlardan geçer:
- Analiz: Hangi verinin hangi yönde, hangi sıklıkla akacağı ve hangi sistemin ana kaynak olduğu belirlenir.
- Alan eşleştirme: Ticari yazılımdaki stok kartı, fiyat listesi, cari ve fatura alanlarının sitedeki karşılıkları tabloya dökülür.
- Test ortamı: Ticari yazılımın test şirketi veya veritabanı kopyası ile sitenin test kopyası üzerinde aktarımlar denenir.
- Pilot: Önce sınırlı bir ürün grubu ile canlıya geçilir, sonuçlar birkaç gün izlenir.
- Tam geçiş ve izleme: Tüm katalog açılır; loglar ve hata bildirimleri ilk haftalarda yakından takip edilir.
Senkron sıklığı
"Anlık olsun" talebi anlaşılır, ancak her saniye tüm kataloğu aktarmak hem sunucuyu hem ticari yazılımı yorar. Dengeli bir kurgu:
- Stok: Hızlı dönen ürünlerde 5–15 dakikada bir, yalnızca değişen kayıtlar.
- Fiyat: Günde birkaç kez veya fiyat güncellendiğinde tetiklenerek.
- Sipariş: Sipariş oluştuğunda veya birkaç dakikalık aralıklarla.
- Ürün kartı: Yeni ürün açıldığında veya günlük.
- Tam eşitleme: Gece saatlerinde, gün içi kaçan farkları kapatmak için.
Yalnızca değişen kayıtları göndermek (son değişiklik tarihi veya değişiklik kuyruğu ile) sıklığı artırmanın en verimli yoludur.
Pazaryerleri ve çoklu kanal
Ürünler hem kendi sitenizde hem pazaryerlerinde satılıyorsa stok tek bir kaynaktan yönetilmelidir. Aksi halde aynı son ürün iki kanalda birden satılır. Bu yapıda ticari yazılım ana stok kaynağı olur, e-ticaret sitesi ve pazaryerleri bu stoğu okur; her kanaldan gelen sipariş de aynı ticari yazılıma aktarılarak stoktan düşer. Kanal bazında farklı fiyat listeleri gerekiyorsa bunlar da ticari yazılımda ayrı fiyat listesi olarak tanımlanabilir.
Hata yönetimi: Entegrasyonun görünmeyen yarısı
Entegrasyonun asıl kalitesi, bir şey ters gittiğinde ortaya çıkar. Ürün kodu bulunamayan bir sipariş, kapalı dönem nedeniyle reddedilen bir fatura veya internet kesintisi sırasında gelen siparişler kaybolmamalıdır. İyi bir entegrasyonda:
- Her aktarım loglanır; neyin, ne zaman, hangi sonuçla gönderildiği görülebilir.
- Başarısız kayıtlar kuyrukta bekler ve otomatik olarak yeniden denenir.
- Aynı siparişin iki kez faturalanmaması için tekrar kontrolü (idempotency) yapılır.
- Çözülemeyen hatalar için sorumlu kişiye e-posta veya panel bildirimi gider.
- Stok düşüş hatalarında "eksiye satış" riskine karşı güvenlik payı tanımlanabilir.
Başlamadan önce: Ürün kodu ve stok kartı temizliği
Entegrasyon projelerinde en çok zaman alan iş genellikle yazılım değil, veridir. Ticari yazılımda yıllar içinde biriken düzensizlik, entegrasyonla birlikte siteye taşınır. Başlamadan önce:
- Ürün kodlarını benzersiz ve tutarlı hale getirin. Aynı ürün için iki stok kartı, boşluk veya küçük/büyük harf farkı olan kodlar eşleşme hatalarına yol açar.
- Pasif ve mükerrer kartları ayıklayın. Satılmayan veya kopya kartlar sitede gereksiz ürün kalabalığı oluşturur.
- Birim, KDV ve fiyat alanlarını kontrol edin. Adet/koli/metre gibi birim farkları ve hatalı KDV oranları siparişte yanlış tutar demektir.
- Varyant yapısını netleştirin. Renk ve beden gibi seçeneklerin ticari yazılımda ayrı kartlar mı, tek kart altında varyant mı olduğu sitedeki gösterimi belirler.
- Kategori eşleşmesini planlayın. Ticari yazılımdaki grup kodlarının sitedeki kategori ağacına nasıl karşılık geleceğini bir tabloda belirleyin.
Bu temizlik yalnızca entegrasyon için değil, ticari yazılımdaki raporların doğruluğu için de faydalıdır. Tutarlı ürün kodları; stok sayımını, alış–satış analizini ve tedarikçi XML dosyalarıyla yapılacak olası eşleştirmeleri de kolaylaştırır. Bu nedenle temizlik işini entegrasyon projesinin ilk ve ayrı bir aşaması olarak planlamak, sonraki adımlarda yaşanacak sorunların büyük kısmını önler.
Sonuç
İyi kurgulanmış bir entegrasyon; stok hatalarını, fiyat farklarını ve elle yapılan sipariş girişini ortadan kaldırarak personelin zamanını satışa ve müşteriye ayırmasını sağlar. OpenCart başta olmak üzere e-ticaret siteleri ile Logo, ETA, Vega, Netsis gibi ticari yazılımlar arasında stok, fiyat ve ürün aktarımını otomatik hale getiren entegrasyon çözümlerimizi inceleyebilirsiniz. Sıfırdan bir e-ticaret sitesi veya mevcut sitenize özel geliştirme ihtiyacınız varsa web yazılım hizmetlerimiz sayfasından bize ulaşabilirsiniz.
Sık sorulan sorular
E-ticaret entegrasyonu hangi işleri otomatik hale getirir?
XML ile mi API ile mi entegrasyon yapılmalı?
Stok ne sıklıkla senkronize edilmeli?
Entegrasyondan önce ne hazırlanmalı?
Bu konuda destek mi lazım?
E-ticaret siteniz ile ticari yazılımınız arasında stok, fiyat ve ürün aktarımını otomatik hale getiren entegrasyon yazılımları…

