Kimlik alanları
| Alan | Nerede | Açıklama |
|---|---|---|
| sku | Ürün ve varyasyon | Stok kodu; belgede benzersiz tanımlayıcı |
| global_unique_id | Ürün ve varyasyon | GTIN, UPC, EAN ya da ISBN |
| mpn | Ürün ve varyasyon | Üretici parça numarası |
| line_items.sku | Sipariş kalemi | Satılan ürünün SKU’su, salt okunur |
| line_items.global_unique_id | Sipariş kalemi | Boşsa boş metin, ürün silinmişse null |
| line_items.variation_id | Sipariş kalemi | Varyasyon numarası |
SKU sizin iç kodunuzdur. GTIN ise ürüne üretici ya da GS1 tarafından verilen uluslararası barkoddur. İkisini karıştırmayın; pazaryerine gönderilen barkod alanı çoğunlukla GTIN beklenir.
Bu alanlarla arama
- SKU ile tam eşleşme: GET /products?sku=SAHTE-001
- Varyasyonda SKU: GET /products/ANA_URUN/variations?sku=SAHTE-001-M
- Barkodla arama: search=8690000000000 ve search_fields=global_unique_id
- MPN ile tam eşleşme: mpn parametresi, virgülle birden çok değer
search_fields parametresi name, sku, global_unique_id, mpn, description ve short_description değerlerini alır. Belgeye göre bu parametre diğer arama parametrelerinden önceliklidir.
Barkod ve SKU yazmak
Mevcut bir ürüne barkod eklemek için yalnız değişecek alanı göndermeniz yeterlidir. PUT isteği gövdedeki alanları günceller, göndermediğiniz alanlara dokunmaz. Aşağıdaki değerler sahtedir.
- Basit ürün: PUT /products/123 ve gövdede global_unique_id: 8690000000001
- Varyasyon: PUT /products/123/variations/456 ve gövdede global_unique_id: 8690000000002
- Çok ürün: POST /products/batch ve update listesinde her öğe için id ile global_unique_id
Barkodu yazdıktan sonra ürünü yeniden okuyup alanın beklenen değerle döndüğünü kontrol edin. Bu alan eski WooCommerce sürümlerinde bulunmayabilir; yanıt alanı hiç içermiyorsa sitenizi güncelleyin.
Varyasyonlarda boş SKU tuzağı
Canlı mağazalarda gözlenen bir durum: varyasyonun kendi SKU’su boşsa sipariş kaleminin sku alanında ana ürünün SKU’su görünebilir. Bu durumda yalnız SKU’ya bakan bir entegrasyon, satılan bedenin değil ana ürünün stoğunu düşer.
| Durum | Kalemde görünen | Doğru eşleştirme |
|---|---|---|
| Varyasyonun SKU’su dolu | Varyasyon SKU’su | SKU yeterli |
| Varyasyonun SKU’su boş | Ana ürünün SKU’su | variation_id ile eşleştirin |
| Basit ürün | Ürün SKU’su | SKU yeterli |
En sağlam yol her varyasyona ayrı SKU vermek ve entegrasyonda variation_id değerini de okumaktır.
Pazaryeri eşleştirmesi için öneriler
- Her satılabilir birime, yani her basit ürüne ve her varyasyona benzersiz SKU verin.
- Barkodlu ürünlerde global_unique_id alanını doldurun; aynı GTIN’i iki ürüne vermeyin.
- SKU’da boşluk ve özel karakterden kaçının; farklı sistemler bunları farklı işler.
- Barkod ve GTIN’in pazaryerinde nasıl kullanıldığını barkod ve GTIN yazısında bulabilirsiniz.
Eşleştirme adımları için ürün eşleştirme rehberi yol gösterir.
Sık sorulanlar
WooCommerce’te barkod hangi alana yazılır?
GTIN, UPC, EAN ya da ISBN barkodu global_unique_id alanına yazılır. SKU ise sku alanında durur.
SKU ile ürün nasıl bulunur?
GET /wp-json/wc/v3/products?sku=DEGER tam eşleşmeyle ürünü getirir. Varyasyonlar için aynı parametre ana ürünün variations adresinde kullanılır.
Sipariş kalemindeki SKU neden ana ürünün SKU’su?
Varyasyonun kendi SKU’su boş olabilir. Her varyasyona SKU verin ve eşleştirmede variation_id değerini kullanın.
GTIN alanı zorunlu mu?
WooCommerce için zorunlu değildir. Ama pazaryerleri barkod istediği için eşleştirmeyi kolaylaştırır.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı