endereco Adressmanagement-Services Modul (AMS)
Für OXID 7.x PE, CE & EE
Funktionsbeschreibung #
Die endereco Adressmanagement-Services (AMS) verbessern die Qualität der Adressdaten deiner Kunden – einfach und unkompliziert – direkt in deinem OXID7 Shop. Fehlerhafte Adressen lassen sich durch intelligente Vorschläge direkt beheben. Die Schreibweise von Adressen wird automatisch normiert. Ein zweistufiger Prozess in den Adressformularen stellt die korrekte Erfassung auf nahezu allen Eingabegeräten sicher.
Stufe 1
Eingabeassistent
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.
Namensprüfung – Passt die Anrede zum Vornamen?
Unsere Namensprüfung kann geschlechtsspezifisch eindeutige Vornamen erkennen, und markiert das entsprechende Anredefeld ihres Webshops. Mehrdeutige oder unbekannte Namen werden ignoriert.
Groß- und Kleinschreibung der Namen werden automatisch korrigiert. Auf Wunsch werden sogar vertauscht eingegebene Vor- und Nachnamen korrigiert.
Wird ein akademischer Titel hinterlegt, wird er aus dem Feld Vorname gelöscht und in das Feld „Titel“ übernommen, sofern das Feld angezeigt wird.
E-Mail-Prüfung
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 Postfach voll oder zustellbar?
- Handelt es sich um eine Einweg-Adresse oder SPAM E-Mail-Adresse
Telefonnummern Normierung
Unterschiedliche Schreibweisen von Telefonnummern sind sehr verbreitet. Endereco räumt auf und gibt Telefonnummern eine einheitliche, normierte Schreibweise. Zusätzlich unterscheidet endereco mobile Rufnummern und Festnetznummern und kann auf Wunsch dieses Merkmal mitgeben. Ungültige Vorwahlen bzw. mobile Rufnummer werden erkannt und gekennzeichnet.
Stufe 2
Adressvalidierung
Der Adresscheck validiert eingegebene Felder auf Gültigkeit im Gesamtzusammenhang. Auf nicht plausible Eingaben werden automatisch valide Korrekturverschläge angeboten. Der Kunde kann zwischen seiner Eingabe und einem der Korrekturverschläge wählen.
Installationsanleitung #
Neuinstallation des Moduls
Das Modul lässt sich über Composer installieren.
Im root-Verzeichnis des Shops folgenden Befehl ausführen:
composer require endereco/endereco-oxid7-twig-clientDer Befehl lädt die neuste Version herunter und die Namespaces werden registriert. Um eine spezielle Version zu installieren, zum Beispiel 1.1.0, kann der Befehl folgenderweise angepasst werden.
composer require endereco/endereco-oxid7-twig-client:1.1.0Migrationen ausführen
vendor/bin/oe-eshop-db_migrate migrations:migrateHinweis! Weitere Informationen zur Mirgation findest du hier: Dokumentation für Migrationen in Oxid 7
Cache leeren und Views neu aufbauen
vendor/bin/oe-console oe:cache:clear
vendor/bin/oe-eshop-db_views_generateModul aktivieren
vendor/bin/oe-console oe:module:activate endereco-oxid7-clientPS: Trage dich gerne in unseren Release-Newsletter ein, dann wirst du bei einem Update immer schnell informiert.
Zugangsdaten anfordern #
Zugangsdaten
Das Modul funktioniert nur mit einem gültigen API-Schlüssel, welchen du von uns bekommst. Falls du noch keinen erhalten hast, kannst du ihn hier oder direkt per E-Mail an info@endereco.de kostenfrei anfordern.
Du kannst das Modul ab Erhalt des API-Schlüssels 30 Tage kostenfrei auf deiner Testinstanz oder im Liveshop ausprobieren und alle Funktionen nutzen.
Einschränkung:
Aus lizenztechnischen Gründen erfolgt die Prüfung während des Testzeitraums nicht auf Hausnummernebene. Diese schalten wir im Live-Betrieb für dich frei!
Weitere Konditionen findest du hier.
Wechsel in den kostenpflichtigen Produktivmodus
Für die live Zugangsdaten benötigen wir deine Zustimmung zu unseren AGB sowie den unterschriebenen Datenverarbeitungsvertrag. Dies kannst du über unser Formular erledigen: Nutzung der endereco-Services.
Zum 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.
Zu unseren AGB: Unsere Allgemeinen Nutzungsbedingungen und AVV | Endereco
Wir benötigen eine Freigabe der Deutschen Post, die ca…. 2-3 Tage dauern kann.
Eingabe der Zugangsdaten
- Im Shop Backend auf Erweiterungen/Module klicken und “Endereco Adress-Services für OXID” auswählen
- Einstellungen auswählen
- API-Key eingeben, Service-Endpoint auswählen
- Einträge speichern
Konfiguration des Moduls #
Wahl des Prüfmodus
Du hast die Möglichkeit, verschiedene Services ein- und auszuschalten:
„ Standardland vorauswählen “ – Hier kannst du einstellen, welches Land in deinem Adressformular automatisch vorausgewählt wird, sollte OXID kein Land definiert haben. Idealerweise ist es das Land, aus dem du die meisten Kundenbestellungen erhältst.
„ Adressprüfung und Eingabeassistent “ – Der Eingabeassistent generiert für den Kunden anhand der eingegebenen Daten die Vorschläge für PLZ, den zugehörigen Ort und die Straße. Ausgewählte Vorschläge werden bei Auswahl in die entsprechenden Adressfelder übernommen.
Bei der Adressprüfung wird die Adresse mit dem Absenden des Formulars nochmals geprüft.
Liegt ein Fehler vor, wird der Kunde über ein Pop-up-Fenster darüber informiert. Er hat nun die Möglichkeit seine Eingabe beizubehalten oder einen Korrekturvorschlag zu übernehmen.
„ Auch Bestandskunden einmalig prüfen “ – Deine Bestandskunden, die noch nicht geprüft wurden, werden beim Einloggen automatisch geprüft. Durchlaufen diese Kunden dann den Checkout-Prozess, werden sie auf der Prüfen und Bestellen“ Seite im Fehlerfall auf eine falsche Adresse hingewiesen und entsprechend umgeleitet.
„ PayPal Express Check-out prüfen “ – Die Daten von Kunden, die mit PayPal Express Check-out die Bestellung abschließen möchten, werden geprüft.
ACHTUNG:
Bei Amazon Pay Kunden – Bezahlen mit Amazon – erfolgt keine Prüfung der Kundenadressen! Bei „Login mit Amazon“ wird der Kunde ebenfalls nicht geprüft.
„ Adressprüfung sofort nach Verlassen der Adressfelder auslösen “ – Ist diese Funktion aktiv, wird die Adressprüfung sofort nach Verlassen der Adressfelder ausgelöst. Z.B. indem er das Feld „Vorname“ auswählt.
Ist diese Funktion nicht aktiv, wird die Adressprüfung erst beim Absenden des Formulars ausgeführt.
„ Das Absenden des Formulars nach der Adressauswahl fortsetzen “ – Liegt ein Fehler in einer der Adressen vor, erscheint das Adressprüfung-Pop-up-Fenster. Wird nun vom Nutzer eine Auswahl getroffen, kann er diese mit dem Button „übernehmen“ bestätigen.
Ist diese Option aktiviert, wird das Absenden des Formulars automatisch fortgesetzt.
Ist diese inaktiv, so muss der Nutzer das Absenden des Formulars nach dem Schließen des Pop-ups manuell anstoßen.
„ Felderreihenfolge optimieren “ – Bringt die Adressfelder im Checkout automatisch in die optimale Reihenfolge (Land, PLZ, Ort, Straße, Hausnummer) – unabhängig vom Standard-Layout des Shops – für eine intuitivere Nutzerführung bei der Adresseingabe mit Autocomplete.
„ Das Schließen des Modals erlauben “ – Blendet im Popup zur Adressprüfung eine Schließen-Schaltfläche ein, sodass Kunden das Fenster jederzeit verlassen können – auch wenn die Adresse noch nicht korrigiert oder bestätigt wurde.
„ Kunde muss eine fehlerhafte Adresse mit einer Checkbox bestätigen “ – Kunde muss seine Eingabe, wenn sie von endereco als falsch gekennzeichnet wird, mit einem Checkbox bestätigen.
„ E-Mail-Adressrüfung aktivieren “ verifiziert die Syntax, Erreichbarkeit und Zustellbarkeit eines E-Mail-Postfachs sowie die Existenz einer eingegebenen E-Mail-Adresse.
„ E-Mail Statusmeldung anzeigen “ entscheidet darüber, ob die Meldung zum Status der E-Mail-Adresse dem Kunden angezeigt wird oder nicht.
„ Namensprüfung und -normierung aktivieren und Anrede automatisch setzen “ erkennt und korrigiert Schreibfehler in Vor- und Nachnamen, vereinheitlicht die Schreibweise (z. B. Groß-/Kleinschreibung) und ermittelt anhand des Vornamens automatisch die passende Anrede – für saubere Kundendaten ohne zusätzlichen Aufwand für den Kunden.
„ Vertauschen Vor- und Nachnamen korrigieren (BETA) “ erkennt vertauschte Vor und Nachname und fügt diese in richtige Felder ein.
„ Standard CSS nutzen “ – Gibt an, ob Standard CSS-Klassen des endereco Moduls geladen werden sollen.
Ist diese Option nicht aktiviert, werden keine CSS Informationen geladen. Du kannst dann das Styling der Elemente selbst z.B im Theme definieren.
„ Weitere Farbeinstellungen “ – Damit kannst du die Farben für Warnmeldungen, Fehlertexte und Hinweise an die Farben deines Webshops anpassen.
„ Whitelist der Controller-Klassen aktivieren “ – Damit kannst du die Farben für Warnmeldungen, Fehlertexte und Hinweise an die Farben deines Webshops anpassen.
„ Adressprüfung beim Absenden des Formulars auslösen “ – In diesem Fall, findet die Adressprüfung erst beim Klicken auf „Weiter“ oder „Speichern“ statt.
„ Debuginformationen in der Browserkonsole ausgeben “ – Diese Funktion ist besonders für die Entwickler nützlich. Ist sie aktiv, werden hilfreiche Informationen zum Debuggen des endereco Moduls in der Browserkonsole / Entwickler Tools angezeigt.
Damit ist die Einrichtung abgeschlossen.
Funktionstest #
Nun solltest du nach Auswahl des Landes „Deutschland“ und der Eingabe einer PLZ passende Vorschläge für den Ort erhalten – Vorschläge sollten auch 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 optimieren!
Bei Fragen helfen wir gerne weiter!
Einfach per E-Mail an: support@endereco.de oder Tel: 0931 66 39 839 – 0
Dein endereco Team
Datenschutzerklärung ergänzen #
Bitte informiere deine Kunden darüber, dass die eingegebenen Adressdaten sowie ggf. weitere personenbezogene Daten geprüft werden.
Du hast nun 3 Möglichkeiten diese Informationen einzubinden:
Wir haben für dich einen Textvorschlag erstellt, den du in deine Datenschutzerklärung aufnehmen kannst. Passe den Vorschlag bitte gemäß der gebuchten Dienste individuell an.
Auf unserer Webseite bieten wir Ihnen die Möglichkeit, bestimmte Eingaben in Adressformularen unseres Webshops in Echtzeit auf Eingabefehler zu überprüfen. Dadurch sollen Probleme bei der Lieferung der von Ihnen bestellten Produkte durch falsche Angaben vermieden werden.
Weiterhin möchten wir sicherstellen, dass ihre Kontaktdaten zur Zusendung von Informationen zu ihrem Auftrag oder für ggf. notwendige Rückfragen gültig sind.
Für die Bereitstellung dieser Funktionen setzten wir den Dienstleister Endereco, Balthasar-Neumann-Straße 4b, 97236 Randersacker ein. Der Dienstleister verarbeitet die Daten ausschließlich nach Weisung durch uns. Rechtsgrundlage für die Übermittlung, Verarbeitung und vorübergehende Speicherung der Daten beim Dienstleister ist Art. 6 Abs. 1 lit. b DSGVO, da es für die Erfüllung des Vertrags oder zur Durchführung von vorvertraglichen Maßnahmen zwingend erforderlich ist, dass einige der von Ihnen in die Eingabemaske eingegebenen Daten auf ihre Richtigkeit überprüft werden. Folgende Daten werden durch den Dienstleister verarbeitet:
- Adresse (Land, Ort, Postleitzahl, Straße, ggf. Hausnummer)
- E-Mail-Adresse (wenn nicht aktiviert bitte löschen)
- Telefonnummer (wenn nicht aktiviert bitte löschen)Die Daten werden beim Dienstleister separat verarbeitet und nicht zusammengeführt. Die Anfragen werden beim Dienstleister gelöscht, sobald der Status der der eingegebenen Daten ermittelt wurde und die Speicherung im Webshop abgeschlossen wurde, spätestens jedoch nach 30 Tagen.
Wenn du schon Kunde bei der IT-Recht-Kanzlei bist, und deine Rechtstexte dort verwaltest, kannst du einen weiteren Textabschnitt einfach zu deinen anderen Inhalten der Datenschutzerklärung hinzufügen.
Im Rechtstexte Generator sind unsere endereco Services unter „Tools und Sonstiges“ > „Verwenden Sie Dienste für automatische Adressprüfung und Eingabekorrekturen“ gelistet.
Im Rechtstextegenerator des Händlerbundes für die Datenschutzerklärung gibt es nun in der Kategorie „Kontakt“ den neuen Punkt:
„Verwenden sie auf ihrer Webseite Tools zur automatischen Adressvalidierung“
Hier ist nun „endereco“ auswählbar.
Nach Selektion und Speicherung wird nun der Rechtstexte-Generator um einen enstrpechenden Paragraphen erweitert.
