Üç katman
| Katman | Önemli alanlar | Ne taşır |
|---|---|---|
| İlan (listing) | listing_id, quantity, has_variations | Ürünlerin kabı; adet tekliflerin toplamı |
| Ürün (product) | product_id, sku, property_values, is_deleted | Satın alınabilir tek bir seçenek birleşimi |
| Teklif (offering) | offering_id, price, quantity, is_enabled, readiness_state_id | Fiyat, adet, görünürlük ve işlem profili |
Etsy'nin webhook belgesindeki örnekle: tişört bir ilandır, "small ve mavi" tişört ise o ilanın bir ürünüdür. SKU ilan düzeyinde değil, ürün düzeyinde tutulur.
*_on_property alanları
Dört dizi, hangi özelliğin neyi değiştirdiğini property_id değerleriyle belirtir: price_on_property, quantity_on_property, sku_on_property ve readiness_state_on_property.
Etsy'nin örneğinde malzeme (çam, meşe, ceviz) fiyatı, yükseklik ise adedi ve SKU'yu belirler. Bu durumda aynı SKU'yu paylaşan ürünlerin adedi her zaman aynı olmalıdır. Bir dizide tüm özellikler varsa diğer diziler ya boş olmalı ya da yine tüm özellikleri içermelidir (Etsy: Listings Tutorial).
Ürün sınırları
| İlan yapısı | En fazla ürün |
|---|---|
| Tek varyasyon | 70 |
| İki varyasyon | 4900 |
| Üç varyasyon | 2500 |
| Bir *_on_property dizisi tüm varyasyonları içeriyorsa | 400 |
Bir ilanda en fazla üç varyasyon özelliği kullanılabilir. Hazır özellikler yetmezse Etsy'nin özel varyasyonları (property_id 513, 514, 516) seçilir.
Üçüncü varyasyon
Üç varyasyonlu ilanlarda okuma uçlarındaki property_values dizileri üç eleman taşır. Etsy, uygulamaların bunu okuyacak şekilde 17 Ağustos 2026'ya kadar güncellenmesini istedi; güncellenmeyen kod bu ilanları sessizce yanlış işleyebilir (Etsy: Third Variation).
Yazarken envanter ucuna max_variations_supported=3 sorgu parametresi eklenir. Parametre olmadan ya da 2 ile gönderilen istek, üç varyasyonlu ilanda 409 alır.
Okurken dikkat
- Etsy'ye göre envanter araçlarıyla hiç düzenlenmemiş ilanların envanter kaydı yoktur; bu ilanlarda products dizisi boş ya da inventory alanı null gelebilir.
- Silinmiş ürünler varsayılan olarak dönmez; show_deleted=true ile istenebilir.
- Çok ilan için GET /v3/application/listings/batch/inventory?listing_ids= ucu tek istekte en fazla 100 ilanın envanterini verir. Listedeki tek bir kimlik bulunamazsa tüm istek 404 döner.
- getListing ucunun includes=Inventory seçeneği kaldırıldı; envanter için bu ayrı uçları kullanın.
Sık sorulanlar
Etsy'de varyasyonlu ilanın stoğu nerede tutulur?
Her ürünün teklifinde (offering) quantity alanında. İlanın quantity değeri tekliflerin toplamıdır.
Etsy SKU ilan düzeyinde mi?
Hayır. SKU envanterdeki her ürünün sku alanındadır. Toplu envanter ucu SKU'yu yalnız ilan sahibine gösterir; başkasının ilanında boş döner.
Üç varyasyonlu ilan neden 409 veriyor?
Envanter isteğine max_variations_supported=3 eklenmemiştir. Bu parametre olmadan Etsy üç varyasyonlu envanteri güncellemeyi reddeder.
Etsy envanterini toplu okuyabilir miyim?
Evet. GET /v3/application/listings/batch/inventory ucu listing_ids parametresiyle tek istekte en fazla 100 ilanın envanterini döndürür ve listings_r kapsamı ister.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı