Zorunlu ve önemli alanlar
| Alan | Zorunlu mu | Açıklama |
|---|---|---|
| quantity | Evet | Pozitif, sıfırdan büyük adet |
| title | Evet | Harf, rakam, noktalama, boşluk ve ™ © ®; % : & + karakterleri en fazla birer kez |
| description | Evet | Ürün açıklaması |
| price | Evet | Pozitif fiyat; ilanın en düşük fiyatı sayılır |
| who_made | Evet | i_did, collective ya da someone_else |
| when_made | Evet | made_to_order, 2020_2026, 2010_2019 gibi dönem değerleri |
| taxonomy_id | Evet | Satıcı kategori ağacındaki düğüm kimliği |
| shipping_profile_id | Fiziksel üründe | Kargo profili |
| readiness_state_id | Fiziksel üründe | İşlem (hazırlık) profili |
| image_ids | Yayın için | Mağazaya yüklenmiş görseller; en fazla 20 |
| tags, materials, type | Hayır | Etiketler, malzemeler; type physical, download ya da both |
Değerler Etsy'nin API başvurusundaki createDraftListing tanımından alınmıştır (Etsy: Listings Tutorial).
İşlem profili ve legacy=false
Etsy işlem süresini kargo profilinden ayırıp işlem profillerine (processing profile) taşıdı. Yeni alanları kullanmak için isteklere legacy=false sorgu parametresi eklenir. Etsy'nin geçiş belgesine göre bu bayrakla birlikte eski işlem süresi parametrelerini göndermek 400 hatası verir.
readiness_state_id değerini mağazanın işlem profillerinden alırsınız. Bir ilanın işlem süreleri profile bağlandıktan sonra eski kargo profili yöntemine geri dönülemez. Ayrıntılar kargo ve işlem profilleri sayfasında.
Taslaktan yayına
- Görseli ilana yükleyin ya da daha önce yüklenmiş görselleri image_ids ile bağlayın.
- Kargo profilinin tüm alanlarının eksiksiz olduğundan emin olun; Etsy etkinleştirmede profili doğrular ve eksik alanı hata mesajında söyler.
- Fiziksel ilanlarda iade politikası (return_policy_id) yayın için gerekir; Etsy'ye göre AB merkezli mağazalar bu şarttan muaftır.
- updateListing ile state alanını active yapın. Taslak durumdayken kargo profili ve dosya şartı aranmaz.
Varyasyon taslak açılırken eklenemez. Renk ya da beden gibi seçenekler, ilan oluştuktan sonra envanter ucuyla tanımlanır; bkz. envanter yapısı.
Sık hatalar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 400, başlık reddedildi | Emoji ya da izin verilmeyen sembol | Başlığı sadeleştirin |
| 400, adet ya da fiyat | 0 ya da negatif değer | Pozitif değer gönderin |
| Profil hatası | Mağazada kargo ya da işlem profili yok | Önce profil oluşturun |
| Yayına alınamıyor | Görsel ya da iade politikası eksik | Görsel yükleyin, politikayı bağlayın |
| 403 | Token'da listings_w yok | Kapsamı ekleyip yeniden yetkilendirin |
Sık sorulanlar
Etsy API ile doğrudan yayında ilan açılabilir mi?
createDraftListing ilanı taslak olarak açar. Yayına almak için görsel ekleyip updateListing ile state alanını active yaparsınız.
Etsy ilanında SKU nereye yazılır?
SKU ilan düzeyinde değil, envanterdeki ürün düzeyinde tutulur. İlan oluştuktan sonra envanter ucunda her ürünün sku alanına yazılır.
who_made ve when_made neden zorunlu?
Etsy bu alanlarla ürünü el yapımı, vintage ya da malzeme gruplarına yerleştirir. who_made için üç değer, when_made için dönem değerleri kabul edilir.
Taslak ilan için kargo profili şart mı?
Fiziksel ilan açarken shipping_profile_id istenir. Etsy, taslak durumdayken profilin eksiksiz olmasını aramaz ama yayına alırken doğrular.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı