Dutch Address Autocomplete : installation et aide

• Recherche néerlandaise. Une rue ou un code postal avec numéro dans le champ de rue existant.
• Champs renseignés ensemble. Rue, numéro avec lettre ou complément, code postal et ville après sélection.
• Source officielle. PDOK Locatieserver de Kadaster, avec les données du registre BAG.
• Formulaires natifs. Compte client, commande invitée, facturation distincte et adresses en back-office.
• Saisie quotidienne. Sélection tactile ou au clavier, annonces pour lecteurs d’écran et saisie manuelle conservée.
• Accès gratuit. Sans compte, clé ni coût par recherche, avec des interrupteurs propres aux formulaires.

Les quatre commandes visibles sont, dans l’ordre : Suggérer des adresses pendant la saisie du client; Dans le formulaire d'adresse du compte client; Dans les formulaires d'adresse de la commande (clients invités et adresses de facturation séparées compris); Sur le formulaire d'adresse du back-office (adresses des clients, nouvelles commandes). Elles sont actives par défaut. Enregistrer suit les interrupteurs, puis viennent les notes de couverture, de saisie manuelle, de confidentialité et de CSP. Couper l’interrupteur général désactive les suggestions pour tous les formulaires.

Ouvrez Configurer dans le gestionnaire de modules ou l’entrée Dutch Address du menu du back-office. Cette version regroupe Configuration, Intégrité, Licence, Mise à jour et Support sur une page Réglages. Les valeurs s’appliquent à une boutique. En multiboutique, choisissez une boutique autorisée avant de modifier.

La page ne contient ni clé de service ni sélecteur Utiliser pour ces pays. Ce sélecteur appartient aux adaptateurs mondiaux. La couverture fixe NL passe avant un adaptateur mondial sans restriction. Une liste choisie qui inclut aussi NL peut passer avant PDOK ; évitez ce chevauchement. Une liste mondiale vide signifie tous les pays proposés par le formulaire et ne change pas vos destinations de vente.

Les textes sources anglais et les traductions de réglages néerlandaises, allemandes, françaises, polonaises, italiennes et espagnoles sont fournis. L’anglais utilise les textes sources pour les notes PDOK actuelles.

Autoriser PDOK dans une Content Security Policy

L’origine externe relevée dans cet adaptateur est https://api.pdok.nl. PDOK ne charge ni kit distant, ni feuille de style, ni police. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Fusionnez cet exemple avec votre politique existante en conservant les règles du thème, de la configuration intégrée et des autres modules. French Address Autocomplete demande aussi https://data.geopf.fr dans connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://api.pdok.nl;

Conserver les précisions de livraison

Saisissez appartement, étage ou précision de livraison sur la seconde ligne avant de choisir un résultat. Cette ligne reste intacte, tout comme pays, nom, entreprise et téléphone. Complétez une rue seule avec numéro et code postal avant d’enregistrer. Aucune province n’est fournie et votre client peut modifier les champs ordinaires.

Prérequis

• Compatibilité générale PrestaShop : PS 1.6 – 9.x. Minimum exact déclaré : PrestaShop 1.6.1.0 ; PHP 7.1 ou ultérieur.
• Champs d’adresse natifs et présentation de liste Bootstrap 3, 4 ou 5. Vérifiez les formulaires et thèmes personnalisés séparément.
• Pays-Bas proposé dans le formulaire et interrupteurs concernés actifs. Ni compte, ni clé, ni paiement par recherche PDOK.

Si un ancien module d’adresse est installé, les suggestions néerlandaises peuvent rester désactivées et la page de réglages du module vous indique quel module mettre à jour. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

Les suggestions commencent après trois caractères et une pause de 300 ms. L’adaptateur envoie une requête GET au service suggest de PDOK avec le texte, des filtres fixes d’adresse et de rue et les noms des champs souhaités. Il demande dix enregistrements, écarte résultats mal formés et doublons, privilégie les adresses complètes et en affiche au plus cinq. Une rue seule peut apparaître uniquement sans adresse complète et sans chiffre saisi. La liste n’est pas exhaustive.

Le choix remplit les champs depuis la suggestion, sans seconde recherche. Un résultat complet accepté possède un numéro entier positif, une lettre facultative, un complément alphanumérique facultatif de 1 à 4 caractères, un code postal néerlandais et une ville. Les formats non pris en charge sont écartés. Le code postal est espacé et mis en majuscules ; la lettre suit le numéro et le complément un trait d’union.

Quels champs sont renseignés après une sélection

Un résultat complet fournit la rue, le numéro avec la lettre ou le complément renvoyé, le code postal et la ville. Une lettre reste accolée au numéro, par exemple 12A ; un complément suit un trait d’union, comme Damrak 12-H. Le code postal est espacé et mis en majuscules au format PrestaShop, par exemple 1012 LG. Ces exemples décrivent un format et non une adresse garantie.

Le pays choisi, le nom, l’entreprise, le téléphone et la seconde ligne déjà remplie restent intacts. Votre client peut y conserver un étage ou une indication de livraison et modifier le résultat avant d’enregistrer. Une suggestion de rue seule ne fournit ni numéro ni code postal : il faut les compléter. Cet adaptateur ne renseigne pas de province.

Quelles destinations reçoivent les suggestions néerlandaises

Les suggestions PDOK concernent la partie européenne des Pays-Bas, avec Pays-Bas sélectionné dans le formulaire. Le module ne couvre pas les territoires néerlandais des Caraïbes ni le monde entier. Un changement de pays arrête les suggestions néerlandaises ; un autre service installé peut répondre selon sa couverture et ses réglages.

French Address Autocomplete peut servir ses destinations françaises tandis que PDOK répond pour les Pays-Bas. Google Address Autocomplete et Fetchify Address Autocomplete conservent leurs propres réglages de pays. La couverture fixe passe avant un service mondial sans restriction ; évitez les listes de pays qui se chevauchent. Un échec ne déclenche pas de nouvelle recherche automatique auprès d’un autre service.

Où votre équipe reçoit-elle cette aide en back-office

Dans Clients > Adresses, votre équipe reçoit des suggestions dans le champ de rue natif. Elle peut saisir le code postal et le numéro communiqués par téléphone, choisir une adresse proposée et vérifier rue, code postal et ville avant l’enregistrement. La lettre ou le complément renvoyé est conservé avec le numéro.

L’intégration vise aussi la fenêtre native d’adresse d’une nouvelle commande lorsqu’elle est servie par AdminAddresses. Les autres fenêtres et les formulaires personnalisés nécessitent leur propre vérification. L’interrupteur du back-office est indépendant de ceux du compte et de la commande native. Lorsque Checkout Revolution utilise ce moteur d’adresses partagé, il utilise les mêmes réglages par boutique pour ce service.

Comment la liste fonctionne-t-elle sur téléphone et au clavier

Sur téléphone, votre client touche une suggestion sous le champ de rue. Les flèches parcourent la liste, Entrée sélectionne et Échap ou Tab ferme la liste. Le nombre de résultats est annoncé aux lecteurs d’écran. La liste partagée prend en charge la présentation Bootstrap 3, 4 et 5 et reste près des champs que le client remplit.

La liste affiche le crédit PDOK Locatieserver (Kadaster, BAG). Sans correspondance utilisable, elle reste fermée et la saisie manuelle reste possible. Si le service tarde à répondre, « Recherche des adresses… » s’affiche brièvement sous le champ de rue puis disparaît ; après 10 secondes sans réponse, vous pouvez simplement saisir l’adresse à la main. Une erreur réseau ou du service peut afficher un bref message, sans imposer une sélection. Votre client vérifie la destination : cette aide ne valide pas l’adresse à l’envoi et ne garantit pas la livraison.

Requêtes, adresses enregistrées et confidentialité

La requête GET directe du navigateur envoie q (texte saisi), rows=10, fq=type:(adres OR weg) et fl (liste fixe des champs). Elle n’envoie ni clé, paramètre de pays sélectionné, langue de page ou identifiant de session. Nom, e-mail, téléphone, entreprise et seconde ligne ne sont pas explicitement ajoutés ; tout texte saisi dans la recherche fait partie de la requête. Les identifiants interorigines sont désactivés.

PDOK reçoit l’adresse IP du visiteur par la connexion et peut recevoir des informations du navigateur (en-têtes Origin et Referer) selon la politique du navigateur. Mentionnez ce transfert dans votre politique de confidentialité. Le module ne détermine ni consentement, ni conformité juridique, ni conservation par le fournisseur. Il ne crée pas de relais de recherche dans la boutique ni d’historique des recherches. L’enregistrement normal reste celui de PrestaShop.

Le crédit affiché est PDOK Locatieserver (Kadaster, BAG). Aucun crédit CC BY supplémentaire n’est affiché. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

• Couverture. Pays-Bas européens uniquement. Aucune couverture des Caraïbes néerlandaises ni garantie de données complètes, fraîches ou de résultat pour chaque code postal et numéro.
• Disponibilité. Réseau, navigateur, CSP ou panne PDOK peuvent arrêter les suggestions. Une réponse 429 entraîne une pause Retry-After ou dix secondes ; délai maximal de dix secondes. Aucun relais automatique.
• Choix incomplet. Une rue seule efface le code postal et ne fournit pas de numéro. Complétez manuellement ; les formats invalides sont écartés.
• Formulaires natifs. Thèmes et fenêtres de compte, de commande ou d’adresse personnalisés nécessitent une vérification. La nouvelle commande vise AdminAddresses.
• Champs préservés. Pays, seconde ligne, nom, entreprise et téléphone restent inchangés. PDOK ne fournit pas de province.
• Protection du remplissage. Un changement de pays ou de valeurs, un champ absent ou une longueur excessive peut empêcher un remplissage tardif.
• Routage et paquets. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Si un ancien module d’adresse est installé, les suggestions néerlandaises peuvent rester désactivées et la page de réglages du module vous indique quel module mettre à jour.
• Saisie manuelle. Ni choix imposé, ni validation à l’envoi, géolocalisation, carte ou garantie de livraison. Les mises à jour gratuites à vie n’incluent pas d’engagement de support.

• Aucune suggestion : vérifiez Pays-Bas, les interrupteurs général et du formulaire, les destinations actives et Intégrité. Si un ancien module d’adresse est installé, les suggestions néerlandaises peuvent rester désactivées et la page de réglages du module vous indique quel module mettre à jour.
• Blocage CSP : autorisez https://api.pdok.nl dans connect-src et gardez les règles de scripts et styles de la boutique. Consultez la console ; l’exemple ne constitue pas une politique complète.
• Code postal ou complément absent : choisissez un résultat complet. Une rue seule demande une saisie manuelle ; les formats invalides sont écartés. Ne modifiez pas une capture pour inventer un résultat.
• Autre pays ou service : PDOK reste fixé à NL. Les autres services gardent leurs réglages. Évitez les listes choisies qui se chevauchent ; aucun relais sur erreur.
• Service indisponible ou remplissage refusé : attendez après une limitation, vérifiez réseau et champs, puis continuez manuellement. La suggestion ne bloque pas l’envoi et ne valide pas la livraison.