Odoo Etsy Connector: Handmade-Commerce-Integration

Etsy beherbergt über 9 Millionen aktive Verkäufer und bedient eine Nische, die kein anderer Marktplatz reproduziert: handgefertigte, Vintage- und Kunsthandwerksartikel. Für Etsy-Verkäufer, die über die einfache Tabellenverfolgung hinausgewachsen sind, bietet Odoo 19 Enterprise die Funktionen für Bestandsverwaltung, Finanzbuchhaltung und Produktionsplanung, die ein expandierendes Handwerksunternehmen benötigt.

Der ECOSIRE Odoo Etsy Connector verbindet Ihren Etsy-Shop mit Odoo und synchronisiert Angebote, Bestellungen, Inventar und Kundendaten. Dieser Leitfaden behandelt die vollständige Integration von der Einrichtung der Etsy-API-Anmeldeinformationen über die Produktionsauftragsverwaltung bis hin zur Etsy-Verkäuferberichterstattung.

Wichtige Erkenntnisse

– Connector verwendet Etsy API v3 mit OAuth 2.0-Authentifizierung – Einträge werden in beide Richtungen synchronisiert: in Odoo erstellen, auf Etsy veröffentlichen – Der Bestellimport umfasst Käuferdetails, Artikelanpassungshinweise und Geschenkverpackungsmarkierungen – Der Lagerbestand wird innerhalb von 5 Minuten nach Bestandsänderungen in Odoo an Etsy weitergeleitet

• Die Integration von Produktionsaufträgen (MRP) verfolgt die Herstellung handgefertigter Waren auf Bestellung
• Etsy-Gebühren und Gebühren für die Zahlungsabwicklung werden automatisch mit Odoo-Rechnungen abgeglichen
• Mehrere Shops unterstützt: Verwalten Sie mehrere Etsy-Shops von einer Odoo-Instanz aus
• Etsys Angebotsverlängerung (automatische Verlängerung 20 Cent pro Angebot) wird in den Odoo-Kosten erfasst

---

Warum Etsy-Verkäufer eine Odoo-Integration benötigen

Der integrierte Shop-Manager von Etsy übernimmt die grundlegende Auftragsverfolgung, verfügt jedoch nicht über die Tiefe, die wachsende Unternehmen für handgefertigte Produkte benötigen:

Für Verkäufer, die einen monatlichen Umsatz von mehr als 10.000 US-Dollar erzielen oder mehr als 50 aktive SKUs in den Bereichen Handarbeit und Materialien verwalten, bietet Odoo Betriebsfunktionen, die mit dem Unternehmen skalieren.

---

Etsy-API-Setup

Schritt 1: Erstellen Sie ein Etsy-Entwicklerkonto

1. Gehen Sie zu developers.etsy.com und melden Sie sich mit Ihrem Etsy-Verkäuferkonto an
2. Klicken Sie unter „Meine Apps“ auf App erstellen
3. Benennen Sie Ihre App (z. B. „Odoo-Integration“) und beschreiben Sie ihren Zweck
4. Akzeptieren Sie die Nutzungsbedingungen der Etsy-API
5. Etsy prüft Ihre Bewerbung (normalerweise 1–3 Werktage).

Schritt 2: OAuth-Bereiche konfigurieren

Ihre App benötigt die folgenden OAuth 2.0-Bereiche:

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

Schritt 3: API-Anmeldeinformationen generieren

Nach Genehmigung:

• API-Schlüssel (Schlüsselzeichenfolge): Ihre Anwendungskennung
• Gemeinsames Geheimnis: Wird für den OAuth-PKCE-Fluss verwendet
• Umleitungs-URI: https://your-odoo.com/etsy/oauth/callback

Schritt 4: OAuth-Autorisierung abschließen

Aus der Connector-Konfiguration in Odoo:

1. Klicken Sie auf Etsy-Shop verbinden
2. Autorisieren Sie den Connector im Etsy OAuth-Popup
3. Der Connector empfängt und speichert Ihr Zugriffstoken und Aktualisierungstoken

Die OAuth-Tokens von Etsy verfallen nicht mit einem festen Zeitlimit (im Gegensatz zu den 18-monatigen Aktualisierungstokens von Amazon). Sie behalten ihre Gültigkeit, bis Sie sie widerrufen.

---

Connector-Installation und -Konfiguration

Vom ECOSIRE-Marktplatz installieren:

Verfügbar unter ECOSIRE Products. Nach dem Kauf:

1. Laden Sie das Etsy Connector-Modul über Apps hoch und installieren Sie es
2. Navigieren Sie zu Inventar → Etsy oder Verkäufe → Etsy-Shops

Shop-Konfiguration:

Zuordnung der Etsy-Shop-Bereiche:

Etsy organisiert Einträge in Shop-Bereichen (entspricht Kategorien). Ordnen Sie Etsy-Abschnitte Odoo-Produktkategorien zu:

---

Eintragsverwaltung

Erstellen von Etsy-Einträgen aus Odoo-Produkten:

1. Öffnen Sie ein Produktformular → Registerkarte Etsy → Eintrag erstellen
2. Eintragsspezifische Felder konfigurieren:

• Titel: maximal 140 Zeichen, reich an Schlüsselwörtern für Etsy SEO
• Beschreibung: vollständige Beschreibung mit Materialien, Abmessungen, Pflegehinweisen
• Tags: bis zu 13 Tags, entscheidend für den Etsy-Suchalgorithmus
• Kategorie: Durchsuchen Sie Etsys Taxonomiebaum
• Wer hat es gemacht: Ich habe es gemacht, ein Mitglied meines Shops, jemand anderes
• Bei Herstellung: Auf Bestellung gefertigt, 2020–2025, 2010–2019 usw.
• Typ: Physischer Artikel, digitaler Download
• Preis: Listenpreis (kann vom Listenpreis von Odoo abweichen)
• Menge: Verfügbarer Bestand zum Auflisten
• Materialien: bis zu 13 Material-Tags
• Fotos: bis zu 10 Fotos (das erste Bild wird zum Hauptbild der Auflistung)

3. Klicken Sie auf Auf Etsy veröffentlichen

Variationsauflistungen (Produktvarianten):

Etsy unterstützt „Variationen“ – Odoo ordnet diese Produktattributen zu:

Beispiel: Ein in Gold/Silber verkaufter Ring mit den Größen 5–10 erstellt einen einzigen Etsy-Eintrag mit 12 Variationskombinationen, jede mit eigenem Preis und eigener Bestandsverfolgung.

Personalisierte und kundenspezifische Bestellangebote:

Etsy ist berühmt für personalisierte Artikel. Konfigurieren Sie die Personalisierung im Connector:

• Aktivieren Sie Personalisierung erforderlich/optional für den Eintrag
• Der Käufer gibt beim Bezahlvorgang den Personalisierungstext (Name, Datum, Monogramm) ein
• Dieser Text erscheint im Kundennotizfeld des Odoo-Verkaufsauftrags
• Das Produktionsteam sieht die Individualisierung bei der Herstellung des Artikels

---

Auftragssynchronisierung

Details zum Bestellimport:

Etsy-Bestellungen umfassen Felder, die für handgefertigte Verkäufer wichtig sind:

Auftragsweiterleitung für Auftragsfertigung:

Etsy-Verkäufer fertigen Artikel oft erst nach Eingang einer Bestellung an (MTO). Konfigurieren Sie den Connector:

1. In den Produkteinstellungen → Registerkarte „Verkauf“ → „On Demand“: „Auf Bestellung gefertigt“
2. Wenn eine Etsy-Bestellung importiert wird, erstellt Odoo:

• Verkaufsauftrag (bestätigt)
• Mit dem Verkauf verknüpfter Fertigungsauftrag (Entwurf).
• Der Fertigungsauftrag zeigt benötigte Materialien und Arbeitszeit

3. Das Produktionsteam arbeitet den Fertigungsauftrag durch
4. Wenn MO fertig ist, kommt die Ware im Lager an → die Lieferung wird bestätigt
5. Versanddetails werden an Etsy zurückgesendet

Benutzerdefinierte Auftragsabwicklung:

Für individuelle Aufträge (nicht auf Etsy aufgeführt):

1. Akzeptieren Sie die individuelle Bestellung auf Etsy
2. Erstellen Sie in Odoo manuell einen Verkaufsauftrag für ein „kundenspezifisches Produkt“ mit vereinbartem Preis
3. Link zur Etsy-Konversation in den Bestellnotizen
4. Markieren Sie den Artikel in Etsy manuell oder über das benutzerdefinierte Bestelltool des Connectors als versendet

---

Inventarsynchronisierung

Für physische Produkte:

Die Inventarsynchronisierung wird standardmäßig alle 5 Minuten ausgeführt. Wenn sich der Odoo-Bestand ändert:

1. Verfügbare Menge neu berechnet (vorrätig minus reserviert)
2. Menge, die über die Listing Inventory API an Etsy übertragen wird
3. Wenn die Menge 0 erreicht: Angebot wird auf „Ausverkauft“ gesetzt (das Angebot bleibt aktiv)
4. Bei Wiederauffüllung: Das Angebot wird automatisch reaktiviert

Für auf Bestellung gefertigte Produkte:

MTO-Produkte erfassen den physischen Bestand nicht im herkömmlichen Sinne. Konfigurieren Sie die Etsy-Eintragsmenge als Indikator für die Produktionskapazität:

• Legen Sie eine feste „verfügbare Menge“ (z. B. 5) fest, die die aktuelle Bestellkapazität darstellt
• Nehmen Sie manuelle Anpassungen vor, wenn sich Ihre Produktionswarteschlange füllt

Für digitale Downloads:

Digitale Produkte haben einen unbegrenzten Bestand. Der Connector setzt die Etsy-Menge auf 999 und synchronisiert niemals Bestandsänderungen. Die Lieferung digitaler Dateien erfolgt über Etsys natives digitales Downloadsystem – der Connector hat keinen Einfluss auf die Dateilieferung.

---

Finanzielle Versöhnung

Die Zahlungsabwicklung und Gebührenstruktur von Etsy erfordert eine sorgfältige Buchhaltungseinrichtung.

Etsy Payments-Gebührenstruktur (als Referenz):

• Listungsgebühr: 0,20 $ pro Listing (wird bei Listung und alle 4 Monate bei automatischer Verlängerung erhoben)
• Transaktionsgebühr: 6,5 % des Artikelpreises + Versand
• Zahlungsabwicklungsgebühr: 3 % + 0,25 $ pro Transaktion (US)
• Gebühr für Offsite-Anzeigen: 12–15 %, wenn Etsy Ihren Artikel bewirbt (sofern registriert)

Einrichten der Gebührenabstimmung in Odoo:

1. Erstellen Sie ein spezielles Etsy Payments-Journal (Typ Bank)
2. Konten erstellen:

• Etsy Listing Fees (Kosten)
• Etsy Transaction Fees (Kosten)
• Etsy Payment Processing Fees (Kosten)
• Etsy Payments Receivable (Umlaufvermögen)

3. Etsy-Zahlungsabrechnungen importieren:

• Navigieren Sie zu Etsy → Zahlungen → Monatsabrechnung → CSV herunterladen
• Import in das Abgleichstool des Connectors
• Der Connector erstellt Journaleinträge für jeden Transaktionstyp

Abstimmungsprozess zum Monatsende:

1. Laden Sie die monatliche Zahlungs-CSV-Datei von Etsy herunter
2. Import über Connector: Etsy → Versöhnung → Import Statement
3. Überprüfen Sie die automatisch abgeglichenen Einträge
4. Gleichen Sie alle nicht erkannten Transaktionen manuell ab
5. Bestätigen Sie die Abstimmung → in Odoo gebuchte Journaleinträge
6. Gleichen Sie das Etsy Payments-Bankkonto mit dem Odoo-Guthaben ab

---

Etsy SEO und Performance-Tracking

Synchronisierung der Auflistungsleistung:

Der Connector importiert Etsy-Shop-Statistiken in Odoo:

• Aufrufe pro Eintrag und Tag
• Favoriten zählen
• Conversion-Rate (Ansichten zu Verkäufen)
• Einnahmen nach Auflistung

Diese Daten werden im Etsy-Analyse-Dashboard in Odoo angezeigt, sodass Sie Top-Performer und leistungsschwache Einträge identifizieren können, ohne zur Etsy-Statistikoberfläche wechseln zu müssen.

Tag- und Keyword-Tracking:

Verfolgen Sie, welche Suchbegriffe den Etsy-Traffic steigern, indem Sie Statistiken aus Etsys Shop Stats API abrufen. Verwenden Sie diese Daten, um:

• Identifizieren Sie Tags mit hoher Conversion-Rate, die Sie ähnlichen Einträgen hinzufügen können
• Finden Sie Einträge mit vielen Aufrufen, aber geringer Conversion (Preis- oder Fotoprobleme)
• Erkennen Sie saisonale Trends in Ihrer Produktkategorie

---

Häufig gestellte Fragen

Kann der Connector zusätzlich zum Etsy-Marktplatz auch Etsys Pattern (benutzerdefinierte Website) verarbeiten?

Nein. Der Connector lässt sich speziell in den Etsy-Marktplatz integrieren. Etsy Pattern (ihr gehosteter Website-Builder) nutzt denselben Bestand, verwendet jedoch eine separate Checkout- und Zahlungsabwicklung. Musterbestellungen müssten separat verwaltet werden. Für eine Website-Integration mit vollem Funktionsumfang wird das Website-Modul von Odoo oder eine Shopify-Integration empfohlen.

Wie verwaltet der Connector Etsys Reserve für Transaktionen (Etsy-Zahlungssperren)?

Etsy bildet manchmal eine Rückstellung für die Zahlungen neuer Verkäufer für das Risikomanagement. Der Connector verfolgt den Zahlungsstatus jeder Bestellung. Reservierte Beträge werden im Etsy Payments-Kontostand angezeigt, können jedoch nicht abgehoben werden. Der Connector markiert diese Rechnungen als „zur Zahlung ausstehend“, bis die Rücklage freigegeben wird, und aktualisiert sie dann auf „bezahlt“, wenn die Mittel an Ihre Bank freigegeben werden.

Kann ich mehrere Etsy-Shops (z. B. einen für Schmuck, einen für Wohndekoration) von einer Odoo-Instanz aus verwalten?

Ja. Erstellen Sie separate Etsy-Shop-Konfigurationen mit unabhängigen OAuth-Anmeldeinformationen für jeden Shop. Jeder Shop verfügt über eigene Einstellungen für den Bestellimport, die Bestandszuordnung und den Zahlungsabgleich. Produkte können in mehreren Shops mit shopspezifischen Preisüberschreibungen gelistet werden.

Unterstützt der Connector die Großhandels-/B2B-Funktionalität von Etsy?

Etsy verfügt über kein natives Großhandels-/B2B-Programm. Wenn Sie Etsy für Großhandelsanfragen nutzen, die eigentliche Transaktion aber offline abwickeln, wird sie vom Connector genauso behandelt wie jede benutzerdefinierte Bestellung – Sie würden den Odoo-Verkaufsauftrag manuell mit vereinbarten Preisen erstellen und über Ihren Standardprozess abwickeln.

Wie geht der Connector mit internationalen Etsy-Verkäufen und den Mehrwertsteuer-/GST-Anforderungen um?

Etsy erhebt und führt die Mehrwertsteuer/GST im Namen von Verkäufern für Käufer in der EU, im Vereinigten Königreich, in Australien und anderen Gerichtsbarkeiten ab, in denen Etsy als Marktplatzvermittler fungiert. Der Connector importiert diese Bestellungen mit einer Steuer von 0 $ (da Etsy diese erhoben hat). Für Märkte, in denen Sie für die Steuererhebung verantwortlich sind, konfigurieren Sie in Odoo entsprechende Steuerpositionen basierend auf dem Land des Käufers.

---

Nächste Schritte

Der ECOSIRE Etsy Connector verwandelt Etsy von einem eigenständigen Marktplatz in einen vollständig integrierten Vertriebskanal innerhalb von Odoo 19 Enterprise. Für handgefertigte Unternehmen, die über das einfache Shop-Management hinausgehen, liefert diese Integration das operative Rückgrat für nachhaltiges Wachstum.

Holen Sie sich den ECOSIRE Etsy Connector für Odoo 19 →

Der Connector umfasst eine Einrichtungsdokumentation, Importtools für historische Bestelldaten und Implementierungsunterstützung, um Ihren Etsy-Shop schnell und korrekt in Odoo zu integrieren.