Kargo profili
Mağazanın kargo profilleri GET /v3/application/shops/{shop_id}/shipping-profiles ucundan okunur ve shops_r kapsamı ister. Yeni profil aynı adrese POST ile açılır ve shops_w ister.
| Alan | Zorunlu mu | Açıklama |
|---|---|---|
| title | Evet | Profil adı; ülke ya da bölgeyi belirtmesi önerilir |
| origin_country_iso | Evet | Gönderimin çıktığı ülke kodu, ör. TR |
| primary_cost | Evet | Tek ürün gönderim ücreti, mağaza para biriminde |
| secondary_cost | Evet | Başka bir ürünle birlikte gönderim ücreti |
| destination_country_iso ya da destination_region | Biri | Ülke kodu ya da eu, non_eu, none bölgesi; ikisi birlikte olmaz |
| min_delivery_days ve max_delivery_days | Koşullu | Taşıyıcı ve mail_class verilmezse teslim günleri, 1 ile 45 arası |
| origin_postal_code | Koşullu | Posta kodu kullanan ülkelerde gerekir |
İşlem profili (processing profile)
İşlem profili Etsy API'de readiness state definition adıyla geçer. Okuma ucu GET /v3/application/shops/{shop_id}/readiness-state-definitions, oluşturma aynı adrese POST'tur.
| Alan | Değerler |
|---|---|
| readiness_state | ready_to_ship (hazır gönderim) ya da made_to_order (siparişe üretim) |
| min_processing_time | 1 ile 10 arası |
| max_processing_time | 1 ile 10 arası |
| processing_time_unit | days ya da weeks; verilmezse days |
Aynı değerlerle bir profil zaten varsa Etsy 409 döner ve var olan profilin adresini Content-Location başlığında bildirir. Bu durumda yeni profil açmak yerine o kimliği kullanın.
Profilleri ilana bağlamak
- Taslak açarken shipping_profile_id ve readiness_state_id alanlarını gönderin.
- Varyasyona göre farklı hazırlık süresi gerekiyorsa readiness_state_id envanterdeki her teklife ayrı yazılır; hangi özelliğin süreyi değiştirdiği readiness_state_on_property ile belirtilir.
- Tüm ürünlerde aynı süre geçerliyse her teklife aynı kimliği yazıp readiness_state_on_property alanını boş bırakın.
- İşlem profili yalnız fiziksel ilanlar içindir; dijital ilanlarda kullanılmaz.
Etsy'nin geçiş belgesine göre bir ilanın işlem süreleri profile bağlandıktan sonra eski kargo profili yöntemine dönülemez. Kargo profilindeki eski işlem süresi alanları kullanımdan kaldırılma sürecindedir.
Sık hatalar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Taslak açılamıyor, profil eksik | Mağazada kargo profili yok | Panelden ya da API ile profil açın |
| Profil oluşturma 403 | Token'da shops_w yok | Kapsamı ekleyin ya da profili panelden açın |
| İşlem profili 409 | Aynı değerlerle profil var | Content-Location'daki profili kullanın |
| Yayına alırken profil hatası | Kargo profilinde eksik alan | Hata mesajındaki alanı tamamlayın |
Sık sorulanlar
Etsy ilanı için kargo profili zorunlu mu?
Fiziksel ilanlarda evet. Profil ilan açılırken shipping_profile_id ile bağlanır ve yayına alırken tüm alanlarının eksiksiz olması gerekir.
readiness_state_id nereden bulunur?
Mağazanın işlem profillerini GET .../readiness-state-definitions ucundan okuyun. Her profilin readiness_state_id değeri ilan ve envanter isteklerinde kullanılır.
Profil oluştururken 409 alıyorum, neden?
Aynı değerlere sahip bir işlem profili zaten var. Yanıttaki Content-Location başlığı mevcut profilin adresini gösterir; onu kullanın.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı