Spezifikation DPD. Modul Rückholauftrag Gültig für Paketversender in Österreich. Version 3.3

Transkript

1 Spezifikation DPD Modul Rückholauftrag Gültig für Paketversender in Österreich Version 3.3

2 1 Inhaltsverzeichnis 1 Inhaltsverzeichnis Versionshistorie Allgemein Produktbeschreibung Prozedere Auftragsdatenimportformat Inhouse-Format Auftragsdatenblock Einschränkungen Auftragsdatenblock XML-Format Elemente Auftragsdatenimportformat DPD Rückholauftrag XML Beispieldatei DPD Rückholauftrag Grenzwerte und sonstige Größen Versionshistorie Tabelle 1 Versionshistorie Ab Version Änderungen 2.2 Keine Änderungen 2.5 Kapitel: Auftragsdatenblock Ergänzung des Abholdatums Kapitel: 4.2 XML-Format Tippfehler korrigiert (rdatum -> adatum) Kapitel: 4.3 Grenzwerte und sonstige Größen erstellt Kapitel: Elemente Auftragsdatenimportformat DPD Rückholauftrag Anpassung an Datensatzaufbauversion Kapitel: Auftragsdatenblock Korrekturen in der Spalte Beschreibung Ergänzung der Felder Abholadresse-Kontaktperson, Abholadresse-Telefon und Abholadresse-Bemerkung Zeile 1 Umbenennung des Feldes Bemerkung in Empfänger-Bemerkung- Kapitel: Einschränkungen Auftragsdatenblock Ergänzung Hinweis, dass Empfänger-Bemerkung- nicht verarbeitet wird Kapitel: 4.2 XML-Format Ergänzung der Felder akontakt, atelefon und abem1 in der Beschreibung und im Beispiel Anpassung an Datensatzaufbauversion Anpassung an Datensatzaufbauversion 23 Kapitel: Auftragsdatenblock Einbau Abholadresse- , Empfänger-Telefon und Empfänger- Datensatzlänge der Abhol- u. Empfängeradressen angepasst. Bemerkungsfeld in Itemlist umgewandelt. Kapitel 4.2.1Elemente Auftragsdatenimportformat DPD Rückholauftrag Einbau Abholadresse- , Empfänger-Telefon und Empfänger- Datensatzlänge der Abhol- u. Empfängeradressen angepasst. Bemerkungsfeld in Itemlist umgewandelt. Kapitel: Einschränkungen Auftragsdatenblock Einschränkungen -Adressen, Einschränkung Abholadresse Kontaktperson, Datensatzlänge der Abhol- u. Empfängeradressen angepasst. Bemerkungsfeld in Itemlist umgewandelt. Kapitel 4.3 Grenzwerte und sonstige Größen Länderspezifische Besonderheiten hinzugefügt Anpassung an Datensatzaufbauversion Anpassung an Datensatzaufbauversion 33 Seite 2 von 7

3 3 Allgemein Das vorliegende Dokument stellt eine Ergänzung zum Dokument Spezifikation DPD und primetime Paketversand Gültig für Paketversender in Österreich (im Folgenden Hauptdokument genannt) dar, spezifiziert die Zusatzleistung Sendungsversand im Detail und hat nur in Zusammenwirkung mit diesem Dokument in der gleichen Version Gültigkeit. Wenn Sie die hier beschriebene Zusatzleistung mit anderen Zusatzleistungen kombinieren wollen halten Sie bitte Rücksprache mit Ihrem zuständigen Versanddepot, um die Gültigkeit der Kombination zu hinterfragen. 3.1 Produktbeschreibung DPD bietet für versendende Kunden die Möglichkeit einzelne Pakete von beliebigen Adressen abzuholen und an eine andere Adresse lt. Auftrag zuzustellen. Die Abholstelle muss lediglich dafür sorgen, dass das Paket transportsicher verpackt zur Abholung bereit steht. Die Abholung erfolgt im Regelfall einen Werktag nach der Beauftragung. Die Zustellung erfolgt in Abhängigkeit von Abhol- und Zustelladresse am nächsten, oder nach wenigen Werktagen. 3.2 Prozedere Der DPD Rückholauftrag ist nicht an den Paketversand gebunden. Der Auftraggeber gibt den Auftrag zur Rückholung. DPD erstellt einen entsprechenden Rückholschein, der mit einem selbstklebenden Zustelletikett versehen ist. Das abgeholte Paket wird vom abholenden DPD Mitarbeiter mit dem Etikett versandfertig gemacht und am selben Tag im zuständigen Depot in das DPD System eingeschleust. Der Auftraggeber erhält das Paket (innerhalb Österreichs) am zweiten Werktag nach Erteilung des Auftrags zugestellt. Die Zuordnung der Pakete im Eingang ist über eine Referenznummer möglich, die mit dem Rückholauftrag angegeben wurde und als Barcode und in Klarschrift am Zustelletikett angedruckt wird. Generell gilt, dass DPD nur die beauftragte Anzahl an Paketen an der Abholstelle übernimmt. Seite 3 von 7

4 4 Auftragsdatenimportformat Die Beauftragung eines Rückholauftrags erfolgt elektronisch durch die Übergabe eines entsprechenden Auftragssatzes im Auftragsdatenblock. 4.1 Inhouse-Format Auftragsdatenblock Tabelle 2 - Auftragsdatenblock Feldname Format Querverweis Option Abhängigkeit Beschreibung Beispiel Satzart A(3) MUSS Fix Auftragsart A(2..3) MUSS Fix RH RH Referenznummern Lieferschein- oder Auftragsnr. Itemlist(A(1..20))0..10 Kapitel KANN Refernznummer(n) des Pakets z.b.: A123~A124 Abholadresse A(1..35) MUSS Erste Abholadresse-Anschriftszeile Zeile 1 Fa. Huber Abholadresse A(1..35) KANN Zweite Abholadresse-Anschriftszeile Zeile 2 GesmbH Abholadresse A(1..35) Kapitel KANN Dritte Abhladresse-Anschriftszeile Zeile 3 Export Abholadresse A(1..35) Kapitel KANN Vierte Abholadresse-Anschriftszeile Zeile 4 Abholadresse Strasse A(1..35) KANN Abholadresse Strasse inkl. Hausnummer Beispielg. 1 Abholadresse A(2) Kapitel 4.3 MUSS Abholadresse-Ländercode Land DE Abholadresse A(1..9) Kapitel MUSS Abholadresse-Postleitzahl PLZ Abholadresse-Ort A(1..25) MUSS Abholadresse-Ort München Abholadresse- A(1..30) KANN Abholadresse-Region Region Abholadresse- A(1..30) KANN Abholadresse-Kontaktperson Kontaktperson Hr. Huber Abholadresse- Telefon A(1..30) KANN Abholadresse-Telefonnummer Abholadresse-E- Mail Itemlist(A(1..40))1..5 Kapitel KANN office@hub er.de Abholadresse- bemerkung- Itemlist(A(1..30))0..2 Kapitel Kapitel 4.3 KANN Abholadresse-Bemerkungszeile h und 14-17h~Blabla Empfänger- A(1..35) MUSS Erste Empfänger-Anschriftszeile Adresse Zeile 1 Fa. Meier Empfänger- A(1..35) KANN Zweite Empfänger-Anschriftszeile Adresse Zeile 2 GesmbH Empfänger- A(1..35) KANN Dritte Empfänger-Anschriftszeile Adresse Zeile 3 Einkauf Empfänger- A(1..35) KANN Vierte Empfänger-Anschriftszeile Adresse Zeile 4 Hr. Müller Empfänger- A(1..35) KANN Empfänger Strasse inkl. Hausnummer Strasse Teststr. 1 Empfänger-Land A(2) MUSS Empfänger-Ländercode AT Empfänger-PLZ A(1..9) Kapitel MUSS Empfänger-Postleitzahl 5020 Empfänger-Ort A(1..25) MUSS Empfänger-Ort Salzburg Empfängeradresse-Region A(1..30) KANN Region Empfänger- Telefonnummer A(1..30) MUSS Internationales Format Empfänger-E- Mail Itemlist(A(1..40))1..5 Kapitel KANN office@mei er.at Empfänger- Itemlist(A(1..30))0..2 Kapitel KANN Empfänger-Bemerkungszeile 1 Bemerkung- Paketanzahl N(3) MUSS Anzahl der abzuholenden Pakete 3 Abholdatum Y(4)M(2)D(2) Kapitel 4.3 KANN Abholdatum Beispiel: (Achtung: Aus Platzgründen dreizeilig dargestellt Korrekt wäre eine Zeile!) 212 RH A123~A124 Fa. Huber GesmbH Export Beispielg. 1 DE München Hr. Huber office@huber.de 8-12h und 14-17h~Blabla Fa. Meier GesmbH Einkauf Hr. Müller Teststr. 1 AT 5020 Salzburg office@meier.at Blabla Seite 4 von 7

5 4.1.2 Einschränkungen Auftragsdatenblock Die vorliegende Dokumentation des Auftragsdatenblockes enthält einige Felder die aktuell von unseren Übernahmeprogrammen noch nicht, oder nur eingeschränkt verarbeitet werden können, trotzdem aber für die zukünftige Verwendung vorgesehen wurden. Tabelle 3 - Einschränkung Auftragsdatenblock Feldname Format Einschränkung Referenznummern Itemlist(A(1..20))0..1 Derzeit wird nur die erste Referenznummer in die Datenbank übernommen Abholadresse A(1..35) Wird derzeit nur national verarbeitet. Zeile 3 Abholadresse A(1..35) Die Abhol- Adresse Zeile 4 wird derzeit nicht in die Datenbank übernommen Zeile 4 Abholadresse A(1..9) Aktuell werden lediglich maximal die ersten 7 Stellen der Postleitzahlen verarbeitet. PLZ Abholadresse-E- Itemlist(A(1..40))1..5 Aktuell wird nur die erste -Adresse verarbeitet. Mail Abholadresse- A(1..30) Wird derzeit nicht in die Datenbank übernommen. Region Abholadresse- A(1..30) Wird derzeit nur national verarbeitet. Kontaktperson Abholadresse- Itemlist(A(1..35))0..2 Bei internationalen Aufträgen wird nur der Inhalt des ersten Items (Bemerkungszeile1) angedruckt. Bemerkung- Empfänger- A(1..35) Wird derzeit nur national verarbeitet. Adresse Zeile 3 Empfänger- A(1..35) Die Empfänger Adresse Zeile 4 wird derzeit nicht in die Datenbank übernommen Adresse Zeile 4 Empfänger-PLZ A(1..9) Aktuell werden lediglich maximal die ersten 7 Stellen der Postleitzahlen verarbeitet. Empfänger- Itemlist(A(1..40))1..5 Aktuell wird nur die erste -Adresse verarbeitet. Empfänger- Bemerkung- Itemlist(A(1..30))0..2 Wird derzeit nicht verwendet 4.2 XML-Format Elemente Auftragsdatenimportformat DPD Rückholauftrag Tabelle 4 - Elemente Auftragsdatenformat DPD Rückholauftrag Elementname Entsprechung od. Definition Ebene Bemerkung order 1 Dokumentelement laufnr N(1..3) 2 Lfd. Nummerierung der XML-Dokumente innerhalb eines Tages version Versionsnummer (Startblock) 2 Datenaufbauversion id 2 Schließt die Elemente ein, die im Identifikationsdatenblock angeführt sind erstell Erstell-Zeitpunkt (Identifikationsdatenblock) 3 kunde 3 Schließt Elemente ein, die den Kunden beschreiben kdepot Kunden-Depot (Identifikationdatenblock) 4 knr Kunden-Nr (Identifikationsdatenblock) 4 kname Kunden-Name (Identifikationsdatenblock) 4 k 4 Schließt Kunden- -Adressen ein k 1 Kunden- 1 (Identifikationsdatenblock) 5 k 2 Kunden- 2 (Identifikationsdatenblock) 5 k 3 Kunden- 3 (Identifikationsdatenblock) 5 k 4 Kunden- 4 (Identifikationsdatenblock) 5 k 5 Kunden- 5 (Identifikationsdatenblock) 5 rmeld Rückmelde-Modus (Identifikationsdatenblock) 3 auftrag 2 Schließt Elemente ein, die im Auftragsdatenblock angeführt sind auftragsid Eindeutige Kennung des Auftrags im Datensatz 3 Dient zur Zuordnung des Verarbeitungsprotokolls auftragsart Auftragsart (Auftragsdatenblock) 3 adatum Abholdatum (Auftragsdatenblock) 3 referenz 3 Schließt die bis zu 10 Referenznummern ein ref1 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 1 ref2 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 2 ref3 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 3 ref4 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 4 ref5 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 5 ref6 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 6 ref7 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 7 ref8 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 8 ref9 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 9 ref10 Referenz-nummern (Auftragsdatenblock) 4 Referenznummer 10 abh 3 Schließt Elemente ein, die die Abholadresse beschreiben azeile1 Abholadresse Zeile 1 (Auftragsdatenblock) 4 azeile2 Abholadresse Zeile 2 (Auftragsdatenblock) 4 azeile3 Abholadresse Zeile 3 (Auftragsdatenblock) 4 azeile4 Abholadresse Zeile 4 (Auftragsdatenblock) 4 astrasse Abholadresse Strasse (Auftragsdatenblock) 4 Seite 5 von 7

6 aland Abholadresse Land (Auftragsdatenblock) 4 aplz Abholadresse PLZ (Auftragsdatenblock) 4 aort Abholadresse Ort (Auftragsdatenblock) 4 aregion Abholadresse-Region (Auftragsdatenblock) 4 akontakt Abholadresse-Kontaktperson(Auftragsdatenblock) 4 atelefon Abholadresse-Telefonnummer(Auftragsdatenblock) 4 a 4 Schließt Abholadresse - -Adressen ein a 1 Abholadresse- 1 (Auftragsdatenblock) 5 a 2 Abholadresse - 2 (Auftragsdatenblock) 5 a 3 Abholadresse - 3 (Auftragsdatenblock) 5 a 4 Abholadresse - 4 (Auftragsdatenblock) 5 a 5 Abholadresse - 5 (Auftragsdatenblock) 5 abem 4 Schließt Abholadresse-Bemerkung ein abem1 Abholadresse-Bemerkung- 5 (Auftragsdatenblock) abem2 Abholadresse-Bemerkung-Zeile2 5 (Auftragsdatenblock) empf 3 Schließt Elemente ein, die den Empfänger beschreiben ezeile1 Empfänger-Adresse Zeile 1 (Auftragsdatenblock) 4 ezeile2 Empfänger-Adresse Zeile 2 (Auftragsdatenblock) 4 ezeile3 Empfänger-Adresse Zeile 3 (Auftragsdatenblock) 4 ezeile4 Empfänger-Adresse Zeile 4 (Auftragsdatenblock) 4 estrasse Empfänger-Strasse (Auftragsdatenblock) 4 eland Empfänger-Land (Auftragsdatenblock) 4 eplz Empfänger-PLZ (Auftragsdatenblock) 4 eort Empfänger-Ort (Auftragsdatenblock) 4 eregion Empfänger-Region (Auftragsdatenblock) 4 etel Empfänger-Telefonnummer (Auftragsdatenblock) 4 e 4 Schließt Empfänger- -Adressen ein e 1 Empfänger- 1 (Auftragsdatenblock) 5 e 2 Empfänger- 2 (Auftragsdatenblock) 5 e 3 Empfänger- 3 (Auftragsdatenblock) 5 e 4 Empfänger- 4 (Auftragsdatenblock) 5 e 5 Empfänger- 5 (Auftragsdatenblock) 5 ebem 4 Schließt Empfängeradresse-Bemerkung ein ebem1 Empfänger-Bemerkung- (Auftragsdatenblock) 5 ebem2 Empfänger-Bemerkung-Zeile2 (Auftragsdatenblock) 5 anzahl Paketanzahl (Auftragsdatenblock) XML Beispieldatei DPD Rückholauftrag Beispieldatei für eine Datei im XML-Auftragsdatenimportformat für einen DPD Rückholauftrag. <?xml version="1.0" encoding="iso "?> <order> <laufnr>1</laufnr> <version>33</version> <id> <erstell> </erstell> <kunde> <kdepot>0620</kdepot> <knr> </knr> <kname>huber GmbH</kname> <k > <k 1>abc@huber.at</k 1> <k 2/> <k 3/> <k 4/> <k 5/> </k > </kunde> <rmeld>1</rmeld> </id> <auftrag> <auftragsid>1</auftragsid> <auftragsart>rh</auftragsart> <adatum> </adatum> <referenz> <ref1>a123</ref1> <ref2>a124</ref2> <ref3/> <ref4/> <ref5/> <ref6/> <ref7/> <ref8/> <ref9/> <ref10/> <referenz> <abh> <azeile1>fa. Huber</azeile1> Seite 6 von 7

7 </abh> <empf> <azeile2>gesmbh</azeile2> <azeile3>export</azeile3> </azeile4> <astrasse>beispielg. 1</astrasse> <aland>de</aland> <aplz>80800</aplz> <aort>münchen</aort> <aregion/> <akontakt>hr. Huber</akontakt> <atelefon> </atelefon> <a > <a 2/> <a 3/> <a 4/> <a 5/> </a > <abem> <abem1>8-12h und 14-17h</<abem1> <abem2>blabla</<abem2> </abem> <ezeile1>fa. Meier</ezeile1> <ezeile2>gesmbh</ezeile2> <ezeile3>einkauf</ezeile3> <ezeile4>hr. Müller</ezeile4> <estrasse>teststr. 1</estrasse> <eland>at</eland> <eplz>5020</eplz> <eort>salzburg</eort> <eregion/> <etel> </etel> <e > <e 2/> <e 3/> <e 4/> <e 5/> </e > <ebem> <ebem1/> <ebem2/> </ebem> </empf> <anzahl>25</anzahl> </auftrag> </order> 4.3 Grenzwerte und sonstige Größen Sofern in der nachfolgenden Tabelle ein Listfeld (List) beschrieben wird werden die einzelnen Elemente der Liste in der vorgeschriebenen Reihenfolge in der Spalte Mögliche Werte zeilenweise angeführt. Feldname Mögliche Werte Beschreibung Abholdatum Leer, oder ein gültiges Abholdatum Wird das Feld leer gelassen, oder wird ein ungültiges, oder in der Vergangenheit liegendes Datum Abholadressebemerkung- Abholadresse Land = GB angegeben, erfolgt die Abholung am nächsten Werktag Nur das erste Item (30 Zeichen) der Abholadresse-bemerkung- kann an Großbritannien übergeben werden. Seite 7 von 7