WooCommerce REST API dokümanları taşındı: entegrasyon yapan satıcılar için ne değişti?

Ne değişti, ne değişmedi?

Değişen, dokümantasyonun adresi ve düzeni. WooCommerce'in REST API'si (wc/v3 uç noktaları) aynı şekilde çalışmaya devam ediyor; mevcut entegrasyonlarınızda anahtar yenilemeniz veya ayar değiştirmeniz gerekmiyor. Eski GitHub sayfasına alışkın geliştiriciler artık yeni portalı kullanacak; kılavuzlar, kimlik doğrulama ve uç nokta referansları tek çatı altında toplanıyor.

Satıcı için pratik sonuç: entegrasyon sağlayıcınız veya yazılımcınız WooCommerce dokümanına bakması gerektiğinde yeni adresi kullanmalı. WooCommerce'i Saystok'a bağlama adımları değişmedi; WooCommerce REST API bağlantısı rehberi geçerliliğini koruyor.

WooCommerce REST API nasıl çalışır? Kısa hatırlatma

WooCommerce, WordPress'in REST altyapısı üzerinde kendi uç noktalarını sunar: ürünler, varyasyonlar, siparişler, müşteriler, kuponlar ve raporlar. Dış bir sistem (entegrasyon paneli) bu uç noktalara HTTPS üzerinden istek atar; kimlik doğrulama için mağaza yöneticisinin WooCommerce ayarlarından ürettiği tüketici anahtarı (consumer key) ve gizli anahtar (consumer secret) çifti kullanılır. Dokümantasyon, bu çiftin temel kimlik doğrulama ile kullanıcı adı/şifre gibi gönderildiğini açıklar.

• Anahtar çifti "okuma", "yazma" veya "okuma/yazma" yetkisiyle üretilir; stok senkronu için okuma/yazma gerekir.
• Bağlantı HTTPS gerektirir; SSL sertifikası olmayan mağazalarda anahtar doğrulaması başarısız olur.
• Anahtarı üreten WordPress kullanıcısının yetkisi API'nin yetkisini belirler; mağaza yöneticisi hesabı kullanmak en sorunsuz yoldur.

API kavramlarını satıcı diliyle okumak isterseniz API nedir yazısına bakın.

Stok senkronunu ilgilendiren alanlar

Pazaryeri entegrasyonu açısından WooCommerce ürün nesnesindeki üç alan kritiktir: "manage_stock" (stok takibi açık mı), "stock_quantity" (adet) ve "stock_status" (stokta / tükendi / ön sipariş). Stok takibi kapalı ürünlerde adet alanı anlamsızdır ve dış sistem stoku yazamaz; bu yüzden pazaryerleriyle senkron edilecek her ürün ve varyasyonda stok takibi açık olmalıdır.

Varyasyonlu ürünlerde (beden, renk) stok ana üründe değil varyasyonda tutulur. Entegrasyon, her varyasyonu pazaryerindeki ilgili varyantla ayrı ayrı eşleştirir; bu eşleşmenin anahtarı SKU alanıdır. WooCommerce'de her varyasyona benzersiz bir SKU vermek, ürün eşleştirmeyi otomatik hale getirir.

Senkron açısından alanların özeti:

WooCommerce mağazanız stok kaynağıysa (fiziksel sayım oraya işleniyorsa) pazaryerleri WooCommerce'i takip eder; tersi de mümkündür. Karar için stok kaynağı seçimi rehberi.

Webhook'lar: siparişi anında öğrenmek

WooCommerce, sipariş oluşturulduğunda veya güncellendiğinde dış sisteme anında bildirim gönderen webhook'lar sunar. Entegrasyon paneli webhook kullanıyorsa WooCommerce'den gelen sipariş saniyeler içinde listelenir ve stok anında düşülür; kullanmıyorsa belirli aralıklarla sorgulama yapılır. Her iki yöntem de dokümantasyonda açıklanır; mağazanızda webhook'un aktif olup olmadığını WooCommerce ayarlarından görebilirsiniz.

Satıcı için kontrol listesi

