Sobald alle erforderlichen Informationen der Deutschen Post vorliegen, kann mit der Konfiguration der Schnittstelle begonnen werden.
Hierzu wird zunächst die Add-On-Konfiguration unter Add-Ons » Deutsche Post Dienste geöffnet und der gewünschte Shop ausgewählt.
Anschließend wird zunächst 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.
| Info |
|---|
Die Schnittstelle selbst wird unabhängig von Produkten angelegt und konfiguriert. In jedem Produkt kann anschließend hinterlegt werden, welcher Dienst der Deutschen Post genutzt werden soll. Nachdem die Schnittstelle in dem Add-On konfiguriert wurde, kann mit der Anbindung konkreter Mailings begonnen werden (ein Mailing inklusive der einzelnen Bestandteile entspricht hierbei einer „Sendung“ bei der Deutschen Post). |
A. Checkliste für erforderliche Informationen
1. Grundlagen & Zugangsdaten
...
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 & Adressen
Im nächsten Tab „Stammdaten & Adressen“ werden die grundlegenden Informationen zum Betrieb der Schnittstelle hinterlegt.
...
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. Kontrakte
Nachdem die Grundlagen eingerichtet worden sind, können alle vorhandenen Kontrakte in dem Tab „Kontrakte“ für die Software hinterlegt werden.
...
Wird der Name eines bereits bestehenden Fertigungsmusters umbenannt wird automatisch ein neues Fertigungsmuster mit dem neuen Namen angelegt. Der Name eines Fertigungsmusters kann somit nachträglich nicht mehr geändert werden.
Nachdem die Schnittstelle in dem Add-On konfiguriert wurde, kann mit der Anbindung konkreter Mailings begonnen werden (ein Mailing inklusive der einzelnen Bestandteile entspricht hierbei einer „Sendung“ bei der Deutschen Post).
| Info |
|---|
| Die Schnittstelle selbst wird unabhängig von Produkten angelegt und konfiguriert. In jedem Produkt kann anschließend hinterlegt werden, welcher Dienst der Deutschen Post genutzt werden soll. |
Voraussetzungen & Einrichtung der Schnittstelle
...
- 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 |
...
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 | |
...
Weitere Informationen zu Dialogpost unter https://www.deutschepost.de/de/d/dialogpost.html
| Hinweis | ||
|---|---|---|
| ||
| Wird der Name eines bereits bestehenden Fertigungsmusters umbenannt wird automatisch ein neues Fertigungsmuster mit dem neuen Namen angelegt. Der Name eines Fertigungsmusters kann somit nachträglich nicht mehr geändert werden. |
...