DPD LabelPrint Handbuch D · REST / SOAP 1 25 M Druckername T020 printer 2 14 C3 DPD...

DPD LabelPrint Handbuch Version 2.1.0 _ 2018-09-04

CIT DPD LabelPrint Handbuch (D) Seite 2 / 25

Inhaltsverzeichnis

1 Einführung ...................................................................................................................................... 3

2 Installation ...................................................................................................................................... 3

2.1 Installation als Windows-Dienst .................................................................................................. 4

3 Konfiguration .................................................................................................................................. 5

3.1 Printclient (Frontend) konfigurieren ............................................................................................ 6

4 Drucken über Frontend / Browser .................................................................................................. 7

5 Drucken über Fileimport ................................................................................................................. 9

5.1 Import Profile .............................................................................................................................. 9

5.2 Mappings .................................................................................................................................. 11

5.3 Transformationen ...................................................................................................................... 12

5.4 Drucker für Fileimport konfigurieren ......................................................................................... 13

5.5 File Import ................................................................................................................................. 14 5.5.1 Import von Aufträgen ......................................................................................................... 14 5.5.2 Paket stornieren: ............................................................................................................... 15 5.5.3 Versandliste Drucken ........................................................................................................ 15

5.6 Dateiformate ............................................................................................................................. 16 5.6.1 Token Based ..................................................................................................................... 16 5.6.2 CSV ................................................................................................................................... 17 5.6.3 XML ................................................................................................................................... 18 5.6.4 REST Service .................................................................................................................... 21 5.6.5 SOAP Service.................................................................................................................... 23

6 Unterstützung und Support .......................................................................................................... 25


1 Einführung

Um die Versandabwicklung des Paketversandes zu vereinfachen, wurde die Paketscheindrucklösung DPD LabelPrint entwickelt. Mit DPD LabelPrint können auf einfache Weise Paketscheine erstellt werden.

2 Installation

Stellen Sie sicher, dass Sie mindestens Java Version 8 installiert haben. Sollte dies nicht der Fall sein Installieren Sie zuerst die aktuellste Java Version bevor sie fortfahren. Im Initialzustand wird der Printserver unter dem Port 8080 gestartet. Diesen Port können Sie auch verändern. Vergessen Sie nicht Ihren Port in der Firewall freizugeben! Starten Sie die Installation indem Sie die Setupdatei „DPDLabelPrintInstaller-X.X.X.exe“ ausführen. Klicken Sie auf „Weiter“ bis um die Installation zu starten. Im nächsten Screen können Sie festlegen ob das Programm bei der Anmeldung ins Windows automatisch gestartet werden soll. Anschliessend können Sie den Installationspfad angeben. Mit einem Klick auf „installieren“ wird das Programm installiert Nach Abschluss der Installation können Sie das Programm über das Icon auf dem Desktop starten. Zuerst öffnet sich die Management Konsole, in welcher der Printserver manuell gestartet und gestoppt werden kann (nur Normale Installation); außerdem wird hier im laufenden Betrieb die Logausgabe erzeugt. Sie können hier auch IP-Adresse und Port unter welcher das Programm läuft anpassen. Sobald der Server gestartet ist öffnet sich das Frontend. Hier können Aufträge manuell erfasst werden und Einstellungen vorgenommen werden.


2.1 Installation als Windows-Dienst

Neben der normalen Installation, bei welcher die DPD LabelPrint-Anwendung erst beim Login des Benutzers im Windows-Betriebssystem gestartet wird, kann auch eine Installation als Windows-Dienst / Windows-Service erfolgen. Dienste werden in Windows bereits gestartet, sobald der PC hochgefahren ist. Hierzu muss die Anwendung ganz normal installiert werden, die Konfiguration des Windows-Dienstes erfolgt nachträglich im zweiten Tab der Management-Console. Damit die Anwendung als Service installiert werden kann, wird der Benutzername und das Passwort des Windows-Benutzers benötigt. Der Hintergrund hierfür ist, dass die Anwendung nicht als normaler Windows-Dienst installiert wird, sondern als spezieller Dienst, der auf die Daten des angegebenen Benutzers zugreifen kann, da ansonsten der Drucker und die Netzwerkverbindung nicht verfügbar wären. ACHTUNG: Der Windows-Benutzer muss ein Passwort besitzen, ansonsten ist keine Installation als Service möglich! Über den Installations-Button lässt sich die Anwendung als Windows-Dienst hinterlegen. Hier erscheint ein Windows-Popup, da das Registrieren eines Dienstes Administrator-Rechte benötigt. Nachdem die Installation erfolgt ist, können Sie den Status über den „Refresh Status“-Button aktualisieren. Hier müsste sich dann der Status von „Der angegebene Dienst ist kein installierter Dienst“ zu „STATE: 1 STOPPED“ ändern. Dies bedeutet, dass der Dienst erfolgreich hinterlegt wurde. Der Dienst wird jedoch nicht sofort gestartet, sondern erst nach einem Neustart des PCs. Analog zur Installation kann hier auch die Deinstallation des Services durchgeführt werden, so dass die Anwendung wieder als normale Windows-Anwendung läuft. Wenn die LabelPrint-Anwendung im Service-Modus läuft, ist die Management-Console leicht verändert, da nicht mehr alle Funktionen zur Verfügung stehen. Das Starten und Stoppen des Programms kann hier nur durch Windows erfolgen, d.h. durch einen Neustart des PCs wird der im Hintergrund laufende Windows-Dienst neugestartet. Im Tab Service-Configuration müsste der Status nun auf „STATE : 4 RUNNING“ stehen.


3 Konfiguration

Solange der Printserver noch nicht konfiguriert wurde, wird im Frontend / Browser immer die Konfigurationsseite erscheinen.

Im Folgenden die Erläuterung der einzelnen Parameter: Delis-ID: Hier müssen sämtliche KundenIDs angegeben werden, mit welchen über den Printserver gedruckt werden soll. Soll mehr als eine ID konfiguriert werden, müssen diese durch eine Kommatrennung angegeben werden (ohne Leerzeichen, z.B. D54080XX,KD54080XY,KD54080XZ) Server-IP: Adresse zum AraneorConnect/DMZ, hier bitte labelprint.dpd.ch eingeben. Die Kommunikation zu diesem Server erfolgt im Übrigen verschlüsselt per HTTPS. Im Folgenden müssen Benutzername und Passwort für den Zugang zum DMZ konfiguriert werden. Username / Password: Ihre Zugangsdaten für die Labelprint-Anwendung. Wenn alle Felder gefüllt wurden auf „Save“ klicken, hierbei wird nun ein Login auf dem DMZ mit den angegebenen Daten versucht. Sollte dieser fehlschlagen, wird eine Fehlermeldung angezeigt. In diesem Fall bitte Benutzername und Passwort, sowie Adresse des DMZ überprüfen. Sollten Sie die Konfiguration im Nachhinein anpassen wollen, klicken Sie links auf „Print Settings“


3.1 Printclient (Frontend) konfigurieren

Nach der Konfiguration des Printservers und bei jedem neuen Client wird folgendes Popup

angezeigt: Client-Name: Bitte einen EINDEUTIGEN Clientnamen eintragen! Your Label Printer: Hier sind alle Drucker zur Auswahl, die auf dem Printserver installiert sind. Wählen Sie den Drucker aus, auf dem der Client später die Labels ausdrucken soll. Your DinA4 Printer: Wählen Sie den Drucker aus, auf dem der Client später die Versandliste ausdrucken soll Your default Delis-Id: Einfach die gewünschte Delis-Id auswählen. Wenn alle Felder gefüllt wurden auf „Save“ klicken und das Popup schließt automatisch. Jetzt sollte folgender Bildschirm erscheinen:


4 Drucken über Frontend / Browser

Nachdem Der Client konfiguriert wurde (Name des Clients, Drucker und DELISID), wird das Eingabefeld zur Delivery ID (Referenznummer) angezeigt.

Wird hier eine Delivery ID eingegeben, wird überprüft, ob die dazugehörige Empfänger-Adresse bereits an die DPD übermittelt wurde. Ist diese vorhanden, wird das Label direkt im konfigurierten Drucker ausgedruckt. Sind die Empfänger-Daten nicht vorhanden, wird folgendes Popup angezeigt:

Hier muss nun die Empfängeradresse eingegeben werden. Hierzu einfach eine Postleitzahl eingeben, mit der Eingabetaste (Entertaste) wird der Name der Stadt und deren Strassen gesucht. Sobald alle Felder gefüllt sind, wird die Adresse validiert. Hierzu entweder aus dem Empfängerfeld heraus die Eingabetaste drücken oder auf den Print-Button klicken. Ist der Zusammenhang zwischen Strasse und Postleitzahl nicht eindeutig, wird ein Popup angezeigt:


Dies hat den folgenden Grund:

Bei der Eingabe einer Postleitzahl werden alle Strassen gesucht, die zur Stadt der Postleitzahl gehören. Wird beispielsweise 8001 (Zürich) eingegeben, werden alle Strassen von Zürich gesucht – auch Strassen, die nicht zur Postleitzahl 8001, sondern beispielswiese auch Strassen zu 8002, 8010, 8048 usw. Wird nun eine Strasse ausgewählt, die nicht zur eingegeben Postleitzahl passt muss dies bestätigt werden. Gehört die Strasse zu mehreren Postleitzahlen, muss eine Postleitzahl ausgewählt werden.

Dies kann direkt über die Tastatur durchgeführt werden, durch die Pfeiltasten ↑ ↓ kann eine

Postleitzahl ausgewählt werden, durch die Eingabetaste (oder den Auswahlbutton) wird das Label gedruckt.


5 Drucken über Fileimport

Neben der Manuellen Erfassung von Aufträgen bietet DPD LabelPrint die Möglichkeiten Pakete über einen Dateiimport zu erfassen.

5.1 Import Profile

Hier können Importe konfiguriert werden, wobei pro Import-Job unterschiedliche Felder konfiguriert werden müssen. Folgende Felder müssen immer konfiguriert werden: Profile Name: eindeutiger Name des Profiles Print-Folder: Geben Sie hier den Ordner an, in welchen die Dateien für den File-Import geschrieben werden. Archive-Folder: In diesen Ordner werden die Dateien verschoben, sobald sie verarbeitet wurden.

ACHTUNG: Dies müssen komplett zwei verschiedene Ordner sein, da der Print-Folder auf neue Dateien überwacht wird. Im Folgenden ein Beispiel:

ACHTUNG: Wenn die Anwendung als Windows-Service läuft und der Printfolder ein Netzwerklaufwerk ist, muss hier eine IP-Adresse und kein Laufwerkspfad angegeben werden. Z.B. statt F:\PrintFolder müsste z.B. \\192.168.178.123\PrintFolder angegeben werden.

Use own Trackingnumbers: Hier muss ausgewählt werden, ob beim File Import eine eigene Paketscheinnummer mitgegeben wird, oder ob die Labelprint-Anwendung automatisch die nächste verfügbare Paketscheinnummer aus dem Nummernkreis des Kunden verwenden soll. Default Printer: Beim Import kann ein Druckername über das entsprechende Feld mitgegeben werden. Wenn dieses Feld im Import leer ist, wird der hier konfigurierte Drucker verwendet. Default Delis-ID: Beim Import kann die Delis-ID über das entsprechende Feld mitgegeben werden. Wenn dieses Feld im Import leer ist, wird die hier konfigurierte Delis-ID verwendet. Use Semaphore: Sollen Files direkt verarbeitet werden, oder soll die Labelprint Anwendung warten, bis ein entsprechendes Semaphore-File vorhanden ist (z.B. test.xml test.xml.sem) Write back generated parcel numbers: Sofern die Labelprint-Anwendung die Paketnummern verwaltet, können die generierten Paketscheinnummern in eine Datei geschrieben werden:

- NONE: es wird kein File erzeugt - CREATE_NEW_FILE: die Original-Datei wird umbenannt (Format xxxxMMddHHmmss), es

wird eine neue Datei mit dem Namen der Original-Datei erzeugt, die die generierten Paketscheinnummern enthält (pro Zeile eine Paketscheinnummer, falls die Datei mehrere Aufträge hatte).

- APPEND_TO_FILE: Die generierten Paketscheinnummern werden direkt in die Original-Datei zurückgeschrieben, hierbei wird das Feld „Generated parcel number“ verwendet.

Encoding: Enkodierung der Datei, mögliche Werte: Automatic Detection, UTF-8, ISO 8859-1, ISO 8859-2


Import file type: Dateiformat für dieses Profil, mögliche Werte:

- TOKEN_BASED - CSV - XML - REST_SERVICE - SOAP_SERVICE

Dokumentation der Datenformate: siehe Kapitel „Dateiformate“. Mapping Profile: Auswahl eines Mapping-Profiles, in welchem die Namen der Felder konfiguriert werden kann. Siehe Kapitel „Mappings“. Transformation Profile: Auswahl eines Transformations-Profiles, in welchem Regeln für die Umwandlung von Feldern konfiguriert werden kann. Siehe Kapitel „Transformationen“.


5.2 Mappings

Grundsätzlich können sämtliche Felder der Import-Files umkonfiguriert werden. Zum Anlegen eines Profiles auf den Button „Add Mapping Profile“ klicken, hier erscheint folgendes Popup, wo ein Name des Profiles und der Typ des Profiles angegeben werden muss.

Anschließend können die Felder nach der Auswahl des Profiles auf der linken Seite beliebig konfiguriert werden; Änderungen müssen immer mit dem Save Button bestätigt werden!


5.3 Transformationen

Hier können Regeln definiert werden, mit denen Werte von Feldern verändert werden können. Zum Anlegen eines Transformation-Profiles auf den Button „Add Transformation Profile“ klicken, hier erscheint folgendes Popup, wo der Name des Profiles angegeben werden muss.

Anschließend können die Felder nach der Auswahl des Profiles auf der linken Seite beliebig konfiguriert werden; Änderungen müssen immer mit dem Save Button bestätigt werden! Jede Regel besteht aus folgenden Teilen:

- IF o Feld-Name o Regel-Typ:

▪ Equals / Equals ignore case ▪ Not equals ▪ Is empty ▪ Is not empty ▪ Contains / Contains ignore case

o Wert (bei equals / contains) - THEN

o Feld-Name o Transformations-Typ

▪ Set Value ▪ Remove Characters ▪ Cut Length

o Wert Beispiele:


5.4 Drucker für Fileimport konfigurieren

Im Menü Printer-File-Mapping muss der im File eingetragene Druckername auf einen am Computer angeschlossenen Drucker gemappt werden.

Mögliche Einstellungen:

- Printername: Auswahl des Druckers - Printername in File: Bezeichnung, die bei der Übergabe des Wertes beim Import verwendet

wird - Paper Size:

o DIN A6 (für Labels) o DIN A4 (für Reports) o Own Size: für andere Formate

- Offset: Verschieben des Dokuments nach oben / unten und links / rechts - Scaling: Skalierungsoptionen für den Drucker, üblicherweise "Actual Size"


5.5 File Import

Sämtliche Importe basieren auf den folgenden Feldern, wobei die Spaltennamen in den Mappings angepasst werden können.

5.5.1 Import von Aufträgen

Nr. Max. Länge

Feld -typ

Beschreibung Standard Token

Standard CSV / XML / REST / SOAP

1 25 M Druckername T020 printer

2 14 C3 DPD Paketscheinnummer1 T400 parcelNumber

3 10 O2 Versandart NP DPD CLASSIC B2C DPD COMFORT NP,E10 DPD EXPRESS 10 NP,E12 DPD EXPRESS 12 NP,GUA DPD CLASSIC Guarantee IE2 DPD EXPRESS INTERNAT. HOME DPD HOME B2BP DPD CLASSIC Predict

T401 serviceCode

4 35 C3 Referenznummer 1 T402 customerBarcode1

5 35 O Referenznummer 2 T403 customerBarcode2



8 10 O DELIS ID T406 delisId

9 35 O Sendername 1 T810 senderName1

10 35 O Sendername 2 T811 senderName2

11 35 O Senderstrasse inkl. Hausnummer T820 senderStreet

12 3 O Sender Land, ISO-2, ISO-3 oder ISO-Numeric 3

T821 senderCountry

13 9 O Sender PLZ T822 senderZipCode

14 35 O Sender Ort T823 senderCity

15 35 M Empfängername 1 T860 receiverName1

16 35 O Empfängername 2 T861 receiverName2

17 35 O Empfängername 3 T862 receiverName3

18 35 M Empfänger Strasse inkl. Hausnummer T863 receiverStreet

19 9 M Empfänger PLZ T330 receiverZipCode

20 35 M Empfänger Ort T864 receiverCity

21 2 C4 Benachrichtigungssprache T880 predictNotificationLanguage

22 50 C4 Benachrichtigungsdaten E-Mail-Adresse oder Telefonnummer

T881 predictContactData

23 3 M Empfänger Land, ISO-2, ISO-3 oder ISO-Numeric 3

T100 receiverCountry

24 30 O Telefonnummer Empfänger T758 receiverPhone

25 3 M Anzahl Pakete für den Empfänger T8905 countParcelsOfShipment

26 3 M Nummer dieses Pakets T8904 numberOfThisParcelInShipment

27 2.1 O Paketgewicht in kg T530 weight

M = Pflicht, O = Optional, C= Bedingt

1. Wenn im File eine eigene Paketscheinnummer mitgegeben wird, muss im Menü Server-Properties die Funktion ”Use own Trackingnumbers for File Import” aktiviert sein. 2. Ist kein Servicecode angegeben, wird ein DPD CLASSIC Paket erstellt. 3. Entweder eine Paketscheinnummer oder Referenznummer 1 muss angegeben werden. 4. Pflicht für DPD COMFORT und DPD CLASSIC Predict


5.5.2 Paket stornieren:

Bis zu 15 Minuten nach dem Import eines Paketes ist es möglich dieses zu Stornieren. Wenn Sie z.B. einen Auftrag um 9:59 erstellen, kann dieser bis 10:15 storniert werden.

Nr. Max. Länge

Optional / Pflicht



1 35 P Referenznummer 1 des zu stornierenden Auftrags

T000 storno

5.5.3 Versandliste Drucken

Sie können die Versandliste entweder für alle Pakete der letzten 30 Tagen oder nur für die, welche seit dem letzten Mal das eine Versandliste gedruckt wurde generieren.

Nr. Max. Länge

Optional / Pflicht



1 15 P ALL alle Pakete DIFFERENCE nur neue Pakete seit dem letzten Druck

T1001 printShippingList

2 10 P DELIS ID T1002 shippingListDelisId

3 25 P Druckername T020 printer


5.6 Dateiformate

5.6.1 Token Based

- Aufbau ist immer "TOKEN:VALUE| " - Delimeter / Trennzeichen ist konfigurierbar, Default: Pipe "|" - Die Reihenfolge der Token spielt keine Rolle. - Sollten weitere Tokens im File vorhanden sein, werden diese ignoriert. - Pro File kann ein Paket angegeben werden.

Beispiele: Labeldruck:

