DPD

Zweck

Der DPD SOAP Connector integriert das System mit den Versanddiensten von DPD über deren SOAP-API. Hauptfunktion ist die Übermittlung von Versandaufträgen und der Abruf von Versandetiketten.

Mit dem Connector können DPD-Sendungen automatisiert erstellt werden, indem detaillierte Auftragsinformationen wie Absender- und Empfängeradressen, Paketdetails sowie Druck- und Serviceoptionen übermittelt werden.

Praktische Anwendungshinweise

• Authentifizierung: Automatische Authentifizierung mittels „delisId“ und Passwort, um ein Authentifizierungs-Token abzurufen. Das Token wird bei Ablauf automatisch erneuert.

• SOAP-Header: Der notwendige authentication SOAP-Header wird automatisch erstellt und an Anfragen angehängt.

• Etikettenkodierung: Versandetiketten werden im Base64-Format im content-Feld der Antwort bereitgestellt und müssen dekodiert werden (z. B. zu PDF).

• WSDL-Konfiguration: Es werden zwei WSDL-URLs benötigt: eine Haupt-WSDL für Anfragen und eine authenticationWSDL für das Abrufen des Sicherheitstokens.

Authentifizierung

Die Authentifizierung erfolgt über Konfigurationsangaben. Der Connector nutzt diese, um einen getAuth-Aufruf durchzuführen und verwaltet das Sitzungs-Token.

• wsdl: URL zur Haupt-WSDL des DPD SOAP-Dienstes.

• authenticationWSDL: URL zur WSDL des DPD Login-Service.

• username: DPD „delisId“.

• password: Passwort des DPD-Kontos.

Erwartungen an Ein- und Ausgabe

Eingabe

Der Connector erwartet ein einzelnes komplexes order-Objekt für die StoreOrders-Anfrage. Dieses enthält:

• printOptions: Ausgabeformat (z. B. PDF, ZPL) und Papierformat des Versandetiketts.

• generalShipmentData: Absender-/Empfängeradressen, Kundenreferenznummern, DPD-Produktcode.

• parcels: Array mit Paketen, inklusive Gewicht, Maßen und Zusatzleistungen (z. B. Höherversicherung).

• productAndServiceData: Informationen zu DPD-Services wie Samstagszustellung, Predict-Benachrichtigungen oder Zollabfertigung.

Eingabeoptionen:

1

Formularanzeige

Benutzeroberflächenformular mit allen verschachtelten Feldern zur Erstellung des order-Objekts.

2

Output-Variable

Übergabe eines vollständigen JSON-Objekts aus einem vorherigen Schritt, das der erwarteten storeOrders-Struktur entspricht.

Ausgabe

• response: JSON-Objekt mit dem Ergebnis des storeOrders-Aufrufs. Erfolgreiche Antworten enthalten ein shipmentResponses-Objekt mit Paketnummer und Base64-kodiertem Versandetikett.

Die Aktion createResponseDataStructure kann verwendet werden, um Felder aus der response für nachfolgende Schritte zuzuordnen.