Etsy Entegrasyonu: Open API, Shop Manager ve Tek Panelden Liste Yönetimi

Etsy Hakkında: Kurucular, İştirakler ve Pazar Konumu

Hikâye (2005 – Bugün)

Etsy, Haziran 2005'te Rob Kalin'in Brooklyn'deki dairesinden, yanında Chris Maguire, Haim Schoppik ve Jared Tarbell ile birlikte; üreticiler, tasarımcılar ve koleksiyonerler için topluluk odaklı bir pazaryeri olarak yayına alındı. Şirket 2015'te ETSY tikerıyla NASDAQ'ta halka arz edildi. Pandemi dönemindeki yükselişin ardından satın almalarla büyüdü: Reverb (müzik aletleri, 2019), Depop (Z kuşağı moda ikinci el satışı, 30M kullanıcı, 2021) ve Elo7 (Brezilya'nın "Latin Amerika Etsy'si", 2021).

Mevcut CEO Josh Silverman döneminde Etsy Inc, çekirdek pazaryerine yeniden odaklandı — satıcı politikası uygulamalarını sıkılaştırdı, Star Seller programı gibi güven sinyallerine yatırım yaptı ve yaratıcı odaklı ticarette derinleşti. Oturumların yaklaşık %80'i artık mobilden geliyor ve mevsimsel dikeyler (düğünler, Noel, Anneler Günü, Sevgililer Günü) düzenli olarak kategori lideri alıcı büyümesi üretiyor.

Etsy Inc Grup Yapısı (2026)

• Etsy.com — el yapımı, vintage ve el sanatları malzemeleri için amiral gemisi pazaryeri
• Reverb — müzik aletleri ve müzik ekipmanları (2019'da satın alındı)
• Depop — Z kuşağı moda ikinci el satışı, 30M+ kullanıcı (2021'de satın alındı)
• Elo7 — Brezilya el yapımı pazaryeri (2021'de satın alındı)
• Etsy Payments — 40+ ülkede kendi bünyesinde ödeme işleme

Etsy'nin Birleşik Krallık Pazarındaki Konumu

Birleşik Krallık, Etsy'nin küresel ölçekte en büyük ikinci satıcı pazarıdır — 350.000'den fazla aktif İngiliz satıcı ve 8M+ aktif İngiliz alıcı Etsy üzerinden yıllık £5B'nin üzerinde GMV üretir. İngiliz üreticiler ince işçilikli takı, deri ürünleri, seramik, baskı ve kişiye özel düğün davetiyesi gibi kategorilerde lider konumdayken; İngiliz vintage satıcılar, Etsy'nin kategoriyi seçici tutan katı "20+ yaşında" politikasından faydalanıyor.

Etsy Pazar Büyüklüğü ve Büyüme (2024–2025 Verileri)

Pandemi dönemindeki sıçramanın ardından Etsy, sağlıklı ve kârlı bir büyümeye yerleşti — Birleşik Krallık ve Batı Avrupa, eski ABD kategorilerinin tutarlı biçimde önünde performans gösteriyor. Brüt Mal Satışları (GMS) ve aktif alıcı sayıları 2020 öncesi seviyelerin oldukça üzerinde kalmaya devam ediyor.

Yıl	GMS (USD)	Aktif Alıcı	Aktif Satıcı	Birleşik Krallık Satıcı
2020	~$10,3B	81M	4,4M	~250B
2022	~$13,3B	89M	7,5M	~320B
2024	~$12,6B	95M+	7M+	350B+
2025 (beklenti)	~$13,5B	100M+	7,3M	380B

Ortalama sipariş değeri £25–£40 bandında seyrederken; düğün, takı ve kişiye özel hediye kategorileri bunun oldukça üzerine çıkar. İngiliz üreticiler için Etsy, küresel alıcılara ulaşmanın en hızlı ve en az sürtünmeli yolu olmaya devam ediyor — Etsy.co.uk trafiğinin %50'si Birleşik Krallık dışından geliyor; ABD, Almanya, Fransa, Avustralya ve Kanada en büyük gelen pazarlar.

Etsy Mağazası Nasıl Açılır (2026 Birleşik Krallık Kuralları)

1. Hesap ve Hukuki Temeller

Etsy, çoğu pazaryerine kıyasla evrak yükü çok daha hafif bir platform — yine de Birleşik Krallık satıcılarının düzgün bir hukuki kurulumu olmalı. Minimum şirket yapısı şartı yok: şahıs şirketleri, limited şirketler ve ortaklıkların hepsi kabul edilir; yeter ki yasalara uygun ticaret yapın ve satışlarınızın vergisini ödeyin.

• Etsy hesabı — doğrulanmış e-posta ve telefon numarası ile
• Birleşik Krallık banka hesabı — mağazanızın yasal unvanı adına (Etsy Payments için)
• HMRC kaydı — şahıs şirketleri için self-assessment, limited şirketler için Corporation Tax
• KDV kaydı — ciro Birleşik Krallık eşiğini (~£90.000) aşıyorsa; Etsy AB alıcılarından IOSS yoluyla KDV tahsil eder
• KDV için MTD uyumlu defter tutma (Making Tax Digital)
• Marka kontrolü — Etsy fikri mülkiyeti katı uygular; marka adı kullanmadan önce UK IPO sicilini kontrol edin
• CITES belgeleri — korunan malzemeler (fildişi, bağa, bazı ahşaplar) içeren vintage ürünler için

2. Etsy Shop Manager Üzerinden Başvuru

etsy.com/sell adresinden kayıt olun. Uyumlu Birleşik Krallık satıcıları için onay genellikle anında verilir — Etsy, onboarding aşamasında çoğu pazaryerinden çok daha esnek; ancak yayın sonrası politikaları katı uygular. Mağazanız yayına girdiğinde bir shop_id alırsınız, Etsy developer uygulaması oluşturabilir ve OAuth 2.0 kimlik bilgilerini (client ID, client secret, kapsamlı token'lar) üretebilirsiniz — Zunapro'nun sizin adınıza Open API ile konuşmak için kullandığı anahtarlar bunlardır.

📥 Resmi Etsy Satıcı Başvurusu etsy.com/sell — ücretsiz başvuru, 1–3 iş günü onay →

3. Liste ve İçerik Kuralları

Etsy'nin listeleme standartları sıkıdır — ve çoğu satıcının beklediğinden de sıkıdır:

• Başlık: en fazla 140 karakter, açıklayıcı ve anahtar kelime yoğun, BÜYÜK HARF istismarı olmadan
• Fotoğraflar: en fazla 10 görsel + 1 video, önerilen 2000×2000 piksel, açık ve havadar lifestyle fotoğrafçılığı tercih edilir
• Açıklama: uzun soluklu, hikâye odaklı; malzeme, ölçü ve hazırlık süresi belirtin
• Etiketler: liste başına 13 etiket, Birleşik Krallık ve uluslararası arama niyetine göre eşleştirilmiş
• Kategoriler ve özellikler: Etsy taksonomisiyle eşleşmeli; vintage ürünler 20+ yaşında olmalı
• Üretim ortakları: el yapımı tasarımlar için bir üretici kullanıyorsanız zorunlu bildirim

2026'da Etsy Ücretleri (Birleşik Krallık Satıcıları)

Etsy'nin ticari modeli, sabit pazaryeri komisyonundan ziyade küçük liste başı ekonomisi üzerine kuruludur. Birleşik Krallık'taki çoğu satıcı; liste ücretleri + işlem komisyonu + ödeme işleme + Offsite Ads'in kümülatif etkisini hafife alır — ve marj tam olarak burada sessizce sızar. £30'luk bir mum ya da £180'lık bir yüzük fiyatlarken gerçekten önemli olan kırılım aşağıdadır:

Gerçek net marj formülü: satış fiyatı − liste ücreti − %6,5 işlem komisyonu − (4% + £0,20) ödeme işleme − isteğe bağlı Offsite/Etsy Ads − KDV − COGS − kargo maliyeti = net kâr. Zunapro bunu her SKU ve kategori için hesaplar, zarar üreten ürünleri liste açmadan önce işaretler ve hiçbir otomasyonun altına inemeyeceği bir minimum marj tabanı belirlemenize olanak tanır.

Etsy Open API v3 — Teknik Detay

Etsy Open API v3, satıcıların listeleri, stoğu, siparişleri, kargo ve finansları programatik olarak yönetebileceği REST tabanlı bir arayüzdür. Temel URL: https://openapi.etsy.com/v3/application/. Resmi dokümantasyon developers.etsy.com adresinde yer alır.

Kimlik Doğrulama: OAuth 2.0

Eski pazaryerlerinin aksine Etsy, standartlara uyumlu OAuth 2.0 with PKCE kullanır. Bir developer uygulaması kaydeder, kapsamlı izinleri (örn. listings_w, transactions_r, shops_w) talep eder ve bir yetkilendirme kodunu erişim token'ı (1 saat geçerli) artı yenileme token'ı (90 gün geçerli) ile değiştirirsiniz. Zunapro OAuth akışının tamamını ve token rotasyonunu üstlenir — böylece üretimde asla bir 401 görmezsiniz.

Çekirdek Endpoint Grupları

• Listings API — liste oluşturma, güncelleme, yenileme, devre dışı bırakma ve stok yönetimi (varyasyon ve kişiselleştirme dahil)
• Inventory API — SKU başına adet ve varyant başına fiyat, mağaza para biriminizde
• Receipts API — siparişler (Etsy bunlara "receipt" der), alıcı bilgileri, kargo adresleri
• Shipping API — kargo profilleri, hesaplanmış kargo, etiket satın alma (ABD/Birleşik Krallık)
• Shop API — mağaza politikaları, duyurular, tatil modu
• Payments API — ödemeler, ücret kırılımı, rezervler
• Reviews API — hizmet kalitesini izlemek için alıcı yorumları ve yanıtları

Hız Limitleri ve Hata Yönetimi

Etsy Open API kademeli hız limitleri uygular — tipik olarak uygulama başına saniyede 10 istek ve günde 10.000 istek. Aşılması durumunda 429 Too Many Requests döner. Yaygın hatalar: 400 (doğrulama, eksik taksonomi öznitelikleri), 401 (süresi dolmuş token — yenileme gerekir), 404 (liste/mağaza bulunamadı) ve 409 (çakışma, genellikle stok yarış koşulu). Zunapro üstel geri çekilme (exponential backoff), idempotency anahtarları ve dead-letter kuyruğu uygular — böylece geçici hatalar hiçbir stok güncellemesini kaybetmez.

Toplu Listeler — Shopify, WooCommerce veya XML'den Etsy'ye

Etsy'nin diğer pazaryerleri gibi yerel bir XML besleme içe aktarıcısı yoktur — listeler ya Open API üzerinden ya da Shop Manager'da elle oluşturulmalıdır. Bu da iyi bir entegratörü, haftada 50 liste açmakla 5.000 liste açmak arasındaki fark hâline getirir. Zunapro toplu listeleme motoru mevcut kataloğunuzu Etsy uyumlu listelere dönüştürür ve API hız limitinde toplu olarak işler.

Etsy Liste Payload Temelleri

Entegratörün oluşturduğu her Etsy listesi şunları içerir:

• title, description, price, quantity, who_made, when_made, is_supply
• taxonomy_id (Etsy kategorisi) ile birlikte zorunlu property_values (malzemeler, ana renk vb.)
• tags (en fazla 13), materials (en fazla 13), shop_section_id
• shipping_profile_id, processing_min, processing_max
• inventory — SKU başına adet, fiyat ve SKU kodu (varyasyonlar desteklenir)
• images — en fazla 10 görsel + 1 video, Listings Images endpoint'i üzerinden gönderilir

Mağazadan Etsy'ye — Zunapro Akışı

Birleşik Krallık'taki üreticilerin çoğu Etsy'nin yanı sıra bir web sitesi (Shopify, WooCommerce, Squarespace) işletir. Zunapro ikisini de adım adım senkron tutar:

1. Ana kataloğunuzu okur — Shopify/WooCommerce/CSV/XML'den planlı şekilde
2. Kategorileri eşler — Etsy taksonomisine (ilk kez manuel, sonra AI önerili)
3. Öznitelikleri normalize eder — malzeme, renk, beden — Etsy property value'larına
4. Mağaza para birimi fiyatını oluşturur (GBP) — marj kurallarınız ve Etsy ücretleri dahil
5. Liste başına 13 etiket otomatik üretir — Etsy arama trendi verisini kullanarak
6. Open API üzerinden Etsy'ye gönderir ve 4 aylık süre dolmadan otomatik yenilemeleri planlar

Etsy Fulfilment — Siz Gönderin, Biz Otomatikleştirelim

Amazon FBA'nın aksine, Etsy'nin fulfilment merkezleri yoktur. Her sipariş satıcının kendi adresinden çıkar — bu hem Etsy'nin en büyük kısıtı hem de en büyük marka değeridir (üretici tarafından gönderilen el yapımı ürünler). Entegratörün işi bu iş akışını ağrısız kılmaktır.

Desteklenen Birleşik Krallık Kargo Şirketleri

• Royal Mail — Tracked 24/48, Special Delivery, International Tracked & Signed
• Evri — ekonomik koliler, kargo bayisi bırakma ağı
• DPD UK — 1 saatlik teslimat penceresiyle ertesi gün
• FedEx ve DHL Express — uluslararası öncelikli
• USPS ve Parcelforce — alıcıya doğrudan ABD gönderimi için

Zunapro İçindeki Otomasyon

• Kargo otomatik seçimi — ağırlık, varış ülkesi ve alıcı tercihine göre
• Tek tıkla etiket yazdırma (A4 ve 4×6 termal) ile Etsy takip numarası Receipts API üzerinden geri gönderilir
• Hazırlık süresi SLA izleme — Star Seller'ın %95 zamanında gönderim eşiğinin üzerinde tutar
• Gümrük beyannameleri (CN22/CN23) — uluslararası Etsy siparişleri için otomatik doldurulur
• Karbon dengeleme kargo işareti — Etsy'nin sürdürülebilirlik iletişimiyle uyumlu

Star Seller, Yorumlar ve İptal Oranları

Etsy'nin Star Seller rozeti, pazaryerinin sahip olduğu kamuya açık kalite puanına en yakın şeydir ve arama sıralamasını doğrudan etkiler. Hak etmek için bir mağaza, kayan üç aylık pencerede her üç eşiği de tutturmak zorundadır:

• 5 yıldızlı yorumlar — yorumların en az %95'i 5★ olmalı (yorum ortalaması 4,8 üstü)
• Takip numaralı, zamanında gönderim — siparişlerin %95'i belirtilen hazırlık süresi içinde, geçerli takip numarasıyla gönderilmeli
• Hızlı mesaj yanıtı — alıcı mesajlarına ilk yanıt 24 saat içinde
• Minimum sipariş hacmi — tipik olarak pencere boyunca 10+ sipariş ve £240+ satış
• İptal oranı %4 altında tutulmalı; fazla satış ve "stokta yok" iptalleri Star Seller'ı en çok öldüren tek başlık

Zunapro'nun gerçek zamanlı stok senkronu iptal riskini yaklaşık %90 azaltır — bir SKU web sitenizde, Depop'ta ya da başka bir kanalda satıldığı anda Etsy stoğu saniyeler içinde düşer, böylece teslim edemeyeceğiniz bir siparişi asla kabul etmezsiniz.

Etsy Ads, Offsite Ads ve Çoklu Para Birimi Fiyatlandırması

Etsy'nin İki Reklam Ürünü

• Etsy Ads (site içi) — Etsy arama sonuçlarında öne çıkan yerleşim için CPC açık artırması; günlük bütçeyi siz belirlersiniz (£1'den itibaren)
• Offsite Ads — Etsy listelerinizde Google, Meta, Pinterest ve Bing kampanyaları yürütür; sadece atfedilen satışlarda %12 (yıllık £8.200 altı mağazalar için %15) ödersiniz — eşik üzerindeki mağazalar için zorunludur
• Etsy Seller Bundles — Etsy editöryel hediye rehberlerinde mevsimsel yerleşim (Noel, Anneler Günü, Sevgililer Günü, düğünler)
• Star Seller artışı — hak eden mağazalar görünür bir rozet ve organik sıralama desteği alır

Çoklu Para Birimi Fiyatlandırması (GBP Ana, Yerel Alıcı)

Etsy mağazanızın tek bir mağaza para birimi vardır (İngiliz satıcılar için tipik olarak GBP) ancak alıcılar fiyatları ödeme adımında otomatik olarak kendi yerel para birimlerinde görür. Döviz dalgalanmaları, USD veya EUR satışlarda marjı sessizce eritebilir. Zunapro repricer'ı bir GBP ana fiyatı saklar, landed marjı canlı kurlara göre yeniden hesaplar ve maliyet + ücretler tolerans bandınızın dışına çıktığında Etsy'yi günceller — asla minimum marj tabanınızı geçmeden.

Etsy Satıcıları için Birleşik Krallık KDV, MTD ve HMRC Uyumu

Etsy, AB alıcıları için satıcılar adına IOSS üzerinden KDV tahsil edip iletir; pek çok yargı bölgesinde dijital ürünlerde de aynısını yapar — ancak Birleşik Krallık'ta KDV mükellefi satıcılar iç KDV beyannamesinden sorumlu olmaya devam eder. Etsy CSV dışa aktarımlarını elle Xero veya QuickBooks ile mutabakata getirmek, her ay sessizce bir Cumartesi sabahını yiyen türden bir iştir.

Zunapro KDV ve muhasebe modülü:

• Her Etsy receipt'ini doğru KDV muamelesiyle (standart, %0, IOSS ile tahsil, marketplace-deemed-supplier) bir satış faturası olarak otomatik kaydeder
• Kayıtları API üzerinden Xero, QuickBooks, Sage veya FreeAgent'a iletir — kutudan çıktığı haliyle KDV için MTD uyumlu
• Etsy bir iadeyi işlediğinde otomatik olarak alacak dekontu kesilir
• Üç aylık KDV beyannamesi hazırlığı ve HMRC'ye sunuma hazır özetler
• Müşteri makbuzları otomatik PDF olarak gönderilir, isteğe bağlı SMS onayı

Etsy Kargo Profilleri ve Kargo Entegrasyonu

Etsy listeleri yeniden kullanılabilir kargo profilleri üzerinden gönderilir — çıkış ülkesi, sabit ya da hesaplanmış tarifeler, hazırlık süresi ve gönderim yapılan ülkeler. Birleşik Krallık satıcılarının çoğu yurt içi Royal Mail, AB takipli ve uluslararası takipli için ayrı profiller işletir. Zunapro çoklu kargo modülü her sipariş için doğru profili otomatik seçer, Royal Mail, Evri, DPD UK, FedEx ve DHL için etiket basar ve takip numaralarını Receipts API üzerinden Etsy'ye geri iletir — Star Seller'ın "takipli ve zamanında gönderim" döngüsünü otomatik olarak kapatır.

İadeler, Fikri Mülkiyet Şikayetleri ve Alıcı Uyuşmazlıkları

Birleşik Krallık Consumer Contracts Regulations, alıcılara kişiselleştirilmemiş çoğu siparişte 14 günlük cayma hakkı tanır ve Etsy'nin kendi politikası da mağazaların net bir iade politikası yayınlamasını şart koşar. Etsy genelinde iade oranları moda pazaryerlerine göre çok daha düşüktür — tipik olarak %3–%8 — çünkü ürünler dürtüsel moda değil, kişiye özel ve duygusal seçimlerdir. Etsy satıcıları için asıl risk farklıdır: fikri mülkiyet ve marka şikayetleri.

Standart Etsy iade akışı:

1. Alıcı, teslimattan sonraki 100 gün içinde Etsy Help With Order merkezinden bir vaka açar
2. Satıcı 48 saat içinde yanıt verir; vermezse Etsy varsayılan olarak alıcı lehine karar verebilir
3. İade, Etsy Payments üzerinden yapılır — kısmi ya da tam, iade gönderimli ya da gönderimsiz
4. Marka/fikri mülkiyet şikayetlerinde liste anında kaldırılır ve satıcının Etsy'nin IP formu üzerinden karşı bildirimde bulunması gerekir
5. Tekrarlanan IP ihlalleri kalıcı mağaza askıya alınmasına yol açabilir

Zunapro vaka yönetimi modülü açık olan her uyuşmazlığı takip eder, Etsy bir alıcıya iade verdiğinde otomatik olarak alacak dekontu keser ve bir IP şikayeti açıldığı an sizi uyarır — böylece Etsy'nin SLA'sı içinde yanıt verebilirsiniz.

Etsy'yi Zunapro'ya Bağlamak — 4 Adım (10 Dakika)

1. Etsy mağazanızı yetkilendirin — Zunapro panelinde Pazaryeri → Etsy'ye gidin, "Bağlan"a tıklayın ve Etsy'nin OAuth 2.0 onayını tamamlayın. Şifrenizi asla görmeyiz — yalnızca kapsamlı token'ları.
2. Mağazanızı bağlayın — Shopify, WooCommerce, Magento, BigCommerce, Squarespace ya da bir CSV/XML beslemesini bağlayın. Hazır konektörler kimlik bilgilerini ve webhook'ları yönetir.
3. Kategorileri ve kargo profillerini eşleyin — Kategorilerinizi Etsy taksonomisine sürükle-bırak ile eşleyin; AI önerileri dakikalar içinde tamamlanır. Hangi ürün tipine hangi kargo profilinin uygulanacağını seçin.
4. İlk senkron — Listeler, stok, fiyatlar, siparişler ve kargo otomatik olarak senkronize edilmeye başlar. 10 dakika içinde Etsy mağazanız Zunapro'dan tam olarak yönetilir hâle gelir.

Etsy Entegrasyonu Hakkında Sıkça Sorulan Sorular