T020:PRT321|T400:06086021189917|T401:NP|T402:ABC|T403:123|T810:DPD (Schweiz) AG|T820:Mülibachstrasse 41|T821:CH|T822:8107|T823:Buchs|T860:DPD (Schweiz) AG|T861:Depot 610|T863:Bäumlimattstrasse 9|T330:4313|T864:Möhlin|T100:CH|T758:0848 373 372|T8904:001|T8905:001|T530:10.5|

Storno:

T000:08150815 Versandliste:

T1001:ALL|T1002:KD5408034|T020:PRT321


5.6.2 CSV

- Pro Datei können mehrere Aufträge importiert werden - Trennzeichen Konfigurierbar - Erste Zeile ist ignorierbar

Header-Based CSV: Identifikation der Spalten über Spaltenname Index-Based CSV: Identifikation der Spalten über Index Beispiele: Labeldruck:

printer;parcelNumber;serviceCode;customerBarcode1;customerBarcode2;customerBarcode3;customerBarcode4;delisId;senderName1;senderName2;senderStreet;senderCountry;senderZipCode;senderCity;receiverName1;receiverName2;receiverName3;receiverStreet;receiverZipCode;receiverCity;receiverCountry;numberOfThisParcelInShipment;countParcelsOfShipment;weight;receiverPhone; PRT312;06086021182637;327;0000111112222331;0000111112222332;0000111112222333;0000111112222334;KD0815;DPD (Schweiz) AG;Depot 0615;Mülibachstrasse 41;CH;8107;Buchs;DPD (Schweiz) AG;Depot 0610;;Bäumlimattstrasse 9;4313;Möhlin;CH;1;2;0.34;+44123456789;

Versandliste:

printShippingList;shippingListDelisId;printer; ALL;KD5408034;PRT312;

Storno:

storno; 0000111112222331;


5.6.3 XML

- Pro Datei können mehrere Aufträge importiert werden - Wenn mehrere Aufträge importiert werden sollen, muss der Parcel-Tag definiert werden

Beispiele Labeldruck:

- Einzelnes Paket (“somexml” bedeutet hier, dass der äußere Tag egal ist, da beim einzelnen Auftrag nur die inneren Tags interpretiert werden): <somexml> <printer>PRT312</printer> <customerBarcode1>0000111112222331</customerBarcode1> <serviceCode>327</serviceCode> <customerBarcode1>0000111112222331</customerBarcode1> <customerBarcode2>0000111112222332</customerBarcode2> <customerBarcode3>0000111112222333</customerBarcode3> <customerBarcode4>0000111112222334</customerBarcode4> <delisId>KD0815</delisId> <senderName1>DPD (Schweiz) AG</senderName1> <senderName2>Depot 0615</senderName2> <senderStreet>Mülibachstrasse 41</senderStreet> <senderCountry>CH</senderCountry> <senderZipCode>8107</senderZipCode> <senderCity>Buchs</senderCity> <receiverName1>DPD (Schweiz) AG</receiverName1> <receiverName2>Depot 0610</receiverName2> <receiverName3></receiverName3> <receiverStreet>Bäumlimattstrasse 9</receiverStreet> <receiverZipCode>4313</receiverZipCode> <receiverCity>Möhlin</receiverCity> <receiverCountry>CH</receiverCountry> <numberOfThisParcelInShipment>1</numberOfThisParcelInShipment> <countParcelsOfShipment>2</countParcelsOfShipment> <weight>0.34</weight> <receiverPhone>+44123456789</receiverPhone> </somexml>

- Mehrere Pakete: hier müsste jetzt der Tag „parcel“ als Parcel-Tag konfiguriert werden

<somexml> <parcel> <printer>PRT312</printer> <customerBarcode1>0000111112222331</customerBarcode1> <serviceCode>327</serviceCode> <customerBarcode1>0000111112222331</customerBarcode1> <customerBarcode2>0000111112222332</customerBarcode2> ..... </parcel> <parcel> <printer>PRT312</printer> <customerBarcode1>0000111112222331</customerBarcode1> <serviceCode>327</serviceCode> <customerBarcode1>0000111112222331</customerBarcode1> <customerBarcode2>0000111112222332</customerBarcode2> ..... </parcel> </somexml>


