Spezifikation DPD. Modul B2C Gültig für Paketversender in Österreich. Version 3.3.1

Transkript

1 Spezifikation DPD Modul B2C Gültig für Paketversender in Österreich Version 3.3.1

2 1 Inhaltsverzeichnis 1 Inhaltsverzeichnis Versionshistorie Allgemein Produktbeschreibung Prozedere Versandzeitpunkt der Empfängerbenachrichtigung Kundenseitiger Paketschein ServiceCodes Selbstbucherliste Auftragsdatenimportformat Inhouse-Format Auftragsdatenblock XML-Format Elemente Auftragsdatenimportformat DPD XML Beispieldatei DPD Paket B2C mit FLEX XML Beispieldatei DPD Paket B2C mit FLEXD Versionshistorie Tabelle 1 Versionshistorie Ab Version Änderungen Erstellung Integration Flex Update auf Datensatzaufbauversionsnummer Anpassung an Datensatzaufbauversion Erstellung Kapitel 3.3 Versandzeitpunkt der Empfängerbenachrichtigung Überarbeitet Kapitel 6.1. Inhouse Format Überarbeitet Kapitel 6.2 XML-Format 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 das Service B2C im Detail und hat nur in Zusammenwirkung mit diesem Dokument Gültigkeit. 3.1 Produktbeschreibung DPD bietet für nationale Postleitzahlgebiete die Zustellung an Privatempfänger am nächsten Werktag an. B2C bietet standardisiert den Service FlexZustellung an. Der Service FlexZustellung sieht ein Terminaviso am Versandtag und ein Zustellaviso am Zustelltag an die dafür vorgesehene Empfängeradresse per und/oder SMS vor. 3.2 Prozedere Der Versender entscheidet beim Versand, dass die Zustelladresse ein Privatempfänger ist. Gemäß der im Hauptdokument beschriebenen Routenberechnung werden aufgrund des Servicecodes 327 die entsprechenden Inhalte für das Servicefeld, das Routenfeld und das Barcodefeld ermittelt und angedruckt. Für die geplante Empfängerbenachrichtigung ist im Auftragsdatenimportformat die Übergabe einer Mobiltelefonnummer, sowie einer -Adresse des Empfängers vorgesehen. 3.3 Versandzeitpunkt der Empfängerbenachrichtigung Sie haben die Möglichkeit in den Auftragsdaten zu bestimmen, zu welchem Ereignis die Empfängerbenachrichtigung an den Paketempfänger übermittelt werden soll. Der Standardprozess, der durch die Übergabe des Wertes FLEX beauftragt wird sieht die Scannung der Einrollung als Auslöser für die Benachrichtigung vor. Durch Übergabe des Wertes FLEXD wird bereits die Übertragung der Auftragsdaten als Auslöser für die Empfängerbenachrichtigung genutzt. Attribut4 FLEX FLEXD Versandzeitpunkt Einlangen des Pakets im Versanddepot Scannart Einrollung Einlangen der Auftragsdaten Seite 3 von 7

4 4 Kundenseitiger Paketschein Die Auswirkung auf die Felder Routenfeld und Barcodefeld des kundenseitigen Paketscheins bei Verwendung des Service B2C ergeben sich im Rahmen der Routenberechnung. Siehe Hauptdokument. 4.1 ServiceCodes Für das Service B2C finden Sie in der Tabelle SERVICE folgenden Service Code: ServiceCode Bemerkung 327 B2C Normalpaket Abb. 1 - DPD Paketschein B2C Normalpaket 5 Selbstbucherliste Die Dokumentation des Service B2C auf der Selbstbucherliste erfolgt durch Angabe des Servicetexts D- B2C in der Spalte Produkte. Außerdem wird in der Spalte Servicecode der Servicecode 327 angegeben. Seite 4 von 7

5 6 Auftragsdatenimportformat Der Aufbau des Auftragsdatenimportformats entspricht der Dokumentation für das DPD Normalpaket im Hauptdokument. Hier der Servicecode ist mit 327 zu befüllen. Für das Service FlexZustellung wird das Feld DPD Attribut4 herangezogen. Beispiele: (für SMS-Benachrichtigung) (für - Benachrichtigung) (für SMS- u. - Benachrichtigung) Werden 2 Mobiltelefonnummern, oder 2 -Adressen angegeben wird jeweils nur die erste angeführte Information verarbeitet. 6.1 Inhouse-Format Auftragsdatenblock Im folgenden Auszug aus dem Auftragsdatenblock DPD werden ausschließlich die vom Service B2C betroffenen Felder behandelt. Tabelle 2 - Auszug aus dem Auftragsdatenblock DPD Feldname Format Querverweis Option Abhängigkeit Beschreibung Beispiel ServiceCode N(3) MUSS ServiceCode aus dem Barcode 327 DPD Attribut4 List(A(4..5),A( )) KANN ServiceCode 327 Kontaktdaten SMS und/oder MAIL FLEX~ ,na me@domain.c om oder FLEXD~ ,n ame@domain. com Beispiel:... FLEX~ ,name@domain.com... FLEXD~ ,name@domain.com 6.2 XML-Format Elemente Auftragsdatenimportformat DPD Im folgenden Auszug aus der Auflistung der Elemente des Auftragsdatenimportformats DPD werden ausschließlich die vom Service B2C betroffenen Felder behandelt. Elementname Entsprechung od. Definition Ebene Bemerkung dpdattrib4 DPD Attribut4 (Auftragsdatenblock) 3 attrib4 A(4..5) 4 FLEX oder FLEXD kontakt_tel A(1..50) 4 Mobiltelefonnummer kontakt_mail A(1..50) 4 -Adresse Seite 5 von 7

6 6.2.2 XML Beispieldatei DPD Paket B2C mit FLEX Beispieldatei für eine Datei im XML-Auftragsdatenimportformat für ein DPD Paket mit dem Service B2C Normalpaket. <?xml version="1.0" encoding="iso "?> <order> <laufnr>1</laufnr> <version>33</version> <id> <erstell> </erstell> <kunde> <kdepot>0621</kdepot> <knr> </knr> <kname>huber GmbH</kname> <k > </k > </kunde> <rmeld>1</rmeld> </id> <auftrag> <auftragsid>1</auftragsid> <auftragsart>dpd</auftragsart> <service>327</service> <adatum> </adatum> <tracknr> </tracknr> <referenz> <ref1>a123</ref1> <ref2>b124</ref2> </referenz> <gewicht>4000</gewicht> <empf> <ezeile1>hr.maier Herbert</ezeile1> <ezeile2></ezeile2> <ezeile3></ezeile3> <estrasse>neue Strasse 25/2/1</estrasse> <eland>at</eland> <eplz>5020</eplz> <eort>salzburg</eort> <eregion/> <etel> </etel> <e > </e > <ebem> <ebem1>blabla1</ebem1> <ebem2>blabla2</ebem2> </ebem> </empf> <dpdattrib4> <attrib4>flex</attrib4> <kontakt_tel> </kontakt_tel> </dpdattrib4> </auftrag> </order> Seite 6 von 7

7 6.2.3 XML Beispieldatei DPD Paket B2C mit FLEXD Beispieldatei für eine Datei im XML-Auftragsdatenimportformat für ein DPD Paket mit dem Service B2C Normalpaket. <?xml version="1.0" encoding="iso "?> <order> <laufnr>1</laufnr> <version>33</version> <id> <erstell> </erstell> <kunde> <kdepot>0621</kdepot> <knr> </knr> <kname>huber GmbH</kname> <k > </k > </kunde> <rmeld>1</rmeld> </id> <auftrag> <auftragsid>1</auftragsid> <auftragsart>dpd</auftragsart> <service>327</service> <adatum> </adatum> <tracknr> </tracknr> <referenz> <ref1>a123</ref1> <ref2>b124</ref2> </referenz> <gewicht>4000</gewicht> <empf> <ezeile1>hr.maier Herbert</ezeile1> <ezeile2></ezeile2> <ezeile3></ezeile3> <estrasse>neue Strasse 25/2/1</estrasse> <eland>at</eland> <eplz>5020</eplz> <eort>salzburg</eort> <eregion/> <etel> </etel> <e > </e > <ebem> <ebem1>blabla1</ebem1> <ebem2>blabla2</ebem2> </ebem> </empf> <dpdattrib4> <attrib4>flexd</attrib4> <kontakt_tel> </kontakt_tel> </dpdattrib4> </auftrag> </order> Seite 7 von 7