Installationsanleitung für Shopware

Endereco Address Management Service Modul (AMS)
Für Shopware 5.4.x - 5.6.x

Aktuelle Release Notes:

Version 2.2.2:

  • Unterstützung für RLT (Right to Left) Eingabe für arabische Länder

Version 2.2.1:

  • Neue JS-SDK eingebunden
  • Die Adressprüfung bei Klick auf "Weiter" im Checkoutprozess angestossen, um Adressänderung zu ermöglichen
  • API-Test Button eingebaut
  • Bugs beseitigt

Funktionsbeschreibung

Die Endereco Address Management Services (AMS) ermöglichen auf einfache und unkomplizierte Weise, die Qualität der Adressdaten, die von deinen Kunden eingegeben werden, zu verbessern. Falsche Adressen können von den Kunden durch Korrekturvorschläge direkt korrigiert werden. Die Schreibweise von Adressen wird normiert . Hierfür wird ein zweistufiger Prozess in die Adressformulare integriert, der eine korrekte Erfassung der Daten über nahezu alle Eingabegeräte sicherstellt.

Schritt 1

a) Adresseingabe-Assistent

Vorschläge zu eingegebenen Adressfragmenten werden in einer Autocomplete Funktion von Straße, PLZ und Ort angezeigt. Dies funktioniert auf PCs, Tablets und Smartphones. Die Adresseingabe wird vereinfacht, beschleunigt und die Fehlerquote massiv reduziert.

b) Anredeprüfung (Passt die Anrede zum Vornamen?)

Die Endereco Vornamendatenbank mit über 30.000 Einträgen kann geschlechtsspezifisch eindeutige Vornamen erkennen, und markiert das entsprechende Anredefeld ihres Webshops. Mehrdeutige oder unbekannte Namen werden ignoriert. Groß- und Kleinschreibung wird automatisch korrigiert.

c) Validierung der E-Mail Adresse

Eine eingegebene E-Mail-Adresse wird in Echtzeit auf verschiedene Merkmale geprüft:

  • Gültige Syntax der E-Mail-Adresse
  • Gültige Länderdomain
  • Ist das E-Mail Postfach registriert und erreichbar?
  • Ist das Postfach voll oder zustellbar?
  • Handelt es sich um eine Einweg-Adresse oder SPAM E-Mail-Adresse?

Schritt 2

a) AddressCheck

Der Adresscheck validiert eingegebenen Adressfelder auf Gültigkeit im Gesamtzusammenhang. Für nicht plausible Eingaben werden automatisch valide Korrekturverschläge angeboten. Der Kunde kann zwischen seiner Eingabe und einem der Korrekturverschläge wählen.


Installationsanleitung

2.1 Installation des Moduls

Lade das Modul für Shopware 5.3.x und größer unter //github.com/Endereco/shopware-ams oder von unserer Webseite herunter: //www.endereco.de/download/ herunter und erstelle den Ordner "EnderecoAMS im Verzeichnis *myshopwareinstallation*/custom/Plugins/

Kopiere nun per SFTP im Binärmodus den Ordnerinhalt in den erstellten Ordner auf deinem Server.

Hier sollte nach Abschluss der Ordner "EnderecoAMS" erstellt, und den Inhalt des Modulpaketes enthalten sein.

Nun solltest du im Shop Backend das Modul sehen und aktivieren können.

2.2 Update des Moduls

Um den Endereco Client für Shopware auf neuesten Stand zu halten, laden Sie bitte die neueste Version von www.endereco.de/downloads herunter.

Alternativ findest du den neusten Release immer auf Github unter. 

//github.com/Endereco/shopware-ams

Wir tragen dich gerne in unseren Release-Newsletter ein, dann wirst du bei einem Update immer schnell informiert. 

2.3 Anpassen der Feldreihenfolge

Durch das aktivieren des Moduls wird die Feldreihenfolge der Adressfelder automatisch auf folgende Reihenfolge angepasst:

LAND
PLZ / Ort
Straße / Hausnummer

Nach dem anpassen der Feldreihenfolge sollten die Adressfelder wie folgt aussehen:

2.4 Aktivieren des Moduls im Shopware Backend

  • Im Backend einloggen
  • Plugin-Manager → Deinstallierte Module → „Endereco AMS“ anklicken
  • Installieren und aktivieren

Zugangsdaten anfordern

3.1 Zugangsdaten

Das Modul funktioniert nur mit einem gültigen API Schlüssel, den du von uns bekommst.

Falls du noch keinen erhalten hast, kannst du ihn auf unsere Webseite unter //www.endereco.de/shopware/ oder direkt per E-Mail an info@endereco.de kostenfrei beantragen.

Du kannst das Modul nun 30 Tage kostenfrei auf deiner Testinstanz oder im Liveshop ausprobieren und alle Funktionen uneingeschränkt nutzen.

Wir melden uns nach dem Testzeitraum oder bei der Halbzeit bei Dir,  und fragen nach, wie es weitergehen soll oder ob du Probleme hast.

3.2 Live Zugangsdaten

Für die Live Zugangsdaten benötigen wir zwei unterschriebene und freigegebene Verträge, nämlich Providervertrag und Datenverarbeitungsvertrag. Beide Verträge finden Sie in Ihrem Installationspaket. Natürlich lassen wir Ihnen die Verträge gerne nochmal per E-Mail zukommen.

Zur Datenverarbeitungsvertrag: Für einige Services, in denen wir laut DSGVO persönliche Daten des Kunden verarbeiten oder an Dritte über Schnittstellen weitergeben, benötigen wir einen Datenverarbeitungsvertrag. Zum Beispiel wenn es um eine E-Mail Zustellbarkeitsprüfung oder Telefonnummern-Normierung geht. Diesen finden Sie ebenfalls im Installationspaket.

Bitte senden Sie beide unterschriebene Verträge an
info@endereco.de oder per Fax an: 0931 6639839-9 oder per Post an uns.
Wir benötigen eine Freigabe der Deutschen Post, die ca. 2-3 Tage dauern kann.

Endereco UG (haftungsbeschränkt)
Robert Rieser
Balthasar-Neumann-Str. 4b,
97236 Randersacker

3.3 Eingabe der Zugangsdaten

In den Moduleinstellungen können Sie nun die Zugangsdaten hinterlegen und die Prüfungen der Adressen konfigurieren.


Konfiguration des Moduls 

4.1 Wahl des Prüfmodus

Du hast die Möglichkeit verschiedene Services ein- und auszuschalten:

  • Autovervollständigung für Adressdaten
  • Adressprüfung
  • E-Mail Prüfung
  • Anredeprüfung
  • Rufnummernvalidierung

„Statusanzeige“ erweitert das Formular um Warnungs- und Erfolgsicons. Eine Aktivierung / Deaktivierung hat keinen Einfluss auf die Funktionalität anderer Services. Es dient nur zur Visualisierung der Prüfergebnisse.

„Eingabehilfe und Adressprüfung“  Input Assistant generiert für den Kunden anhand der eingegebenen Daten die Vorschläge für PLZ, zugehörigen Ort und Straßen.Ausgewählte Daten werden dann automatisch in die entsprechenden Adressfelder eingefügt. Bei Adress-Prüfung werden nach Verlassen der Adress-Formularfelder alle Adressdaten geprüft. Liegt ein Fehler vor, wird der Kunde über ein Popup Fenster gefragt, ob er seine Eingabe beibehalten oder einen Korrekturvorschlag übernehmen will, auch wenn der Kunde sich einloggt und über die „Adress-Seite“ durch den Checkoutprozess geführt wird. So können alte Stammdaten bereinigt werden, und Adressen können bei Eingenmeidungen aufgeschlüsselt werden.

„E-Mail Prüfung“ verifiziert die Syntax, Zustellbarkeit und Existenz einer eingegebenen E-Mail-Adresse. Außerdem wird geprüft, ob es sich um eine Wegwerf oder Spam-Adresse handelt.

„Anredeprüfung“ stellt fest, ob ausgewählte Anrede zum Vornamen passt, und korrigiert Groß- und Kleinschreibung. Namen, die nicht bekannt sind oder mehrdeutig sein können, werden nicht als falsch markiert.

„Vorwahl-Prüfug“ verifiziert, ob eine Telefonnummer-Vorwahl existiert und formatiert die Nummern nach dem gewählten Format. Es stehen dir 10 Formate zur Verfügung. Diese Funktion steht aktuell nur für deutsche Telefonnummern zur Verfügung.

Fabeinstellungen - Damit kannst du die Farben für Warnmeldungen, Fehlertexte und Hinweise an die Farben deines Webshops anpassen.

Damit ist die Einrichtung abgeschlossen. Leere bitte vor dem Test den Temp Ordner Deines Webshops und rufe die Registrierungsseite auf.


Funktionstest 

Nun sollten Sie nach Auswahl des Landes „Deutschland“ und der Eingabe einer PLZ passende Vorschläge für den Ort erhalten. Ebenso sollten Suggests bei der Eingabe der Straße erscheinen.

Viel Freude beim Einsatz unseres Moduls. Über Feedback, Anregungen und Rückmeldungen freuen wir uns. Nur so können wir unsere Services für Sie optimieren!

Bei Fragen helfen wir gerne weiter!
Einfach per E-Mail an: info@endereco.de oder Tel: 0931 66 39 839 - 0
Dein Endereco Team


Release Notes 

Version 2.2.1:

  • Demo Release
  • Neue JS-SDK eingebunden
  • Submit wird ausgebremst, um Adressänderung zu ermöglichen (einmalig)
  • API-Test Button eingebaut
  • Einige Bugs beseitigt

Version 1.0:

  • Initialer Release unseres Shopware Moduls zur Prüfung und Korrektur von Adressdaten in
    Echtzeit.

Auszug unserer Kunden

    Referenzen

    Copyright Endereco UG (haftungsbeschränkt) - Gesellschaft für Master Data Quality Management
    2014 - 2020