Voraussetzungen & Einrichtung der Schnittstelle
Bevor die Schnittstelle genutzt werden kann, müssen die erforderlichen Zugangsdaten bei der Deutschen Post angefragt und in der PRINT LOUNGE unter "Add-Ons » Deutsche Post Dienste" hinterlegt werden. Außerdem kann hier die aktiv zu verwendende Dienstumgebung festgelegt werden, wobei grundsätzlich zwischen einer Produktiv- und einer Entwicklungsumgebung unterschieden wird. Die Umgebungen werden separat und unabhängig voneinander konfiguriert.
Bevor mit der Konfiguration der Schnittstelle begonnen werden kann, müssen folgende Informationen von bzw. in Rücksprache mit der Deutschen Post vorliegen:
- API-Zugangsdaten (Benutzername und Passwort)
- Kundennummer (EKP-Nummern des Betreibers bzw. des Einlieferers)
- Vertragsinformationen (Kontrakte für die jeweils zu nutzenden Dienstleistungen)
- Informationen zu Fertigungsmustern (bspw. Abmessungen, Gewichte, Informationen zur Aussendung, …)
1. Grundlegende Zugangsdaten für die API
Die API-Zugangsdaten bilden die Grundlage für die Schnittstelle der Deutschen Post Dienste.
Alle erforderlichen Zugangsdaten werden innerhalb der Add-On-Konfiguration unter "Add-Ons » Deutsche Post Dienste » Auswahl des Shops » Auswahl der Dienstumgebung » Zugangsdaten" zusammen mit der gewünschten Lokalisierung hinterlegt. Die Lokalisierung bestimmt hierbei die Sprache der Schnittstelle.
| Einstellung | Beschreibung | Daten werden bereitgestellt bzw. festgelegt von … |
|---|---|---|
| Benutzername | Deutsche Post | |
| Passwort | Deutsche Post | |
| Lokalisierung | 2-stelliger Sprachcode (bspw. "de" / "en") | Shop-Betreiber |
2. Stammdaten des Anbieters und Einlieferungsdaten
Innerhalb der Stammdaten werden alle relevanten Informationen des Betreibers bzw. des Einlieferers der Mailings hinterlegt. Diese Daten werden sofort mit der Deutschen Post synchronisiert.
| Einstellung | Beschreibung | Daten werden bereitgestellt bzw. festgelegt von … |
|---|---|---|
| Stammdaten für Deutsche Post Dienste | ||
| Kundennummer | Kundennummer bei der Deutschen Post | Deutsche Post |
| Depot für Einlieferung | Abgabestelle für alle Sendungen | Shop-Betreiber |
| Einlieferer (wird mit dem Adressbuch der Deutschen Post synchronisiert) Der "Einlieferer" ist verantwortlich für die Abgabe (also die Einlieferung) aller erforderlichen Dokumente und der eigentlichen Sendung. | ||
| EKP-Nummer | Deutsche Post | |
| Name | Shop-Betreiber | |
| Straße | Shop-Betreiber | |
| PLZ | Shop-Betreiber | |
| Stadt | Shop-Betreiber | |
| Telefonnummer | Shop-Betreiber | |
3. Dokumente (nur für Dialogpost)
Hier können die erforderlichen Dokumente festgelegt werden, die von der Deutschen Post bei einer verbindlichen Buchung einer DIALOGPOST-Verwendung generiert und zurückgeliefert werden sollen.
Erstellung der Dokumente
4. Fertigungsmuster
Für die Berechnung von Portokosten muss jedem Mailing ein Fertigungsmuster zugewiesen werden, welches die Rahmenparameter für ein Mailing festlegt. Damit diese innerhalb des Mandanten global genutzt werden können, werden diese Muster innerhalb der Add-On-Konfiguration erstellt und mit der Deutschen Post synchronisiert. Innerhalb eines Artikels kann dann das jeweils zu verwendende Fertigungsmuster ausgewählt und verknüpft werden.
Weitere Informationen zu Dialogpost unter https://www.deutschepost.de/de/d/dialogpost.html
Umbenennung von Fertigungsmustern
4.1. Fertigungsmuster » Sendungsangaben
Innerhalb der Sendungsdaten werden grundlegende Angaben wie die Abmessung und weitere sendungsbezogene Angaben hinterlegt:
Hier muss zunächst der Sendungsinhalt ausgewählt und die zugehörigen Abmessungen und das Gewicht einer Gesamtsendung hinterlegt werden.
4.2. Fertigungsmuster » Behälter & Bunde: Behälterfertigung
Für die Behälterfertigung können verschiedene Parameter hinterlegt werden:
Hier müssen alle Angaben zur Behälterfertigung ausgefüllt werden. Diese Daten werden mit Standardwerten gefüllt.
PLZ = Postleitzahl; LR = Leitregion
4.2. Fertigungsmuster » Behälter & Bunde: Bundfertigung
Für die Bundfertigung können verschiedene Parameter hinterlegt werden:
Hier müssen alle Angaben zur Bundfertigung ausgefüllt werden. Diese Daten werden mit Standardwerten gefüllt.
PLZ = Postleitzahl; LR = Leitregion
4.3. Fertigungsmuster » Palettenfertigung
Für die Palettenfertigung werden feste Standardwerte genutzt. Falls erforderlich können diese Einstellungen bei der Anlage eines neuen Fertigungsmusters hinterlegt werden.