Etsy bağlama

Etsy bağlantısı, Etsy'nin geliştirici uygulaması üzerinden kurulur. Etsy size yalnız API anahtarı (keystring) ve gizli anahtar (shared secret) verir; panel bu anahtarla sizi Etsy'nin izin ekranına götürür, onayladığınızda bağlantı kendiliğinden kurulur. Elle girmeniz gereken bir "refresh token" yoktur.

Adım adım

1. etsy.com/developers adresinde "Your Apps" bölümünden bir uygulama oluşturun (varsa mevcut uygulamanızı kullanın). Uygulamanın durumu Approved (onaylı) olmalıdır; Etsy onay vermeden yalnız sınırlı erişim mümkündür.
2. Panelde Entegrasyonlar > Etsy > Bağla ekranını açın. Ekranın üstündeki dönüş adresini (Callback URL) kopyalayın.
3. Etsy uygulamanızın ayarlarında Callback URL alanına bu adresi yapıştırıp kaydedin. Adres birebir aynı olmalıdır; en ufak fark Etsy'nin "redirect_uri" hatası vermesine yol açar.
4. Panele dönüp API anahtarını (keystring) ve gizli anahtarı (shared secret) girin ve Etsy ile bağlan deyin. İkisi de gerekir: Etsy her isteği bu iki değerle birlikte doğrular.
5. Etsy'nin izin ekranı açılır; mağazanın sahibi olan Etsy hesabıyla giriş yapıp Allow deyin. Uygulamayı başka bir hesapta (ör. ayrı geliştirici hesabı) açmış olmanız sorun değildir; önemli olan izin ekranında mağazayı yöneten hesapla giriş yapmanızdır. Mağazası olmayan bir hesapla izin verirseniz panel "bu Etsy hesabına bağlı bir mağaza yok" der; Etsy'den çıkış yapıp doğru hesapla yeniden deneyin. Panele geri döndüğünüzde bağlantı kurulmuş olur; ürünler ve siparişler arka planda çekilmeye başlar.

Etsy'de uygulamanın iznini kaldırırsanız ya da yetki süresi dolarsa (Etsy jetonu 90 günde bir yeniler, panel bunu kendisi yapar; yalnız uzun süre hiç istek atılmazsa düşer) Entegrasyonlar > Etsy > Yönet ekranındaki Etsy yetkisini yenile düğmesiyle yeniden yetkilendirin; API anahtarınızı yeniden girmeniz gerekmez.

Bilinmesi gerekenler

• Yalnız değişen gider. Ürünü kaydettiğinizde başlık ya da açıklama yalnız panelde değiştiyse Etsy'ye gönderilir; Etsy'de elle düzelttiğiniz başlık, siz panelde değiştirmedikçe ezilmez.
• Para birimi: Etsy mağazaları genellikle USD/EUR ile çalışır. Panel fiyatı çevirmez; Etsy kanalı için ayrı fiyat girmeniz gerekir. Bkz. Kanal bazlı fiyat.
• Stok ve fiyat envanter üzerinden güncellenir: Etsy envanteri bütün olarak okur ve yazar; panel değişiklik yaparken mevcut envanteri koruyarak günceller.
• Yetki kendiliğinden tazelenir; panel Etsy'nin döndürdüğü yeni jetonu kendisi saklar. Etsy tarafında yetkiyi kaldırırsanız bağlantı düşer; Yönet ekranından yeniden yetkilendirin.
• Kargo bildirimi takip numarasıyla yapılır; sipariş "Kargoda" olduğunda gönderilir.
• Kargo bildirimi dışında panelden Etsy'ye ilan da açabilirsiniz; aşağıya bakın.

Panelden Etsy'ye ilan açma

Etsy her ilanda kategori, kargo profili, iade politikası ve "kim yaptı / ne zaman yapıldı" bilgisini zorunlu tutar. Bir kerelik hazırlık:

1. Entegrasyonlar > Etsy > Yönet ekranında Etsy ilan ayarları bölümünden kargo profilini ve iade politikasını seçin. Liste Etsy mağazanızdan okunur; boşsa Etsy'de Shop Manager > Settings altından bir kargo profili ve iade politikası oluşturup Listeyi Etsy'den yenile deyin. "Kim yaptı / ne zaman yapıldı" için varsayılan "kendim yaptım / 2020-2026"dır; markanız üretim ortağıyla çalışıyorsa "başkası üretti" seçin.
2. Entegrasyonlar > Etsy > Kategori eşle ekranında ürün kategorilerinizi Etsy kategorileriyle (taxonomy) eşleştirin. Etsy listesi bağlantı kurulunca arka planda çekilir; boş görünüyorsa Yenile deyin.
3. Ürün kartında en az bir görsel ve sıfırdan büyük fiyat olsun.

Sonra ürün listesinden Kanala gönder > Etsy deyin. Panel ilanı taslak olarak açar, görselleri yükler, varyantları (en çok 2 seçenek: örn. boyut ve renk) ve stok/fiyatı yazar, stok varsa ilanı yayına alır. Stok 0 ise ilan taslak kalır; stok girip yeniden gönderince yayınlanır. Aynı ürünün diğer varyantları aynı ilana bağlanır, ikinci ilan açılmaz.

Bilinmesi gerekenler:

• Başlık kuralı: Etsy başlıkta yalnız harf, rakam, noktalama ve boşluğa izin verir; %, :, &, + işaretleri en fazla birer kez geçebilir. Panel fazlasını kendiliğinden temizler. Başlık 140 karakterde kesilir.
• Etiketler başlıktaki kelimelerden üretilir (en çok 13); Etsy panelinden düzenleyebilirsiniz.
• Fiyat mağazanızın para biriminde gönderilir, çevrilmez. Etsy kanal fiyatını ayrı girin.
• Etsy'nin satış kuralları: Etsy yalnız el yapımı, kendi tasarımınız, vintage ya da el işi malzemesi satışına izin verir; markalı hazır ürün satışı mağaza kapatma sebebi olabilir. Bu kuralın sorumluluğu satıcıdadır.
• Var olan ilanı panelden güncellemek başlık, açıklama, kargo/iade profili, varyant, stok ve fiyatı yazar. Görseller panelde değiştiğinde ayrıca eşitlenir: yalnız yeni ya da yeri değişen görsel yüklenir, panelde olmayan Etsy görseli silinir — kopya oluşmaz. Görsellerine panelde hiç dokunmadığınız ilanda ürünü kaydetmek Etsy'deki görselleri değiştirmez.
• İlanı Etsy'de açtıysanız varyasyon yapısına dokunulmaz: Etsy'nin kendi özelliklerini (ör. ölçekli Beden) kullanan ya da panelde karşılığı olmayan varyasyonu bulunan ilanda panel yalnız eşleşen varyasyonların fiyatını, adedini ve açık/kapalı durumunu yazar; diğer varyasyonlar olduğu gibi kalır. Böyle bir ilana yeni varyasyonu Etsy panelinden, aynı stok koduyla ekleyin — stok ve fiyatını panel yazmaya devam eder.

Siparişler anında düşer (tek seferlik ayar)

Etsy anlık sipariş bildirimi gönderiyor, ancak adresi kendi geliştirici panelinizden tanımlamanız gerekiyor — Etsy bu kaydı API üzerinden açtırmıyor.

Adresi panel sizin için hazırlar:

1. Entegrasyonlar > Etsy > Yönet ekranını açın.
2. "Etsy anlık sipariş bildirimi" kutusundaki adresi Kopyala ile alın.
3. developers.etsy.com adresinde Manage your apps > (uygulamanız) > Webhook portal'ı açın.
4. + Add Endpoint ile adresi yapıştırın, olay olarak order.paid seçin ve kaydedin.
5. İsterseniz order.canceled için ikinci bir kayıt daha ekleyin.

Bu adres size özeldir, kimseyle paylaşmayın.

Bu ayarı yapmasanız da sipariş kaçmaz: panel Etsy'yi 5 dakikada bir kendisi yoklar. Bildirim yalnızca bekleme süresini ortadan kaldırır.