Spezifikation DPD. Modul Abholauftrag Gültig für Paketversender in Österreich. Version 3.3.0

Transkript

1 Spezifikation DPD Modul Abholauftrag Gültig für Paketversender in Österreich Version 3.3.0

2 1 Inhaltsverzeichnis 1 Inhaltsverzeichnis Versionshistorie Allgemein Produktbeschreibung Prozedere Auftragsdatenimportformat Inhouse-Format Auftragsdatenblock Einschränkungen Auftragsdatenblock XML-Format Elemente Auftragsdatenimportformat DPD XML Beispieldatei DPD Abholauftrag Versionshistorie Tabelle 1 Versionshistorie Ab Version Änderungen 2.2 Keine Änderungen 2.5 Kapitel: Elemente Auftragsdatenimportformat DPD Anpassung an Datensatzaufbauversion Anpassung auf Datensatzaufbauversion Anpassung auf Datensatzaufbauversion 23 Kapitel: 4.1.1Auftragsdatenblock Ergänzung Telefonnummer und Datensatzlänge der Abholadressen angepasst. Bemerkungsfeld in Itemlist umgewandelt. Kontaktperson hinzugefügt. Kapitel: 4.2.1Elemente Auftragsdatenimportformat DPD Ergänzung Telefonnummer und Datensatzlänge der Abholadressen angepasst. Bemerkungsfeld in Itemlist umgewandelt. Kontaktperson hinzugefügt Anpassung an Datensatzaufbauversion Anpassung an Datensatzaufbauversion Anpassung an Datensatzaufbauversion 33 Seite 2 von 6

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 den Abholauftrag im Detail und hat nur in Zusammenwirkung mit diesem Dokument Gültigkeit. 3.1 Produktbeschreibung Je nach Regelmäßigkeit des Paketversands des Kunden bietet DPD die Möglichkeit die Paketabholung entweder zu definierten Tagen und Zeitpunkten zu vereinbaren, oder je nach Bedarf eine Abholung zu beauftragen. 3.2 Prozedere Wenn der Versender keine Vereinbarung zur regelmäßigen Abholung der Pakete mit DPD hat, muss einen Werktag vor der gewünschten Paketabholung ein Abholauftrag übermittelt werden. Die Übermittlung von Paketdaten allein löst keine Paketabholung aus. Der Abholauftrag muss als eigener Satz übergeben werden. Seite 3 von 6

4 4 Auftragsdatenimportformat Die Beauftragung eines Abholauftrags 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 DPD ABH Abholdatum Y(4)M(2)D(2) KANN Versanddatum (Datum der Übergabe an DPD) Abholadresse A(1..35) MUSS Erste Anschriftszeile Zeile 1 Fa. Meier Abholadresse A(1..35) KANN Zweite Abholadresse -Anschriftszeile Zeile 2 GesmbH Abholadresse A(1..35) Kapitel KANN Dritte Abholadresse -Anschriftszeile Zeile 3 Einkauf Abholadresse A(1..35) Kapitel KANN Vierte Abholadresse -Anschriftszeile Zeile 4 Abholadresse A(1..35) KANN Abholadresse Strasse inkl. Hausnummer Strasse Teststr. 1 Abholadresse A(2) MUSS Ländercode Land AT Abholadresse A(1..9) Kapitel MUSS Postleitzahl PLZ 5020 Ort A(1..25) MUSS Ort Salzburg A(1..30) KANN Region Region A(1..30) Kapitel KANN Kontaktperson Kontaktperson Hr. Müller Telefonnummer A(1..30) KANN Internationales Format E- Mail Itemlist(A(1..40))1..5 KANN office@mei er.at Abholadresse Itemlist(A(1..30))0..2 KANN Bemerkungstext Blabla1~Bl Bemerkungabla2 Zeile1 Paketanzahl N(3) MUSS Anzahl der abzuholenden Pakete 25 Tracking Nummern Itemlist(A(14))10 KANN Sind mehr als 10 Pakete abzuholen und wird die Übermittlung der Paketnummern gewünscht müssen mehrere Abholaufträge übergeben werden. Beispiel: (Achtung: Aus Platzgründen dreizeilig dargestellt Korrekt wäre eine Zeile!) ~ ~ ~~~~~~ ~~ 212 ABH Fa. Meier GesmbH Einkauf Teststr. 1 AT 5020 Salzburg Hr. Müller office@meier.at Blabla1~Blabla ~ ~ ~~~~~~~~ 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änkungen Auftragsdatenblock Feldname Format Einschränkung Abholadresse Zeile 3 Abholadresse Zeile 4 Abholadresse PLZ A(1..35) A(1..35) A(1..9) Wird derzeit nur national verarbeitet. Die Abholadresse Adresse Zeile 4 wird derzeit nicht in die Datenbank übernommen Aktuell werden lediglich maximal die ersten 7 Stellen der Postleitzahlen verarbeitet. Seite 4 von 6

5 Region E- Mail Kontaktperson Bemerkung- Zeile1 A(1..30) Itemlist(A(1..40))1..5 A(1..30) Itemlist(A(1..30))0..2 Die Region wird aktuell nicht in die Datenbank übernommen. Aktuell wird nur die erste -Adresse verarbeitet. Wird derzeit nur national verarbeitet. Bei internationalen Aufträgen wird nur der Inhalt des ersten Items (Bemerkungszeile1) angedruckt. 4.2 XML-Format Elemente Auftragsdatenimportformat DPD Die Spezifikationen der einzelnen Feldeinhalte entsprechen den Definitionen im Inhouse-Format. Tabelle 4 - Elemente Auftragsdatenformat DPD Abholauftrag 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 Abholdatumm (Auftragsdatenblock) 3 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 aland Abholadresse Land (Auftragsdatenblock) 4 aplz Abholadresse PLZ (Auftragsdatenblock) 4 aort Abholadresse Ort (Auftragsdatenblock) 4 aregion Abholadresse Region (Auftragsdatenblock) 4 akontakt Abholadresse Kontakt 4 atel Telefonnummer 4 a 4 Schließt -Adressen ein a 1 1 (Identifikationsdatenblock) 5 a 2 Abholadresse - 2 (Identifikationsdatenblock) 5 a 3 Abholadresse - 3 (Identifikationsdatenblock) 5 a 4 Abholadresse - 4 (Identifikationsdatenblock) 5 a 5 Abholadresse - 5 (Identifikationsdatenblock) 5 abem 4 Schließt Bemerkung ein abem1 Abholadresse Bemerkung-Zeile1 5 (Auftragsdatenblock) abem2 Abholadresse Bemerkung-Zeile1 5 (Auftragsdatenblock) anzahl Paketanzahl (Auftragsdatenblock) 3 pakete Tracking-Nummer (Auftragsdatenblock) 3 tracknr1 4 tracknr2 4 tracknr3 4 tracknr4 4 tracknr5 4 tracknr6 4 tracknr7 4 tracknr8 4 tracknr9 4 tracknr10 4 Seite 5 von 6

6 4.2.2 XML Beispieldatei DPD Abholauftrag Beispieldatei für eine Datei im XML-Auftragsdatenimportformat für einen DPD Abholauftrag. <?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 2/> <k 3/> <k 4/> <k 5/> </k > </kunde> <rmeld>1</rmeld> </id> <auftrag> <auftragsid>1</auftragsid> <auftragsart>abh</auftragsart> <adatum> </adatum> <abh> <azeile1>fa. Meier</azeile1> <azeile2>gesmbh</azeile2> <azeile3>einkauf</azeile3> <azeile4>hr. Müller</azeile7> <astrasse>teststr. 1</astrasse> <aland>at</aland> <aplz>5020</aplz> <aort>salzburg</aort> <aregion/> <atel> </atel> <a > <a 2/> <a 3/> <a 4/> <a 5/> </a > <abem> <abem1>blabla1</a 1> <abem2/> </abem> </abh> <anzahl>25</anzahl> <pakete> <tracknr1> </tracknr1> <tracknr2> </tracknr2> <tracknr3> </tracknr3> <tracknr4> </tracknr4> <tracknr5> </tracknr5> <tracknr6> </tracknr6> <tracknr7> </tracknr7> <tracknr8> </tracknr8> <tracknr9> </tracknr9> <tracknr10> </tracknr10> </pakete> </auftrag> </order> Seite 6 von 6