Uniserv Address Cleansing Plugin
Mit dem Uniserv Address Cleansing Plugin können internationale Lieferadressen über Auftrags-Ereignisaktionen automatisiert geprüft und korrigiert werden. Abhängig vom Ergebnis können die Aufträge in einen gewünschten Status verschoben werden.
Direkter Download bei Plentymarkets Marketplace:
>> Uniserv Address Cleansing
Erste Schritte & Vorraussetzungen:
1. Kontodaten
Um Uniserv Address Cleansing in Ihrem plentymarkets 7 System nutzen zu können, benötigen Sie ein Konto bei Uniserv.
Ein kostenloses und unverbindliches Testkonto beinhaltet bereits 100 Test-Transaktionen. Ein Upgrade Ihres Testkontos ist jederzeit unkompliziert möglich.
Weitere Informationen zu Preisen, Laufzeiten und Kontingenten erhalten Sie bei cleversolution (sales@cleversolution.net)
Kostenlose Registrierung und Login bei Uniserv
Die erworbenen Transaktionen sind ein Jahr gültig. Bei Bedarf kann nachbestellt werden. Es gibt keinen Mindestumsatz (Prepaid-System).
2. Uniserv Address Cleansing in plentymarkets einrichten
2.1 Schnittstelle einrichten
- Öffnen Sie das Menü Plugins » Plugin-Übersicht.
- Klicken Sie auf das Plugin ** Uniserv Address Cleansing**.
- Klicken Sie auf Konfiguration » API.
Einstellung | Erläuterung |
---|---|
BENUTZERNAME | Geben Sie den Benutzernamen ein. |
PASSWORT | Geben Sie das Passwort ein. |
Speichern Sie die Einstellungen.
2.2 Auftragsstatuswechsel einstellen (optional)
Abhängig vom Ergebnis der Adressprüfung und Korrektur können die Aufträge in einen angegebenen Status verschoben werden. Öffnen Sie dazu die Uniserv Address Cleansing Plugin-Konfiguration:
- Öffnen Sie das Menü Plugins » Plugin-Übersicht.
- Klicken Sie auf das Plugin UniservAddressCleansing.
- Klicken Sie auf Konfiguration.
Der gewünschte Auftragsstatus für die verschiedenen Prüfungsergebnisse kann unter den folgenden Menüpunkten des Plugins gesetzt werden:
Empfohlene Einstellungen:
- Geben Sie bei Adresse korrigiert und Allgemeiner Status einen Auftragsstatus für valide Adressen an
- Aktivieren Sie die Optionen Adresse bei unsicherem Ergebnis nicht korrigieren, Adresse bei Warnung nicht korrigieren, Adresse bei mehreren Adressvorschlägen nicht korrigieren
- Vergeben Sie für die restlichen Einstellungen (Adresse nicht korrigiert, Verhalten bei Warnung, Verhalten bei mehreren Adressvorschlägen, Restdatenbehandlung, Fehlerbehandlung) einen Status in dem die Adressen von Hand geprüft werden.
Adresse korrigiert – Status
Einstellung | Erläuterung |
---|---|
Auftragsstatus bei korrigierter Adresse | Geben Sie den Auftragsstatus an, der gesetzt werden soll, wenn die Adresse korrigiert wurde. |
Adresse bei unsicherem Ergebnis nicht korrigieren | Aktivieren Sie diese Option, wenn die Adresse bei unsicherem Ergebnis (Ergebnisklasse 3) nicht korrigiert werden soll. |
Mindestabgleichsrate für Straße | Geben Sie die Mindesabgleichrate für das Adressfeld “Straße” an, die erreicht werden muss um die Adresse zu aktualisieren. Standard: 70 |
Mindestabgleichsrate für Stadt | Geben Sie die Mindesabgleichrate für das Adressfeld “Stadt” an, die erreicht werden muss um die Adresse zu aktualisieren. Standard: 70 |
Verhalten bei mehreren Adressvorschlägen
Einstellung | Erläuterung |
---|---|
Status des Auftrags bei mehreren Adressvorschlägen | Geben Sie den Status an der gesetzt werden soll, wenn es mehrere Adressvorschläge zu einer übermittelten Adresse gibt. |
Adresse bei mehreren Adressvorschlägen nicht korrigieren | Aktivieren Sie diese Option, wenn die Adresse bei mehreren Adressvorschlägen nicht mit der laut Schnittstelle wahrscheinlichsten Adresse korrigiert werden soll. |
Restdatenbehandlung
Einstellung | Erläuterung |
---|---|
Auftragsstatus bei vorhandenen Restdaten | Geben Sie den Auftragsstatus an der gesetzt werden soll, wenn der Adressvorschlag nicht zuweisbare Restdaten zurückliefert. |
Allgemeiner Status
Einstellung | Erläuterung |
---|---|
Auftragsstatus wenn sonstige nicht zutreffen | Geben Sie den Auftragsstatus an der gesetzt werden soll, wenn die obigen Einstellungen nicht zutreffen oder nicht gesetzt wurden. |
Fehlerbehandlung
Einstellung | Erläuterung |
---|---|
Auftragsstatus bei Fehler | Geben Sie den Auftragsstatus an der gesetzt werden soll, wenn Probleme bei der Kommunikation mit der Schnittstelle auftreten. |
Bitte beachten Sie, dass die optionale Einstellung für die Änderung des Auftragsstatus wie folgt priorisiert wird:
- Fehlerbehandlung
- Mehrere Adressvorschläge
- Adresswarnung
- Adresse korrigiert
- Adresse nicht korrigiert
- Allgemeiner Status
Ergebnisklasse:
0 = Keine Adresse von diesem Adresstyp wurde geprüft
1 = Die Adresse wurde eindeutig gefunden
2 = Die Adresse wurde sicher gefunden.
3 = Die Adresse wurde unsicher gefunden.
5 = Zu wenig Informationen oder Adresse nicht gefunden
2.3 Ereignisaktion einrichten
Sobald Sie das Plugin wie oben im aufklappbaren Bereich Erste Schritte und Anforderungen beschrieben aktiviert haben, ist es in den Auftrags-Ereignisaktionen Einrichtung » Aufträge » Ereignisse bei Aktionen im Ordner Plugins sichtbar.
Sie können nun die Aktion UniservAddressCleansing: Adresse prüfen und ggf. korrigieren hinzufügen. Die Prüfung, Korrektur und der optional einstellbare ergebnisabhängige Statuswechsel erfolgt unmittelbar nachdem das eingestellte Ereignis (z.B. Statuswechsel oder neuer Auftrag) eintritt.
2.4 Log
Die Datenkommunikation zwischen plentymarkets und Uniserv wird geloggt und ist im Menü Daten » Log zu finden.
Im Log werden die ursprüngliche und korrigierte Adresse, Statuscodes und Fehler erfasst. Der Log muss dafür für das Plugin aktiviert werden (Log level = Debug).