Mailoptimizer 4 SOAP Extern

Transkript

1 Mailoptimizer 4 SOAP Extern Externe Datenübertragung an AM.portal Stand: Die Software der Deutschen Post für DV-Freimachung.

2 Inhaltsverzeichnis Inhaltsverzeichnis 1. Einleitung Handbuchhinweise Benutzungshinweise Team Mailoptimizer 5 2. Funktionsweise 6 3. Installation und Einrichtung Einrichtung auf Rechner Mailoptimizer Einrichtung auf externem Rechner Konfiguration von Soap Extern 7 4. Datenaustausch Rückmeldungen von AM 8 5. Logdateien Ordner von Logdateien Logdateien auf Rechner Mailoptimizer 9 6. AM Nachrichten Links und Glossar Abkürzungen Abbildungsverzeichnis Tabellenverzeichnis Index 15 2

3 Kapitel 1 - Einleitung 1. Einleitung Der Mailoptimizer ist die Software zur DV-Freimachung der Deutschen Post AG, die Ihre Versandvorbereitung maximal vereinfacht und beschleunigt. Die Software ermittelt für Sie Sendungsarten, -mengen und -gewichte, berechnet die Entgelte, übernimmt die Freimachung und Sortierung der Sendungen, erstellt die nötigen Einlieferungsunterlagen und bereitet die ordnungsgemäße Abrechnung vor. Bitte beachten Sie, dass Ihnen die Deutsche Post AG ein Höchstmaß an Daten- und Anwendungssicherheit bieten möchte. Deshalb ist diese Software so konzipiert, dass alle unwiderruflichen Vorgänge durch eine Sicherheitsabfrage bestätigt werden müssen, bevor die von Ihnen gewünschte Aktion durchgeführt werden kann. Darüber hinaus ist die Nutzung der Software nur mit einer Kunden-ID, einem Benutzernamen und einem Kennwort möglich. Änderungen in den Postbestimmungen können dazu führen, dass Tarife und Teile der in diesem Handbuch aufgelisteten Prüfkriterien ihre Gültigkeit verlieren und/oder ergänzt werden. Verbindlich sind deshalb nur die aktuellen Allgemeinen Geschäftsbedingungen der Deutschen Post AG. Detaillierte Informationen zu einzelnen Postbestimmungen finden Sie unter anderem im Internet: (Alle Produkte A-Z). Funktionsweise des Mailoptimizer: Abbildung 1-1 Einleitung > Funktionsweise des Mailoptimizer 3

4 Kapitel 1 - Einleitung 1.1 Handbuchhinweise Der Mailoptimizer unterliegt einer permanenten Pflege und Qualitätssicherung. Dadurch gewährleistet die Deutsche Post DHL Group die bestmögliche Funktionsfähigkeit jedes Releases. Sie erhalten dann die jeweils neueste Fassung als Classic Kunde mit dem nächsten Update. Für Online Kunden werden Updates automatisch zur Verfügung gestellt. Soweit Übersetzungen dieses Dokumentes für Dienstleister, Hersteller, Softwarefirmen etc. auch in anderen Sprachen zur Verfügung gestellt werden, ist immer die Version in deutscher Sprache maßgeblich und bei Verweis auf bzw. bei Einbeziehung dieses Dokument in die Verträge Grundlage für die vertragliche Vereinbarung mit der Deutschen Post AG. Folgende Handbücher stehen Ihnen zur Verfügung: Für eine Übersicht der Software das Ablaufdiagramme Handbuch Für die Benutzung der Software das Benutzerhandbuch Für die Einrichtung der Software das Integrationshandbuch Für die Teilleistung (Verfahren 39) das Teilleistungshandbuch i Die in diesen Handbüchern verwendeten Firmen-, Marken- und Produktbezeichnungen sind gesetzlich geschützt und unterliegen dem Copyright des jeweiligen Rechteinhabers. Folgende Handbücher sind online verfügbar: Ablaufdiagramme und Leitfaden: Für die grafische Oberfläche: Für die Einrichtung: Für die Teilleistung (Verfahren 39): Sie finden die für Soap Extern relevanten Handbücher auch im Ordner..\SOAP Extern\Dokumentation\. 4

