Durumlar ne anlama gelir?
| Durum | Etsy'deki anlamı | API ile yapılabilen |
|---|---|---|
| draft | Henüz yayına alınmamış yeni ilan | active yapma, silme |
| active | Yayında, en az bir adedi olan ve süresi dolmamış ilan | inactive yapma, silme |
| inactive ya da edit | Bilerek kapatılmış, düzenlemeye hazır ilan | active yapma, silme |
| sold_out | Yayındayken adedi sıfıra inmiş ilan | Silme; yeniden açma için aşağıya bakın |
| expired | Süresi dolup yenilenmemiş ilan | active yapma, silme |
| removed | Etsy'de kaldırılmış ilan | Liste filtresinde görünür |
Tablo Etsy'nin tanımlar belgesi ile ilan eğitimindeki yaşam döngüsü tablosundan derlendi (Etsy: Definitions).
Durum değiştirme
updateListing bir PATCH ucudur ve gövdede state: active ya da state: inactive kabul eder. Taslağı active yapmak ilanı etsy.com'da yayımlar ve ilanın görseli olmasını gerektirir. Fiziksel ilanı etkinleştirirken ya da elle yenilerken bağlı kargo profilinin tüm alanları eksiksiz olmalıdır.
Mağaza ilanlarını durumlara göre okumak için GET /v3/application/shops/{shop_id}/listings ucuna state parametresi verilir. Varsayılan active'dir; inactive, sold_out, draft, removed ve expired de istenebilir. Tüm ilanları görmek için her durumu ayrı ayrı sorgulamanız gerekir.
sold_out ve expired ilanlar
Etsy'nin ilan eğitimi sold_out ilan için API'de yalnız silme işlemini listeler. API başvurusundaki state açıklaması ise sold_out ilanı active yapmanın adedi 1'e çekip ilanı etsy.com'da yenileyeceğini söyler. Bu yenileme satıcının mağaza hesabına yansıyan bir işlemdir; bu yüzden otomatik bir sistemin bunu satıcıya sormadan yapması önerilmez.
Süresi dolan ilanlar should_auto_renew açıksa dört ay için otomatik yenilenir. Kapalıysa ilan expired olur ve yeniden active yapılabilir.
Stok 0 olunca ne olur?
Etsy ilan ve envanter uçları pozitif adet ister; canlı kullanımda 0 adet gönderilen istekler reddedildi. Stoğu biten bir ürünün yayında kalmaması için ilan inactive yapılır. Stok geldiğinde ilan yeniden active yapılır ve adet envantere yazılır.
- Taslak ilanı inactive yapmaya çalışmak "Cannot deactivate a listing in this state" hatası verir; taslak zaten yayında değildir.
- Kaldırılmış (removed) ilan düzenlenemez; düzenleme istekleri 403 ve "is removed" mesajı alır.
Sık sorulanlar
Etsy ilanı API ile nasıl pasife alınır?
updateListing ucuna PATCH isteği atıp gövdede state değerini inactive yaparsınız. Yeniden açmak için aynı uçla active gönderilir.
Etsy sold out ilan API ile açılabilir mi?
Etsy'nin belgeleri bu konuda iki farklı şey söyler: eğitim yalnız silmeyi listeler, başvuru ise active yapmanın adedi 1'e çekip ilanı yenileyeceğini belirtir. Yenileme mağaza hesabına yansıdığı için bu işlemi panelden bilinçli yapmak daha güvenlidir.
Taslak ilan neden yayına alınamıyor?
En sık neden görsel eksikliğidir. Fiziksel ilanlarda kargo profilinin eksik olması ya da iade politikasının bağlanmamış olması da etkinleştirmeyi engeller.
Tüm ilanları tek istekte alabilir miyim?
Hayır. Mağaza ilan ucu state parametresine göre filtreler. active, inactive, sold_out, draft ve expired durumlarını ayrı ayrı sorgulayın.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı