WooCommerce entegrasyonu:
siteniz ve pazaryerleri aynı stokta.

WooCommerce entegrasyonu nedir ve ne zaman gerekir?

WooCommerce entegrasyonu, sitenizdeki ürün kartlarını merkezi bir stok ve sipariş akışına bağlamaktır: sitede satılan ürün pazaryerinde, pazaryerinde satılan ürün sitede düşer. WooCommerce, WordPress için geliştirilmiş açık kaynaklı bir e-ticaret eklentisidir ve tek başına yalnız kendi sitesinin stoğunu bilir. Trendyol, Hepsiburada ya da Amazon'da da satmaya başladığınız gün aynı ürün için iki ayrı stok sayısı oluşur; sipariş sayısı arttıkça bunları elle eşitlemek hata üretir.

Bir entegrasyona ihtiyacınız olduğunu genellikle şu işaretlerden anlarsınız:

• Sitede tükenen ürün pazaryerinde satılmaya devam ediyor ve siparişi iptal etmek zorunda kalıyorsunuz.
• Gün sonunda stokları tablo üzerinden karşılaştırıyorsunuz.
• Siparişleri WordPress yönetim panelinden ve her pazaryerinin satıcı panelinden ayrı ayrı topluyorsunuz.
• Sitede fiyat değiştirdiğinizde pazaryeri fiyatlarını tek tek güncelliyorsunuz.

WordPress eklentisi mi, harici panel mi?

İki yaygın yol vardır. Birincisi her pazaryeri için WordPress'e ayrı eklenti kurmaktır: eklenti sitenizin sunucusunda çalışır, zamanlanmış işleri WP-Cron'a bağlıdır ve her kanal kendi ayarını ister. İkincisi stok kartını site dışındaki bir panelde tutup WooCommerce'i bu panele bir satış kanalı olarak bağlamaktır. Yox İş Ortağım ikinci modeli kullanır; siteniz panele REST API anahtarıyla bağlanır, pazaryerleri de aynı üründen beslenir. Tek pazaryerinde az ürün satıyorsanız eklenti yeterli olabilir; kanal sayısı arttıkça tek merkez daha az hata üretir. Aynı karar Shopify kullanan satıcılar için de geçerlidir; farkları Shopify entegrasyonu sayfasında anlattık.

WooCommerce REST API: bağlantının dayandığı resmî kurallar

WooCommerce REST API, mağaza verisini JSON biçiminde okuyup yazmaya yarayan ve WordPress REST API'sine yerleşik gelen arayüzdür; WooCommerce belgelerine göre bunun için ayrı bir REST API eklentisi kurmanız gerekmez. Sitenizin aşağıdaki şartları karşılaması bağlantının ön koşuludur. Tablodaki kurallar WooCommerce REST API v3 belgesinden alınmıştır.

WooCommerce entegrasyonu için REST API anahtarı nasıl oluşturulur?

REST API anahtarı, bir WordPress kullanıcısının yetkileriyle sınırlı çalışan ve dilediğiniz an iptal edebileceğiniz bir erişim çiftidir; bu sayede bağlantı için yönetici şifrenizi kimseyle paylaşmazsınız. WooCommerce belgelerindeki akış şöyledir:

1. Ayarlar > Kalıcı bağlantılar ekranında yapının Düz (Plain) olmadığını doğrulayın.
2. WooCommerce > Ayarlar > Gelişmiş > REST API sekmesini açın ve Anahtar ekle (Add key) düğmesine basın.
3. Açıklama alanına anahtarın amacını yazın, örneğin Yox İş Ortağım bağlantısı; birden fazla anahtarınız olduğunda hangisini iptal edeceğinizi bu addan anlarsınız.
4. Kullanıcı listesinden ürün ve siparişleri yönetme yetkisi olan hesabı seçin.
5. İzin düzeyini Okuma/Yazma (Read/Write) yapın ve API anahtarı oluştur (Generate API Key) düğmesine basın.
6. Ekranda beliren Consumer Key ve Consumer Secret değerlerini kopyalayın; WooCommerce belgelerine göre Consumer Secret yalnız bir kez gösterilir.
7. İki değeri site adresinizle birlikte Yox İş Ortağım'daki WooCommerce bağlantı ekranına girin.

Okuma, Yazma ya da Okuma/Yazma: hangi izin seçilmeli?

WooCommerce üç izin düzeyi sunar. Yalnız Okuma izniyle ürünler ve siparişler panele gelir ama stok ve fiyat siteye geri yazılamaz; yalnız Yazma izni ise mevcut kataloğu okumaya yetmez. Sitede de stoğun düşmesini istiyorsanız Okuma/Yazma izni şarttır.

Anahtarı hangi WordPress kullanıcısına bağlamalısınız?

Belgelere göre anahtar, bağlı olduğu kullanıcının rol ve yetkileriyle çalışır; kullanıcı silinirse anahtar da çalışmaz ve başka bir kullanıcıya devredilmez. Ayrılabilecek bir çalışanın hesabı yerine kalıcı bir yönetici hesabı seçin. Secret değerini e-postayla veya mesajlaşma uygulamasıyla dolaştırmayın; kaybederseniz eski anahtarı aynı ekrandan iptal edip yenisini üretmeniz yeterlidir.

Ürün eşleştirme: SKU, GTIN ve stok alanları

WooCommerce ürünlerinin pazaryeri ilanlarıyla doğru eşleşmesi, sitenizdeki birkaç alanın tutarlı doldurulmasına bağlıdır. Yox İş Ortağım'da mevcut ürünleriniz panele okunur ve barkod ya da stok koduyla eşleşir; WooCommerce tarafında bu bilgiler API'de aşağıdaki alanlarda durur. Tanımlar ürün ve varyasyon uç noktalarının resmî belgesinden alınmıştır.

Varyasyonlu ürünlerde stok nerede tutulmalı?

Beden ve renk gibi seçenekler WooCommerce'te değişken (variable) ürünün varyasyonlarıdır ve API'de ayrı bir uç noktada, /products/<ürün_id>/variations altında yer alır. Varyasyondaki manage_stock alanı true, false ya da parent değerini alabilir; parent seçildiğinde varyasyonun stoğu ana ürünün stoğundan yönetilir. Beden bazında satış yapıyorsanız her varyasyona ayrı SKU ve ayrı stok tanımlayın; ana üründe tek bir toplam tutulursa M beden bittiğinde diğer kanallar bunu ayırt edemez. Yox İş Ortağım'da varyant stoğu da tek stok kartında izlenir.

Gruplanmış ve harici ürünler ne olacak?

Gruplanmış (grouped) ürün birden fazla basit ürünü tek sayfada gösteren bir kapsayıcıdır; harici (external) ürün ise satışı başka bir siteye yönlendiren bağlantıdır. Pazaryerinde satılacak ürünleri bu iki tür yerine basit ya da değişken ürün olarak kurmanızı öneririz; 5'li ya da 10'lu set satıyorsanız Yox İş Ortağım'daki paket stoğu özelliğiyle seti tek stok biriminden yönetebilirsiniz.

WooCommerce sipariş durumları stoğu ne zaman düşürür?

WooCommerce stoğu ödeme sürecine bağlar: ödeme alındığında (İşleniyor) ya da ödeme onayı beklenirken (Beklemede) stok düşer, ödeme başarısız olduğunda ya da sipariş iptal edildiğinde geri eklenir. Entegrasyon sitenin stok rakamıyla çalıştığı için bu kurallar pazaryerinde gördüğünüz adedi de belirler. Tablo WooCommerce'in sipariş durumları belgesine dayanır.

Havale siparişlerinde gözden kaçan stok

Stok bekletme (Hold stock) süresi belgelere göre yalnız Ödeme bekliyor durumuna uygulanır, Beklemede durumuna uygulanmaz. Havale ile ödenecek siparişler Beklemede durumunda açılır ve stoğu hemen düşürür; ödeme gelmese bile siz iptal edene kadar o adet bütün kanallarda satılamaz görünür. Eski Beklemede siparişlerini düzenli gözden geçirin.

İade edilen ürün stoğa geri döner mi?

REST API'nin sipariş iadesi uç noktasındaki api_restock parametresi varsayılan olarak true'dur ve seçilen satırları stoğa geri ekler. Yönetim panelinden yapılan iadelerde ise ürünlerin stoğa eklenip eklenmeyeceğini iade ekranında siz seçersiniz. Hasarlı dönen ürünü stoğa eklemeyin; aksi halde satılamayacak bir adet bütün kanallarda satışa açılır. Pazaryeri iadeleri Yox İş Ortağım'daki iade ve talepler kutusunda toplanır.

Webhook, WP-Cron ve HPOS: site altyapısı senkronu nasıl etkiler?

Bir WooCommerce entegrasyonunun tutarlılığını yalnız entegrasyon yazılımı değil, sitenizin kendi altyapısı da belirler; özellikle webhook teslimatı, WordPress zamanlayıcısı ve sipariş depolama biçimi gözden geçirilmelidir.

Webhook nedir, neden kendiliğinden devre dışı kalır?

Webhook, sitede bir olay olduğunda (ör. order.created, order.updated, product.updated) dış bir adrese HTTP POST ile bildirim gönderen WooCommerce özelliğidir. Belgelere göre çekirdek konular sipariş, ürün, müşteri ve kupon olaylarını kapsar; her istek X-WC-Webhook-Signature başlığında gövdenin base64 kodlu HMAC-SHA256 imzasını taşır. Art arda 5 başarısız teslimattan sonra webhook devre dışı kalır ve yeniden etkinleştirilene kadar bildirim göndermez.

WP-Cron ve düşük trafikli siteler

Webhook teslimatı varsayılan olarak arka planda WP-Cron ile işlenir. WordPress geliştirici belgesine göre WP-Cron sürekli çalışmaz, yalnız bir sayfa yüklendiğinde tetiklenir; saat 14.00'e planlanan bir iş, 17.00'ye kadar ziyaret gelmezse 17.00'de çalışır. Barındırma firmanızdan WP-Cron'u sunucu zamanlayıcısına bağlamasını istemek bu riski azaltır.

HPOS (yüksek performanslı sipariş depolama)

HPOS, siparişleri WordPress yazı tabloları yerine siparişe özel tablolarda saklayan depolama biçimidir. WooCommerce belgelerine göre 8.2 sürümünden itibaren yeni kurulumlarda varsayılan olarak açıktır; mevcut mağazalar WooCommerce > Ayarlar > Gelişmiş > Özellikler ekranından elle geçer. Uyumsuz bir eklenti etkinse geçiş seçeneği kilitlenir; uyumluluk modu ise iki tabloyu eşitleyerek gerektiğinde eski depolamaya dönmeyi kolaylaştırır.

• HPOS'a geçmeden önce sipariş verisine dokunan eklentilerinizin uyumluluğunu kontrol edin.
• Geçişten sonra ilk siparişleri sitede ve panelde karşılaştırın.
• Güvenlik eklentileri ve sunucu güvenlik duvarı /wp-json/ isteklerini engellememeli.

Yox İş Ortağım ile WooCommerce entegrasyonu nasıl kurulur?

Yox İş Ortağım'da WooCommerce, pazaryerleriyle aynı ürün kartından beslenen bir satış kanalıdır: ürünler siteden panele aktarılır, satış hangi kanaldan gelirse gelsin stok diğerlerinde de düşer, siparişler tek listede toplanır. Kurulum sırası şöyledir:

