Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

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.

Konfiguration der Schnittstelle

Bevor die Schnittstelle genutzt werden kann, müssen die erforderlichen Zugangsdaten bei der Deutschen Post angefragt und in der PRINT LOUNGE unter "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" hinterlegt werden. Außerdem kann hier 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

Bevor mit der Konfiguration der Schnittstelle begonnen werden kann, müssen folgende Informationen von bzw. in Rücksprache mit der Deutschen Post vorliegen:

  1. API-Zugangsdaten (Benutzername und Passwort)
  2. Kundennummer (EKP-Nummern des Betreibers bzw. des Einlieferers)
  3. Vertragsinformationen (Kontrakte für die jeweils zu nutzenden Dienstleistungen)

Zusätzlich sollten die Informationen zu Fertigungsmustern (bspw. Abmessungen, Gewichte, Informationen zur Aussendung, …) besprochen werden, da hierbei gegebenenfalls Besonderheiten berücksichtigt werden müssen, die softwareseitig nicht überprüft werden können.

1.

...

Die API-Zugangsdaten bilden die Grundlage für die Schnittstelle der Deutschen Post Dienste. Diese 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.

Image Removed

...

Grundlagen & Zugangsdaten

Innerhalb des Tabs „Zugangsdaten“ werden nun die Kundendaten des Betreibers der Schnittstelle sowie die gewünschte Sprache („Lokalisierung“; bspw. „de“ oder „en“) hinterlegt.

Die Zugangsdaten bestehen aus dem Benutzernamen und dem Passwort des bereitgestellten API-Zugangs.

Einstellung

Beschreibung

Daten werden bereitgestellt bzw. festgelegt von …

Benutzername


Deutsche Post

Passwort


Deutsche Post

Lokalisierung

2-stelliger Sprachcode (bspw. "de"

oder

/ "en")

Shop-Betreiber

Image Added

2. Stammdaten

...

Innerhalb der Stammdaten werden alle relevanten Informationen des Betreibers bzw. des Einlieferers der Mailings hinterlegt. Diese Daten werden sofort mit der Deutschen Post synchronisiert.

...

& Adressen

Im nächsten Tab „Stammdaten & Adressen“ werden die grundlegenden Informationen zum Betrieb der Schnittstelle hinterlegt.

Hierzu zählen die Daten des Betreibers, die Einlieferungsinformationen und auch die Daten des Einlieferers.

Diese Daten werden direkt im Adressbuch der Deutschen Post gespeichert und aktualisiert.

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

Image Added

3.

...

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.

Bei POSTWURFSPEZIAL und POSTAKTUELL werden immer alle verfügbaren Dokumente abgerufen. Die übermittelten Dokumente sind nach Abschluss einer Bestellung innerhalb der Administration in der jeweiligen Bestellung verfügbar.

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

Image Removed

...

Kontrakte

Nachdem die Grundlagen eingerichtet worden sind, können alle vorhandenen Kontrakte in dem Tab „Kontrakte“ für die Software hinterlegt werden.

So wird festgelegt, was über die Schnittstelle generell genutzt werden kann und welche Kontraktarten bereitstehen. Kontrakte können nach der Anlage nur eingesehen und gelöscht werden.

Eine Bearbeitung ist über die Software nicht möglich, um eine nachträgliche Veränderung oder potentielle Konflikte bereits getätigter Bestellungen zu vermeiden.

4. Dokumente für DIALOGPOST

Info
Einstellungen in diesem Bereich gelten ausschließlich für Sendungen, die mit DIALOGPOST verarbeitet werden. Es dauert unter Umständen bis zu 24 Stunden, bis ein Auftrag vollständig verarbeitet worden ist und die Dokumente von der Deutschen Post bereitgestellt werden.

Es können verschiedene Dokumente für jede Bestellung bei der Deutschen Post angefordert und erzeugt werden.

Diese können in dem Tab „Dokumente (Dialogpost)“ ausgewählt und aktiviert werden und werden nach einer Bestellung und erfolgreichen Verarbeitung in der Administration innerhalb der Bestelldetails als ZIP-Datei zum Download bereitgestellt.

5. Fertigungsmuster

Info
titleStep-by-Step-Anleitung für Fertigungsmuster

Die Fertigungsmuster sind ein zentraler Punkt für alle Dienste der Deutschen Post. Für die Anlage eines neuen Fertigungsmusters gibt es hier eine Step-by-Step-Anleitung.

Im letzten Schritt werden die Informationen aller potentiellen Sendungen in dem Tab „Fertigungsmuster“ hinterlegt.

Hierbei werden unter anderem die Abmessungen und das Gewicht einer vollständigen Sendung hinterlegt, so dass Mailings mit denselben Sendungsdaten nur einmalig angelegt werden müssen.

Innerhalb eines Mailing-Artikels kann dieses allgemeine Fertigungsmuster dann mit einem konkreten Mailing verknüpft und somit der Sendungsinhalt hinterlegt werden.

Werden neue Mailings geplant, muss zunächst geprüft werden, ob ein bestehendes Fertigungsmuster genutzt, oder ein neues angelegt werden kann.

Werden bspw. ausschließlich Mailings mit 2 DIN A4-Seiten und identischer Verpackung verschickt (also nur mit einem inhaltlichen Unterschied), kann ein einziges Fertigungsmuster ausreichen.

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.

4.1. Fertigungsmuster » Sendungsangaben

Innerhalb der Sendungsdaten werden grundlegende Angaben wie die Abmessung und weitere sendungsbezogene Angaben hinterlegt:

Image Removed

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:

Image Removed

Hier müssen alle Angaben zur Behälterfertigung ausgefüllt werden. Diese Daten werden mit Standardwerten gefüllt.

(Info) PLZ = Postleitzahl; LR = Leitregion

4.2. Fertigungsmuster » Behälter & Bunde: Bundfertigung

Für die Bundfertigung können verschiedene Parameter hinterlegt werden:

Image Removed

Hier müssen alle Angaben zur Bundfertigung ausgefüllt werden. Diese Daten werden mit Standardwerten gefüllt.

(Info) 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 werdenImage Added

Info
titleGewichtsberechnung

Im Tab "Sonstiges" kann festgelegt werden, ob die Gewichtsberechnung auf der Angabe in den Fertigungsmustern basieren soll, oder ob die Gewichtsangaben der jeweiligen zugewiesenen Artikel verwendet werden soll. Bei Verwendung der Artikelgewichte wird das Gesamtgewicht ermittelt und für die weitere Berechnung verwendet.