Odoo Etsy Bağlayıcısı: El Yapımı Ticaret Entegrasyonu

Etsy, 9 milyondan fazla aktif satıcıya ev sahipliği yapıyor ve başka hiçbir pazarın taklit edemeyeceği bir niş hizmet veriyor: el yapımı, vintage ve el sanatları tedarik ürünleri. Odoo 19 Enterprise, temel elektronik tablo takibinin ötesinde büyüyen Etsy satıcıları için ölçeklendirme işinin ihtiyaç duyduğu envanter yönetimi, finansal muhasebe ve üretim planlama yeteneklerini sağlar.

ECOSIRE Odoo Etsy Bağlayıcı, Etsy mağazanızı Odoo ile birleştirerek listeleri, siparişleri, envanteri ve müşteri verilerini senkronize eder. Bu kılavuz, Etsy API kimlik bilgisi kurulumundan üretim siparişi yönetimine ve Etsy satıcı raporlamasına kadar tüm entegrasyonu kapsar.

Önemli Çıkarımlar

• Bağlayıcı, OAuth 2.0 kimlik doğrulamasıyla Etsy API v3'ü kullanır
• Listeler her iki yönde de senkronize edilir: Odoo'da oluşturun, Etsy'de yayınlayın
• Siparişin içe aktarılması, alıcı ayrıntılarını, ürün özelleştirme notlarını ve hediye paketleme bayraklarını içerir
• Envanter, Odoo'daki stok değişikliklerinden sonraki 5 dakika içinde Etsy'ye aktarılır
• Üretim siparişi (MRP) entegrasyonu, siparişe göre üretilen el yapımı ürünleri takip eder
• Etsy ücretleri ve ödeme işlem ücretleri, Odoo faturalarıyla otomatik olarak mutabakata varılır
• Birden fazla mağaza desteklenir: birden fazla Etsy mağazasını tek bir Odoo örneğinden yönetin
• Etsy'nin liste yenilemesi (liste başına 20¢ otomatik yenileme) Odoo maliyetlerinde takip edilir

---

Etsy Satıcıları Neden Odoo Entegrasyonuna İhtiyaç Duyuyor?

Etsy'nin yerleşik mağaza yöneticisi, temel sipariş takibini gerçekleştirir ancak büyüyen el yapımı işletmelerin ihtiyaç duyduğu derinliğe sahip değildir:

Odoo, aylık 10.000 ABD dolarının üzerinde gelir elde eden veya el yapımı ve malzemelerden 50'den fazla aktif SKU'yu yöneten satıcılar için, işletmeye göre ölçeklenen operasyonel yetenekler sunar.

---

Etsy API Kurulumu

1. Adım: Etsy geliştirici hesabı oluşturun

1. developers.etsy.com adresine gidin ve Etsy satıcı hesabınızla oturum açın
2. Uygulamalarım altında Uygulama Oluştur'a tıklayın
3. Uygulamanıza bir ad verin (ör. "Odoo Entegrasyonu") ve amacını açıklayın
4. Etsy API Hizmet Şartları'nı kabul edin
5. Etsy başvurunuzu inceleyecektir (genellikle 1-3 iş günü içinde)

2. Adım: OAuth kapsamlarını yapılandırın

Uygulamanız aşağıdaki OAuth 2.0 kapsamlarına ihtiyaç duyar:

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

3. Adım: API kimlik bilgilerini oluşturun

Onaylandıktan sonra:

• API Anahtarı (Anahtar Dizisi): uygulama tanımlayıcınız
• Paylaşılan Sır: OAuth PKCE akışı için kullanılır
• Yönlendirme URI'si: https://your-odoo.com/etsy/oauth/callback

4. Adım: OAuth yetkilendirmesini tamamlayın

Odoo'daki bağlayıcı yapılandırmasından:

1. Etsy Shop'a Bağlan'a tıklayın
2. Etsy OAuth açılır penceresinde bağlayıcıyı yetkilendirin
3. Bağlayıcı, erişim belirtecinizi ve yenileme belirtecinizi alır ve saklar

Etsy'nin OAuth jetonlarının süresi sabit bir süre sınırıyla dolmaz (Amazon'un 18 aylık yenileme jetonlarının aksine). Siz onları iptal edene kadar geçerli kalırlar.

