Senkron için önemli ürün alanları
Ürün nesnesinde onlarca alan vardır. Stok ve sipariş senkronu için aşağıdakiler yeterlidir.
| Alan | Tür | Açıklama |
|---|---|---|
| id | tam sayı | Ürün numarası, salt okunur |
| name | metin | Ürün adı |
| sku | metin | Stok kodu, benzersiz tanımlayıcı |
| global_unique_id | metin | GTIN, UPC, EAN ya da ISBN |
| type | metin | simple, grouped, external ya da variable |
| status | metin | draft, pending, private ya da publish |
| price | metin | Geçerli fiyat, salt okunur |
| regular_price ve sale_price | metin | Normal ve indirimli fiyat |
| manage_stock | mantıksal | Ürün düzeyinde stok yönetimi açık mı |
| stock_quantity | tam sayı | Stok adedi |
| stock_status | metin | instock, outofstock ya da onbackorder |
| variations | dizi | Varyasyon numaraları, salt okunur |
| date_modified | tarih | Son değişiklik zamanı, salt okunur |
Fiyat alanları metindir. stock_quantity ise yalnız stok yönetimi açıkken anlamlıdır; kapalı üründe null gelebilir.
İşe yarayan filtreler
| Parametre | Örnek | Ne yapar |
|---|---|---|
| sku | sku=SAHTE-001 | Belirli SKU’lu ürünü getirir |
| status | status=publish | Duruma göre süzer; varsayılan any |
| type | type=variable | Yalnız varyasyonlu ürünler |
| stock_status | stock_status=outofstock | Stokta olmayanlar |
| modified_after | ISO 8601 tarih | Bu tarihten sonra değişenler |
| search ve search_fields | search_fields=sku,global_unique_id | Aramayı belirli alanlarla sınırlar |
| include | include=12,15 | Yalnız verilen numaralar |
| orderby ve order | orderby=modified | Sıralama |
Belgeye göre status varsayılan olarak any’dir; yani taslak ve özel ürünler de gelir. Yalnız yayındaki ürünleri istiyorsanız status=publish gönderin. Birden çok durum için include_status, hariç tutmak için exclude_status kullanılabilir.
Yalnız değişenleri çekmek
Büyük katalogda her seferinde tüm ürünleri çekmek yavaştır. modified_after parametresi son okumadan sonra değişen ürünleri getirir. dates_are_gmt=true ile tarihin GMT olarak yorumlanmasını sağlarsınız.
Siparişle düşen stoğun date_modified alanını değiştirip değiştirmediği belgede açıkça yazılmıyor. Artımlı okumaya geçmeden önce bunu kendi sitenizde bir test siparişiyle deneyin. Emin olamıyorsanız artımlı okumanın yanında belirli aralıklarla tam okuma da yapın.
Ürün türleri ve stok
- simple: tek bir ürün; stok ürünün kendisindedir.
- variable: seçenekli ürün; stok çoğunlukla her varyasyonda ayrı tutulur. Ayrıntılar varyasyonlar sayfasında.
- grouped: başka ürünleri bir arada gösteren grup.
- external: başka sitede satılan, dış bağlantılı ürün.
Pazaryeri senkronunda genellikle basit ürünler ve varyasyonlar izlenir. Varyasyonlu ana ürünün kendi stoğu ancak ürün düzeyinde stok yönetimi açıksa anlam taşır.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Yalnız 10 ürün geliyor | per_page gönderilmedi | per_page=100 ve page ile sayfaları gezin |
| Varyasyonlar listede yok | Varyasyonlar ayrı uç noktada | /products/ID/variations adresini çağırın |
| Taslak ürünler beklenmedik şekilde geldi | status varsayılanı any | status=publish gönderin |
| Fiyat toplamı yanlış | Fiyatlar metin olarak geliyor | Sayıya çevirip hesaplayın |
Sık sorulanlar
WooCommerce API ile tüm ürünleri nasıl çekerim?
GET /wp-json/wc/v3/products adresini per_page=100 ile çağırıp X-WP-TotalPages başlığındaki sayı kadar sayfayı gezin.
Yalnız yayındaki ürünleri nasıl listelerim?
status=publish parametresini ekleyin. Belgeye göre varsayılan any olduğu için parametre olmadan taslaklar da gelir.
SKU ile ürün nasıl bulunur?
GET /wp-json/wc/v3/products?sku=SKU_DEGERI. Varyasyon SKU’su için ana ürünün variations adresinde aynı parametre kullanılabilir.
stock_quantity neden null geliyor?
Ürün düzeyinde stok yönetimi kapalı olabilir. manage_stock false iken WooCommerce adet tutmaz; yalnız stok durumu tutulur.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı