Administration im Backend

Add-on - POSTAKTUELL

Wenn das POSTAKTUELL Modul aktiviert ist, gibt es unter Module → POSTAKTUELL eine entsprechende Konfigurationsseite um das Modul für die Shops zu konfigurieren.

API-seitige Validierung der Eingaben bei der Funktion SetJobRole

Parameter – Name

Zulässige Zeichen:

"abcdefghijklmnopqrstuvwxyzäöüßABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÜ0123456789.- ()&+@:,"

 Parameter - Address

Zulässige Zeichen:

"abcdefghijklmnopqrstuvwxyzäöüßABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÜ0123456789.- ()"

Parameter – ZipCode

Zulässige Zeichen:

"ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"

Parameter – Town

Zulässige Zeichen:

"abcdefghijklmnopqrstuvwxyzäöüßABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÜ0123456789.- ()"

 Parameter – EKP

 Hier sind nur Zahlen zulässig, die Länge muss 10 Stellen betragen und den formalen Kriterien für eine gültige Kundennummer genügen.

 Parameter - PostcardID

Der Parameter muss numerisch sein und eine Länge von 7 Zeichen haben.

Parameter IBAN, BIC

Schnittstellendaten

Zur Verwendung von POSTAKTUELL sind die beiden aufgeführten Schnittstellen (AM und PAMAPI) erforderlich. Wie diese beantragt werden und wofür diese genau sind, wird in dem folgenden Artikel erklärt: Detailinformationen zu den Zugangsdaten.

Sind die beiden Zugangsdaten vorhanden, müssen diese in die entsprechenden vorgegebenen Felder eingetragen werden.

Schnittstelle aktivieren
Damit die Schnittstelle ordnungsgemäß funktionieren kann, müssen alle Pflichtfelder aus allen Reitern / Tabs gefüllt werden. Erst dann empfiehlt es sich die Schnittstelle zu aktivieren.

Übertragung an PostAktuell bei Status
Es kann frei entschieden werden, bei welchem Statuswechsel der Auftrag an die Deutsche Post übermittelt werden soll.
Sobald dieser Status gesetzt wird findet die Übertragung über die API statt.

AGB
Aus Datenschutzgründen, da hier mit personenbezogenen Daten gearbeitet wird, müssen die AGB der Deutschen Post für die Verwendung der Schnittstelle akzeptiert werden.

Seitenansicht

Adressdaten

Damit die Verarbeitung reibungslos funktioniert, benötigt die Deutsche Post die sogenannte EKP-Nummer, in dem verknüpften Artikel wird genauer darauf eingegangen und im nachfolgenden Teil als EKP bezeichnet.
In dem Druckshop werden für alle Adresszuweisungen für die Deutsche Post zusätzlich die EKP-Nummer benötigt. Dies gilt auch für den Kunden der die Bestellung ausführen möchte.

Für die Deutsche Post gibt es sogenannte Rollen (Einliefer, Abweichender Zahlungsemfänger) bei der Verwendung der Schnittstelle. 

Die Einliefer Adressdaten sind zwingend erforderlich und benötigen ebenso die EKP, die bei der Deutschen Post beantragt werden muss, falls diese noch nicht vorhanden ist.
Der Abweichender Zahlungsemfänger ist nur optional, wie es der Name schon sagt.

Zahlung

Es wird nur die Zahlung mit der POSTCARD-ID unterstützt, die hier einzugeben ist.
Die beauftragte Verteilung wird dieser in Rechnung gestellt.

Zahlungspflichtiger

Es kann zwischen Shop-Betreiber und Endkunde unterschieden werden.

Shop-Betreiber
Bei dieser Option aktiviert, wird die Verteilposition incl. MwSt ausgewiesen und kann nicht gesondert ausgeweisen werden.

Endkunde
Hierbei ist die Verteilposition ein Nettobetrag, wo wie MwSt separat ausgewiesen wird.

Lieferung / Abholung

