Neue Magento 2 Erweiterung: Automatische Adressprüfung im Backend

Wir freuen uns, eine neue endereco-Erweiterung für Magento 2 vorzustellen: Version 1.0.0 ist ab sofort verfügbar.

• Version 1.0.0: kompatibel mit Magento 2.4 und höher

Die Erweiterung wurde in Zusammenarbeit mit Parc Network, einer auf Magento spezialisierten Agentur, entwickelt.

Was macht die Erweiterung?

Anders als unsere bekannte Checkout-Erweiterung für Magento 2 setzt dieses neue Plugin im Backend an: Es prüft automatisch die Versandadresse eingehender Bestellungen über die endereco API. Bestellungen mit einer problematischen Adresse werden zur Prüfung zurückgehalten, sodass fehlerhafte Adressen erst gar nicht in den Versand gelangen. So bleibt deine Auftragsabwicklung sauber und die Zahl gescheiterter Zustellungen sinkt.

Funktionsumfang

• Automatische Prüfung eingehender Bestellungen: Ein Cronjob prüft neue Bestellungen im konfigurierten Bestellstatus und schickt die Versandadresse an die endereco API.
• Bestellungen bei Bedarf zur Prüfung zurückhalten: Ist eine Adresse mehrdeutig, enthält sie Adresszusätze oder liefert die API einen als kritisch eingestuften Statuscode, wird die Bestellung automatisch auf Hold gesetzt.
• Optionale automatische Korrektur: Eindeutige Korrekturen der API können automatisch in die nativen Magento-Adressfelder übernommen werden.
• Volle Nachvollziehbarkeit: Originaladresse, API-Vorschlag und manuelle Korrektur werden pro Bestellung in einer eigenen Tabelle gespeichert.
• CSV-Export: Validierte Adressen lassen sich direkt aus dem Bestellraster exportieren, mit frei konfigurierbarer Spaltenzuordnung.
• Konfigurierbare Sharpness-Einstellungen: Du legst selbst fest, welche API-Statuscodes eine Bestellung auf Hold setzen und welche automatisch korrigiert werden dürfen.

So funktioniert es

1. Ein Cronjob prüft neue Bestellungen im konfigurierten Bestellstatus.
2. Jede Versandadresse wird zur Prüfung an die endereco API gesendet.
3. Je nach Ergebnis hält die Erweiterung die Bestellung zur manuellen Prüfung zurück oder korrigiert die Adresse automatisch, sofern Auto-Overwrite aktiviert ist.
4. Alle Ergebnisse – Originaladresse, API-Vorschlag und etwaige manuelle Korrektur – werden gespeichert.

Zur Prüfung zurückgehaltene Bestellungen lassen sich direkt im Magento Admin unter Sales → Orders einsehen und bearbeiten: Die Erweiterung zeigt die von der API vorgeschlagene Adresse an, du kannst sie bei Bedarf korrigieren und die Bestellung anschließend wieder freigeben.

Voraussetzungen

• Magento 2.4 oder höher
• Ein aktiver endereco-Account mit gültigem API-Key (hier erhältlich)
• Aktivierte Cronjobs in deiner Magento-Installation

Installation

Die Erweiterung kann per ZIP-Datei oder über Composer installiert werden. Wichtig für Live-Shops: Beim Ausführen von setup:upgrade den Parameter --keep-generated setzen, damit es beim Update nicht zu einer kurzen Ausfallzeit kommt:

php bin/magento setup:upgrade --keep-generated

Die vollständige Installationsanleitung inklusive Composer-Variante findest du im GitHub-Repository.

Empfehlung zum Einstieg

Wir empfehlen, für zur Prüfung zurückgehaltene Bestellungen einen eigenen Bestellstatus anzulegen (z. B. „Address Validation Pending“), statt den Standard-Hold-Status von Magento zu verwenden. So lassen sich betroffene Bestellungen im Bestellraster leicht filtern und gezielt exportieren. Details dazu findest du in der Dokumentation im Repository.

Mehr über endereco erfahren

Alles rund um unsere Adressvalidierung, unsere Integrationen für verschiedene Shopsysteme und die Magento-Anbindung findest du auf unserer Webseite.