5 Kapitel 1 - Einleitung 1.2 Benutzungshinweise Das Symbol i markiert allgemeine Informationen Das Symbol! markiert sehr wichtige Informationen Datei- und Verzeichnisangaben sind in blau dargestellt Einträge in Kursiv sind im Indexverzeichnis aufgelistet. Orange Einträge beziehen sich auf die aktuelle Oberfläche Links sind orange und unterstrichen dargestellt XML-Tag Angaben sind hellgrau: <tag> Im Abbildungsverzeichnis finden Sie eine Übersicht aller Screenshots der Software. Für eine Schlagwortsuche benutzen Sie bitte die Auflistung Index am Ende dieses Handbuches. 1.3 Team Mailoptimizer Neben den Handbüchern stehen wir Ihnen selbstverständlich für weitere Fragen und Supportunterstützung gerne zur Verfügung: Hotline: mailoptimizer@deutschepost.de Bitte geben Sie in der Ihre Kontaktdaten für Rückfragen an. Telefon Mo-Fr, Uhr bis Uhr i Bitte richten Sie Anfragen für das Produkt Mailoptimizer immer direkt an das Team Mailoptimizer und nicht z.b. an den Vertrieb oder die DV Beratung, um unnötige Wartezeiten für Sie zu vermeiden. 5

6 Kapitel 2 - Funktionsweise 2. Funktionsweise Die durch den Mailoptimizer erzeugten Abrechnungsdaten werden per SOAP Schnittstelle an die Deutsche Post AG übermittelt. Soll der Rechner, auf dem der Mailoptimizer installiert ist, nicht kommunikationsfähig oder keine Kommunikation gewünscht sein (z.b. aus Gründen der Datensicherheit), so besteht die Möglichkeit, mittels dem optionalen Modul SOAP Extern die Datenübertragung von einem anderen Rechner mit Internetzugang aus durchzuführen. Die durch den Mailoptimizer erzeugten Dateien für die Übertragung werden manuell durch einen Datenträger, z.b. USB Stick, auf den externen Rechner kopiert und dann an das AM.portal übermittelt. Die vom AM.portal erhaltenen Antworten (Textdateien im XML Format) werden mit einem Datenträger zum Mailoptimizer Rechner übertragen. Für die Installation oder ein Update starten Sie die Datei MO_Installer_SoapExtern.exe. i Die Konfiguration für diesen Dienst wird in dem folgenden Kapitel Installation und Einrichtung beschrieben. 6

7 Kapitel 3 - Installation 3. Installation und Einrichtung Für die Funktion des optionalen Moduls SOAP Extern ist ein Rechner mit installiertem und funktionsbereitem Mailoptimizer und ein Rechner mit Internetzugang notwendig. Informationen über die Installation des Mailoptimizer entnehmen Sie bitte dem Integrationshandbuch. 3.1 Einrichtung auf Rechner Mailoptimizer Auf dem Rechner, auf dem der Mailoptimizer installiert wurde, aktivieren Sie im Menü Konfiguration > Optionen > Allgemein die Option SOAP Extern.! Anschließend ist der Dienst Mailoptimizer Apache Tomcat x.x neu zu starten. x.x = Version z.b Einrichtung auf externem Rechner Auf dem Rechner mit Internetanbindung muss zuerst Java installiert werden (mind. Version 1.8 Stand 09/2017). Informationen dazu siehe Installations- und Einrichtungsanleitung für Java: Für die Installation oder ein Update starten Sie die Datei MO_Installer_SoapExtern.exe. Nach der erfolgreichen Installation oder einem Update ist der Dienst Mailoptimizer SoapExtern vorhanden und aktiviert. 3.3 Konfiguration von Soap Extern Während der Installation können Sie die AM Zugangsdaten für SOAP (Senden der Daten an AM) und sftp für die Responses (Antworten von AM) für den Datenaustausch angeben. Sie können die Konfiguration auch nach einer Installation oder einem Update manuell mit einem Texteditor (z.b. Notepad von Windows) anpassen:..\soap Extern\Software\Konfiguration\moConfigSoapExtern.properties! Starten Sie nach einer Änderung der Konfigurationsdatei in der Diensteverwaltung von Windows den Dienst Mailoptimizer SoapExtern neu. Beachten Sie auch die Hinweise im Benutzerhandbuch das Kapitel Konfiguration > Optionen > SOAP / sftp. 7