• WooCommerce ve WordPress sürümlerinizi güncel tutun; eski sürümlerde API uç noktaları eksik olabilir.
• API anahtarını okuma/yazma yetkisiyle, yönetici kullanıcısıyla üretin; anahtarı paylaşmayın.
• Tüm senkron edilecek ürünlerde "stok takibi" açık ve SKU dolu olsun.
• Mağazanızda SSL (https) aktif olsun.
• Eklentileriniz REST API'yi engellemiyor olsun; bazı güvenlik eklentileri API erişimini kapatır.

Bu beş madde, WooCommerce bağlantı sorunlarının büyük bölümünü önler. Mağazanızı pazaryerlerine bağlamak için Saystok'u ücretsiz deneyebilirsiniz.

Sık görülen WooCommerce bağlantı hataları ve anlamları

Bağlantı kurarken veya senkron sırasında karşılaşılan hataların çoğu birkaç nedene iner. "401 Unauthorized": anahtar çifti yanlış ya da anahtarı üreten kullanıcının yetkisi yetersiz; anahtarı yönetici hesabıyla yeniden üretin. "403 Forbidden": sunucu veya güvenlik eklentisi REST isteğini engelliyor; barındırma sağlayıcınızın güvenlik duvarı kurallarını ve eklenti ayarlarını kontrol edin. "404 Not Found": kalıcı bağlantı (permalink) ayarları "düz" modda olduğunda REST uç noktaları çözümlenemez; WordPress'te kalıcı bağlantıları "yazı adı" gibi bir yapıya alın.

Stok yazılıyor ama mağazada değişmiyorsa önbellek eklentisi eski sayfayı gösteriyor olabilir; ürün sayfaları için önbelleği temizleyin. Varyasyonlu ürünlerde stok ana üründe görünüp varyasyonda değişmiyorsa "stok takibi" varyasyon düzeyinde kapalıdır. Bu hataların teknik adlarını satıcı diliyle okumak için API nedir yazısına bakın.

• 401: anahtar/yetki. 403: eklenti/güvenlik duvarı. 404: kalıcı bağlantı ayarı.
• Değişiklik görünmüyor: önbellek veya varyasyon düzeyinde stok takibi kapalı.

WooCommerce stok kaynağı olduğunda günlük akış

Birçok satıcı için WooCommerce mağazası aynı zamanda deponun kaydıdır: mal kabul ve sayım oraya işlenir. Bu durumda akış şöyle işler: pazaryerinde satış olduğunda entegrasyon WooCommerce stokunu düşer; WooCommerce'de satış olduğunda webhook ile entegrasyon haber alır ve pazaryerlerine yeni adedi yazar; sayım düzeltmesi WooCommerce'e girilir ve tüm kanallara yayılır. Tek kural, stoku yalnızca WooCommerce üzerinden değiştirmektir; pazaryeri panelinden elle stok girmek senkronla çakışır.

Bu modelin avantajı, mevcut alışkanlıkları korumasıdır; dezavantajı, WooCommerce sitesi bakımda veya erişilemez olduğunda senkronun durmasıdır. Yoğun kampanya günlerinde sitenin barındırma kapasitesini buna göre planlayın. Alternatif modeller için stok kaynağı seçimi rehberi; genel karşılaştırma için pazaryeri mi, kendi siten mi.

Dokümantasyon değişikliklerini takip etmek neden önemli?

Bu haber tek başına küçük görünür, ama bir alışkanlığı hatırlatır: entegrasyon kurduğunuz her platformun geliştirici duyurularını izlemek. Belgelerin taşınması bugün bir şey değiştirmez; yarın aynı kanaldan "şu uç nokta kaldırılıyor", "kimlik doğrulama yöntemi değişiyor" gibi duyurular gelir ve bunlar senkronun durmasına yol açabilir. Entegrasyon sağlayıcınız bu duyuruları takip etmekle yükümlüdür; ancak satıcı olarak da hangi platformun hangi değişikliği yaptığını kabaca bilmek, "kanal çalışmıyor" durumunda sorunun nerede olduğunu hızla anlamanızı sağlar.

Bu kategoride WooCommerce, Shopify, Etsy ve Türkiye pazaryerlerindeki kural ve özellik değişikliklerini satıcı diliyle özetlemeye devam edeceğiz; örnekler için Shopify stok yapısı ve Etsy OAuth yazıları.