Endereco Adressmanagement Service Modul (AMS)
Für Shopware 6.0.x und neuer
Funktionsbeschreibung #
Was leistet das Plugin? #
Das endereco Adressmanagement-Services Plugin verbessert die Qualität der Kundenadressen in deinem Shopware 6 Shop durch Echtzeit-Validierung und automatische Korrekturfunktionen.
Kernfunktionen #
Intelligente Adresskorrektur
- Sofortige Korrekturvorschläge bei Tippfehlern oder unvollständigen Adressen
- Kunden können Korrekturen direkt im Formular übernehmen
- Verhindert fehlerhafte Adresseingaben bereits bei der Eingabe
Automatische Adressnormierung
- Standardisiert Schreibweisen nach postalischen Vorgaben
- Einheitliche Formatierung aller Adresskomponenten
- Verbessert Datenqualität für nachgelagerte Systeme (ERP, Versandsoftware)
Responsive Validierung
- Zweistufiger Validierungsprozess optimiert für alle Endgeräte
- Funktioniert auf Desktop-PCs, Tablets und Smartphones
- Nahtlose Integration und Optimierung der User Experience
Technische Umsetzung #
Das Plugin erweitert die Standard-Shopware 6 Adressformulare um folgende Funktionen:
- Live-Validierung während der Eingabe
- Korrekturvorschläge zur Auwahl
- Automatische Vervollständigung bei Eingabe von PLZ oder Ort
Business-Nutzen für deine Shop-Betreiber #
- Weniger Versandprobleme: Korrekte Adressen reduzieren Zustellfehler um bis zu 90%
- Geringere Retourenquote: Weniger unzustellbare Sendungen
- Bessere Conversion: Reibungslose Checkout-Erfahrung ohne Unterbrechungen
- Saubere Kundendaten: Normierte Adressen für CRM und Marketing-Automation
- Compliance: Erfüllung von Datenqualitätsanforderung der Geschäftsführung
Funktionen im Detail #
Installation #
Neuinstallation des Moduls #
Um das endereco Plugin für Shopware 6 zu installieren, hast du zwei Möglichkeiten:
- Installation über den Shopware Store
- Installation über GitHub / per Composer
Du solltest dich für einen Installationsweg entscheiden, da ein nachträglicher Wechsel ggf. mit einem Verlust von Statuscodes zu geprüften Bestandskunden verbunden sein kann. Beide Plugins verwenden eine leicht unterschiedliche Datenstruktur.
Installation über den Shopware Store #
Die Installation über den Store ist unkompliziert und dauert nur wenigen Minuten:
Shopware Store aufrufen
Ruf den Store im Backend deines Stores auf oder klicke auf diesen Link zum zum Plugin im Store gelangen:
endereco-Plugin suchen
Alternativ kannst du im Shop Backend im Shopware Store nach „endereco“ suchen.
- Achte auf das endereco Icon (weisser Briefumschlag auf blauem Hintergrund) und den Plugin Hersteller (endereco)
Wähle das passende Plugin für Shopware 6 aus.
Plugin kostenlos installieren
Jetzt gehst du in dein Shopware 6 Admin-Backend.
Gehe zu: Einstellungen → System → Shopware Account → Meine Erweiterungen.
Dort klickst du auf „Herunterladen“ neben dem endereco-Plugin.
Installieren und Aktivieren
Nach dem Download findest du das Plugin unter Einstellungen → System → Plugins.
Klicke auf das Drei-Punkte-Menü neben Endereco → Installieren.
- Nach der Installation wieder auf das Drei-Punkte-Menü → Aktivieren.
Zugangsdaten und Konfiguration
- Fordere deine Zugangsdaten
- Konfiguriere das Modul (siehe unten)
Installation über den GitHub #
endereco Modul herunterladen
Lade den aktuellsten Release des endereco Shopware 6 Plugins von GitHub herunter.
Je nach Version deines Shopware Shops, wähle die passende Version von Plugin:
- Plugin v. 7.0.X – kompatibel mit Shopware 6.7.0.0 – 6.7.3.1
- Plugin v. 6.5.X – kompatibel mit Shopware 6.6.0.0 – 6.6.10.3
- Plugin v. 5.5.X – kompatibel mit Shopware 6.5.0.0 – 6.5.8.15
- Plugin v. 4.5.X – kompatibel mit Shopware 6.4.0.0 – 6.4.20.2
Modul im Shopware Backend hochladen
Lade das Zip Archiv nun im Shopware Backend über den Plugin-Manager hoch.
Das Endereco Modul erscheint daraufhin in der Liste der Module. Du kannst diese dann mit einem Klick installieren.
Update des bereits installierten Moduls
Um den Endereco Client für Shopware auf neuesten Stand zu halten, laden Sie bitte die neueste Version des Moduls über GitHub herunter.
Den neusten Release findest du immer auf Github unter
PS: Trage dich gerne in unseren Release-Newsletter ein, dann wirst du bei einem Update immer schnell informiert.
Lade das Modul über den Plugin Manager in deinem Shopware Backend hoch. Nun kannst du über den Update-Button rechts neben dem Modul, das Update starten und ausführen.
Das Theme wird neu kompiliert und die Caches werden gelöscht. Damit ist das Modul nun auf dem aktuellen Stand.
Aktivieren des Moduls im Shopware Backend
- Im Backend einloggen
- Meine Erweiterungen → „endereco Adress-Services für Shopware“ anklicken
- Aktivieren
Anpassungen der Texte und Übersetzungen (optional) #
Der Plugin enthält deutsche und englische Übersetzungen. Übersetzungen für weitere Sprachen müssen über Textbausteinverwaltung im Backend gepflegt werden.
Die entsprechenden Textbausteine lassen sich über den Namespace „Endereco“ finden.
Zugangsdaten anfordern #
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 hier kostenfrei beantragen.
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 für unseren AGB sowie unterschriebenen Auftragsverarbeitungsvertrag. Dies kannst du über unser Formular erledigen: Nutzung der Endereco Services.
Zum Auftragsverarbeitungsvertrag: 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: www.endereco.de/agb
Wir benötigen eine Freigabe der Deutschen Post, die ca. 2-3 Tage dauern kann.
Eingabe der Zugangsdaten #
In den Moduleinstellungen kannst du nun die Zugangsdaten hinterlegen und die Prüfungen der Adressen konfigurieren.
Konfiguration des Moduls #
Wahl des Prüfmodus #
Du hast die Möglichkeit verschiedene Services ein- und auszuschalten, z. B.:
- Autovervollständigung für Adressdaten
- Adressprüfung
- Prüfung von Bestandskunden
- Prüfung von PayPal Express Bestellungen
„Standardland“
Hier kannst du einstellen, welches Land in deinem Adressformular automatisch vorausgewählt wird, sollte Shopware kein Land definiert haben. Idealerweise ist es das Land, für das du die meisten Kundenbestellungen erhältst.
(Hinweis: Aktuell ohne Funktion – Wir arbeiten an einer Lösung)
„AMS aktivieren (Adressprüfung und Eingabeassistent)“
Der Eingabeassistent generiert für den Kunden anhand der eingegebenen Daten die Vorschläge für PLZ, zugehörigen Ort und Straßen. 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.
„Eingabe-Assistent (Autocomplete) aktivieren – Hier kannst du den Adresseingabe-Assistent auf Wunsch ausschalten, wenn z.B. für dein Land kein Eingabeassistent verfügbar ist. Die Adressfelder werden dann nicht in der Reihenfolge gedreht, sondern es wir die Standardeinstellung des Shops genutzt.
„Schließen der Korrekturhinweise erlauben“ – Ist diese Funktion aktiv, kann der Kunde Adressvorschläge der Adressprüfung übergehen ohne eine Auswahl treffen zu müssen.
„Kunde muss eine fehlerhafte Adresse mit einer Checkbox bestätigen“ – Ist diese Funktion aktiv, muss der Kunde seine Eingabe aktiv bestätigen, wenn er keine Korrekturvorschläge von Endereco übernehmen möchte.
„Straße in Straßenname und Hausnummer unterteilen„ – Beim Aktivieren wird das Standardfeld ‚Straße und Haus Nr.‘, in zwei Pflichtfelder ‚Straße‘ und ‚Hausnummer‘ unterteilt.
Der Kunde muss jetzt beide Felder getrennt eingeben. Das hat den Vorteil, dass keine Hausnummer mehr vergessen werden kann. Shopware speichert die Daten weiterhin in einem gemeinsamen Feld.
„Adressen der 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.
„Adressen über PayPal Express Checkout prüfen“ – Die Daten von Kunden, die mit PayPal Express Checkout die Bestellung abschließen möchten, werden geprüft.
„Validierung der Rechungs- und Lieferadressen in „Custom Fields“ schreiben“
Die Statuscodes einer Prüfung einer Adresse werden nun in Custom Fields gespeichert. Dies passiert aktuell nur bei einer Prüfung, liegt also nicht bei jeder Bestellung vor. Die Statuscodes sind aktuell zur internen Verwendung vorgesehen, können aber auch – ohne Gewährleistung – für andere Zwecke genutzt werden. Wir werden diese Funktion zukünftig offiziell unterstützen.
„Adressprüfung beim Kundenimport durchführen“
Werden Kundendaten durch ein Import oder eine Synchronisation mit einer Wartenwirtschaft aktualisiert so kann über diesen Schalter definiert werden, ob die syncrhonsierten Kunden geprüft werden oder nicht.
Diesen Schalter bitte mit Vorsicht bedienen oder bitte bei uns nachfragem ob ungewollte Prüfungen einlaufen.
Hinweise: #
Bei Amazon Pay Kunden – Bezahlen mit Amazon – erfolgt keine Prüfung der Kundenadressen!
Bei „Login mit Amazon“ wird der Kunde ebenfalls nicht geprüft.
Prüfung von Namen #
Die „Namensprüfung“ stellt fest, ob ausgewählte Anrede zum Vornamen passt. Des Weiteren wird der Vorname, Nachname sowie Titel erkannt und die Schreibweise normiert.
Wurde noch keine Anrede mit der Eingabe des Vornamens gewählt, so kann diese automatisch gesetzt werden, sofern der eingegebene Vorname erkannt wurde, und eindeutig einem Geschlecht zugewiesen werden kann.
Groß- und Kleinschreibung wird auch automatisch angepasst. Namen, die nicht bekannt sind oder mehrdeutig sein können, werden nicht als falsch markiert.
Prüfung von E-Mail Adressen #
Die „E-Mail Prüfung“ verifiziert die Syntax, Erreichbarkeit und Zustellbarkeit eines E-Mail-Postfachs sowie die Existenz einer eingegebenen E-Mail-Adresse.
Prüfung von Telefonnummern #
Unsere „Telefonnummernprüfung“ erkennt Mobil- und Festnetznummern. Diese werden in einem zu definierenden Format automatisch normiert. Mobilfunknummern werden auf Wunsch auf Erreichbarkeit geprüft.
Erweitere Einstellungen #
„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. 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.
„Adressprüfung beim Absenden des Formulars auslösen“ – In diesem Fall findet die Adressprüfung erst beim Klicken auf „Weiter“ oder „Speichern“ statt.
„Standard-Pfad zur Proxydatei „io.php“ anpassen (optional)“ – Wenn Probleme bei der Ausführung der Proxy-Datei „io.php“ bestehen (z.B. beim Einsatz von AMAZON AWS, oder wenn Plugin-Bundles in einem anderen Ordner gespeichert werden), kann der Pfad zur „io.php“ Datei manuell hinterlegt werden. Eine Kopie der io.php Datei kann im „/public“ Ordner erstellt werden. Dann kann z. B. der Pfad „%SHOP_URL%/io.php“ eingetragen werden.
„Standard CSS laden“ – Gibt an, ob Standard CSS-Klassen des Endereco Moduls geladen werden sollen. Ist diese Option nicht aktiviert, werden keine CSS Informationen geladen. Sie können dann das Styling der Elemente selbst z. B. im Theme definieren.
„Endereco JavaScript Datei nur auf bestimmten Seiten laden (Standardseiten mit Adressformularen)“ – Ist diese Funktion aktiv, wird die endereco.min.js Datei nur auf bestimmten Seiten geladen. Dadurch verbessert sich die Ladezeit des Shops. Standard Controller Namen sind bereits in der Whitelist.
„Plugin auch für folgende Controllern aktivieren (optional, kommagetrennt)“ – Das Javascript von Endereco wird bei den hier hinterlegten Controllern ausgegeben. Die Controller Namen müssen mit „,“ getrennt eingeben werden.
Damit ist die Einrichtung abgeschlossen.
Datenschutzerklärung ergänzen #
Nun solltest du noch deine Kunden darüber informieren, dass wir die Adressdaten, ggf. auch weitere personenbezogene Daten prüfen.
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 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 DS-GVO, 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, Strasse, ggf. Hausnummer)
– E-Mail Adresse (wenn nicht aktiviert bitte löschen)
– Anrede, Vorname, Nachname und Titel (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 einen weiteren Textabschnitt einfach zu deinen anderen Inhalten der Datenschutzerklärung hinzufügen.
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.
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: support@endereco.de oder Tel: 0931 66 39 839 – 0
Dein Endereco Team
