Deutsche Post Direkt Datafactory Autocomplete für Magento 2

Die Seite wird erstellt Gesine Menzel
 
WEITER LESEN
Shop Extension for Magento® 2

         Deutsche Post Direkt
         Datafactory
         Autocomplete für
         Magento® 2

         Das Modul Datafactory Autocomplete bietet Kunden im Shop-Frontend eine
         automatische Vervollständigung für Rechnungs- und Lieferadressen in Deutschland.

         Diese Dokumentation erklärt die Installation, Kon guration und Nutzung des
         Moduls.

Powered by Netresearch                                                                      1 / 11
Last updated: 4/26/2022
Inhaltsverzeichnis
Inhaltsverzeichnis
Voraussetzungen
  • Magento® 2
  • PHP
  • Browser-Support
Hinweise zur Verwendung des Moduls
  • Zugangsdaten
  • Unterstützte Länder
  • Datenschutz / DSGVO
Installation und Kon guration
  • Installation
  • Modulkon guration
Modulnutzung
  • Bestellung im Checkout
  • Adresseingabe im Kundenkonto
  • Adresseingabe im Magento® 2 Adminpanel
Troubleshooting
  • Keine Adressvorschläge
Modul deinstallieren
Technischer Support

Powered by Netresearch                       2 / 11
Last updated: 4/26/2022
Voraussetzungen
Die nachfolgenden Voraussetzungen müssen für den reibungslosen Betrieb des Moduls erfüllt sein.

Magento® 2
Folgende Magento® 2-Versionen werden vom Modul unterstützt:

  • Open Source 2.3.0 und neuer
  • Commerce 2.3.0 und neuer

PHP
Folgende PHP-Versionen werden vom Modul unterstützt:

  • PHP 7.1 und neuer

Weitere Informationen nden Sie auch in diesen Dateien im Modulpackage:

  •   README.md

  •   composer.json

Im Zweifelsfall sind die Versionsangaben in der Datei composer.json maßgeblich.

Browser-Support
Grundsätzlich werden die aktuellen Versionen gängiger Browser unterstützt. Das Modul kann in
älteren Browserversionen ebenfalls funktionieren, jedoch wird dies nicht garantiert.

Die Funktion im Shop-Frontend wurde in folgenden Desktop-Browsern getestet:

  • Chrome 69
  • Firefox 62
  • Edge 42
  • Safari 11
  • Opera 56

Powered by Netresearch                                                                         3 / 11
Last updated: 4/26/2022
Hinweise zur Verwendung des Moduls
Zugangsdaten
Das Modul kommuniziert mit dem Service Datafactory Autocomplete von Deutsche Post Direkt. Zur
Nutzung sind entsprechende Zugangsdaten notwendig, welche Sie von Deutsche Post Direkt
erhalten.

Weitere Informationen: https://www.deutschepost.de/de/d/deutsche-post-direkt/datafactory.html

Unterstützte Länder
Die Adress-Vervollständigung funktioniert ausschließlich für deutsche Adressen.

Es wird empfohlen, das Standardland im Shop auf Deutschland einzustellen, damit der Kunde im
Shop-Frontend das Land nicht selbst wählen muss.

Wenn ein anderes Land eingestellt ist, erfolgt keine Vervollständigung der Adresse.

Datenschutz / DSGVO
Zur Vervollständigung der Kundenadresse werden persönliche Daten des Kunden (Straße,
Postleitzahl, Ort) an Deutsche Post Direkt übertragen. Dies ist für die Funktion des Moduls
erforderlich. Gemäß DSGVO (Datenschutz-Grundverordnung der EU) müssen Sie sich hierfür das
Einverständnis Ihrer Kunden einholen, z.B. über die AGB des Shops.

Es werden keine zusätzlichen Daten oder Meta-Angaben in Magento® 2 gespeichert, sondern
lediglich die im Shop-Frontend eingegebene Kundenadresse.

Powered by Netresearch                                                                         4 / 11
Last updated: 4/26/2022
Installation und Kon guration
Installation
Installieren Sie das Modul gemäß der Anweisung in der Datei README.md, die Sie im Modulpackage
 nden. Achten Sie darauf, alle Anweisungen exakt zu befolgen und keine Schritte zu überspringen.

Bei der Installation werden keine Datenbank-Tabellen verändert oder Felder hinzugefügt, da das
Modul keine zusätzlichen Daten speichert.

Modulkon guration
Die Kon gurations-Einstellungen nden Sie im Magento® 2 Adminpanel unter:

   Stores → Konfiguration → Kunden → Kunden Konfiguration → Deutsche Post Direkt
   Autocomplete

Im diesem Kon gurationsbereich können folgende Einstellungen vorgenommen werden:

  • Aktiviert (Enabled): Wählen Sie, ob das Modul aktiv sein soll.
  • Benutzername (Username): Geben Sie den Nutzernamen ein, den Sie von Deutsche Post Direkt
     erhalten haben, siehe Zugangsdaten.
  • Passwort (Password): Geben Sie das Passwort für den o.g. Nutzer ein.
  • Hausnummern Hinweis anzeigen (Enabled): Wählen Sie, ob die Straßennummern-Infobox
     aktiviert werden soll.
  • Hausnummern Hinweistext (House number hint text): Geben Sie den Text ein, der als Infobox am
     Adress-Straßenfeld bei Adressvorschlagsauswahl angezeigt werden soll.

Das Modul verfügt nicht über einen Sandbox-Modus. Es sind in jedem Fall Zugangsdaten
erforderlich.

Powered by Netresearch                                                                           5 / 11
Last updated: 4/26/2022
Modulnutzung
Bestellung im Checkout
Im Checkout steht die Vervollständigung für Rechnungs- und Lieferadressen zur Verfügung.

Powered by Netresearch                                                                     6 / 11
Last updated: 4/26/2022
Folgende Eingabefelder werden vom Datafactory Autocomplete Modul vervollständigt:

  • Straße 1
  • Postleitzahl
  • Ort

Powered by Netresearch                                                              7 / 11
Last updated: 4/26/2022
Sobald in eines der o.g. Felder Daten eingegeben werden, die zur Vervollständigung der Adresse
ausreichen, erscheinen Vorschläge, aus denen der Kunde wählen kann. Die übrigen Felder werden
dann (soweit möglich) automatisch befüllt.

Das Land muss auf Deutschland eingestellt sein, bevor in die o.g. Felder Daten eingegeben werden,
sonst erfolgt keine Vervollständigung. Beachten Sie die Hinweise im Abschnitt Unterstützte Länder.

Adresseingabe im Kundenkonto
Beim Bearbeiten von Rechungs- und Lieferadressen im Kundenkonto steht die Adress-
Vervollständigung im Shop-Frontend ebenfalls zur Verfügung. Es gelten die gleichen Bedingungen
wie bei einer Bestellung im Checkout.

Adresseingabe im Magento® 2 Adminpanel
Im Adminpanel steht die Adress-Vervollständigung nicht zur Verfügung.

Powered by Netresearch                                                                           8 / 11
Last updated: 4/26/2022
Troubleshooting
Keine Adressvorschläge
Wenn bei der Eingabe von Adressen keine Vorschläge erscheinen, prüfen Sie folgende Punkte:

  • Ist das Modul aktiviert?
  • Ist das Land auf Deutschland eingestellt?
  • Gibt es Probleme mit den Zugangsdaten? Diese sind an 401-Fehlern in der Browserkonsole (Dev
     Tools) sowie im Log erkennbar.

Powered by Netresearch                                                                       9 / 11
Last updated: 4/26/2022
Modul deinstallieren
Befolgen Sie die Anleitung aus der Datei README.md im Modulpackage, um das Modul zu
deinstallieren. Die Datei README.md ist im Package enthalten.

Powered by Netresearch                                                                10 / 11
Last updated: 4/26/2022
Technischer Support
Wenn Sie Fragen haben oder auf Probleme stoßen, werfen Sie bitte zuerst einen Blick in das
Support-Portal (FAQ):

postdirekt.support.netresearch.de

Sollte sich das Problem damit nicht beheben lassen, können Sie das Supportteam über das o.g.
Portal oder per Mail unter postdirekt.support@netresearch.de kontaktieren.

Powered by Netresearch                                                                         11 / 11
Last updated: 4/26/2022
Sie können auch lesen