Zum Hauptinhalt springen
ChannelEngine

Die ChannelEngine API in Odoo: Tenant-URL, Schlüssel, Webhooks und Aufrufprotokoll

ChannelEngine für Odoo arbeitet mit der ChannelEngine Merchant API. Der Connector wurde gegen die veröffentlichte Spezifikation (v2.23.2) gebaut und protokolliert jeden Aufruf mit der Request-ID von ChannelEngine. Für die Verbindung brauchen Sie zwei Dinge. Das Erste ist Ihre eigene Tenant-URL, die mit https:// beginnen muss. Das Zweite ist der Merchant-API-Schlüssel, der in FlexigoTech Cloud gespeichert wird. Webhooks setzen voraus, dass Ihr Odoo aus dem Internet erreichbar ist.

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

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0
Lesezeit
4 Min.

Was die ChannelEngine Merchant API ist und was der Connector abdeckt

Der Connector bindet die ChannelEngine Merchant API für Marktplätze wie Amazon, bol.com, Zalando, Kaufland, Cdiscount, Conrad und eBay an. Er nutzt sie für Produkte, Preis und Bestand, Bestellungen mit Bestätigung und Statusaktualisierung, Sendungen, Stornierungen, Retouren, Webhooks und Benachrichtigungen.

Preis und freier Bestand gehen an ChannelEngine, wobei der freie Bestand um jede ausgehende Lieferung und jede wartende Bestellung bereinigt ist. Sie werden gebündelt gesendet und täglich abgeglichen. Bestellungen kommen in der Währung nach Odoo, in der sie bezahlt wurden. Sie werden nach Bestands- und Margenprüfung automatisch bestätigt oder zur Prüfung durch Sie zurückgehalten.

Alles läuft ohne Eingriff über Geplante Aktionen, die ab der Installation aktiv sind. Einige davon:

  • ChannelEngine: neue Bestellungen importieren, alle 15 Minuten.
  • ChannelEngine: Sendungen und Tracking-Aktualisierungen übertragen, alle 15 Minuten.
  • ChannelEngine: Bestellstatus aktualisieren und ChannelEngine: Retouren importieren, alle 2 Stunden.

Verbindung zur ChannelEngine API: Tenant-URL und Schlüssel

Das ChannelEngine-Konto in Odoo braucht zwei Dinge. Das Erste ist der API-Endpunkt: laut seinem Hilfetext Ihre eigene ChannelEngine-Tenant-URL. Im Code des Moduls stehen Adressen wie https://yourcompany.channelengine.net und https://yourcompany-dev.channelengine.net. Beginnt die URL nicht mit https://, bricht das Modul mit Der API-Endpunkt muss eine https://-URL sein. ab.

Das Zweite ist der Merchant-API-Schlüssel. Der Schlüssel und die Aufrufe an ChannelEngine laufen über FlexigoTech Cloud, und ein Administrator muss das akzeptieren, bevor der Schlüssel gespeichert wird. Hat das niemand akzeptiert, erscheint Bevor der Merchant-API-Schlüssel gespeichert wird, muss ein Administrator akzeptieren, dass der Schlüssel und die Aufrufe an ChannelEngine über FlexigoTech Cloud laufen. Es wurde nichts gesendet.

Ist der Schlüssel nicht in der Cloud gespeichert, sehen Sie Der Merchant-API-Schlüssel von … ist nicht in FlexigoTech Cloud gespeichert: Geben Sie ihn erneut ein. Die Lösung steht in der Meldung: Geben Sie ihn erneut ein. Auch das Löschen des Schlüssels aus FlexigoTech Cloud ist Sache eines Administrators. Jeder andere Benutzer erhält Nur ein Administrator kann den Merchant-API-Schlüssel aus FlexigoTech Cloud löschen.

ChannelEngine-Konto in Odoo mit Tenant-URL und Verbindungsstatus
ChannelEngine-Konto mit Demodaten: Sandbox-Umgebung, Tenant-URL, eine Schaltfläche zum Testen der Verbindung und die Reiter Automatisierung und Webhook.

Was passiert, wenn ich das Konto auf einen anderen ChannelEngine-Tenant umstelle?