Zudem ist es wichtig, ob die gedruckten Daten von der Deutschen Post abgeholt (Ja) oder eingeliefert (Nein) werden.
Bei der Abholung entstehen noch zusätzliche Kosten, die in der Broschüre von der Post eingesehen werden können.

Die Variable Maximale Druck-Bündelgröße ist Artikelgebunden, wenn der Wert im Artikel nicht vorhanden ist wird der Wert aus den Globalen Einstellungen verwendet.

Zeiten

Die Zeiten, wann die Abholung / Einlieferung durchgeführt werden soll, hängt von mehreren Faktoren ab.

1. Produktionszeit
2. Vorgaben aus der Broschüre von der Post

Paletteninformationen

Für die Planung ist es zusätzlich wichtig, wie die Palette zur Abholung / Einlieferung von der Druckerei gepackt wird.

Dazu sind die zusätzlichen Angaben bei der Lieferung:

• Maximale Druck-Bündelgröße
• Mindestgewicht einer Palette
• Hochstgewicht einer Palette

Layout Optionen

Zum Personalisieren gibt es auf der Startseite zwei Möglichkeiten um POSTAKTUELL anzukündigen.

Banner

Als Voraussetzung für die Verwendung des Banners, muss der Slider im Shop aktiviert werden.
Vorlagen für Banner sind unter POSTAKTUELL-Slidervorlagen zu finden.

Mit Aktivieren dieser Funktion wird im Shop auf jedem Banner ein PLZ-Suchfeld hinzugefügt, das auf die Konfigurationsseite von POSTAKTUELL verlinkt.
Wie dies im Shop dargestellt wird, kann unter der folgenden Übersichtseite betrachtet werden: Startseitendarstellung

Info-Block

Wird der Info-Block aktiviert, erscheint auf der Startseite ein eigener Block mit einem Suchfeld für eine Umkreissuche.
Der Erklärungstext kann in den dazugehörigen Eingabefeldern angepasst werden. Indem der individuelle Text aktiviert wird, erscheint dieser, ansonsten wird ein vorgefertigter einheitlicher Text ausgegeben.

Startseitendarstellung

Benachrichtigung

Im Tab Benachrichtigung kann man die Funktion aktivieren, dass eine Email bei einem eingestellten Status verschickt wird.
Die Vorlage dazu kann man in der  unter "Content-Management→Vorlagen" bei "Benachrichtigung für POSTAKTUELL" finden

Zahlarten

Im Tab Zahlarten kann man die Zahlarten auswählen welche nicht angzeigt werden sollen sobald ein PostAktuell Artikel im Warenkorb ist.

Google Maps API Key

Der API Key für Google Maps kann kostenfrei direkt bei Google beantragt werden: https://developers.google.com/maps/documentation/embed/get-api-key

Artikelkonfiguration

Aktivierung

Sofern das Modul aktiviert wurde kann man bei "Artikel → bearbeiten" unter dem Punkt "PostAktuell" folgende Einstellungen vornehmen:

• "ausgeschaltet": PostAktuell steht nicht zur Verfügung
• "ausschließlich PostAktuell": Der Artikel kann nur mit PostAktuell bestellt werden.
• "PostAktuell oder normale Bestellung": Der Artikel kann sowohl mit als auch ohne PostAktuell bestellt werden.

Sobald der Artikel für POSTAKTUELL aktiviert ist, wird in der Kalkulation ein Button angezeigt um direkt zur Konfiguration zu gelangen.
Ebenso wird dieser entsprechend bei der Produktauswahl auf der Konfigurationsseite berücksichtigt.

Aufschlag

Unter "Artikel → bearbeiten → Preistaffel" wurde Punkt "PostAktuell Aufschlag" hinzugefügt.
Dieser Aufschlag wird im Shop dazugerechnet, sobald ein Artikel als PostAktuell-Artikel in den Warenkorb gelegt wird.

Auf der Produktübersichtsseite wurde der Filter "PostAktuell" hinzugefügt.

Gewicht

Das Gewicht ist grundlegend für die Berechnung der Kosten für die Verteilung.
Somit ist es zwingend erforderlich, dass das Gewicht für den zu konfigurierenden Artikel komplett und durchgängig konfiguriert wird.
Wie sich das Gewicht für die Übermittlung an POSTAKTUELL zusammensetzt, wird in dem folgenden Artikel beschrieben: Gewichtsberechnung

Produktionszeit

TODO Einstellung

Bei der Ermittlung der Produktionszeit wird aktuell ausschließlich unter den Administrationseinstellungen die Standard-Produktionszeit verwendet. Diese wird von der Artikel-Produktionszeit überschrieben.

Maximale Maße / Gewicht einhalten

Um einen Artikel per POSTAKTUELL verteilen zu lassen, muss dieser entsprechende Maße und Gewichte einhalten.
Dies muss beim Konfigurieren des Artikels berücksichtigt werden.
Die genauen Anforderungen sind in der Broschüre von der Deutschen Post zu finden: POSTAKTUELL-Broschüre

Bestellung

Details

Auf der Detailseite sieht der Block für die POSTAKTUELL-Artikel wie folgt aus:

Suche

Hier werden die Informationen ausgegeben, wonach der Benutzer gesucht hat und welches Gewicht der Artikel mit den gewählten Optionen hatte.

IDs

Es wird die POSTAKTUELL-ID angegeben, diese ist die Referenz zu der gespeicherten Suche.
Zusätzlich wird nach dem Übermitteln des Auftrages an die Deutsche Post die Manager-Bestell-ID angezeigt.
Die beiden Nummern können als Referenz bei Problemanfragen verwendet werden.

Bündelgröße verändern

Solange noch keine Manager-Bestell-Id vom System hinterlegt worden ist, ist die Bestellung noch nicht an PostAktuell versendet worden und wenn dies der Fall ist, können Sie unter Auftrag bearbeiten die Bündelgröße für diesen Auftrag noch verändern.

Absender (TODO)

Der Absender enthält die Adresse die der Benutzer im Warenkorb eingetragen hat.

Abholung / Einlieferung (TODO)

Wenn der Auftrag übermittelt wurde und eine Manager-Bestell-ID existiert, dann wird auch dieser Block dargestellt und beinhaltet das Datum, wann die Deutsche Post die Palette einsammeln kommt, oder wann diese die Zustellung der Palette erwartet.

Einlieferungs-PDFs (TODO)

Ein Tag nachdem der Auftrag an die Post übermittelt wurde, kann in diesem Abschnitt eine PDF heruntergeladen werden, welche die drei Dokumentarten (Kassenbeleg, Übersicht Verteilstellen, Aufschriftzettel) enthält, die der Palette beigefügt werden müssen.

API-seitige Validierung der Eingaben bei der Funktion SetJobRole

Parameter – Name

Zulässige Zeichen:

"abcdefghijklmnopqrstuvwxyzäöüßABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÜ0123456789.- ()&+@:,"

Parameter - Address

Zulässige Zeichen:

"abcdefghijklmnopqrstuvwxyzäöüßABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÜ0123456789.- ()"

Parameter – ZipCode

Zulässige Zeichen:

"ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"

Parameter – Town

Zulässige Zeichen:

"abcdefghijklmnopqrstuvwxyzäöüßABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÜ0123456789.- ()"

Parameter – EKP

Hier sind nur Zahlen zulässig, die Länge muss 10 Stellen betragen und den formalen Kriterien für eine gültige Kundennummer genügen.

Parameter - PostcardID

Der Parameter muss numerisch sein und eine Länge von 7 Zeichen haben.

Parameter IBAN, BIC

Stornierung

Sobald eine Bestellung / Position storniert wird, die eine POSTAKTUELL-Bestellung beinhaltet, wird die POSTAKTUELL-ID auch bei der Post gelöscht und entfernt.