1. Yox İş Ortağım'a başvurun; 3 günlük ücretsiz deneme ve isterseniz kısa bir ön görüşmeyle başlarsınız.
2. REST API anahtarını oluşturup Consumer Key ve Consumer Secret değerlerini panele girin.
3. WooCommerce ürünleriniz panele aktarılır; barkod ya da stok koduyla eşleşmeyen kayıtları gözden geçirin.
4. Ürünleri pazaryeri kategorileriyle eşleştirin; siz onaylamadan hiçbir ürün değişmez.
5. Pazaryerlerinin API bilgilerini girip aynı ürünleri satışa açın; kanal kuralları için Trendyol entegrasyonu ve Hepsiburada entegrasyonu sayfalarına bakabilirsiniz.
6. Kanal başına fiyat kuralını tanımlayın ve ilk siparişleri tek listeden izleyin.

İsterseniz bu adımları sizinle birlikte yapıyor, ilk eşleştirmeyi beraber kontrol ediyoruz.

Elle yönetim ile Yox İş Ortağım arasındaki fark

Tablodaki kargo ve fatura adımları paket kapsamına bağlıdır; hangi firmaların bağlanabildiğini entegrasyonlar sayfasında görebilirsiniz.

WooCommerce ve pazaryeri fiyatları nasıl ayrılır, hangi paket gerekir?

Sitenizde pazaryeri komisyonu ödemediğiniz için WooCommerce fiyatını pazaryeri fiyatının altında tutmak yaygın bir tercihtir; Yox İş Ortağım'da bunu kanal başına yüzde ya da tutar fiyat farkıyla ana fiyattan türetirsiniz.

Örnek fiyat kuralı hesabı

Oranlar örnektir, gerçek komisyon oranı değildir. Yüzde farkı pahalı üründe büyür, tutar farkı sabit kalır; fiyat aralığınız genişse iki yöntemi birkaç üründe karşılaştırın. Kesinti sonrası kalan tutarı komisyon hesaplama aracıyla, ürün bazında kârı kâr hesaplama aracıyla kontrol edin.

WooCommerce hangi pakette bağlanır?

WooCommerce de bir kanal sayılır; Büyüme paketinde site artı iki pazaryeri bağlanabilir. Yıllık ödemede %20 indirim uygulanır; ayrıntılı karşılaştırma paketler bölümünde.

WooCommerce entegrasyonu öncesi kontrol listesi ve sık yapılan hatalar

WooCommerce entegrasyonunda yaşanan aksaklıkların çoğu bağlantının kendisinden değil, sitedeki veri ve ayar düzensizliğinden kaynaklanır. Bağlamadan önce şu listeyi gözden geçirin.

Bağlamadan önce kontrol edin

• Kalıcı bağlantı yapısı Düz değil, SSL sertifikası geçerli.
• WooCommerce ve WordPress güncel; en az WooCommerce 3.5 ve WordPress 4.4.
• WooCommerce > Ayarlar > Ürünler > Envanter ekranında stok yönetimi açık, ürün ve varyasyon düzeyinde de adet tutuluyor.
• Her ürün ve varyasyonda tekil SKU var; barkod alanı pazaryerindeki barkodla aynı.
• Ödenmemiş eski Beklemede siparişleri temizlendi.

Sık yapılan hatalar

• Aynı stoğu iki ayrı araçla güncellemek: eski pazaryeri eklentisi açık kalırsa panel ile eklenti birbirinin yazdığını ezer; eklentinin stok güncellemesini kapatın ya da eklentiyi kaldırın.
• Yalnız Okuma izinli anahtar vermek: ürünler gelir ama site stoğu güncellenmez.
• Anahtarı ayrılacak bir çalışana bağlamak: kullanıcı silindiğinde bağlantı kopar.
• Stokta yok eşiğini (Out of stock threshold) unutmak: belgeye göre bu eşiğe inen ürün stokta yok sayılır; eşik 2 ise 2 adetlik ürün sitede satılamaz görünür.
• Düşük trafikli sitede WP-Cron'a güvenmek: zamanlanmış işler ziyaret gelene kadar bekler.