Installationsanleitung für JTL 5

Endereco Address Management Service Modul (AMS)
Für JTL 5.00 – 5.03

Aktuelle Release Notes

Funtionsbeschreibung #

Die Endereco Adressmanagement 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

Inhalt bearbeiten
Adress-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.

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.

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?

Die Rufnummernprüfung erweitert das Feld „Telefon“ um eine Landesflagge und zeigt entsprechend der gewählten oder eingegebenen Vorwahl die passende Landesflagge an.
Wird keine Vorwahl hinterlegt, wird vom Standardland des Shops bzw. dem gewählten Land im Dropdown der Adresse ausgegangen. Dabei wird die Rufnummer dann auf das gewünschte Zielformat konvertiert.

Inhalt bearbeiten
Adressvalidierung

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 #

Neuinstallation des Moduls #

Lade den aktuellsten Release des Endereco AMS Moduls für Shopware 5.3.x und größer von GitHub herunter.

Die Datei ist ein Archiv und heißt endereco_jtl5_client-x.x.x.zip, wo x.x.x für die Versionsnummer steht.

Falls hinten dran noch ein -rc.x hängt, handelt es sich dabei um eine Entwicklerversion des Plugins. Sie enthält die neusten Features, kann aber unstabil sein. Man kann sie im Testshop testen.

Danach das Archiv einfach im Shop hochladen. Dafür im Admin > Plugin-Manager auf den Reiter „Upload“ klicken, das heruntergeladene Archiv auswählen und auf „Hochladen“ klicken.

Nach dem Hochladen erscheint der Plugin in der Liste der verfügbaren Plugins. Wähle ihn aus und klicke auf „Installieren“.

Ist der Plugin installiert, soll bei ihm gleich ein API-Key eingetragen werden. Falls der API-Key noch nicht vorliegt, deaktiviere erstmal den Plugin.

Update des Moduls #

Um JTL Plugin zu aktualisieren, soll zuerst die neue Version von GitHub-Seite heruntergeladen werden.

Neue Version über Plugin-Manager hochladen und dann auf „Aktualisieren“ drucken.

PS: Trage dich gerne in unseren Release-Newsletter ein, dann wirst du bei einem Update immer schnell informiert. 

Aktivieren des Moduls im Backend #

  • Im Backend einloggen
  • API-Key eintragen
  • Speichern

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 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.

Wechsel in den kostenpflichtigen Produktivmodus #

Für die live Zugangsdaten benötigen wir deine Zustimmung für unseren AGB sowie unterschriebenen Datenverarbeitungsvertrag. Dies kannst du über unser Formular erledigen: Nutzung der Endereco Services.

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.

Zu unseren AGB: www.endereco.de/agb

Wir benötigen eine Freigabe der Deutschen Post, die ca. 2-3 Tage dauern kann.

Konfiguration des Moduls #

Wahl des Prüfmodus #

Der Plugin ist mit einer Standardkonfiguration ausgestattet und bedarf keiner Einstellung. Unvermeidlich ist jedoch das Eintragen eines API-Keys.

Weitere Funktionen, wie Prüfung von PayPal Express Kunden, kann ein- bzw. ausgeschaltet werden.

Für diesen API-Keys werden einzelne Dienste bei Endereco Server freigeschaltet.

Den API-Keys erstellen wir auf Anfrage bei info@endereco.de oder über unsere Website https://www.endereco.de/jtl/

Weitere Funktionen wie E-Mail- und Anredeprüfung, sowie Entwicklereinstellungen stehen in der Konfiguration des Plugins zu Verfügung.

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

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 2 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)

  • 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 Rechtstexte Generator sind unsere endereco Services unter „Tools und Sonstiges“ > „Verwenden Sie Dienste für automatische Adressprüfung und Eingabekorrekturen“ gelistet.
Was sind deine Gefühle
Aktualisiert am 26. Januar 2024