Installationsanleitung für JTL 4

Endereco Address Management Service Modul (AMS)
Für JTL 4.04 – 4.06

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

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.

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.

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

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 werden erkannt und gekennzeichnet.

Inhalt bearbeiten

Der Adresscheck validiert eingegebenen 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 #

Lade den aktuellsten Release des Endereco AMS Moduls für JTL 4 von GitHub herunter.

Die Datei ist ein Archiv und heißt endereco_jtl4_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 > Plugins > Pluginverwaltung 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“.

Update des Moduls #

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

Neue Version über Pluginmanager hochladen und dann auf „Aktualisieren“ drucken.

** Die Version 1.00 ist mit der Version 1.01 im Moment nicht kompatibel. Daher soll der „Aktualisieren“ Knopf nach dem Hochladen sofort gedruckt werden, sonst hat man einen Fehler. Als zweite Möglichkeit kann man die alte Version zuerst deinstallieren und danach die neue installieren. Es kann aber zu Verlust von Statuscodes bei Bestandskunden führen.

PS: 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, 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/

Ab Version 1.1.0 verfügt Endereco Plugin für JTL 4 über die Statuscode Mapping Funtion für JTL WaWi.

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 28. Januar 2024