Oku, değiştir, geri yaz
| Adım | İşlem |
|---|---|
| 1 | GET .../listings/{listing_id}/inventory ile mevcut envanteri okuyun |
| 2 | Ürünlerden product_id, offering_id, scale_name ve is_deleted alanlarını çıkarın |
| 3 | Tekliflerdeki fiyatı Money nesnesinden ondalıklı sayıya çevirin (amount / divisor) |
| 4 | Değişecek adet ya da fiyatı yazın, diğer alanları olduğu gibi bırakın |
| 5 | products dizisini ve dört *_on_property dizisini birlikte PUT ile gönderin |
Bu adımlar Etsy'nin ilan eğitimindeki notlardan alınmıştır. Belge, güncellemede varyasyonlardan doğan tüm ürünlerin products dizisinde bulunmasını şart koşar. Yalnız değişen ürünü göndermek eksik bir envanter yazmak demektir.
Her teklifte bulunması gerekenler
| Alan | Not |
|---|---|
| price | Ondalıklı sayı. Boş kalırsa canlıda "Expected float value for 'price'" hatası görüldü |
| quantity | Pozitif adet |
| is_enabled | true ise teklif alıcıya görünür |
| readiness_state_id | İşlem profili. Eksikse canlıda "All offerings need readiness state" hatası görüldü |
Ürün düzeyinde sku ve property_values da gönderilir. property_values zorunludur ama varyasyonsuz ilanda boş dizi olabilir.
Stok 0 olunca
Etsy ilan adedini "pozitif ve sıfırdan büyük" olarak tanımlar. Canlı kullanımda 0 adet gönderen istekler hem envanter ucunda hem ilan güncellemesinde reddedildi. Doğru yol, ilanı updateListing ile inactive yapmak ve stok geldiğinde yeniden active yapıp adedi yazmaktır.
Ayrıca updateListing gövdesinde adet alanı tanımlı değildir. Canlı kullanımda envanteri olmayan ilanlarda bu uçla gönderilen adedin 200 yanıtına rağmen uygulanmadığı görüldü. Adedi her zaman envanter ucuyla yazın ve sonucu geri okuyarak doğrulayın.
Fiyat güncelleme
Fiyat da aynı PUT isteğiyle, tekliflerdeki price alanından değişir. Fiyatı bir özelliğe bağlı olan ilanlarda price_on_property bu özelliği içerir ve aynı değeri paylaşan ürünlerin fiyatı aynı olmalıdır. İlan nesnesindeki price alanı, Etsy'ye göre ilanın en düşük olası fiyatıdır.
Fiyat mağaza para biriminde yazılır. TL ile çalışıyorsanız kur dönüşümünü ve yuvarlamayı gönderimden önce yapın; ayrıntı dil, çeviri ve para birimi sayfasında.
Sık sorulanlar
Etsy'de tek bir varyasyonun stoğunu nasıl güncellerim?
Envanteri okuyup yalnız o ürünün teklif adedini değiştirin ve tüm products dizisini geri gönderin. Adedi o özelliğe bağlı tutmak için quantity_on_property dizisinde ilgili özellik bulunmalıdır.
Etsy stok 0 neden kabul edilmiyor?
Etsy ilan adedini pozitif bir sayı olarak tanımlar. Stok bittiğinde ilanı inactive yapın; stok gelince yeniden active yapıp adedi yazın.
Envanter PUT isteği 400 dönüyor, neden?
En sık nedenler teklifte boş fiyat, eksik readiness_state_id ya da *_on_property dizileriyle uyuşmayan değerlerdir. Okuduğunuz envanteri yalnız gereken alanı değiştirerek geri gönderin.
Saystok Etsy fiyatını günceller mi?
Hayır. Etsy fiyatları döviz bazlı olduğu için Saystok Etsy'de yalnız stoğu ve ilan durumunu yönetir; fiyatı Etsy panelinden belirlersiniz.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı