fulfillmenttools

Zweck

Der Fulfillmenttools Connector stellt eine Schnittstelle zur Fulfillmenttools-API bereit, um zentrale E‑Commerce‑Daten zwischen Systemen zu verwalten und zu synchronisieren. Er fokussiert sich auf die Handhabung von Artikeln, Fulfillment‑Aufträgen, Lagerbeständen und Filialinformationen.

Mit diesem Connector lassen sich folgende Aufgaben umsetzen:

• Artikel verwalten: Alle Artikel abrufen oder einen bestimmten Artikel über seine Nummer suchen.

• Aufträge verwalten: Fulfillment‑Aufträge listen oder einen bestimmten Auftrag anhand seiner ID abrufen.

• Lagerbestand verwalten: Lagerbestände für Artikel aktualisieren, Bestände abrufen oder eine vollständige Lagerbestandsübersicht erhalten.

• Filialen verwalten: Filialliste abrufen oder Details zu einer bestimmten Filiale abfragen.

Praktische Anwendungshinweise

Authentifizierung: Erfolgt automatisch über Shop‑ID, Benutzername und Passwort, um ein JSON Web Token (JWT) zu erhalten. Das Token wird sicher gespeichert und bei Ablauf automatisch erneuert.

Paginierung: Bei Listenabrufen (z. B. Artikel oder Aufträge) wird Paginierung über die Parameter page und pageSize unterstützt, um große Datenmengen effizient zu verarbeiten.

Authentifizierung

Für die Verbindung zur Fulfillmenttools‑API werden folgende Angaben benötigt, um ein Bearer‑Token für die Authentifizierung zu beziehen:

• URL: Basis‑URL des Fulfillmenttools‑API‑Endpunkts.

• Shop ID: Shop‑Kennung in Fulfillmenttools.

• Username: Benutzername des Fulfillmenttools‑Kontos.

• Password: Passwort des Fulfillmenttools‑Kontos.

Erwartungen an Ein- und Ausgabe

1

Eingabe

Die Eingabe erfolgt über ein Formular, dessen Felder sich je nach gewählter Aktion unterscheiden:

• Artikel nach Artikelnummer abrufen: Angabe von articleNumber erforderlich.

• Artikel abrufen: Optionale Parameter page und pageSize zur Paginierung.

• Fulfillment‑Auftrag nach ID abrufen: Angabe von fulfillmentOrderId erforderlich.

• Fulfillment‑Aufträge abrufen: Optionale Parameter page und pageSize zur Paginierung.

• Lagerbestand aktualisieren: Erfordert articleNumber und ein JSON‑data‑Objekt mit den Bestandsinformationen.

2

Ausgabe

• response: Enthält den JSON‑Body der API‑Antwort.

• header: Optional, wenn „Header ausgeben“ aktiviert ist, enthält die Response‑Header.

• createResponseDataStructure: Unterstützt das Erzeugen einer Datenstruktur aus der response für die weitere Verwendung in Workflows.