WooCommerce entegrasyonu: kurulumdan önce bilmeniz gereken teknik ayrıntılar
WooCommerce entegrasyonu, WordPress üzerindeki mağazanızın stok, fiyat ve siparişlerini pazaryerlerindeki ilanlarınızla aynı kayıttan yönetmenizi sağlar. WooCommerce açık kaynaklı ve esnek bir altyapı olduğu için her sitenin ayarı farklıdır; bağlantının sorunsuz çalışması da büyük ölçüde stok yönetimi, SKU ve sipariş durumu ayarlarına bağlıdır. Aşağıda bu ayarları, API anahtarının nasıl oluşturulacağını ve kurulumdan önce kontrol etmeniz gerekenleri adım adım anlattık.
WooCommerce entegrasyonu hangi sorunu çözer?
WooCommerce sitesi olan birçok satıcı bir noktada Trendyol, Hepsiburada ya da n11 gibi pazaryerlerine de açılır. Sorun burada başlar: sitedeki stok sayısı bir yerde, pazaryerindeki stok başka bir yerde tutulur. Sitede son ürün satıldığında pazaryerindeki ilan açık kalırsa aynı ürünü iki kez satarsınız; iptal edilen sipariş de pazaryerinde satıcı puanınızı etkileyebilir.
Bu ihtiyacı karşılamanın iki yaygın yolu vardır. Birincisi, her pazaryeri için WordPress'e ayrı bir eklenti kurmaktır. Bu yöntem tek kanal için yeterli olabilir; ancak kanal sayısı arttıkça eklentiler sitenizin sunucusunda çalışır, zamanlanmış görevler WordPress'in kendi zamanlayıcısına bağlı kalır ve her eklentinin varyasyon desteği farklı olur. İkincisi, stok kartını site dışında tek bir panelde tutup WooCommerce'i de bu panele bir satış kanalı olarak bağlamaktır. eticaretcim ikinci yaklaşımı kullanır:
- Ürünün stok sayısı tek kartta tutulur; WooCommerce ve pazaryerleri bu karttan beslenir.
- Sitede ya da pazaryerinde satılan ürün, diğer kanallardaki stoktan düşer.
- Siparişler kanal fark etmeksizin tek listede toplanır.
- Her pazaryeri için WordPress'e ayrı eklenti kurmanız gerekmez; WooCommerce panele kendi REST API anahtarıyla bağlanır.
Senkronun mantığını ayrıntılı görmek isterseniz stok ve fiyat senkronizasyonu sayfasına bakabilirsiniz.
WooCommerce REST API anahtarı nasıl oluşturulur?
Bağlantı için mağaza yönetici şifrenizi paylaşmazsınız. WooCommerce, dış uygulamalara erişim vermek için kendi REST API anahtarlarını kullanır; anahtarı siz oluşturur, istediğiniz an iptal edersiniz. Adımlar şöyledir:
- WordPress yönetim panelinde Ayarlar > Kalıcı bağlantılar ekranını açın ve yapıyı Düz (Plain) dışında bir seçeneğe alın. WooCommerce belgelerine göre varsayılan düz bağlantılarla REST API çalışmaz.
- WooCommerce > Ayarlar > Gelişmiş > REST API sekmesine gidin ve Anahtar ekle düğmesine basın.
- Açıklama alanına anahtarı sonradan tanıyacağınız bir ad yazın, örneğin "eticaretcim stok ve sipariş".
- Kullanıcı olarak ürünlere ve siparişlere erişebilen bir yönetici hesabı seçin; anahtar bu kullanıcının yetkileriyle çalışır.
- İzin düzeyini Okuma/Yazma (Read/Write) yapın. Yalnız okuma izniyle stok güncellenemez.
- API anahtarı oluştur düğmesine basın ve ekranda görünen Consumer Key ile Consumer Secret değerlerini sekmeyi kapatmadan kopyalayın; anahtarı sonradan açtığınızda Secret değeri gizlenir.
- Bu iki değeri ve site adresinizi panelde WooCommerce bağlantı ekranına girin.
WooCommerce REST API bağlantı hataları ve çözümleri
WooCommerce geliştirici belgelerine göre 401 Unauthorized hatası, anahtarın ya da imzanın yanlış olduğunu gösterir. Bu durumda anahtarı oluşturan kullanıcının ilgili kayıtlara erişebildiğini kontrol edin, gerekirse yeni bir anahtar üretin; sunucunuz FastCGI kullanıyorsa Authorization başlığının doğru okunup okunmadığını barındırma firmanıza sorun. "Consumer key is missing" hatası da sunucunun Authorization başlığını işleyememesinden kaynaklanan bir sunucu sorunudur. ModSecurity kullanan sunucularda 501 Method Not Implemented hatası görülebilir; WordPress güvenlik eklentileri de REST API isteklerini engelleyebilir. Belgeler API trafiği için HTTPS öneriyor, bu yüzden sitenizde geçerli bir SSL sertifikası olduğundan emin olun.
WooCommerce stok entegrasyonu için doğru ayarlar
WooCommerce stok entegrasyonunun sağlıklı çalışması, sitenizdeki stok ayarlarının tutarlı olmasına bağlıdır. Kurulumdan önce şu üç noktayı kontrol edin.
WooCommerce stok yönetimi ayarı açık mı?
WooCommerce > Ayarlar > Ürünler > Envanter ekranındaki Stok yönetimi seçeneği kapalıysa WooCommerce adet tutmaz, ürün yalnız "stokta", "stokta yok" ya da "ön sipariş" durumunda görünür. Adet bazlı senkron için bu seçenek genel ayarda ve ürün düzeyinde açık olmalıdır. Varyasyonlu ürünlerde stok her varyasyonun kendi satırında yönetilmelidir; ana üründe tek bir toplam adet tutmak beden ya da renk bazında aşırı satışa yol açar.
SKU ve barkod eşleşmesi
Mevcut ilanlarınız panele okunduğunda ürünler barkod ya da stok koduyla eşleşir. WooCommerce'te bu bilgi genellikle SKU alanındadır. Aynı ürünün sitede "TSRT-01-M", pazaryerinde başka bir kodla kayıtlı olması eşleşmeyi bozar. Varyasyonlara da ayrı SKU verin ve boş SKU bırakmayın.
Stok bekletme süresi ve sipariş durumları
WooCommerce stoğu siparişin durumuna göre düşer ya da geri ekler. Stok beklet (dakika) ayarı, ödemesi tamamlanmamış siparişler için stoğu belirli bir süre ayırır; süre dolunca bekleyen sipariş iptal edilir ve stok geri döner. Belgelere göre durumların stoğa etkisi şöyledir:
| WooCommerce sipariş durumu | Anlamı | Stoğa etkisi |
|---|---|---|
| Ödeme bekliyor (Pending payment) | Sipariş alındı, ödeme yapılmadı | Düşmez; stok bu süre boyunca ayrılmış tutulur |
| İşleniyor (Processing) | Ödeme alındı, hazırlanmayı bekliyor | Düşer |
| Beklemede (On hold) | Havale gibi ödemelerde onay bekleniyor | Düşer |
| Tamamlandı (Completed) | Sipariş hazırlandı ve tamamlandı | Yeni bir değişiklik olmaz |
| Başarısız (Failed) | Ödeme reddedildi ya da tamamlanamadı | Daha önce düşülmüşse geri eklenir |
| İptal edildi (Cancelled) | Yönetici ya da müşteri iptal etti | Stok yönetimi açıksa geri eklenir |
| İade edildi (Refunded) | Tutarın tamamı iade edildi | Otomatik değişmez; stoğa dönüşü ayrıca kontrol edin |
WooCommerce site fiyatı ile pazaryeri fiyatı nasıl ayrılır?
Pazaryeri komisyonu ve kargo kesintisi yüzünden çoğu satıcı pazaryerinde siteden daha yüksek fiyat kullanır. Panelde her kanal için yüzde ya da tutar olarak fiyat farkı tanımlayabilirsiniz. Böylece ana fiyatı tek kartta değiştirdiğinizde kanal fiyatları bu kurala göre hesaplanır.
Örnek: Ürünün site fiyatı 500 TL. Pazaryeri için %15 fark tanımlarsanız ilan fiyatı 575 TL olur. Kesintilerden sonra ne kadar kaldığını hesaplamak için komisyon ve kargo kesintisi rehberine göz atın.
- WooCommerce'te normal fiyat ile indirimli fiyat ayrı alanlardır; site kampanyasının pazaryerine yansıyıp yansımayacağına önceden karar verin.
- Yüzde farkı ürün fiyatıyla birlikte büyür, tutar farkı sabit kalır. Fiyat aralığınız genişse iki yöntemi birkaç örnek üründe karşılaştırın.
- Fiyat değişikliklerini toplu yapmadan önce birkaç üründe deneyin.
WooCommerce sipariş entegrasyonu: kargo etiketi, e-Fatura ve iade
Sitenizden gelen siparişler pazaryeri siparişleriyle birlikte tek listede Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim aşamalarıyla izlenir. Bu, sabah depoya girdiğinizde "hangi kanaldan ne çıkacak" sorusunu tek ekranda cevaplar. Ayrıntılar sipariş yönetimi sayfasında.
- Kargo: Kendi kargo sözleşmenizle firmayı bağlayıp birincil kargoyu seçebilir, barkod ve etiketi panelden alabilirsiniz. Desteklenen firmalar kargo entegrasyonu sayfasında listelenir.
- Fatura: Profesyonel ve üstü paketlerde siparişe otomatik e-Arşiv ya da e-Fatura kesilebilir; bunun için muhasebe veya e-fatura programınızın bağlı olması gerekir.
- Geciken sipariş uyarısı: Gecikmeye giren siparişler için panelde uyarı görürsünüz.
- İadeler: İade ve talepler ayrı bir kutuda toplanır; WooCommerce'te iade edilen siparişin stoğa dönüşünü ayrıca kontrol edin.
WooCommerce entegrasyon programı fiyatı: hangi paket gerekir?
Paket seçerken WooCommerce'in de bir satış kanalı sayıldığını unutmayın. Başlangıç paketindeki tek kanal yalnız Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ve idefix arasından seçilebilir; WooCommerce bu listede olmadığı için sitenizi bağlamak için en az Büyüme paketi gerekir.
| Paket | Kanal hakkı | WooCommerce ile örnek kurulum |
|---|---|---|
| Büyüme (₺999/ay) | 80 kanaldan herhangi üçü | WooCommerce + Trendyol + Hepsiburada |
| Profesyonel (₺1.999/ay) | 28 kanaldan 5'i | WooCommerce için durumu demo görüşmesinde birlikte kontrol ederiz |
| Kurumsal (₺3.999/ay) | Sınırsız | WooCommerce + istediğiniz kadar pazaryeri; depo yönetimi (5 depo) |
| Enterprise (₺7.999/ay) | Sınırsız, bütün limitler sınırsız | Çoklu şirket yapısı, özel SLA |
Yıllık ödemede %20 indirim uygulanır. Ürün ve aylık sipariş limitlerinin karşılaştırması paketler ve fiyatlar sayfasında. Pazaryeri tarafının kurallarını öğrenmek için Trendyol entegrasyonu sayfasıyla başlayabilirsiniz.
WooCommerce entegrasyonu kontrol listesi ve sık yapılan hatalar
Entegrasyonda yaşanan sorunların çoğu bağlantıdan değil, sitedeki verinin dağınıklığından çıkar. Bağlamadan önce şu listeyi tamamlayın:
- Bütün ürün ve varyasyonlarda SKU dolu ve tekil mi?
- Stok yönetimi genel ayarda ve ürün düzeyinde açık mı?
- Kalıcı bağlantılar "Düz" dışında bir yapıda mı?
- SSL sertifikası geçerli mi, güvenlik eklentisi REST API'yi engelliyor mu?
- Havale siparişlerinde "Beklemede" durumunda kalan eski siparişler temizlendi mi?
- Aynı ürün için başka bir stok eklentisi çalışıyor mu? İki ayrı aracın aynı stoğu güncellemesi çakışma yaratır.
Mevcut ilanlarınız panele okunduktan sonra satıcı onaylamadan hiçbir ilan değişmez; stok çakışmaları listesi ve senkron sağlığı ekranı tutarsız kayıtları ayrıca gösterir. Çok kanallı stokta dikkat edilecek diğer noktalar için aşırı satışı önleme rehberini okuyabilirsiniz.
- WooCommerce REST API (woocommerce.com)
- Getting started with the WooCommerce REST API (developer.woocommerce.com)
- WooCommerce Settings: Products > Inventory
- WooCommerce Order Statuses
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi
