Otto

Zweck

Der Otto Marketplace Connector bietet eine leistungsstarke Schnittstelle zur Integration mit der OTTO Market API. Er wurde entwickelt, um Verkäufern die Automatisierung zentraler E‑Commerce Prozesse zu ermöglichen, einschließlich Verwaltung von Produkten, Bestellungen, Sendungen und Retouren. Mit diesem Connector lassen sich folgende Aufgaben erledigen:

• Produkte verwalten: Produktdaten aus dem Katalog abrufen.

• Bestellungen bearbeiten: Bestelllisten abrufen und nach Status oder Datum filtern, um sie in die Fulfillment‑Prozesse einzubinden.

• Sendungen verwalten: Sendungen für Bestellungen erstellen und vorhandene Sendungsinformationen abrufen.

• Retouren verwalten: Erwartete Retouren ankündigen sowie alle Retouren oder einzelne Retouren per ID abrufen.

1

Praktische Anwendungshinweise — Authentifizierung

• Die Authentifizierung erfolgt automatisch.

• Benutzername und Passwort werden verwendet, um ein Bearer-Token vom /v2/token-Endpunkt abzurufen.

• Dieses Token wird sicher gespeichert und bei Ablauf automatisch erneuert, sodass die Kommunikation nahtlos bleibt.

Die Aktion „Test Connection“ kann verwendet werden, um die Gültigkeit der Anmeldeinformationen zu prüfen. Sie versucht, ein Authentifizierungstoken abzurufen und schlägt fehl, wenn URL, Benutzername oder Passwort nicht korrekt sind.

2

Praktische Anwendungshinweise — Paginierung

• Listenanfragen (z. B. „Get Orders“, „Get Returns“) verwenden Cursor‑basierte Paginierung.

• Enthält eine Antwort mehr Ergebnisse als die Seitenbegrenzung, enthält der Link‑Header der Antwort eine URL zur nächsten Seite.

• Damit der Header verfügbar ist, muss die Option „Header einschließen“ aktiviert sein.

• Für den Abruf der nächsten Seite wird die spezielle Aktion „Get Next Page“ verwendet, die die vollständige URL aus dem Link‑Header der vorherigen Antwort erwartet.

Wichtig für Entwickler

Stellen Sie sicher, dass die Option "Header einschließen" aktiviert ist, damit der Link-Header in der Connector-Antwort verfügbar ist. Die Aktion „Get Next Page“ benötigt exakt die URL aus diesem Header als Input.

3

Praktische Anwendungshinweise — Verbindung testen

• Verwenden Sie die Aktion „Test Connection“, um die Anmeldeinformationen zu prüfen.

• Die Aktion versucht, ein Authentifizierungstoken abzurufen und schlägt fehl, wenn URL, Benutzername oder Passwort nicht korrekt sind.

Authentifizierung

Die Authentifizierung erfolgt über Benutzername und Passwort. Der Connector verwendet diese Angaben, um ein temporäres Bearer‑Token zu erhalten, das für alle weiteren API‑Anfragen genutzt wird.

• URL: Basis‑URL der OTTO Market API‑Umgebung.

• Benutzername: Benutzername des OTTO Market‑Kontos.

• Passwort: Passwort des Kontos.

Bewahren Sie Benutzername und Passwort sicher auf. Der Connector speichert nur das erhaltene Bearer‑Token und erneuert es bei Ablauf automatisch.

Ein- und Ausgabeerwartungen

Eingabe

Der Connector stellt eine formularbasierte Oberfläche bereit, in der die gewünschte Aktion ausgewählt wird. Die benötigten Parameter ändern sich je nach gewählter Aktion.

• Query‑Parameter: Für Listenabrufe (z. B. „Get Orders“) können optionale Filter wie status, from und to verwendet werden.

• Pfadparameter: Für Aktionen auf einzelnen Entitäten (z. B. „Get Return By Id“) muss die jeweilige ID (returnId) angegeben werden.

• JSON‑Body: Für das Erstellen von Daten, etwa bei „Create Shipment“, ist ein data‑Objekt im JSON‑Format mit den erforderlichen Details zu übergeben.

• Next Page URL: Die spezielle Aktion „Get Next Page“ erwartet die vollständige url, die im Link‑Header einer vorherigen paginierten Antwort steht.

Ausgabe

Der Connector gibt die API‑Antwort im Standardformat zurück.

• response: Enthält den Body der API‑Antwort im JSON‑Format. Bei Listen ist dies typischerweise ein Array von Elementen.

• header: Enthält die Response‑Header. Diese Ausgabe ist wichtig für die Paginierung und muss über die Option „Header einschließen“ aktiviert werden.

• createResponseDataStructure: Mit dieser Aktion lässt sich aus der response eine Datenstruktur generieren, um die Ausgabe einfacher in nachfolgenden Workflow‑Schritten zu verwenden.

Beispiel: Warum `header` wichtig ist

Bei paginierten Endpunkten liefert die API im Link‑Header die URL zur nächsten Seite. Ohne die Header‑Ausgabe kann die Aktion „Get Next Page“ nicht mit der korrekten URL versorgt werden.