---

Konektör Kurulumu ve Yapılandırması

ECOSIRE pazarından yükleyin:

ECOSIRE Ürünleri adresinde mevcuttur. Satın aldıktan sonra:

1. Etsy Bağlayıcı modülünü Uygulamalar aracılığıyla yükleyin ve yükleyin
2. Envanter → Etsy veya Satış → Etsy Mağazaları'na gidin

Mağaza yapılandırması:

Etsy mağaza bölümleri eşlemesi:

Etsy, listeleri mağaza bölümleri (kategorilere eşdeğer) halinde düzenler. Etsy bölümlerini Odoo ürün kategorileriyle eşleyin:

---

Listeleme Yönetimi

Odoo ürünlerinden Etsy listeleri oluşturma:

1. Bir ürün formu açın → Etsy sekmesi → İlan Oluştur
2. Listelemeye özgü alanları yapılandırın:

• Başlık: Maksimum 140 karakter, Etsy SEO için anahtar kelime açısından zengin
• Açıklama: malzemeler, boyutlar ve bakım talimatlarını içeren tam açıklama
• Etiketler: 13'e kadar etiket, Etsy arama algoritması için kritik öneme sahiptir
• Kategori: Etsy'nin sınıflandırma ağacına göz atın
• Kim Yaptı: Ben Yaptım, Dükkanımın Üyesi, Başkası
• Yapıldığı Zaman: Sipariş Üzerine Yapıldı, 2020–2025, 2010–2019 vb.
• Tür: Fiziksel Öğe, Dijital İndirme
• Fiyat: liste fiyatı (Odoo'nun liste fiyatından farklı olabilir)
• Miktar: listelenecek mevcut envanter
• Malzemeler: 13'e kadar malzeme etiketi
• Fotoğraflar: en fazla 10 fotoğraf (ilk resim ana liste resmi olur)

3. Etsy'de Yayınla'ya tıklayın

Varyasyon listeleri (ürün çeşitleri):

Etsy "varyasyonları" destekler - Odoo bunları ürün özelliklerine eşler:

Örnek: 5-10 bedende Altın/Gümüş olarak satılan bir yüzük, her birinin kendi fiyatı ve stok takibi olan 12 varyasyon kombinasyonundan oluşan tek bir Etsy listesi oluşturur.

Kişiselleştirilmiş ve özel sipariş listeleri:

Etsy kişiselleştirilmiş ürünlerle ünlüdür. Bağlayıcıda kişiselleştirmeyi yapılandırın:

• Listede Kişiselleştirme Gerekli/İsteğe Bağlı seçeneğini etkinleştirin
• Alıcı ödeme sırasında kişiselleştirme metnini (isim, tarih, monogram) girer
• Bu metin Odoo satış siparişinin müşteri notları alanında görünür
• Üretim ekibi, öğeyi yaparken özelleştirmeyi görüyor

---

Sipariş Senkronizasyonu

Sipariş içe aktarma ayrıntıları:

Etsy siparişleri, el yapımı satıcılar için kritik öneme sahip alanları içerir:

Sipariş üzerine üretim için sipariş yönlendirme:

Etsy satıcıları genellikle sipariş (MTO) aldıktan sonra ürün üretir. Bağlayıcıyı yapılandırın:

1. Ürün ayarlarında → Satış sekmesinde → Talep Üzerine: "Sipariş Üzerine Üretilir"
2. Bir Etsy siparişi içe aktarıldığında Odoo şunları oluşturur:

• Satış siparişi (onaylandı)
• Satışa bağlı üretim siparişi (taslak)
• Üretim siparişi gerekli malzemeleri ve işçilik süresini gösterir

3. Üretim ekibi üretim siparişi üzerinden çalışır
4. MO tamamlandığında ürünler stoğa ulaşır → teslimat onaylanır
5. Gönderi ayrıntıları Etsy'ye geri gönderildi

Özel sipariş yönetimi:

Özel komisyonlar için (Etsy'de listelenmemiş):

1. Etsy'deki özel siparişi kabul edin
2. Odoo'da, üzerinde anlaşmaya varılan fiyatla manuel olarak bir "Özel Ürün" satış siparişi oluşturun
3. Sipariş notlarında Etsy konuşmasının bağlantısı
4. Etsy'de manuel olarak veya bağlayıcının özel sipariş aracını kullanarak gönderildi olarak işaretleyin

---

Envanter Senkronizasyonu

Fiziksel ürünler için:

Envanter senkronizasyonu varsayılan olarak her 5 dakikada bir çalıştırılır. Odoo hisse senedi değiştiğinde:

1. Mevcut miktar yeniden hesaplandı (eldeki eksi ayrılmış)
2. Listeleme Envanteri API'si aracılığıyla miktar Etsy'ye aktarıldı
3. Miktar 0'a ulaşırsa: listeleme tükendi olarak ayarlanır (listelemenin aktif kalması sağlanır)
4. Stoklar yeniden doldurulduğunda: listeleme otomatik olarak yeniden etkinleştirilir

Sipariş üzerine üretilen ürünler için:

MTO ürünleri fiziksel envanteri geleneksel anlamda izlemez. Etsy listeleme miktarını üretim kapasitesi göstergesi olarak yapılandırın:

• Mevcut sipariş kapasitesini temsil eden sabit bir "mevcut miktar" (ör. 5) belirleyin
• Üretim kuyruğunuz doldukça manuel olarak ayarlayın

Dijital indirmeler için:

Dijital ürünler sonsuz envantere sahiptir. Bağlayıcı, Etsy miktarını 999'a ayarlar ve envanter değişikliklerini hiçbir zaman senkronize etmez. Dijital dosya teslimi, Etsy'nin yerel dijital indirme sistemi tarafından gerçekleştirilir; bağlayıcı, dosya teslimine dokunmaz.

---

Mali Mutabakat

Etsy'nin ödeme işleme ve ücret yapısı dikkatli bir muhasebe kurulumu gerektirir.

Etsy Payments ücret yapısı (referans için):

• Listeleme ücreti: Listeleme başına 0,20 ABD Doları (listelendiğinde ve otomatik yenilemede her 4 ayda bir ücret alınır)
• İşlem ücreti: Ürün fiyatının %6,5'i + kargo
• Ödeme işlem ücreti: %3 + işlem başına 0,25 ABD doları (ABD)
• Site Dışı Reklam ücreti: Etsy ürününüzün reklamını yaptığında %12-15 (kayıtlıysanız)

Odoo'da ücret mutabakatını ayarlama:

1. Özel bir Etsy Payments günlüğü oluşturun (Banka türü)
2. Hesap oluşturun:

• Etsy Listing Fees (gider)
• Etsy Transaction Fees (gider)
• Etsy Payment Processing Fees (gider)
• Etsy Payments Receivable (dönen varlık)

3. Etsy ödeme ekstrelerini içe aktarın:

• Etsy'ye gidin → Ödemeler → Aylık Ekstre → CSV'yi İndirin
• Bağlayıcının mutabakat aracına aktarın
• Bağlayıcı her işlem türü için günlük girişleri oluşturur

Ay sonu mutabakat süreci:

1. Etsy aylık ödeme CSV dosyasını indirin
2. Bağlayıcı aracılığıyla içe aktarma: Etsy → Mutabakat → İçe Aktarma Bildirimi
3. Otomatik eşleşen girişleri inceleyin
4. Tanınmayan işlemleri manuel olarak eşleştirin
5. Mutabakatı onaylayın → Odoo'ya gönderilen günlük girişleri
6. Etsy Payments banka hesabının Odoo bakiyesiyle mutabakatını sağlayın

---

Etsy SEO ve Performans Takibi

Liste performansı senkronizasyonu:

Bağlayıcı, Etsy mağaza istatistiklerini Odoo'ya aktarır:

• Liste başına günlük görüntüleme sayısı
• Favorites count
• Dönüşüm oranı (satışlara yönelik görüntülemeler)
• Listelemeye göre gelir

Bu veriler Odoo'daki Etsy analiz panosunda görünür ve Etsy'nin istatistik arayüzüne geçmeden en iyi performansı gösterenleri ve düşük performans gösteren listeleri belirlemenize olanak tanır.

Etiket ve anahtar kelime izleme:

Etsy'nin Mağaza İstatistikleri API'sinden istatistikler alarak hangi arama terimlerinin Etsy trafiğini artırdığını takip edin. Bu verileri aşağıdaki amaçlarla kullanın:

• Benzer listelere eklenecek yüksek dönüşüm sağlayan etiketleri belirleyin
• İzlenme sayısı yüksek ancak dönüşümü düşük olan (fiyat veya fotoğraf sorunları) listeleri bulun
• Ürün kategorinizdeki sezon trendlerini tespit edin

---

Sıkça Sorulan Sorular

Bağlayıcı, Etsy pazarına ek olarak Etsy'nin Kalıbını (özel web sitesi) de işleyebilir mi?

Hayır. Konektör, özellikle Etsy pazarıyla entegre olur. Etsy Pattern (barındırılan web sitesi oluşturucusu) aynı envanteri paylaşır ancak ayrı ödeme ve ödeme işlemlerini kullanır. Desen siparişlerinin ayrı olarak yönetilmesi gerekir. Tam özellikli bir web sitesi entegrasyonu için Odoo'nun web sitesi modülü veya Shopify entegrasyonu önerilir.

Bağlayıcı, Etsy'nin işlemlere ilişkin rezervini (Etsy ödeme bekletme) nasıl yönetir?

Etsy bazen risk yönetimi amacıyla yeni satıcı ödemelerine karşılık ayırır. Bağlayıcı her siparişin ödeme durumunu izler. Ayrılmış tutarlar Etsy Payments bakiyesinde görünür ancak para çekme işlemi için uygun değildir. Bağlayıcı, rezerv serbest bırakılana kadar bu faturaları "ödemeyi bekleyen" olarak işaretler, ardından para bankanıza aktarıldığında "ödendi" olarak güncellenir.

Bir Odoo örneğinden birden fazla Etsy mağazasını (ör. biri mücevher, biri ev dekorasyonu) yönetebilir miyim?

Evet. Her mağaza için bağımsız OAuth kimlik bilgileriyle ayrı Etsy mağaza yapılandırmaları oluşturun. Her mağazanın kendi sipariş içe aktarma, envanter tahsisi ve ödeme mutabakatı ayarları vardır. Ürünler, mağazaya özel fiyatlandırma geçersiz kılmalarıyla birden fazla mağazada listelenebilir.

Bağlayıcı, Etsy'nin toptan satış/B2B işlevini destekliyor mu?

Etsy'nin yerel bir toptan satış/B2B programı yoktur. Toptan satış talepleri için Etsy'yi kullanıyorsanız ancak gerçek işlemi çevrimdışı olarak gerçekleştiriyorsanız, bağlayıcı bunu herhangi bir özel siparişle aynı şekilde ele alır; üzerinde anlaşılan fiyatlandırmayla Odoo satış siparişini manuel olarak oluşturur ve standart işleminizi yerine getirirsiniz.

Bağlayıcı uluslararası Etsy satışlarını ve KDV/GST gereksinimlerini nasıl karşılıyor?

Etsy, AB, Birleşik Krallık, Avustralya ve Etsy'nin pazar kolaylaştırıcısı olarak görev yaptığı diğer yargı bölgelerindeki alıcılar için satıcılar adına KDV/GST'yi toplar ve öder. Bağlayıcı bu siparişleri 0 ABD Doları vergiyle içe aktarır (Etsy bu vergiyi topladığı için). Vergi toplamaktan sorumlu olduğunuz pazarlar için Odoo'da alıcının ülkesine göre uygun mali pozisyonları yapılandırın.

---

Sonraki Adımlar

ECOSIRE Etsy Bağlayıcısı, Etsy'yi bağımsız bir pazar yerinden Odoo 19 Enterprise içinde tamamen entegre bir satış kanalına dönüştürür. Temel mağaza yönetiminin ötesine geçen el yapımı işletmeler için bu entegrasyon, sürdürülebilir büyümenin operasyonel omurgasını sağlar.

Odoo 19 için ECOSIRE Etsy Bağlayıcısını edinin →

Bağlayıcı, Etsy mağazanızın Odoo ile hızlı ve doğru bir şekilde entegre olmasını sağlamak için kurulum belgelerini, geçmiş sipariş verileri için içe aktarma araçlarını ve uygulama desteğini içerir.