İlan dili ve mağaza dilleri
ShopListing nesnesindeki language alanı ilanın varsayılan dilini IETF etiketiyle verir; ör. en, de, fr. Shop nesnesindeki languages alanı ise mağazanın kayıtlı dillerini listeler ve ilk eleman varsayılan dildir.
Türkiye'den satan bir mağaza için pratik sonuç şudur: ilan metni alıcının dilinde değilse aramada geri kalır. Başlık ve etiketleri hedef pazarın dilinde yazmak, otomatik çeviriyi de mutlaka gözden geçirmek gerekir.
Çeviri uçları
| İşlem | Uç | Kapsam |
|---|---|---|
| Çeviri okuma | GET .../shops/{shop_id}/listings/{listing_id}/translations/{language} | Herkese açık |
| Çeviri ekleme | POST aynı yol | listings_w |
| Çeviri güncelleme | PUT aynı yol | listings_w |
Ekleme ve güncellemede title ve description zorunlu, tags isteğe bağlıdır. language yol parametresidir; Etsy örnek olarak de, en, es, fr, it, ja, nl, pl ve pt etiketlerini verir. Tek ilan okurken getListing ucuna language parametresi verilerek o dildeki metin istenebilir.
Money nesnesi
| Alan | Anlamı | Örnek |
|---|---|---|
| amount | Bölünemeyen en küçük birimde tutar | 500 |
| divisor | Tutarı bölecek sayı | 100 |
| currency_code | Üç harfli para birimi kodu | USD |
Bu örnekte fiyat 500 / 100 = 5 dolardır (Etsy: Definitions). Etsy envanter güncellemesinde fiyatın amount bölü divisor sonucu olan ondalıklı sayı olarak gönderilmesini ister. Okuduğunuz Money nesnesini olduğu gibi geri göndermeyin; belge onu ondalıklı sayıya çevirmenizi söyler.
Para birimi neden önemli?
Etsy'ye göre mağaza fiyatları varsayılan olarak Shop.currency_code alanındaki para biriminde gösterilir; kargo profilindeki ücretler de mağaza para birimindedir. TL ile çalışan bir sistem Etsy fiyatını okurken bu kodu dikkate almalı, kurla çevirmeli ve çevirinin hangi gün yapıldığını bilmelidir.
- Fiyat yazarken mağaza para birimini varsayın; isteklerde ayrı bir para birimi alanı yoktur.
- Raporlarda Etsy tutarlarını diğer kanallarla toplamadan önce aynı para birimine çevirin.
- Kur değiştiğinde Etsy fiyatları kendiliğinden değişmez; fiyat politikanızı belirli aralıklarla gözden geçirin.
- Sipariş tutarları da aynı biçimde gelir: grandtotal, subtotal ve total_shipping_cost birer Money nesnesidir ve aynı hesapla okunur.
Sık sorulanlar
Etsy fiyatı API'de neden 500 gibi büyük bir sayı?
Fiyat Money nesnesiyle gelir. amount en küçük birimdeki tutardır; gerçek fiyat için divisor ile bölünür. 500 ve 100, 5,00 anlamına gelir.
Etsy ilanına İngilizce çeviri nasıl eklenir?
POST .../listings/{listing_id}/translations/{language} ucuna title ve description, isteğe bağlı olarak tags gönderin. Var olan çeviri PUT ile güncellenir.
Etsy fiyatları hangi para biriminde?
Mağazanın para biriminde. Bu bilgi Shop nesnesinin currency_code alanındadır; her fiyatın Money nesnesi de currency_code taşır.
Saystok Etsy fiyatını kur değişince günceller mi?
Hayır. Saystok dolar fiyatını yalnız ilan açarken hesaplar. Kur değiştiğinde Etsy fiyatlarınızı Etsy panelinden gözden geçirmeniz gerekir.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı