Odoo eBay Connector: Listing, Bestellungen und Inventarsynchronisierung

eBay bleibt mit 132 Millionen aktiven Käufern weltweit einer der größten Marktplätze der Welt. Für Verkäufer, die sowohl eBay als auch Odoo 19 Enterprise nutzen, ist die Verwaltung zweier separater Systeme für Bestellungen, Lagerbestand und Kundendaten ineffizient und fehleranfällig. Der ECOSIRE Odoo eBay Connector synchronisiert Ihren eBay-Shop mit Odoo und automatisiert den gesamten Verkaufsworkflow von der Angebotserstellung über die Auftragsabwicklung bis hin zur Buchhaltung nach dem Verkauf.

Dieser Leitfaden behandelt alles von der Einrichtung der eBay-API-Anmeldeinformationen über die Angebotsverwaltung, Auftragsautomatisierung, Bestandssynchronisierung, Retourenabwicklung bis hin zur Überwachung der Verkäuferleistung.

Wichtige Erkenntnisse

• Connector verwendet eBay REST APIs und OAuth 2.0 zur Authentifizierung
• Unterstützt eBay Motors, eBay Business & Industrial und Verbraucherkategorien
• Sowohl Festpreis- als auch Auktionseinträge werden unterstützt (Auftragsimport nur für Auktionen)
• Die Inventarsynchronisierung aktualisiert die eBay-Mengen innerhalb von 10 Minuten nach Odoo-Bestandsänderungen
• Die Out-of-Stock-Einstellung (OOS) von eBay wird automatisch verwaltet, wenn die Menge 0 erreicht
• Der Bestellimport umfasst Käuferdetails, Versandanforderungen und eBay-Kaufbeträge
• Fälle von Rücksendungen und eBay-Geld-zurück-Garantie werden mit dem RMA-Workflow von Odoo synchronisiert
• Multi-Store-Unterstützung: Verwalten Sie mehrere eBay-Verkäuferkonten über eine Odoo-Instanz

---

Einrichtung und Autorisierung der eBay-API

Der Connector nutzt die REST-API-Suite von eBay und ersetzt für die meisten Vorgänge die ältere Trading-API.

Schritt 1: Erstellen Sie ein eBay-Entwicklerkonto

1. Registrieren Sie sich unter developer.ebay.com
2. Erstellen Sie unter „Mein Konto“ → „Anwendungsschlüsselsätze“ eine neue Anwendung
3. Notieren Sie Ihre App-ID (Client-ID), Entwickler-ID und Zertifikat-ID (Client-Geheimnis)
4. Generieren Sie einen RuName (eBay-Redirect-URL-Name) für den OAuth-Flow

Schritt 2: OAuth-Bereiche konfigurieren

Ihre Anwendung benötigt die folgenden OAuth-Bereiche:

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

Schritt 3: Benutzertoken generieren

Für Verkäufervorgänge sind OAuth 2.0-Benutzertokens (keine Anwendungstokens) erforderlich:

1. Klicken Sie in der Connector-Konfiguration auf Mit eBay autorisieren
2. Schließen Sie den eBay OAuth-Zustimmungsprozess ab
3. Der Connector speichert das Zugriffstoken und das Aktualisierungstoken automatisch
4. Token verfallen nach 18 Monaten; Der Connector wird mithilfe des Aktualisierungstokens automatisch aktualisiert

Sandbox vs. Produktion

Testen Sie immer zuerst mit der Sandbox-Umgebung von eBay:

• Sandbox-API: api.sandbox.ebay.com – Sandbox-Anmeldeinformationen unterscheiden sich von Produktionsanmeldeinformationen
• Erstellen Sie Sandbox-Verkäufer- und Käuferkonten unter developer.ebay.com/sandbox

---

Connector-Installation und -Konfiguration

Vom ECOSIRE-Marktplatz installieren:

1. Kaufen Sie das eBay Connector-Modul bei ECOSIRE Products
2. Installieren Sie über „Apps“ → „Apps-Liste aktualisieren“ → „eBay Connector“ suchen → „Installieren“.
3. Navigieren Sie zu Inventar → Konfiguration → eBay-Shops oder Verkäufe → eBay

Store-Konfiguration:

Versandrichtlinien:

Konfigurieren Sie vor dem Einstellen die eBay-Versandrichtlinien im Seller Hub:

• Versandrichtlinien: Spediteure, voraussichtliche Lieferzeit, Bearbeitungszeit
• Rückgaberecht: 30-tägige Rückgabe, Wiedereinlagerungsgebühr
• Zahlungsrichtlinie: Von eBay verwaltete Zahlungen sind seit 2021 erforderlich

Der Connector referenziert diese anhand der Richtlinien-ID. Verknüpfen Sie sie in den Shop-Einstellungen.

---

Eintragsverwaltung

Der Connector unterstützt das Erstellen und Verwalten von Festpreisangeboten direkt aus Odoo-Produktdatensätzen.

Einen Eintrag aus einem Odoo-Produkt erstellen:

1. Öffnen Sie das Produktformular → Registerkarte eBay
2. Klicken Sie auf Auf eBay einstellen
3. Listenfelder konfigurieren:

• Titel: bis zu 80 Zeichen, automatisch aus dem Produktnamen ausgefüllt
• Kategorie: eBay-Kategorie auswählen (Suche nach Stichwort oder ID)
• Zustand: Neu, gebraucht, für Teile/nicht funktionsfähig usw.
• Preis: Verwendet die Produktpreisliste oder den Überschreibungspreis
• Menge: verfügbarer Lagerbestand oder kundenspezifische Menge
• Dauer: GTC (Good 'Til Cancelled) empfohlen für Festpreis
• Artikelspezifikationen: Von eBay erforderliche Attribute für die Kategorie

4. Klicken Sie auf Bei eBay veröffentlichen

Eintragsvorlagen:

Erstellen Sie für Verkäufer mit vielen Produkten in derselben Kategorie Angebotsvorlagen:

• Navigieren Sie zu eBay → Vorlagen → Vorlage erstellen
• Konfigurieren Sie gemeinsame Felder: Kategorie, Versand, Rückgabebedingungen, Artikeldetails
• Wenden Sie Vorlagen gleichzeitig auf mehrere Produkte an

Sammelauflistung:

Für Kataloge mit mehr als 100 Produkten:

1. Exportieren Sie die Produktliste mit den erforderlichen eBay-Feldern in eine CSV-Datei
2. Verwenden Sie den Massenimport in eBay → Masseneintrag → CSV hochladen
3. Überprüfen und veröffentlichen Sie sie im Stapel

Auflistungssynchronisierung:

In der Odoo-Synchronisierung mit eBay vorgenommene Änderungen:

• Preisänderungen → eBay-Preis wird innerhalb von 15 Minuten aktualisiert
• Änderungen an der Produktbeschreibung → eBay-Eintrag wird bei der nächsten Synchronisierung aktualisiert
• Bildänderungen → eBay-Bilder aktualisiert (für einige Änderungen ist eine erneute Auflistung erforderlich)

Artikeldetails der eBay-Kategorie:

eBay benötigt kategoriespezifische Attribute (z. B. Marke, Größe, Farbe für Kleidung). Der Connector ordnet Odoo-Produktattribute den eBay-Artikeldetails zu:

---

Auftragssynchronisierung

Bestellimportvorgang:

Bestellungen fließen automatisch von eBay zu Odoo:

1. Der Käufer gibt eine Bestellung bei eBay auf und schließt die Kaufabwicklung ab
2. eBay erstellt eine Bestellung mit dem Status „Warten auf Versand“.
3. Connector fragt alle 15 Minuten die eBay Orders API ab (konfigurierbar)
4. Odoo erstellt einen Sale.Order mit Käuferdaten von eBay
5. Der Lieferauftrag wird automatisch erstellt
6. Das Lager führt die Bestellung aus und validiert die Lieferung
7. Connector sendet die Sendungsverfolgungsnummer an eBay zurück
8. eBay markiert die Bestellung als „Versendet“

Auftragsdatenzuordnung:

Senden von Tracking-Informationen:

Wenn Sie eine Lieferung in Odoo validieren und eine Sendungsverfolgungsnummer eingeben:

1. Der Connector erkennt die Sendungsverfolgungsnummer auf der Lagerkommissionierung
2. Es ruft die Order Fulfillment API von eBay auf, um die Nachverfolgung hinzuzufügen
3. Der Käufer erhält eine eBay-Benachrichtigung mit Tracking-Details
4. eBay aktualisiert den Bestellstatus auf „Versendet“

Unterstützte Spediteure für automatische Tracking-Updates: USPS, UPS, FedEx, DHL, Royal Mail, Deutsche Post und mehr als 100 andere über die Carrier-Code-Liste von eBay.

---

Inventarsynchronisierung

Eine genaue Bestandsaufnahme verhindert, dass eBay-„Defekt“-Metriken zu Fehlbeständen führen.

Inventarsynchronisierungsmechanismus:

Der Connector verwendet die Inventar-API von eBay mit der folgenden Logik:

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

Bei der Inventarsynchronisierung:

• Nach jedem bestätigten Lieferauftrag (sofort)
• Nach jedem validierten Empfang (sofort)
• Geplante vollständige Synchronisierung alle 30 Minuten
• Manuelle Synchronisierung jederzeit verfügbar

Umgang mit nicht vorrätigen Lagerbeständen:

Konfigurieren Sie, was passiert, wenn die Menge 0 erreicht:

• Option A: OOS-Modus (Odoo-Empfehlung): Halten Sie das Angebot mit der Menge 0 aktiv, indem Sie die eBay-Option „Nicht vorrätig“ verwenden – das Angebot behält seinen Verlauf und seine Bewertungen bei
• Option B: Angebot beenden: Angebot aus eBay entfernen, wenn der Lagerbestand 0 erreicht, und erneut einstellen, wenn der Lagerbestand wieder aufgefüllt ist
• Option C: Minimum festlegen: Legen Sie eine Mindestmenge fest (z. B. 1) und gehen Sie in Odoo nur dann auf 0, wenn das OOS-Minimum ausgelöst wird

Das Beenden und erneute Einstellen beeinträchtigt häufig die Platzierung in der eBay-Suche. Der OOS-Modus wird empfohlen.

Inventar an mehreren Standorten:

Bei Versand aus mehreren Lagern:

• Legen Sie in den Shop-Einstellungen ein primäres Lager für eBay fest
• Oder den Bestand über mehrere Lager hinweg zusammenfassen
• Konfigurieren Sie pro Produkt, wenn einige SKUs von bestimmten Standorten aus versendet werden

---

Rückgabe- und Rückerstattungsabwicklung

Die Geld-zurück-Garantie von eBay bedeutet, dass Verkäufer Rückgaben akzeptieren müssen. Der Connector übernimmt den Retouren-Workflow in Odoo.

Workflow für die Rückgabesynchronisierung:

1. Der Käufer eröffnet eine Rückgabeanfrage bei eBay
2. Connector importiert den Retourenfall als RMA (Return Merchandise Authorization) in Odoo
3. Das Betriebsteam überprüft den Rückgabegrund in Odoo
4. Bei Annahme: Erstellen Sie ein Rücksendeetikett (bei Bereitstellung vorfrankierter Etiketten).
5. Der Käufer sendet den Artikel zurück
6. Rücksendungen in Odoo empfangen → Quittung validieren
7. Rückerstattung bearbeiten: Gutschrift in Odoo erstellen → Connector löst eBay-Rückerstattung aus

Verfolgte Rücksendefallstatus:

---

Überwachung der eBay-Verkäuferleistung

eBay bewertet Verkäufer anhand von Kennzahlen, die sich direkt auf die Sichtbarkeit der Angebote auswirken. Überwachen Sie sie in Odoo:

Wichtige Kennzahlen für eBay-Verkäufer:

Leistungs-Dashboard in Odoo:

Navigieren Sie zu eBay → Leistung, um Folgendes anzuzeigen:

• Bestellungen nach Status in den letzten 30 Tagen
• Verspätete Lieferungen (Bestellungen werden nach der Bearbeitungszeit versandt)
• Rücklaufquote nach Kategorie
• Mängelübersicht mit Bestell-IDs
• Voraussichtliche Verkäuferebene für die nächste Bewertung

---

Preise und Sonderangebote

Automatisierte Preisregeln:

Konfigurieren Sie dynamische eBay-Preise basierend auf Odoo-Kostendaten:

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

Beispiel: Wenn die Kosten 10 $ betragen, beträgt die Zielmarge 40 % und die eBay-Gebühren betragen normalerweise 12,5 %:

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

Markdown-Aktionen:

Der Connector unterstützt die Integration des eBay Promotions Manager:

• Verkäufe in Odoo erstellen → Connector erstellt entsprechende eBay-Aktionen
• Flash-Sales, Bestellrabatte und Versandaktionen
• Geplante Werbeaktionen: Start- und Enddatum in Odoo konfiguriert

---

Häufig gestellte Fragen

Unterstützt der Connector eBay-Auktionsangebote?

Der Connector importiert Bestellungen aus Auktionsangeboten genau wie Festpreisangebote. Das Erstellen und Verwalten von Auktionsangeboten (Festlegen von Startpreis, Mindestpreis und Dauer) über den Connector ist jedoch begrenzt – Auktionen werden am besten direkt im eBay Seller Hub verwaltet. Die primäre Angebotsverwaltungsfunktion des Connectors betrifft Festpreis-/AGB-Angebote.

Wie verarbeitet der Connector eBay Managed Payments (die Zahlungsabwicklung von eBay)?

Seit 2021 wickelt eBay alle Zahlungen über von eBay verwaltete Zahlungen ab. Der Connector importiert Bestellsummen einschließlich des eBay-Bezahlpreises (Artikelpreis + Versand). eBay überweist den Nettoerlös (nach Abzug der Gebühren) auf Ihr Bankkonto. Der Connector unterstützt den Import von eBay-Auszahlungsberichten zum Abgleich und erstellt automatisch Journaleinträge, die die von den Auszahlungen abgezogenen eBay-Gebühren berücksichtigen.

Kann ich Produkte von Odoo mit mehreren eBay-Shops (verschiedenen Verkäuferkonten) synchronisieren?

Ja. Erstellen Sie mehrere eBay-Shop-Konfigurationen mit jeweils eigenen OAuth-Anmeldeinformationen. Produkte können mit geschäftsspezifischen Preisüberschreibungen gleichzeitig in mehreren Geschäften gelistet werden. Der Lagerbestand wird global in Odoo verfolgt und den Einträgen jedes Stores basierend auf konfigurierten Regeln zugewiesen.

Was passiert mit meinem eBay-Eintragsverlauf (Bewertungen, Anzahl der Verkäufe), wenn ich einen Eintrag aktualisiere?

Durch Standardaktualisierungen von Angeboten (Preis, Menge, Beschreibung, Bilder) bleiben der Angebotsverlauf und die Anzahl der Verkäufe erhalten. Aktionen, die den Verlauf zurücksetzen: Beenden und erneutes Einstellen, Ändern der eBay-Kategorie für einige Kategorien. Der Connector nutzt den Endpunkt „Angebot aktualisieren“ der eBay-Inventar-API für routinemäßige Änderungen, wodurch der Verlauf erhalten bleibt.

Wie geht der Connector mit internationalen eBay-Verkaufs- und Zollanforderungen um?

Bei grenzüberschreitenden Verkäufen über eBay International Shipping oder GSP (Global Shipping Program) markiert der Connector den Verkaufsauftrag mit dem Land des Käufers. Für internationale Verkäufe konfigurieren Sie in Odoo die entsprechenden Steuerpositionen und Steuerbehandlungen. GSP-Bestellungen werden an das inländische Versandzentrum von eBay versendet. Die Zolldokumentation wird vom GSP-Programm von eBay abgewickelt, nicht von Ihrem Betrieb.

---

Nächste Schritte

Durch die Verwaltung von eBay-Vorgängen über Odoo entfällt die manuelle Dateneingabe, verhindert Bestandsfehler und bietet Ihnen eine zentrale Informationsquelle für alle Vertriebskanäle. Der ECOSIRE eBay Connector wurde für Odoo 19 Enterprise entwickelt und bietet volle Unterstützung für die neuesten REST-APIs von eBay.

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

Jeder Kauf umfasst die Modullizenz, die Einrichtungsdokumentation und den Zugang zu unserem Implementierungs-Support-Team, damit Ihre eBay-Odoo-Synchronisierung vom ersten Tag an reibungslos funktioniert.