Zum Hauptinhalt springen
Shopee Marketplace Connector

Fehler im Shopee Marketplace Connector (APAC): wann welche Meldung erscheint und was zu tun ist

Die Meldungen des Shopee Marketplace Connector (APAC) erscheinen in ganz bestimmten Momenten: beim Anlegen des Shopee-Kontos, beim Festlegen der Synchronisierungsfrequenz oder des Konfliktschwellenwerts, beim Zuordnen von Kategorien, Attributen und Produkten, beim Import eines Auftrags und beim Versuch, das Synchronisierungsprotokoll zu ändern. Jede Meldung sagt, welche Regel verletzt wurde, und manche sagen zusätzlich, was zu tun ist. Hier gehen Sie sie anhand eines erfundenen Falls und mit dem Originaltext jeder Meldung durch.

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.

Ein Fall von Anfang bis Ende: ein Shop verbindet Shopee

Beispiel Fiktiver Fall: Firma und Zahlen sind erfunden, um den Ablauf zu zeigen.

Papelería Arrecife ist ein erfundenes Unternehmen, das Büromaterial verkauft und bereits mit Odoo arbeitet. Der Verantwortliche installiert Shopee Marketplace Connector (APAC) und nimmt ihn an einem Nachmittag in Betrieb. Unterwegs stößt er auf fast alle Hinweise des Moduls. Wir sehen sie uns in der Reihenfolge an, in der sie auftauchen, mit ihrer Bedeutung und dem, was er tut, um weiterzukommen.

Erste Station: das Marketplace-Konto

Zuerst wird das Konto angelegt. Da das Team auch auf anderen Plattformen verkauft, versucht er, einen anderen Marketplace als Shopee zu wählen, und Odoo antwortet mit %s is not available: this connector only connects Shopee. Das Modul hat einen weiteren Hinweis mit derselben Aussage: Only Shopee accounts can be connected. Beide sagen dasselbe: Dieser Connector verbindet nur Shopee. Was er tut: Er lässt das Konto auf Shopee.

Danach legt er versehentlich ein zweites Konto mit derselben shop_id wie das erste im selben Unternehmen an. Beim Speichern erscheint Each marketplace account (shop_id) must be unique per company. Die Regel steht im Text selbst: Pro Unternehmen darf eine shop_id nur in einem Konto vorkommen. Was er tut: Er verwirft den Entwurf und arbeitet mit dem bereits vorhandenen Konto.

Im selben Konto trägt er als Synchronisierungsfrequenz einen Wert unter dem Minimum ein und erhält Sync frequency must be between 5 and 60 minutes. Er korrigiert ihn auf einen Wert in diesem Bereich, zwischen 5 und 60 Minuten. Beim Schwellenwert für die Konflikterkennung vertippt er sich, und es erscheint Conflict detection threshold must be between 0 and 100%. Er gibt einen Wert zwischen 0 und 100% ein und speichert.

Zweite Station: Kategorien, Attribute und Produkte

Mit dem fertigen Konto geht es an die Zuordnungen. Er beginnt mit den Kategorien: Er ordnet eine Odoo-Kategorie einer Shopee-Kategorie zu und versucht später, dieselbe Odoo-Kategorie im selben Konto einer anderen Shopee-Kategorie zuzuordnen. Es erscheint Each Odoo category maps to one marketplace category per account. Was er tut: Er bearbeitet die vorhandene Zuordnung, statt eine neue anzulegen.

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.

Bei den Attributen passiert dasselbe. Wiederholt er ein Odoo-Attribut für dasselbe Konto, lautet der Hinweis Each Odoo attribute maps to one marketplace attribute per account. Der Ausweg ist derselbe: ein Odoo-Attribut, ein Marketplace-Attribut pro Konto.

Liste der Attributzuordnungen mit Schaltfläche New, Suchleiste und den Spalten Marketplace Account, Odoo Attribute, Marketplace Attribute Key und Created
Die Liste der Attributzuordnungen, noch ohne Einträge.

Dann ordnet er Produkte zu. Versehentlich dupliziert er die Zuordnung einer Variante im selben Konto und erhält One mapping per product per account. Beim Korrigieren kopiert er die Shopee-Produkt-ID aus einer anderen Zeile, und es erscheint Marketplace product ID must be unique per account. Zwei verschiedene Regeln: Jedes Produkt hat pro Konto nur eine Zuordnung, und jede Produkt-ID des Marketplace darf pro Konto nur einmal vorkommen. Er prüft die Liste und lässt pro Produkt eine Zuordnung mit eigener ID stehen.

Liste der Produktzuordnungen mit einem Eintrag des Kontos Shopee SG, seiner Variante, einer Produkt-ID, der SKU und dem Status Synced, mit Schaltfläche Neu und Suchleiste
Eine Produktzuordnung im Status Synced, mit Demodaten.

Dritte Station: der Auftragsimport

Beim Import des ersten Auftrags erscheint No product of the order %s is mapped to the account %s: map them in Product Mappings and try again. Die Meldung zeigt den Weg bereits: Kein Produkt dieses Auftrags ist diesem Konto zugeordnet. Was er tut: Er öffnet Product Mappings, ordnet die Produkte dieses Auftrags zu und versucht es erneut.

Bei einem anderen Versuch erhält er %s did not return the order %s: %s. Der Text sagt, dass der Auftrag nicht zurückgegeben wurde, und hängt am Ende ein Detail an. Was er tut: Er liest dieses Detail vollständig, bevor er es erneut versucht, und hebt es für seinen Support auf.

Schließlich löscht eine Kollegin ein Testkonto, das noch einen ausstehenden Auftrag hatte. Beim Import erscheint The account of the order %s no longer exists: create its sales order by hand, or delete the hold so that the next import of the company makes it. Hier schlägt die Meldung zwei Auswege vor, und Papelería Arrecife wählt einen: den Verkaufsauftrag von Hand anlegen oder die Sperre (hold) löschen, damit der nächste Import des Unternehmens ihn anlegt.

Vierte Station: das Synchronisierungsprotokoll

Beim Durchsehen des Synchronisierungsprotokolls versucht der Verantwortliche, eine Zeile zu korrigieren, und erhält Sync logs are immutable after creation. You cannot edit them. Daraufhin versucht er, sie zu löschen, und der Hinweis lautet Sync logs cannot be deleted. They are part of the immutable audit trail. Das Modul erlaubt weder das Bearbeiten noch das Löschen dieser Einträge: Sie gehören zum Prüfpfad. Was er tut: Er lässt sie, wie sie sind, und korrigiert die Daten an ihrer Quelle.

Der Unternehmenshinweis, der an mehreren Stellen erscheint

Eine Meldung wiederholt das Modul bei mehreren Datensatztypen: The company of a %s is the one of its marketplace account. Sie besagt, dass das Unternehmen dieses Datensatzes das seines Marketplace-Kontos ist. Wenn sie erscheint, versuchen Sie nicht, dem Datensatz ein anderes Unternehmen als das seines Kontos zu geben: Prüfen Sie, zu welchem Unternehmen das Marketplace-Konto gehört, und arbeiten Sie von dort aus.

Rundgang durch die Liste der Produktzuordnungen, die Liste der Marketplace-Konten, erneut die Produktzuordnungen und die leere Liste der Attributzuordnungen
Ablauf mit Testdaten und Test-Tokens: fünf Demokonten in der Kontenliste und die Liste der Attributzuordnungen noch ohne Einträge.

Was man aus dem Fall lernt

Die Hinweise bei Papelería Arrecife lassen sich nach dem Moment ordnen, in dem sie erscheinen:

  • Konto: nur Shopee, eine shop_id pro Unternehmen, Frequenz zwischen 5 und 60 Minuten und Konfliktschwellenwert zwischen 0 und 100%.
  • Zuordnungen: eine Odoo-Kategorie und ein Odoo-Attribut pro Konto, eine Zuordnung pro Produkt und Konto und eine pro Konto eindeutige Produkt-ID des Marketplace.
  • Aufträge: ohne zugeordnete Produkte kein Import; existiert das Konto des Auftrags nicht mehr, nennt die Meldung selbst die beiden Auswege.
  • Protokoll: Synchronisierungsprotokolle lassen sich weder bearbeiten noch löschen.
  • Unternehmen: Das Unternehmen jedes Datensatzes ist das seines Marketplace-Kontos.

Welche Felder Sie ausfüllen sollten, bevor es zu diesen Hinweisen kommt, zeigt die Inbetriebnahme des Connectors, und was jeder Datensatz durchläuft, erklärt wie er intern funktioniert.

Wie FlexigoTech Ihnen hilft

Der Connector ist kostenlos (zzgl. MwSt.) in Odoo Apps für Odoo 17, 18, 19 und 20 gelistet; Sie finden ihn im Eintrag in Odoo Apps und auf seiner Seite auf flexigotech.com. Wenn Sie ihn lieber gemeinsam mit jemandem einrichten möchten: FlexigoTech implementiert Odoo 17, 18, 19 und 20 und entwickelt individuelle Connectoren und Integrationen, wenn Ihr Bedarf über den Funktionsumfang des Moduls hinausgeht.

Weiterlesen

Shopee Marketplace Connector (APAC) in Odoo einrichten: Felder, Zuordnungen, erste WocheAnleitung zur Einrichtung des Shopee Marketplace Connector (APAC) in Odoo: Kontofelder, Kategorie- und Attributzuordnungen und Prüfpunkte der ersten Woche.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