Octopia

Zweck

Der Octopia Connector bietet eine umfassende Schnittstelle zur Integration mit der Octopia-Marktplatz-API. Er automatisiert den gesamten Verkaufslebenszyklus, von der Produkt- und Angebotsverwaltung bis zur Bestellabwicklung und dem Fulfillment.

Mit diesem Connector lassen sich folgende Aufgaben erledigen:

• Produkte und Angebote verwalten: Produkte und zugehörige Angebote erstellen, aktualisieren und abrufen.

• Bestellungen bearbeiten: Bestellungen filtern, abrufen, annehmen, ablehnen und den Status aktualisieren (z. B. versandt, erhalten, storniert).

• Fulfillment abwickeln: Informationen zu Paketen, Sendungen und Rechnungen abrufen.

Praktische Anwendungshinweise

• Authentifizierung: Erfolgt automatisch über Benutzername und Passwort. Ein Bearer-Token wird vom /token-Endpunkt angefordert, gespeichert und bei Ablauf automatisch erneuert.

• Filterung und Paginierung: Listenabfragen unterstützen Filter wie states, startDate, endDate und Paginierung über pageNumber und pageSize.

• Massenoperationen: Aktionen wie „Bestellungen annehmen“ oder „Produkte erstellen/aktualisieren“ erwarten ein JSON-Objekt mit einem Hauptschlüssel (z. B. orders oder products), der eine Liste von Elementen enthält.

Authentifizierung

Benötigt werden folgende Anmeldeinformationen:

• URL: Basis-URL der Octopia-API-Umgebung.

• Username: Octopia-Konto-Benutzername.

• Password: Passwort zum Konto.

Hinweis: Das Token wird über den Endpunkt /token bezogen und als Bearer-Token in nachfolgenden Anfragen verwendet.

Erwartungen an Ein- und Ausgabe

Eingabe

• Query-Parameter: Optionale Filter- und Paginierungsparameter für Datenlisten (z. B. states, startDate, endDate, pageNumber, pageSize).

• JSON-Body: Für Erstell- oder Aktualisierungsaktionen ein JSON-data-Objekt mit den relevanten Informationen. Massenoperationen erwarten typischerweise ein Objekt mit einem Hauptschlüssel, z. B.:

{
  "orders": [
    { /* order 1 */ },
    { /* order 2 */ }
  ]
}

Ausgabe

• response: JSON-formatierter Body der API-Antwort.

• header: Optional, wenn „Header ausgeben“ aktiviert ist.

• createResponseDataStructure: Unterstützt beim Erzeugen einer Datenstruktur aus der Antwort zur weiteren Workflow-Verarbeitung.