Wenn der Schlüssel des Kontos bereits in FlexigoTech Cloud gespeichert ist, müssen Sie ihn beim selben Speichern erneut eingeben. Tun Sie das nicht, erscheint Um … auf einen anderen ChannelEngine-Tenant zu verschieben, geben Sie beim selben Speichern seinen Merchant-API-Schlüssel erneut ein: Der in FlexigoTech Cloud gespeicherte gehört zu ….

ChannelEngine-Webhooks: Ihr Odoo muss aus dem Internet erreichbar sein

Das Konto hat ein Feld Webhook-URL. Ist diese Adresse leer oder nicht öffentlich, bricht das Modul mit dieser Meldung ab:

Die Basis-URL dieses Odoo ist aus dem Internet nicht erreichbar (…), daher könnte ChannelEngine nie einen Webhook an sie zustellen. Legen Sie zuerst eine öffentliche 'web.base.url' fest.

In den Klammern steht die Adresse, die das Modul geprüft hat. Sie müssen tun, was die Meldung verlangt: Geben Sie Ihrem Odoo eine öffentliche Basis-URL. Solange Ihr Odoo nur innerhalb Ihres Netzwerks sichtbar ist, kann ChannelEngine keine Webhooks an es zustellen.

Daneben läuft die Geplante Aktion ChannelEngine: Benachrichtigungen importieren alle 4 Stunden.

Ratenlimits der ChannelEngine API, Fehler und das Protokoll jedes Aufrufs

Der Connector wendet pro Endpunkt Ratenlimits auf API-Aufrufe an. Im Screenshot des Protokolls sehen Sie mit Demodaten einen Aufruf, der wegen des Ratenlimits wiederholt wird.

Jeder Aufruf der Merchant API wird mit der Request-ID von ChannelEngine protokolliert.

ChannelEngine-Synchronisierungsprotokoll in Odoo mit einer Zeile pro API-Aufruf
Synchronisierungsprotokoll mit Demodaten: Typ, Ergebnis, Datensätze, Fehler und Meldung zu jedem Aufruf, darunter rohe API-Aufrufe, ein Aufruf mit Wiederholung wegen Ratenlimit und eine Sendungsnummer, die der Zusteller nicht erkennt.

Häufen sich die Aufrufprotokolle für immer an?

Die Geplante Aktion ChannelEngine: alte Synchronisierungsprotokolle bereinigen läuft jede Woche und ist ab der Installation aktiv.

Fragen zur ChannelEngine API mit Odoo

Kann ich mehrere ChannelEngine-Konten oder mehrere Odoo-Unternehmen verbinden?

Ja. Der Connector arbeitet mit jedem Konto und jedem Unternehmen und bringt ein Live-Dashboard mit.

Was ist mit Sendungen und Stornierungen, die direkt in ChannelEngine angelegt werden?

Sie werden mit ChannelEngine: in ChannelEngine erstellte Sendungen importieren und ChannelEngine: in ChannelEngine erstellte Stornierungen importieren nach Odoo geholt, alle 30 Minuten.

Wie oft werden Preis- und Bestandsänderungen übertragen?

ChannelEngine: geänderte Preise und Bestände vormerken läuft jede Stunde und ChannelEngine: ausstehende Preise/Bestände übertragen alle 30 Minuten. Zusätzlich läuft ChannelEngine: Bestand mit ChannelEngine vergleichen jeden Tag.

Brauche ich das Abonnement von FlexigoTech Cloud?

Ja. Der Connector arbeitet mit dem Abonnement von FlexigoTech Cloud, Plan Konnektor: Dort wird der Merchant-API-Schlüssel gespeichert, und die Aufrufe an ChannelEngine laufen über die Cloud. Das Modul finden Sie auf Odoo Apps und alle Details auf der Connector-Seite auf flexigotech.com.

Weiterlesen

Geprüft im Quellcode des Connectors (Version 20.0)

Quellen

  • Quellcode des Moduls: flexigobe_channelengine_connector 20.0 (af29566e): __manifest__.py
  • Quellcode des Moduls: flexigobe_channelengine_connector 20.0 (af29566e): models/channelengine_account.py
  • Quellcode des Moduls: flexigobe_channelengine_connector 20.0 (af29566e): models/fgt_cloud.py
  • Quellcode des Moduls: flexigobe_channelengine_connector 20.0 (af29566e): data/channelengine_cron.xml