Verschachteltes XML: <parcels> <parcel> <printer>PRT312</printer> <serviceCode>327</serviceCode> <delisId>KD0815</delisId> <receiver> <name1>DPD (Schweiz) AG</name1> <name2>Depot 0610</name2> <name3></name3> <street>Bäumlimattstrasse 9</street> <zipCode>4313</zipCode> <city>Möhlin</city> <country>CH</country> </receiver> <barcodes> <parcelNumber>06086021182637</parcelNumber> <customerBarcode1>0000111112222331</customerBarcode1> <customerBarcode2>0000111112222332</customerBarcode2> <customerBarcode3>0000111112222333</customerBarcode3> <customerBarcode4>0000111112222334</customerBarcode4> </barcodes> <sender> <name1>DPD (Schweiz) AG</name1> <name2>Depot 0615</name2> <street>Mülibachstrasse 41</street> <zipCode>CH</zipCode> <city>8107</city> <country>Buchs</country> </sender> <numbers> <this>002</this> <count>003</count> <weight>0.34</weight> </numbers> </parcel> </parcels> Hier müssten die Tags dann im Mapping-Profil angepasst werden, da die Felder (z.B. name1) nicht mehr eindeutig sind. Felder, die weiterhin eindeutig sind (z.B. parcelNumber) müssen nicht angepasst werden, da es hier egal ist, wie sie verschachtelt sind. Als Trennzeichen für die Verschachtelung muss ein Punkt verwendet werden. - Receivername1 receiver.name1 - Receivername2 receiver.name2 - Receivername3 receiver.name3 - Receiverstreet receiver.street - ReceiverZipCode receiver.zipCode - ReceiverCity receiver.city - ReceiverCountry receiver.country - …


Versandliste: <shippingList> <shipping> <printShippingList>ALL</printShippingList> <shippingListDelisId>KD0815</shippingListDelisId> <printer>PRT312</printer> </shipping> </shippingList> Storno: <stornoList> <stornoEntry> <storno>08150815</storno> </stornoEntry> <stornoEntry> <storno>08150816</storno> </stornoEntry> </stornoList>


5.6.4 REST Service

- Pro Request kann ein Auftrag importiert werden - Ergebnis ist ein JSON-Objekt mit der erzeugen Paketnummer und dem PDF-Label als base64

encodierter Wert - Wenn ein Drucker als Parameter übergeben wird, wird das Label automatisch ausgedruckt - Kein Storno und kein Versandlistendruck möglich. - Editierung der Parameter über Mapping - Transformationen werden ebenso angewendet wie beim normalen Import

Beispiele: Request-URL ohne direkten Druck

http://localhost:8080/createLabel?serviceCode=101&customerBarcode1=0000111112222331&receiverName1=DPD (Schweiz) AG&receiverStreet=Mülibachstrasse 41&receiverZipCode=8107&receiverCity=Zürich&receiverCountry=CH

JSON-Ergebnis:

{ "success": true, "message": "success", "parcelNumber": "06086021196030", "labelId": "807", "base64pdf": "JVBERi0x[…]" }

Request-URL mit direktem Druck

http://localhost:8080/createLabel?serviceCode=101&customerBarcode1=0000111112222331&receiverName1=DPD (Schweiz) AG&receiverStreet=Mülibachstrasse 41&receiverZipCode=8107&receiverCity=Zürich&receiverCountry=CH&printer=PRT312

JSON-Ergebnis:

{ "success": true, "message": "printed", "parcelNumber": "06086021196030", "labelId": "807", "base64pdf": "JVBERi0x[…]" }


Transformation des PDFs in andere Formate: Zusätzlich kann die Labelprint Anwendung das Label auch in andere Formate umwandeln:

- pdf - png - jpg - bmp - gif

