Tradebyte

Zweck

Der Tradebyte Connector bietet eine Schnittstelle zur Tradebyte TB.One REST-API, die für den automatisierten, dateibasierten Datenaustausch konzipiert ist. Mit diesem Connector lässt sich der gesamte Lebenszyklus von Datendateien verwalten – der primären Kommunikationsmethode mit der Tradebyte-Plattform.

Mit diesem Connector können folgende Aufgaben umgesetzt werden:

• Dateien hoch- und herunterladen: Datendateien (z.B. Produkt- oder Bestandsdaten) hochladen und von Tradebyte bereitgestellte Dateien (z.B. Bestellungen, Retouren) herunterladen.

• Dateien verwalten: Listen verfügbarer Dateien abrufen, Details zu Dateien anzeigen und Dateien löschen.

• Service-Status prüfen: Den API-Betriebsstatus überwachen.

Praktische Anwendungshinweise

• Dateizentrierte Operationen: Der Fokus liegt auf Dateioperationen (z.B. XML- oder CSV-Dateien) und nicht auf einzelnen Datenobjekten.

• Datei herunterladen: Das response-Feld enthält den rohen Dateiinhalt (z.B. XML- oder CSV-String), der für weitere Verarbeitung gespeichert oder geparst werden muss.

• Datei hochladen: Für den Upload müssen data (Dateiinhalt), fileName und channel als Eingabeparameter übergeben werden.

Authentifizierung

HTTP Basic Authentication: Benutzername und Passwort werden bei jeder Anfrage automatisch kodiert und mitgesendet.

Benötigte Angaben:

• URL: Basis-URL der Tradebyte TB.One REST-API.

• Username: TB.One-Benutzername.

• Password: Passwort zum TB.One-Konto.

Ein- und Ausgabeerwartungen

Eingabe

• Dateien abrufen: Parameter channel und type (z.B. ORDERS, PRODUCTS).

• Datei herunterladen/löschen: Parameter fileId.

• Datei hochladen: Parameter channel, fileName und data (Dateiinhalt).

Ausgabe

• JSON-Antworten: Bei Listen-, Upload- und Metadatenanfragen enthält response JSON-Objekte mit Datei-Details.

• Roher Dateiinhalt: Bei „Datei herunterladen“ enthält response den unverarbeiteten Dateiinhalt.

• header: Antwort-Header, falls die Option „Header einschließen“ aktiviert ist.

• createResponseDataStructure: Für JSON-Antworten nutzbar, jedoch nicht für rohe Datei-Downloads.