DHL Mailoptimizer
- Stefan Bleilevens
- Bernhard Becker
In Kombination mit dem Modul "Mailing-Artikel" kann die automatische Portooptimierung und -aufbereitung über einen DHL Mailoptimizer genutzt werden. Hierzu kann entweder eine von der Print Lounge angebotene und freigeschaltete oder eine vollständig eigenständige Instanz gewählt werden.
DHL Mailoptimizer der Deutschen Post
Weitere Informationen zum DHL Mailoptimizer erhalten Sie direkt bei der Deutschen Post: https://www.deutschepost.de/de/m/mailoptimizer.html
Konfiguration
Die grundlegende Konfiguration der Schnittstelle erfolgt innerhalb der Add-on-Einstellungen in der Administration der Print Lounge unter Add-ons → Mailing-Artikel. Hier kann für jeden einzelnen Shop eine eigene Konfiguration in Bezug auf die Schnittstelle als solche, die Meta-Informationen sowie die Transfereinstellungen hinterlegt werden:
DHL-Einstellungen
| Einstellung | Beschreibung |
|---|---|
| Präfix für Eingangsdatei | Dieser Präfix wird für die übertragene Ein- und Ausgangsdatei genutzt. |
| Kunden-ID | 5-stellige Kunden-ID der Deutschen Post |
| Funktion | Verarbeitungsmodus des Mailoptimizers |
| Funktion (nach Bestellabschluss) | Verarbeitungsmodus des Mailoptimizers nach Abschluss einer Bestellung (optional; falls diese Option nicht ausgefüllt wird, wird die Einstellung "Funktion" verwendet) |
| Optimierung | Brutto- / Netto-Optimierung |
| EKP-Nummer | EKP-Nummer der Deutschen Post |
| Postleitzahlenprüfung aktivieren | Prüfung auf gültige PLZ aktivieren (wenn diese Option deaktiviert ist, werden auch ungültige PLZ-Angaben verarbeitet) |
| DMC als Image erzeugen | |
| Datamatrix |
Transfereinstellungen
Sofern ein eigener Server verwendet wird, können alle FTP-Verbindungsdaten hinterlegt werden (inklusive Passiv-Modus und SFTP mit Passwort). Wird eine vordefinierte Verbindung genutzt, kann lediglich ein abweichender Ein- und Ausgangsordner eingetragen werden (sofern vom Anbieter mitgeteilt).
Kontrakte
Alle Kontrakte, die bei der Portooptimierung eingesetzt werden sollen, können innerhalb der Moduleinstellungen hinterlegt werden. Hierbei stehen folgende Kontraktarten zur Verfügung:
- Brief-Kontrakte (<brief>)
- Dialogpost-Kontrakte (<dialogpost>)
- DHL-Kontrakte (<dhl>)
Abhängig von der gewünschten Kontraktart stehen für jeden Kontrakt weitere Parameter zur Verfügung:
| Einstellung | Tag in Eingangsdatei | Beschreibung |
|---|---|---|
| Internes Kontraktkürzel | Eine ausschließlich interne Beschreibung, die im Backend der PRINT LOUNGE angezeigt wird. | |
| Kontraktart | ||
| EKP-Nummer | ekpnr | EKP-Nummer des Kontraktes. |
| Verfahren | verfahren | Verfahrenskennung des Kontraktes. |
| Zusätzliche Angaben für Brief-Kontrakte | ||
| Teilnahme | teilnahme | Teilnahmekennung des Kontraktes (die letzten zwei Stellen der 14-stelligen Kundenabrechnungsnummer). |
| Buchungstext | buchungstext | Zusätzlich zu anderen Angaben erscheint dieser Buchungstext auf der späteren Postrechnung zur Einlieferung. Innerhalb dieses Tags können alle zur Verfügung stehenden Kontraktinformationen genutzt werden. |
| Einlieferung | einlieferung | Art der Einlieferung, mögliche Werte: Versandplan Matrixplan |
| Infrastrukturrabatt | infrastrukturrabatt | Die Nutzung eines Infrastrukturrabattes wird aktiviert oder deaktiviert. |
| Produktionsbezeichnung | produktionsbezeichnung | Kundenindividuelle Angabe auf dem Einlieferungsbeleg. Innerhalb dieses Tags können alle zur Verfügung stehenden Kontraktinformationen genutzt werden. |
| Zusätzliche Angaben für Dialogpost-Kontrakte | ||
| Teilnahme | teilnahme | Teilnahmekennung des Kontraktes (die letzten zwei Stellen der 14-stelligen Kundenabrechnungsnummer). |
| Automation | automation | Automationsfähigkeit der Sendung vermerken bzw. nicht vermerken. |
| Buchungstext | buchungstext | Zusätzlich zu anderen Angaben erscheint dieser Buchungstext auf der späteren Postrechnung zur Einlieferung. Innerhalb dieses Tags können alle zur Verfügung stehenden Kontraktinformationen genutzt werden. |
| Fertigungsmuster-ID | fertigungsmuster → id | Verweis auf ein in den Stammdaten angelegtes Dialogpost-Fertigungsmuster für Sendungsangaben. |
| Produktionsbezeichnung | produktionsbezeichnung | Kundenindividuelle Angabe auf dem Einlieferungsbeleg. Innerhalb dieses Tags können alle zur Verfügung stehenden Kontraktinformationen genutzt werden. |
| TrackMatch | trackmatch | Track & Match aktivieren bzw. deaktivieren. |
| Werblich | werblich | Werblichen Inhalt der Sendungen vermerken bzw. nicht vermerken. |
Verfügbare Kontraktinformationen
| Variable | Beschreibung |
|---|---|
| type | "brief", "dialogpost" oder "dhl" |
| short | Vertragskürzel |
| postingDate | Einlieferungsdatum |
| ekpNumber | EKP-Nummer |
| procedure | Verarbeitung |
| participation | Teilnahme |
Kontraktinformationen können innerhalb der gekennzeichneten Variablen mit der Smarty-Syntax ausgegeben werden (beispielsweise {$contract->short}).
Nutzung von Kontrakten innerhalb eines Mailings
Wurden Mailingartikel und Kontrakte angelegt, können für jeden Mailingartikel individuelle Kontrakte verwendet werden. Ist einem Artikel kein Kontrakt zugewiesen, werden standardmäßig alle Kontrakte des jeweiligen Shops genutzt. Ist eine Zuweisung hinterlegt, werden nur die entsprechenden Kontrakte angewendet. Diese Einstellung kann direkt in den Artikeleinstellungen vorgenommen werden. Darüber hinaus muss hier auch die Sendungsart des Artikels angegeben werden:
Beschreibung des Workflows
Beginnt der Benutzer im Frontend mit der Konfiguration eines Mailings, kann er wie gewohnt sämtliche dynamischen Optionen und die Adressauswahl vornehmen. Innerhalb der Adressauswahl kann dann der Prozess der Portooptimierung durch einen Klick auf "Porto optimieren" angestoßen werden, wodurch die sogenannte Eingangsdatei an den hinterlegten Mailoptimizer-Server gesendet wird. War die Übertragung erfolgreich, erhält der Benutzer die Information, dass die Sendungsinformationen übertragen wurden und die Datei verarbeitet wird. Der Prozess wird automatisch fortgesetzt, sobald der verarbeitende Server eine entsprechende Rückmeldung an die Print Lounge gesendet hat und die erzeugte Ausgangsdatei abgeholt werden kann. Solange keine Ausgangsdatei vorhanden ist, kann der Prozess nicht fortgesetzt werden (keine Personalisierung und Bestellung möglich).
Rückmeldung zur Erzeugung der Ausgangsdatei
Da die Verarbeitung innerhalb des Mailoptimizers einige Zeit in Anspruch nehmen kann, ist eine Rückmeldung an die Print Lounge erforderlich. Diese Rückmeldung erfolgt durch den Aufruf der PL-API. Ist diese Rückmeldung erfolgt, versucht das System erneut die Ausgangsdatei abzuholen.
Technische Beschreibung der Verarbeitung der Eingangsdatei
Die Eingangsdatei (XML) wird innerhalb der PRINT LOUNGE anhand der Adressselektion erstellt und anschließend per FTP an den hinterlegten Eingangsordner übertragen. Dieser Ordner wird entweder vom MO selbst überwacht (automatische Verarbeitung) oder es muss ein zusätzliches Script erstellt werden, welches die abgelegten Eingangsdateien an die Mailoptimizer-Instanz weitergibt, sofern diese keinen direkten Zugriff auf den Eingangsordner haben kann.
Nachdem die Eingangsdateien erfolgreich vom Mailoptimizer verarbeitet wurden, wird die entsprechende Ausgangsdatei (XML / ZIP) im Ausgangsordner bereitgestellt.