Installationsanleitung für JTL Shop

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

Functional description

Endereco Address Management Services provide a simple and straightforward way to improve the quality of the address data entered by your customers. To this end, a two-step process is integrated into the address forms to ensure that data is captured correctly on virtually all input devices.

Level 1

a) Input Assistant - Input help

Suggestions for entered address fragments are displayed in an autocomplete function of street, postcode and city. This works on PCs, tablets and smartphones. Address entry is simplified, accelerated and the error rate is massively reduced.

b) First name check - Does the form of address match the first name?

The Endereco first name database with over 30,000 entries can recognise gender-specific first names and marks the corresponding salutation field of your webshop. Ambiguous or unknown names are ignored. Upper and lower case is automatically corrected.

c) E-mail verification

An entered e-mail address is checked for various characteristics in real time:

  • Valid syntax of the e-mail address
  • Valid country domain
  • Is the mailbox full or deliverable?
  • If it is a one-way address or SPAM e-mail address
d) Telephone numbers Standardisation

Different ways of writing telephone numbers are very common. Endereco tidies up and gives telephone numbers a uniform, standardised spelling. In addition, Endereco distinguishes between mobile numbers and landline numbers and can include this feature if desired. Invalid prefixes are recognized and marked

Level 2

a) AddressCheck

The address check validates entered fields for validity in the overall context. Valid correction proposals are automatically offered for entries that are not plausible. The customer can choose between his entry and one of the correction codes.


Installation

2.1 Installation of the module

Lade zuerst die aktuellste Version des Plugins down.

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 of the module

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.


Request access data

3.1 Test access data

The module only works with valid access data, which you can download from our website at //www.endereco.de/oxid-eshop/ or directly by e-mail to info@endereco.de free of charge.

You can then test the module including all services for 30 days without obligation.

3.2 Live access data

For the live access data we need two signed and approved contracts, namely provider contract and data processing contract. You will find both contracts in your installation package. Of course we will gladly send you the contracts again by e-mail.

About the data processing contract: For some services in which we process personal data of the customer or pass them on to third parties via interfaces according to the DSGVO, we need a data processing contract. For example, when it comes to an e-mail deliverability check or telephone number standardization. You will also find this in the installation package.

Please send both signed contracts to
info@endereco.de or by fax to: 0931 6639839-9 or by mail to us.
We need a release from the German Post, which can take about 2-3 days.

Endereco UG (limited liability)
Robert Rieser
Balthasar-Neumann-Str. 4b,
97236 Edge bag


Configuration of the module 

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.


Functional test und Support

Now, after selecting the country "Germany" and entering a postcode, you should receive suitable suggestions for the city. Suggestions should also appear when you enter the street.

Have fun using our module. We are looking forward to your feedback, suggestions and feedback. This is the only way we can optimize our services for you!

If you have any questions we will be happy to help you!
Simply send an e-mail to: support@endereco.de or Tel: 0931 66 39 839 - 0
Your Endereco Team


Robert Rieser
CEO - Contact person for your inquiries

You still have questions or would like to discuss special requirements?

You can arrange a free meeting with our experts!

Extract of our customers

    References

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