8 Kapitel 4 - Datenaustausch 4. Datenaustausch Ist eine Verarbeitung (Optimierung und DV-Freimachung) im Mailoptimizer abgeschlossen, so werden die zu übertragenden Dateien (XML-Format) für das AM.portal auf dem Rechner Mailoptimizer in den folgenden Ordner..\win32app\Kunden\ geschrieben: Rechner mit Mailoptimizer Rechner mit SOAP Extern..\dpagam\Out_SoapExtern..\Soap Extern\dpagam\Out_SoapExtern Requests für createorder, changeorder und deleteorder für alle Produkte Vom Rechner mit Mailoptimizer sind die XML-Dateien jeweils aus dem Quellordner (linke Seite der obigen Auflistung) auf dem Rechner SOAP Extern (mit Internetzugang ) in den jeweils zugeordneten Ordner (rechte Seite der obigen Auflistung) zu kopieren. 4.1 Rückmeldungen von AM Für die korrekte Darstellung von geänderten Sendungen und durchgeführten Stornierungen findet mit dem Auftragsmanagement ein Datenaustausch statt. Um statistische Auswertungen und aktuelle Informationen für Änderungen oder Stornierungen von Aufträgen im Mailoptimizer korrekt anzuzeigen, ist rückwärts der Dateiaustausch folgender Verzeichnisse durchzuführen: Rechner mit SOAP Extern Rechner mit Mailoptimizer..\Soap Extern\dpagam\In..\win32app\Kunden\dpagam\In Responses für changeorder und deleteorder..\soap Extern\dpagam\Sicherung..\win32app\Kunden\dpagam\Sicherung Sicherungsdateien der Übertragungen an AM Diese Verzeichnisse werden in regelmäßigen Abständen durch den Dienst von dem Modul SOAP Extern gescannt und die darin befindlichen Dateien dann an das AM.portal der Deutschen Post AG übertragen. 8

9 Kapitel 5 - Logdateien 5. Logdateien In Logdateien werden wichtige Ereignisse und Fehlermeldungen hinterlegt. 5.1 Ordner von Logdateien Die Logdateien von SOAP Extern für eine Fehleranalyse liegen im Ordner:..\SOAP Extern\Software\Log\ 5.2 Logdateien auf Rechner Mailoptimizer Die Logdateien des Mailoptimizer für eine Fehleranalyse liegen im Ordner:..\win32app\Software\Log\ Beispiel für eine Logdatei: :14:29 Beginn der Verarbeitung :14:30 Das im Block 'dvfkopf' angegebene Einlieferungsdatum ist veraltet und wurde aktualisiert. Kontrakt: :14:30 1 Sendungen freigemacht :14:30 Sendungsbestimmung und -freimachung erfolgreich beendet :14:42 Entgeltabrechnung für EDI-CC : C:/win32app/dvf/dpagbrief/out/out_10000_10_ _soapextern_ _1001.xml wird bearbeitet. Datei für SOAPExtern wird vorbereitet :14:44 Datei für EDI-CC : C:/win32app/dvf/dpagbrief/out/out_10000_10_ _soapextern_ _1001.xml Externe Soapübertragung. Datei für SOAPExtern ist vorbereitet :14:32 Verfahren : 10 Eingangsdatei : _soapextern_ _1001.xml :14:32 Verfahren : 10 Die Entgeltabrechnung wurde erzeugt :14:41 Verfahren : 10 Die Entgeltabrechnung für das EDI-CC wurde konvertiert :14:41 Verfahren : 10 Die Entgeltabrechnung mit der Nachricht wurde erstellt. 9

10 Kapitel 6 - AM Nachrichten 6. AM Nachrichten Für eine Vereinbarung einer DV-Freimachung mit elektronischer Übermittlung der ermittelten Sendungsdaten an das AM.portal der Deutschen Post AG (AM = Auftragsmanagement) mittels AM.exchange (AM Protokoll SOAP) müssen die Zugangsdaten im Mailoptimizer einmalig eingerichtet werden. Informationen zu AM finden Sie online hier: AM Ordnerstruktur des Mailoptimizer Server: Alle angegebenen Ordner liegen im Stammverzeichnis..\win32app\Kunden\dpagam\: Create Order Out In Sicherung Request gesendet an AM..\Out_SoapExtern nicht verwendet..\sicherung Change Order Out In Sicherung Request gesendet an AM Response Antwort von AM..\Out_SoapExtern nicht verwendet..\sicherung nicht verwendet..\in..\sicherung Cancel Order Out In Sicherung Request gesendet an AM Response Antwort von AM Tabelle 6-1..\Out_SoapExtern nicht verwendet..\sicherung nicht verwendet..\in..\sicherung AM-Nachrichten Create / Change / Cancel Order Nach einer Optimierung und DV-Freimachung von Sendungen wird die Nachricht mit den Sendungsdaten aus der erzeugten Report-Datei (Abrechnungsdatei) abgeleitet und eine XML-Datei für die Übermittlung an AM als CreateOrder im Ordner..\win32app\Kunden\dpagam\Out_SoapExtern erzeugt. Eine Stornierung von einem Auftrag wird mittels CancelOrder an AM übermittelt; eine nachträgliche Änderung eines Auftrages z.b. der Einlieferungsstelle wird mittels ChangeOrder an AM übermittelt. 10

