Spezifikation primetime Modul AVISO Gültig für Paketversender in Österreich Version 3.3.0
1 Inhaltsverzeichnis 1 Inhaltsverzeichnis... 2 2 Versionshistorie... 2 3 Allgemein... 3 3.1 Produktbeschreibung... 3 3.2 Prozedere... 3 4 Kundenseitiger Paketschein... 4 5 Selbstbucherliste... 4 6 Auftragsdatenimportformat... 5 6.1 Inhouse-Format... 5 6.1.1 Auftragsdatenblock... 5 6.2 XML-Format... 5 6.2.1 Elemente Auftragsdatenimportformat... 5 6.2.2 XML Beispieldatei primetime SMS-AVISO... 5 6.3 Grenzwerte und sonstige Größen... 7 2 Versionshistorie Tabelle 1 Versionshistorie Ab Version Änderungen 2.2 Keine Änderungen 2.5 Kapitel: 6.2 XML-Format Anpassung an Datensatzaufbauversion 21 2.8 Anpassung auf Datensatzaufbauversion 22 3.0 Anpassung auf Datensatzaufbauversion 23 Erweiterung des Service Aviso um die Funktion E-Mail 3.1.0 Anpassung an Datensatzaufbauversion 31 Ergänzung um pt-attribut 18 3.2.0 Anpassung an Datensatzaufbauversion 32 3.3.0 Anpassung an Datensatzaufbauversion 33 Seite 2 von 7
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 AVISO im Detail und hat nur in Zusammenwirkung mit diesem Dokument Gültigkeit. 3.1 Produktbeschreibung Primetime bietet als Zusatzservice ein AVISO per SMS und E-Mail an. Primetime versendet nach Verladung des Pakets in das Zustellfahrzeug am frühen Morgen der Zustellung eine SMS und/ oder eine E-Mail an die angegebene Mobiltelefonnummer bzw. E-Mail um dem Empfänger die Zustellung und das vorgesehene Zeitfenster zu avisieren. Es ist also möglich, dass der Empfänger eine SMS, eine E-Mail oder beides pro Paket zugeschickt bekommt (1 SMS und 1 E-Mail pro Paket). 3.2 Prozedere Beim Versand kennzeichnet der Versender das Paket mit den im Punkt 6 Auftragsdatenimportformat angeführten Kürzeln. Im Auftragsdatenblock des Auftragsdatenimportformats wird die Mobiltelefonnummer und/ oder die E-Mail Adresse angegeben. Seite 3 von 7
4 Kundenseitiger Paketschein Bei der Beauftragung eines AVISOS ist auf dem kundenseitigen Paketschein im Servicefeld der Text AVISO mit einer Mindesthöhe von 4mm anzudrucken. Aeußerlich nicht erkennbare Schaeden muessen primetime innerhalb von 6 Tagen nach Ablieferung schriftlich gemeldet werden. / Notification on damage which is not recognisable from the outside has to be submitted to primetime within 6 days in writing. Fa. Meier GmbH & Co. KG Dispositionsabteilung Neue Strasse 25 Halle C, Block 1 AT-5020 Salzburg Referenznummer 1: Auftragsnummer 2: ABCDEFGHIJKLMNOPQRSTUV WXYZABCD 123456789012345678901234567 890 Lieferung 1 / 2 Gewicht 12,22 kg Delivery Address: Sender: DPD Depot 638 Litfaßstrasse 8 A-1030 Wien primetime primetime primetime AVISO Service Werktag 17:00 Direct Parcel Distribution Austria GmbH Depot 638 Litfaßstrasse 8 A 1030 Wien Telefon: +43-(0) 1 76031-100 Fax: +43-(0) 1 76031-290 0621 9912 3456 78D PM2 Track Service AT-0634 P055 0008 812 AT - 05020 04/07/05 18:56 07/05 0163/99 Versandstation 0005 020 0621 9912 3456 78 812 040 9 Abbildung 1 - primetime Paketschein PM2 mit AVISO 5 Selbstbucherliste Eine Kennzeichnung des AVISOS auf der Selbstbucherliste erfolgt durch den zusätzlichen Andruck des Servicetextes AVISO in der Spalte Produkte. In der Spalte Servicecode wird der Servicecode des verwendeten Zustellservices angegeben. Seite 4 von 7
6 Auftragsdatenimportformat Für das Empfänger-Aviso wird das Feld primetime-attribut5 herangezogen. Beispiele: +4369912345678 (für SMS-Aviso) name@domain.com (für E-Mail-Aviso) +4369912345678,name@domain.com (für SMS- u. E-Mail-Aviso) 6.1 Inhouse-Format 6.1.1 Auftragsdatenblock Tabelle 2 Auszug aus dem Auftragsdatenblock primetime Feldname Format Querverweis Option Abhängigkeit Beschreibung Beispiel primetime- Attribut5 List(A(5),A(1..43)) KANN Avisoart SMS und/ oder MAIL AVISO~+436 9912345678,name@doma in.com 6.2 XML-Format 6.2.1 Elemente Auftragsdatenimportformat Tabelle 3 - Elemente Auftragsdatenformat primetime Elementname Entsprechung od. Definition Ebene Bemerkung attrib5 A(5) 4 fix AVISO aviso A(1..43) 4 Avisodetail (Mobil-Telefonnummer und/ oder E-Mail) 6.2.2 XML Beispieldatei primetime SMS-AVISO Beispieldatei für eine Datei im XML-Auftragsdatenimportformat für ein primetime Standardpaket (PM2) mit Service AVISO. <?xml version="1.0" encoding="iso-8859-1"?> <order> <laufnr>1</laufnr> <version>33</version> <id> <erstell>200608011659</erstell> <kunde> <kdepot>0620</kdepot> <knr>1234567</knr> <kname>huber GmbH</kname> <kemail> <kemail1>abc@huber.at</kemail1> <kemail2/> <kemail3/> <kemail4/> <kemail5/> </kemail> </kunde> <rmeld>1</rmeld> </id> <auftrag> <auftragsid>1</auftragsid> <auftragsart>pt</auftragsart> <service>812</service> <adatum>20060801</adatum> <track>06201234567890</track> Seite 5 von 7
<referenz> <ref1>a123</ref1> <ref2>a124</ref2> <ref3/> <ref4/> <ref5/> <ref6/> <ref7/> <ref8/> <ref9/> <ref10/> </referenz> <gewicht>31500</gewicht> <empf> <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/> <eemail> <eemail1>office@meier.at</eemail1> <eemail2/> <eemail3/> <eemail4/> <eemail5/> </eemail> <ebem> <ebem1>blabla1</<ebem1> <ebem2>blabla2</<ebem2> </ebem> </empf> <ptattrib1> <von>1700</von> <bis/> </ptattrib1> <ptattrib2/> <ptattrib3/> <ptattrib4/> <ptattrib5> <attrib5>aviso</attrib5> <aviso>+4369912345678,name@domain.com</aviso> </ptattrib5> <ptattrib6/> <ptattrib7/> <ptattrib8/> <ptattrib9/> <ptattrib10/> <ptattrib11/> <ptattrib12/> <ptattrib13/> <ptattrib14/> <ptattrib15/> <ptattrib16/> <ptattrib17/> <ptattrib18/> </auftrag> </order> Seite 6 von 7
6.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 primetime-attribut5 AVISO Telefonnummer und/ oder E-Mail fix AVISO für SMS- und/ oder Mail-AVISO internationale Mobiltelefonnummer (Führendes + bzw. 00, Vorwahl ohne 0, Telefonnummer ohne Leerzeichen), SMS-Aviso werden nur national (+43 oder 0043 ) zugestellt Die Gesamtlänge für SMS-Rufnummer und/oder E-Mail-Adresse darf 43 Zeichen nicht überschreiten. etel Leer, nicht befüllt. Weiters darf das Feld Empfänger-Telefonnummer bei Zusatzservice AVISO nicht gefüllt sein, da dieses Feld in der Auftragsdatenbank für die Ablage der AVISO-Daten benutzt wird. Ist dieses Feld dennoch gefüllt, wird dessen Inhalt durch die AVISO-Daten überschrieben. Seite 7 von 7