Zum Inhalt springen
SDXS

Etsy für Odoo

Marktplatz-Connector · Odoo 19 lieferbar, Odoo 20 auf Anfrage · Community und Enterprise

Etsy-Shop in Odoo: Bestellungen, Bestand, Preise und Listings als Entwurf oder aktiv.

Kern ist PflichtOhne den Sales Channel Connector – Kern läuft Etsy Connector nicht. Der Kern ist die Grundlage für jedes Kanal-Modul und kostet einmal je Odoo-Instanz; weitere Module brauchen ihn dann nicht noch einmal.

Schnittstelle
Etsy Open API v3
Takt
Alle 15 Minuten, einstellbar von jeder Minute …
Odoo
19, Community und Enterprise
Lizenz
Kauf einmalig, OPL-1

Was das Modul macht

  • Bestellungen automatisch als Odoo-Verkaufsauftrag
  • Bestand senden
  • Preise senden
  • Tracking melden
  • Marktplatz-Bestand lesen
  • Erstattungsstatus von Belegen wird erkannt

Aus dem Marktplatz-Kern, immer dabei

Das bringt der Sales Channel Connector – Kern mit. Sie kaufen ihn einmal, jedes Modul nutzt ihn.

  • Eine Eingangsliste für alle Kanäle, jede Bestellung wird automatisch ein Odoo-Verkaufsauftrag
  • Produkt-Zuordnung mit Vorschlägen über EAN und SKU, Platzhalter statt Blockade
  • Steuern aus Ihren Odoo-Regeln, Ausgleich auf den tatsächlich gezahlten Betrag
  • Rechnung je Kanal: aus, Entwurf, gebucht oder gebucht und bezahlt, mit Doppelsende-Schutz
  • Bestand nach jeder Änderung an alle Kanäle, mit Puffer je Kanal und Niedrigbestand-Alarm
  • Storno- und Retourenablauf nach Ihren Regeln, Sync-Protokoll mit Fehlerdetails, Wiederholung mit steigendem Abstand
  • Dashboard je Kanal: Umsatz heute und im Monat, offene Aufträge, versendet, Fehler
  • Zugangsdaten verschlüsselt, Rollen Benutzer und Manager, Multi-Company
  • Jeder Sendeschalter ist ab Werk aus

So arbeitet das Modul im Einzelnen

Geprüft am Modul selbst, Stand Oktober 2026. Was hier nicht steht, kann das Modul nicht.

  1. Nur bezahlte Receipts der letzten 3 Tage; der Auftrag entsteht bei „paid“.
  2. Statusabgleich ohne Bezahlfilter, damit Stornos und Erstattungen sichtbar werden.
  3. Bestand und Preis über das Listing-Inventar, Varianten über die SKU; bestehende Bindungen bleiben erhalten.
  4. Sendungsnummer am Receipt mit Zusteller-Kennung (dhl, dpd, ups, fedex, gls, hermes, deutsche-post, royal-mail, usps, sonst „other“).
  5. Der Marktplatzbestand lässt sich zurücklesen.

So läuft eine Etsy-Bestellung durch Odoo

Jeder Schritt als Beleg, mit erfundenen Beispielwerten. So sieht der Weg aus, den jede Bestellung nimmt.

  1. 01BestellungEtsy · 09:41
    Bestellnummer…-4471
    2 × Artikel89,80 €
    Statusbezahlt

    Der Käufer bestellt und bezahlt auf Etsy. Sie tun nichts.

  2. 02AbrufOdoo · bis 09:56
    KanalEtsy
    Produkteüber EAN zugeordnet
    Kundeangelegt oder erkannt

    Das Modul holt neue Bestellungen im eingestellten Takt, ab Werk alle 15 Minuten. Doppelte Abrufe erzeugen keine doppelten Aufträge.

  3. 03VerkaufsauftragOdoo · 09:56
    AuftragS00412
    Steuernaus Ihren Regeln
    Rechnungje Einstellung

    Der Auftrag entsteht mit Kunde, Positionen, Steuern und Versandkosten, auf den Cent wie vom Käufer bezahlt. Die Lieferung ist angelegt.

  4. 04VersandLager · 11:05
    LieferungWH/OUT/00412
    Etikettaus der Versand-Suite
    SendungsnummerJJD 0000 1…

    Sie packen und versenden wie immer. Das Etikett kommt aus Odoo, wenn Sie die Versand-Suite nutzen.

  5. 05RückmeldungEtsy · 11:06
    Sendungsnummergemeldet
    Rechnungin Odoo
    Bestandaktualisiert

    Was Sie eingeschaltet haben, geht automatisch zurück an Etsy. Der Käufer sieht die Sendungsnummer.

So sieht es aus

Drei Bildschirme, die Sie nach der Einrichtung täglich sehen: die Liste, die Einstellungen und das Protokoll. Schematisch gezeichnet, damit Sie wissen, was Sie bekommen.

Marktplatz › Eingangheute 14 · offen 2
KanalBestellungKäuferBetragAuftragStatusEtsy DE…-4471M. Huber89,80 €S00412neuEtsy DE…-4470S. Keller249,00 €S00411gepacktEtsy AT…-4468J. Novak34,50 €S00409versendetEtsy DE…-4466L. Brandt118,20 €S00407Produkt zuordnenEtsy DE…-4465A. Mayer61,90 €S00406versendet
Schematische Darstellung mit Beispieldaten, keine Abbildung der Odoo-Oberfläche.
Kanal › Etsy DE › Einstellungen
Auftrag entsteht ab Statusbezahlt
Rechnunggebucht
LagerWH/Stock
Bestandspuffer2 Stück
Abrufalle 15 Min
Bestand sendennach jeder Änderung, mit Puffer
Preise sendenab Werk aus, Sie schalten ein
Sendungsnummern meldenbei jeder Lieferung
Rechnung hochladenbietet dieser Kanal nicht
Beispiel nach der Einrichtung. Ab Werk ist jeder Sendeschalter aus, Sie schalten ein, was laufen soll.
Kanal › Etsy DE › Protokoll
  • 09:41:02Abruf Etsy: 3 neue Bestellungen, 0 Änderungen
  • 09:41:03…-4471 → Verkaufsauftrag S00412, Kunde erkannt, 2 Positionen über EAN
  • 09:41:03…-4466 → wartet: Produkt 4006381… nicht zugeordnet, Vorschlag über EAN liegt vor
  • 09:42:10Bestand an Etsy: 12 Artikel aktualisiert (Puffer 2)
  • 11:06:31Sendungsnummer JJD 0000 1… an Etsy gemeldet, Bestellung …-4471
Jeder Schritt mit Zeit, Ergebnis und Fehlergrund. Nichts passiert still.

Was passiert, wenn …

Die Fälle, die im Alltag vorkommen, und was das Modul dann tut. Geprüft am Code, nicht am Prospekt.

Der Käufer storniert auf dem Marktplatz.
„canceled“ stoppt den Auftrag in Odoo. Lieferung und Entwurfsrechnung werden abgebrochen, reservierter Bestand ist wieder frei, eine Gutschrift entsteht nach Ihrer Regel. Eine Notiz am Beleg sagt, warum.
Eine Retoure kommt.
„partially refunded“ und „fully refunded“ lösen Rücklieferung und Gutschrift nach Ihrer Regel aus; Etsy hat keine Retouren-Schnittstelle.
Sie müssen erstatten.
Etsy erlaubt keine Erstattung über die Schnittstelle. Sie erstatten im Etsy-Shop-Manager, das Modul erkennt sie und spiegelt sie als Gutschrift.
Der Marktplatz ist gerade nicht erreichbar.
Wiederholung bei Überlastung und Serverfehlern; der Statusabgleich bricht den Import nie ab.
Eine Bestellung kommt doppelt an.
Jede Marktplatz-Bestellnummer wird je Kanal nur einmal zum Auftrag. Ein zweiter Abruf erkennt sie und legt nichts Neues an.
Ein Produkt ist in Odoo nicht zugeordnet.
Zuordnung über Listing-ID, dann SKU. Sonst landet die Position auf dem Platzhalterprodukt des Kanals, mit Vorschlag.
Der Bestand geht auf null.
Der neue Bestand geht beim nächsten Lauf an Etsy, abzüglich des Puffers, den Sie je Kanal setzen. 0 wird gesetzt, nie negativ. Der Niedrigbestand-Alarm meldet sich vorher.

Zugang und Voraussetzungen

Was Sie brauchen, bevor es losgeht, und was ausdrücklich nicht.

Schnittstelle
Etsy Open API v3: Shop-Receipts, Listing-Inventar, Tracking je Receipt, Shop-Listings; OAuth2 mit Keystring und Refresh Token, der Zugriffstoken erneuert sich automatisch
Konto beim Anbieter
Etsy-Shop und eine App im Etsy-Entwicklerportal (Keystring); einmalige OAuth-Autorisierung mit den Scopes transactions_r/w und listings_r/w. Für den Dauerbetrieb gegebenenfalls „commercial access“ beantragen.
Was eingetragen wird
API-Key (Keystring), numerische Shop-ID und Refresh Token
In Odoo
Verkauf, Lager, Rechnungen (Standard-Apps von Odoo)
Takt
Alle 15 Minuten, einstellbar von jeder Minute bis täglich; neue Bestellungen rückblickend 3 Tage, Statusabgleich 14 Tage
Sofortmeldung
Keine Sofortmeldung vom Anbieter, Bestellungen werden nach Zeitplan geholt. Nach außen: signierte Webhooks für Bestellung, Sendungsnummer und Rechnung, zum Beispiel für n8n.
Im Formular
  • API-Key, Shop-ID, Refresh Token
  • Sendungsnummer an Etsy senden
  • Retouren-Regeln: Erstattungen werden Gutschriften
Nicht nötig
  • Keine laufende Token-Pflege
  • Kein Odoo Enterprise

Gut zu wissen

Grenzen, die wir lieber vorher sagen.

  • Erstattung selbst erfolgt im Etsy-Konto
  • Kein Rechnungs-Upload
  • Keine Erstattung über die Schnittstelle
  • Käufer-E-Mail nur mit zusätzlicher Etsy-Freigabe
  • Keine öffentliche Sandbox; neue Keys starten mit persönlichem Zugang
  • Inventar-Schreiben ersetzt das Listing komplett

Passt dazu

Fragen dazu

Brauche ich Odoo Enterprise?

Nein. Alle Module laufen auf Odoo 19, Community und Enterprise; Odoo 20 folgt auf Anfrage. Einzige Ausnahme: Die Amazon-Enterprise-Brücke ergänzt Odoos eigenen Amazon-Connector und setzt deshalb Enterprise voraus. Für Amazon ohne Enterprise nutzen Sie das Modul Amazon SP-API.

Werden Bestellungen automatisch zu Verkaufsaufträgen?

Ja. Sie stellen je Kanal ein, ab welchem Marktplatz-Status ein Auftrag entsteht, zum Beispiel erst nach Zahlungseingang. Steuern und Steuerposition kommen aus Ihren Odoo-Steuerregeln; der Auftrag wird auf den tatsächlich gezahlten Bruttobetrag abgestimmt.

Wie funktioniert der Bestandsabgleich?

Bei jeder Bestandsänderung in Odoo wird der neue Wert sofort an den Kanal gesendet. Je Produkt und Kanal entscheiden Sie: Odoo-Bestand folgen oder fester Kanalbestand. Ein Sicherheitspuffer je Kanal verhindert Überverkauf. Sie können außerdem den Bestand vom Marktplatz lesen und mit Ihrem vergleichen.

Was passiert bei Stornos und Retouren?

Stornos vom Marktplatz kommen automatisch an und laufen über denselben Ablauf wie ein Storno in Odoo. Für Retouren legen Sie je Kanal Regeln fest: Rücklieferung als Entwurf oder validiert, Gutschrift ja oder nein, Frist. Bei Kaufland und OTTO entscheiden Sie Retouren direkt aus Odoo. Erstattungen aus Odoo heraus sind bei Kaufland, Shopify, WooCommerce, Medusa, Temu und Stripe möglich; Amazon erstattet dem Käufer selbst.

Was passiert, wenn der Marktplatz nicht erreichbar ist?

Nichts geht verloren. Fehlgeschlagene Übertragungen landen in einer Wiederhol-Warteschlange mit steigendem Abstand. Jeder Versuch steht im Sync-Protokoll mit der Antwort des Marktplatzes, und am Beleg erscheint eine Notiz.

Wie funktionieren Updates nach dem ersten Jahr?

Mit dem Update-Plan: 25 % des Kaufpreises im Jahr. Darin sind alle neuen Versionen des Moduls, Anpassungen, wenn ein Marktplatz seine Schnittstelle ändert, und Fehlerbehebungen. Ohne Update-Plan läuft das Modul weiter, bekommt aber keine neuen Versionen. Der Plan ist jährlich kündbar.

Etsy Connector: Passt das zu Ihrem Odoo?

Sagen Sie uns Ihre Odoo-Version und wie Sie heute arbeiten. Wir prüfen, ob das Modul passt, und schicken ein Angebot mit Installation, wenn Sie wollen.

Angebot anfragenPakete und Preise
FestpreisAntwort innerhalb von drei Werktagen · Festpreis statt Stundenabrechnung · Angebote für Unternehmer