Installationsanleitung für JTL Shop

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

Aktuelle Release Notes:

Aktuelle Release Notes findest du ganz bequem auf unserer Github Seite:

Funktionsbeschreibung

Die Endereco Address Management Services ermöglichen auf einfache und unkomplizierte Weise, die Qualität der Adressdaten, die von Ihren Kunden eingegeben werden, zu verbessern. Hierfür wird ein zweistufiger Prozess in die Adressformulare integriert, der eine korrekte Erfassung der Daten über nahezu alle Eingabegeräte sicherstellt.

Stufe 1

a) Input Assistant – Eingabehilfe

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) Vornameprü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) 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
d) 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 werden erkannt und gekennzeichnet

Stufe 2

a) AddressCheck

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.


Installation

2.1 Installation des Moduls

Lade zuerst die aktuellste Version des Plugins 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”.

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

2.2 Update des Moduls

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

Neue Version über Plugin-manager 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.


Zugangsdaten anfordern

3.1 Test Zugangsdaten

Das Modul funktioniert nur mit gültigen Zugangsdaten.Diese können Sie auf unsere Webseite unter //www.endereco.de/oxid-eshop/ oder direkt per E-Mail an info@endereco.de kostenfrei beantragen.

Sie können dann das Modul inklusive alle Services 30 Tage unverbindlich testen.

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


Konfiguration des Moduls 

Der Plugin ist mit einer Standardkonfiguration ausgestattet und bedarf keiner Einstellung. Unvermeindlich 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 //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 und Support

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


Robert Rieser
CEO – Ansprechpartner für deine Anfragen

Du hast noch Fragen oder möchtest besondere Anforderungen besprechen?

Du kannst ein kostenfreies Meeting mit unseren Experten vereinbaren!

Auszug unserer Kunden

    Referenzen

    © Endereco UG (haftungsbeschränkt) - Gesellschaft für Master Data Quality Management - 2014 - 2021- Made with ♥ in Franconia