Hierzu muss das Label zuerst über den createLabel Service erzeugt werden, anschließend kann die labelId verwendet werden, um das PDF umzuwandeln und direkt als Datei zu erhalten. URL: http://localhost:8080/getLabel?labelId=807&filetype=png

http://localhost:8080/getLabel?labelId=807&filetype=png


5.6.5 SOAP Service

- Pro Request kann ein Auftrag importiert werden - Ergebnis ist ein SOAP-Objekt mit der erzeugen Paketnummer und dem PDF-Label als base64

encodierter Wert - Wenn ein Drucker als Parameter übergeben wird, wird das Label automatisch ausgedruckt - Kein Storno und kein Versandlistendruck möglich. - Der Soap-Service ist relativ robust

o wie im XML Import können die Parameter über das Mapping edititiert werden o Muss nicht notwendigerweise als SOAP implementiert werden, theoretisch kann auch

einfach ein normales XML File per HTTP POST an den Endpoint geschickt werden. - Transformationen werden ebenso angewendet wie beim normalen Import - WSDL-File unter http://localhost:8080/soap/labelprint.wsdl - SOAP Endpoint: http://localhost:8080/soap/

Beispiel: SOAP-Request: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:labelprintWs"> <soapenv:Header/> <soapenv:Body> <urn:CreateLabelRequest> <printer>PRT312</printer> <parcelNumber></parcelNumber> <serviceCode>327</serviceCode> <customerBarcode1>0000111112222331</customerBarcode1> <customerBarcode2>0000111112222332</customerBarcode2> <customerBarcode3>0000111112222333</customerBarcode3> <customerBarcode4>0000111112222334</customerBarcode4> <receiverName1>DPD (Schweiz) AG</receiverName1> <receiverName2>Depot 0610</receiverName2> <receiverName3></receiverName3> <receiverStreet>Bäumlimattstrasse 9</receiverStreet> <receiverCity>Möhlin</receiverCity> <receiverZipCode>4313</receiverZipCode> <receiverCountry>CH</receiverCountry> <receiverPhone>+44123456789</receiverPhone> <senderName1>DPD (Schweiz) AG</senderName1> <senderName2>Depot 0615</senderName2> <senderStreet>Mülibachstrasse 41</senderStreet> <senderZipCode>8107</senderZipCode> <senderCity>Buchs</senderCity> <senderCountry>CH</senderCountry> <countParcelsOfShipment>2</countParcelsOfShipment> <numberOfThisParcelInShipment>1</numberOfThisParcelInShipment> <weight>0.34</weight> <delisId>KD0815</delisId> <predictNotificationLanguage>EN</predictNotificationLanguage> <predictContactData>[email protected]</predictContactData> </urn:CreateLabelRequest> </soapenv:Body> </soapenv:Envelope>

http://localhost:8080/soap/labelprint.wsdl

http://localhost:8080/soap/


SOAP-Response: <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header/> <SOAP-ENV:Body> <ns3:CreateLabelResponse xmlns:ns3="urn:labelprintWs"> <success>true</success> <message>printed</message> <parcelNumber>06086021196034</parcelNumber> <labelId>839</labelId> <base64pdf>JVBERi[...]</base64pdf> </ns3:CreateLabelResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Für das Umwandeln des PDFs kann hier ebenso der Rest-Service mit der labelId aus der SOAP-Response verwendet werden.


6 Unterstützung und Support

Für weitere Fragen und technischen Support zu DPD LabelPrint wenden Sie sich bitte an unseren DPD IT BUSINESSdesk. Support- Zeiten: Mo bis FR zwischen 09:00 und 17:00 Uhr E-Mail: [email protected]

mailto:[email protected]

DPD LabelPrint Handbuch D · REST / SOAP 1 25 M Druckername T020 printer 2 14 C3 DPD...

Documents

Transcript of DPD LabelPrint Handbuch D · REST / SOAP 1 25 M Druckername T020 printer 2 14 C3 DPD...