11 Kapitel 7 - Links und Glossar 7. Links und Glossar Links Thema Deutsche Post AG Java XML Link Mailoptimizer Tabelle 7-1 Externe Links Glossar Begriff Auftragsmanagement AM.exchange AM.portal Business to Business Sendungsart Erklärung Kommunikationsschnittstelle der Deutschen Post AG zum Erstellen, Ändern, Suchen und Löschen von Einlieferungsaufträgen. Die Kommunikation wird über das B2B-Datenprotokoll abgewickelt. Datenformat für das AM der Deutschen Post AG (B2B Protokoll) Die Internetanwendung AM.portal bietet Ihnen einen direkten Zugang zu aktuellen Informationen über alle Aufträge, die Sie im Datenformat AM.exchange an die Deutsche Post übertragen haben bidirektionaler Datenaustausch (B2B) mit dem Auftragsmanagement (AM) für Brief Deklariert das Produkt z.b. Standardbrief, Kompaktbrief Versandart Tabelle 7-2 Glossar Gibt die Sparte der Post an z.b. Brief 11

12 Kapitel 8 - Abkürzungen 8. Abkürzungen Abkürzung AG AGB AM ASCII CSV DP DPCom DV DVD DVF EDI-CC EHB EU FTP HB IHB LAN MOC SOAP TXT UPU XML ZA Tabelle 8-1 Beschreibung Aktiengesellschaft Allgemeine Geschäftsbedingungen Abrechnungs- und Auftragsmanagement der Deutschen Post AG American Standard Code for Information Interchange Comma Separated Values (Textformat mit Semikolon getrennt) Dialogpost Deutsche Post Com GmbH Datenverarbeitung Digital Video Disc / Digital Versatile Disc Datenverarbeitung Freimachung Electronic Data Interchange (Elektr. Datenaustausch) - Competence Center Entwicklerhandbuch Europa / Europäische Union File Transfer Protocol Handbuch Integrationshandbuch Local Area Network Mailoptimizer Classic Simple Object Access Protocol Textformat ohne Formatierungszeichen Union postale universelle (Weltpostverein) Extensible Markup Language (hierarchische aufgebaute Daten im Textformat) Zusatzauftrag für Teilleistungsaufträge Abkürzungen 12

13 Kapitel 9 - Abbildungsverzeichnis 9. Abbildungsverzeichnis Abbildung 1-1 Einleitung > Funktionsweise des Mailoptimizer

14 Kapitel 10 - Tabellenverzeichnis 10. Tabellenverzeichnis Tabelle 6-1 AM-Nachrichten Create / Change / Cancel Order Tabelle 7-1 Externe Links Tabelle 7-2 Glossar Tabelle 8-1 Abkürzungen

15 Kapitel Index 11. Index Abrechnungsdaten... 6 AM Zugangsdaten... 7 AM.exchange AM.portal... 6, 8, 10 Auftragsmanagement... 8 Auswertungen... 8 Benutzerhandbuch... 4 CancelOrder ChangeOrder CreateOrder Datenaustausch... 8 Datensicherheit... 6 Datenträger... 6 Datenübertragung... 6 Dienst... 7 DV-Freimachung... 8 EDI-CC... 9 Einlieferungsdatum... 9 Einlieferungsstelle Einrichtungsanleitung... 7 Entgeltabrechnung... 9 Ereignisse... 9 Fehleranalyse... 9 Fehlermeldungen... 9 Handbücher... 4 Hotline... 5 Installation... 7 Installationsanleitung... 7 Integrationshandbuch... 4 Internetzugang... 6 Java... 7 Konfigurationsdatei... 7 Logdatei... 9 Optimierung... 8 Release... 4 Sendungsbestimmung... 9 sftp... 7 SOAP... 6, 7, 10 Stornierung Stornierungen... 8 Support... 5 Übertragung... 6 Update... 7 Verarbeitung... 9 Verfahren... 9 XML Format

16 Deutsche Post AG Abt Frankierung Otto-Röhm-Straße Darmstadt Tel. : mailoptimizer@deutschepost.de