Aldi Logistics

Zweck

Der Aldi Logistics API Connector automatisiert die Kommunikation zwischen dem System und dem Aldi-Logistiknetzwerk. Er optimiert die Auftragsabwicklung, verwaltet Produktdaten und bearbeitet Retouren direkt aus der Xentral-Umgebung.

Mit diesem Connector lassen sich folgende Aufgaben erledigen:

• Bestellungen verwalten: Neue Bestellungen abrufen, Status aktualisieren und bei Bedarf stornieren.

• Sendungen bearbeiten: Sendungsinformationen abrufen, Sendungsdetails (Tracking-IDs, Links) erstellen und aktualisieren sowie den Versandprozess steuern.

• Produktdaten steuern: Produktinformationen abrufen und Lagerbestände verwalten.

• Retouren abwickeln: Kundenretouren erstellen und verwalten.

Verwenden Sie diesen Connector, um Routineabläufe mit dem Aldi-Logistik-Netzwerk direkt aus Workflows heraus zu automatisieren — z. B. automatisches Erstellen von Sendungen nach Bestelleingang oder Aktualisieren von Versandstatus.

Praktische Anwendungshinweise

• Für den Versandstatus größer als READY sind carrier (Spediteur), trackingId (Tracking-ID) und shippingDate (Versanddatum) verpflichtend.

• Das shippingDate darf nicht in der Zukunft liegen und muss nach dem Bestelldatum erfolgen.

• Bei Status DELIVERED ist das receiptDelivery (Zustelldatum) Pflicht.

• Veraltete („deprecated“) Retouren-Endpunkte sollten vermieden und durch die aktuellen Versionen ersetzt werden.

• Bei Speditions-Retouren ist die Telefonnummer des Kunden Pflicht.

Authentifizierungsoptionen

Keine Authentifizierung

• Keine Eingaben erforderlich.

OAuth2-Passwort

Eingabe:

• url: Basis-URL des API-Endpunkts

• username: Benutzername

• password: Passwort

• clientId: Client-ID von Aldi

OAuth2-Passwort: Verwenden Sie diese Option, wenn Aldi eine OAuth2-Password-Grant-Authentifizierung anbietet und Sie Benutzeranmeldedaten plus Client-ID verwenden.

API-Schlüssel

Eingabe:

• key: Name des API-Schlüsselfelds (z. B. x-api-key)

• value: API-Schlüssel

• addTo: headers oder queryParameters

API-Schlüssel: Geben Sie exakt das Feldnamen- und Wert-Paar an und wählen Sie, ob der Schlüssel in Headern oder Query-Parametern übergeben werden soll.

Erwartungen an Ein- und Ausgabe

Eingabe

• Formularbasierte Eingabe mit dynamischen Feldern passend zur Aktion.

• Ausgabevariablen aus vorherigen Schritten als JSON-Objekt zur Verkettung von Aktionen.

Ausgabe

• response: Hauptteil der API-Antwort im JSON-Format.

• header: API-Antwort-Header, wenn aktiviert.

Die Aktion createResponseDataStructure unterstützt beim Erzeugen strukturierter Daten für weitere Workflow-Schritte.