Zum Hauptinhalt springen
Shopee Marketplace Connector

Shopee Marketplace Connector (APAC) in Odoo einrichten: Felder, Zuordnungen, erste Woche

Um den Shopee Marketplace Connector (APAC) einzurichten, legen Sie in Odoo ein Marketplace-Konto mit Unternehmen, Lagerhaus, Partner ID / App Key, Shop ID und dem Partner Key Ihrer Shopee-App an, wählen die Umgebung und legen fest, ab wann Aufträge zu Angeboten werden. Danach ordnen Sie Odoo-Kategorien und -Attribute denen von Shopee zu und prüfen in der ersten Woche Synchronisationsprotokolle, Konflikte und Warteschlange. Hier finden Sie die Schritte in der richtigen Reihenfolge und die Bedeutung jedes Felds.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 4. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Moduls, Version 20.0 · in den Quellen am Ende
Lesezeit
5 Min.

Was Sie vorbereiten sollten, bevor Sie Odoo öffnen

Das Marketplace-Konto des Moduls benötigt Angaben von Shopee und Angaben aus Ihrer eigenen Organisation. Es lohnt sich, sie vor dem Start zusammenzutragen:

  • Die partner_id Ihrer Shopee-App und deren Partner Key, zu finden unter Shopee Open Platform > App list.
  • Die shop_id des Shops, den Sie verbinden möchten.
  • Wenn Sie zuerst testen möchten: die Test-Partner-ID und den Testschlüssel Ihrer App sowie einen Shopee-Testshop.
  • Das Odoo-Unternehmen, dem das Konto gehören soll, und das Lagerhaus, aus dem Sie den Bestand synchronisieren.
  • Die E-Mail-Adressen, die Benachrichtigungen erhalten sollen.

Das Modul ist in Odoo Apps für 17, 18, 19 und 20 veröffentlicht und laut der Seite jeder Version in allen kostenlos (Einmalzahlung pro Version, zzgl. MwSt.). Sie finden es auf der Seite in Odoo Apps und auf der Modulseite.

Schritte zum Anlegen des Shopee-Kontos

Jeder Schritt entspricht einem Feld des Marketplace-Kontos. Die Namen stehen so da, wie sie im Modul erscheinen.

  1. Tragen Sie den Account Name ein, den Namen des Kontos.
  2. Wählen Sie die Company. Das Modul trennt die Konten nach Unternehmen: Jedes Unternehmen besitzt seine eigenen Marketplace-Konfigurationen.
  3. Geben Sie das Default Fulfillment Warehouse an. Das ist das Standard-Lagerhaus für die Bestandssynchronisation und lässt sich pro Produkt ändern.
  4. Wählen Sie die Shopee Environment. Mit Sandbox werden die Test-Partner-ID und der Testschlüssel Ihrer App sowie die Testshops von Shopee verwendet.
  5. Füllen Sie Partner ID / App Key mit der partner_id von Shopee und Shop ID mit der shop_id Ihres Shops.
  6. Fügen Sie in Partner Key den Partner Key Ihrer App ein. Laut Feldbeschreibung signiert er jeden Aufruf.
  7. Nutzen Sie den Link Connect Shopee shop. Das Modul speichert in Authorization State einen Zufallswert des zuletzt erzeugten Links und prüft ihn, wenn Shopee den Verkäufer zurückleitet. Das Konto hat außerdem die Felder OAuth Access Token, OAuth Refresh Token und Access Token Expires.
  8. Legen Sie Create Sales Orders From fest. Aufträge, die vor diesem Zeitpunkt bei Shopee eingegangen sind, werden zurückgehalten (Held Orders), statt zu Angeboten zu werden.
  9. Stellen Sie Sync Frequency (minutes) ein, das Abfrageintervall für Aufträge und Bestand, zwischen 5 und 60 Minuten.
  10. Setzen Sie einen Low Stock Threshold (units): Unterhalb dieses Werts löst das Modul eine Warnung wegen niedrigen Bestands aus. Wenn Sie zusätzlich Auto-Create PO on Low Stock aktivieren, erstellt es einen Entwurf einer Bestellung, sobald der Bestand unter den Schwellenwert fällt.
  11. Tragen Sie in Alert Email Recipients die durch Kommas getrennten Adressen ein, die Synchronisationswarnungen, die Zusammenfassung und Fehlermeldungen erhalten sollen.
  12. Wählen Sie die Strategie für Auto-Conflict Resolution bei erkannten Konflikten und den Conflict Detection Threshold (%), also die prozentuale Abweichung, ab der ein Konflikt erkannt wird.
  13. Wenn Sie alles geprüft haben, aktivieren Sie Enable Sync, womit alle Synchronisationen des Kontos ein- oder ausgeschaltet werden.

Das Feld API Key erscheint im Konto, laut seiner eigenen Beschreibung wird es von Shopee aber nicht verwendet.

Kategorien, Attribute und Produkte zuordnen

Das Konto hat drei Zuordnungen zwischen Odoo und Shopee: Category Mappings, Attribute Mappings und Product Mappings.

Kategorien

In Category Mappings ordnen Sie einer Odoo-Kategorie eine Shopee-Kategorie zu. Jede Zeile enthält Marketplace Account, Odoo Category, Marketplace Category ID (die category_id von Shopee) und Marketplace Category Name, einen lesbaren Namen, den das Modul für die Anzeige speichert. Die Spalte Created hält fest, wann die Zeile angelegt wurde.

Liste der Kategoriezuordnungen mit den Spalten Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name und Created
Die Liste der Kategoriezuordnungen, noch ohne Einträge, mit der Schaltfläche Neu und der Suchleiste.

Attribute

In Attribute Mappings ordnen Sie ein Odoo-Attribut (Odoo Attribute, zum Beispiel Farbe, Größe oder Marke) dem Attributschlüssel des Marketplace in Marketplace Attribute Key zu. Jede Zeile enthält außerdem ihr Marketplace Account und ihr Datum Created.

Produkte

In Product Mappings stehen die Verknüpfungen zwischen jedem Odoo-Produkt und seiner Produkt-ID im Marketplace. Die folgende Sequenz zeigt einen Beispieleintrag des Kontos Shopee SG mit dem Status Synced.

Liste der Produktzuordnungen mit einem Eintrag von Shopee SG im Status Synced, Liste der Marketplace-Konten und leere Liste der Attributzuordnungen
Rundgang durch die Beispiel-Produktzuordnung, die Kontenliste mit Testdaten und die Liste der Attributzuordnungen, noch ohne Einträge.

Wie diese Bausteine intern zusammenspielen, erklären wir in So funktioniert der Connector intern.

Was Sie in der ersten Woche prüfen sollten

Nach dem Aktivieren der Synchronisation lohnt sich anfangs ein täglicher Blick auf diese Bereiche des Kontos:

  • Sync Logs: das Audit-Protokoll der API-Interaktionen.
  • Sync Conflicts: erkannte Konflikte, die auf eine Lösung warten. Prüfen Sie offene Konflikte und passen Sie bei Bedarf die Strategie für Auto-Conflict Resolution oder den Conflict Detection Threshold (%) an.
  • Sync Queue: die interne Warteschlange asynchroner Synchronisationsaufgaben.
  • Zurückgehaltene Aufträge: Wenn Sie Aufträge in Held Orders sehen, prüfen Sie, ob das Datum in Create Sales Orders From das gewünschte ist.
  • Token: Prüfen Sie das Datum in Access Token Expires im Konto.
  • Niedriger Bestand: Wenn Sie Auto-Create PO on Low Stock aktiviert haben, suchen Sie die Bestellentwürfe und prüfen Sie, ob der Low Stock Threshold (units) für Ihre Produkte sinnvoll ist.
  • E-Mail: Stellen Sie sicher, dass die Adressen in Alert Email Recipients korrekt geschrieben und durch Kommas getrennt sind.

Das Modul bringt außerdem Übersichts- und Leistungsberichtslisten mit. Auf den Screenshots sind sie noch leer:

Übersichtsliste des Marketplace-Dashboards mit den Spalten Company, Total Reve…, Total Or…, Critical… und Major E…
Die Übersichtsliste des Dashboards, noch ohne Daten.
Liste der Leistungsberichte mit den Spalten Company, Marketplace, Product Category, Date From und Date To
Die Liste der Leistungsberichte, noch ohne Einträge.

Taucht in diesen Tagen eine Meldung auf, die Sie nicht verstehen, finden Sie die genauen Texte und ihre Lösung unter Fehlermeldungen des Connectors.

Wie FlexigoTech Sie unterstützt

Bei FlexigoTech implementieren wir Odoo 17, 18, 19 und 20 und entwickeln individuelle Connectoren und Integrationen. Wenn wir die Konfiguration Ihres Shopee-Kontos, Ihre Zuordnungen oder eine Integration prüfen sollen, die das Modul nicht abdeckt, schreiben Sie uns über die Modulseite.

Weiterlesen

Fehler im Shopee Marketplace Connector (APAC): wann welche Meldung erscheint und was zu tun istWas jede Fehlermeldung des Shopee Marketplace Connector (APAC) in Odoo bedeutet, wann sie erscheint und was zu tun ist, mit Beispielfall und Originaltexten.So funktioniert Leroy Merlin Connector in Odoo: Menüs, geplante Aktionen und RundgangWelche Menüs Leroy Merlin Connector in Odoo ergänzt, welche zehn geplanten Aktionen wie oft laufen und was über FlexigoTech Cloud geht.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen