PrestaShop Checkout & Zahlung

DataFirefly Address Lookup – Adress-Autovervollständigung im Checkout für PrestaShop 8 & 9

Adress-Autovervollständigung im Checkout — kostenlose französische API + optionales Google Places

Reduzieren Sie Adresstippfehler und beschleunigen Sie den Checkout. Der Kunde tippt seine Postleitzahl, die Stadt wird ausgefüllt. Er tippt seine Straße, die komplette Adresse erscheint.

PrestaShop 8 & 9 Kostenlose französische API DSGVO-konform Keine Datenbanktabellen
  • 30 Tage Rückgaberecht
  • 12 Monate Updates
  • 24-h-Support
www.datafirefly.com/de/
DataFirefly Address Lookup Prestashop Module
v1.0.0 · aktualisiert 2026-05-15
Was es leistet

Die Kurzfassung.

01

Kostenlose französische API

Bereitgestellt von api-adresse.data.gouv.fr, der offiziellen API der französischen Regierung auf Basis der nationalen Adressdatenbank. Kein Schlüssel, keine spürbaren Quoten, vollständige Abdeckung des Staatsgebiets.

02

Optionales Google Places

Für Kunden außerhalb Frankreichs binden Sie Ihren Google-Places-Schlüssel ein und profitieren von weltweiter Abdeckung. Beschränkbar per Länder-Allowlist.

03

Postleitzahl → Stadt → Straße

Der Kunde tippt 75001: die Stadt wird automatisch ausgefüllt. Er tippt den Anfang seiner Straße: der Vorschlag vervollständigt die Adresse, die Hausnummer und bestätigt die Postleitzahl.

04

PrestaShop 8 und 9

Kompatibel mit Classic- und Hummingbird-Theme, One-Page- und Mehrschritt-Checkout. Standard-Hooks, keinerlei Template-Überschreibung, keine Datenbanktabellen.

Die ausführliche Fassung

Alles, was Sie wissen sollten bevor Sie installieren.

Ein detaillierter Blick darauf, wie DataFirefly Address Lookup - Adress-Autovervollständigung im Checkout für PrestaShop 8 & 9 funktioniert, warum wir es so gebaut haben und der Gedanke hinter den Funktionen oben.

§ 01

Das unsichtbare Problem, das Geld kostet: falsch geschriebene Adressen

Jeder zehnte Kunde gibt seine Adresse mit einem Tippfehler, einer unvollständigen Straße oder einer falschen Postleitzahl ein. Die Folge: fehlgeschlagene Lieferungen, Versandkosten für Neuversand, überlasteter Support, am Checkout abgebrochene Warenkörbe. In PrestaShop bietet das native Adressformular null Unterstützung — der Kunde tippt blind. DataFirefly Address Lookup löst dies, indem es das Adressformular in einen intelligenten Assistenten verwandelt, der in Echtzeit vorschlägt, vervollständigt und validiert.

§ 02

Die französische BAN-API: kostenlos und offiziell

Das Modul nutzt standardmäßig api-adresse.data.gouv.fr, die offizielle API der französischen Regierung. Es ist dieselbe Datenbank, die von Postdiensten und öffentlichen Informationssystemen verwendet wird: vollständige Gebietsabdeckung, kontinuierliche Aktualisierung, normalisierte Adressen. Kein API-Schlüssel, kein Abonnement, keine Nutzungskosten. Anfragen gehen direkt vom Browser des Kunden an die API — Ihr Server wird nie beansprucht, Ihre Bandbreite nicht verbraucht.

§ 03

Optionales Google Places für internationale Kunden

Wenn Sie international verkaufen, aktivieren Sie die Google-Places-Engine als Ergänzung. Geben Sie Ihren API-Schlüssel in der Konfiguration ein, beschränken Sie ihn per HTTP-Referrer in der Google Cloud Console, und das Modul wechselt automatisch zu Google, sobald der Kunde ein anderes Land als Frankreich wählt. Sie können Google auch auf eine Länder-Allowlist beschränken (BE, CH, LU, DE zum Beispiel), um Ihr Google-Cloud-Budget unter Kontrolle zu halten.

§ 04

Der Kunden-Workflow: Postleitzahl → Stadt → Straße

Der Kunde beginnt, seine Adresse auszufüllen. Er tippt die fünf Ziffern seiner Postleitzahl: stimmt eine einzige Gemeinde überein, füllt sich die Stadt von selbst aus; sonst erscheint ein Städteauswahl. Er beginnt, seine Straße einzugeben: das Modul fragt die BAN ab, gefiltert nach der bereits bekannten Postleitzahl, und schlägt die passenden Adressen vor. Ein Klick, und alle drei Felder werden auf einmal mit einer normalisierten Adresse gefüllt. Drei Interaktionen, null verschwendete Tastendrücke.

§ 05

Reibungsfreie Integration in jeden Checkout

Das Modul hängt sich an den Standard-Hook actionFrontControllerSetMedia und injiziert sein JavaScript und CSS nur auf Seiten, die ein Adressformular enthalten: Bestellung, Meine Adresse, Meine Identität, Registrierung. Keine Smarty-Template-Überschreibung. Keine Datenbanktabellen. Keine Abhängigkeit von einem bestimmten Theme — Classic, Hummingbird und die meisten Drittanbieter-Themes funktionieren ohne Konfiguration.

§ 06

Robustheit: kompatibel mit One-Page-Checkout und mehreren Formularen

Der One-Page-Checkout von PrestaShop rendert das Adressformular bei jedem Schrittwechsel neu, und einige Drittanbieter-Erweiterungen tun dasselbe. Das Modul bewältigt diese Neu-Renderings mit einem MutationObserver kombiniert mit nativen PrestaShop-Events: updatedAddressForm, updatedAddress, updatedDeliveryForm, changedCheckoutStep. Werden zwei Adressformulare gleichzeitig angezeigt (Versand + Rechnung), erhält jedes seine eigene unabhängige Autovervollständigung.

§ 07

Leistung und Datenschutz: kein Zwischenserver

Alle Anfragen zur Autovervollständigung gehen direkt vom Browser des Kunden zur gewählten API (BAN oder Google). Ihr PrestaShop-Server wird vom Modul während der Eingabe nie abgefragt: keine CPU-Last, kein Bandbreitenverbrauch, keine zusätzliche Latenz. Im Hinblick auf die DSGVO: keine Datenübertragung über DataFirefly, keine Datenerhebung auf der DataFirefly-Seite, kein Drittanbieter-Cookie vom Modul gesetzt.

§ 08

Konfiguration in zwei Minuten

Installieren Sie das Modul, öffnen Sie seine Konfiguration, und es ist bereits für Frankreich einsatzbereit. Für Google Places: aktivieren Sie die Option, fügen Sie Ihren Schlüssel ein, wählen Sie die Länder-Allowlist. Stellen Sie die Mindestzeichenzahl vor Auslösung ein, die Debounce-Verzögerung, die Aktivierung des Treffer-Highlights. Keine einzige Codezeile zu ändern.