Polish Address Autocomplete : installation et aide

• Suggestions polonaises. Données officielles GUGiK PRG sur les formulaires natifs de compte et commande, invités compris.
• Champs remplis ensemble. Rue et numéro de bâtiment renvoyé, code NN-NNN et localité.
• Pologne fixe. Villages sans rues pris en charge ; rues seules et appartements à compléter à la main.
• Back-office. Même aide pour l’équipe dans Clients > Adresses.
• Saisie quotidienne. Écran tactile, clavier et annonces pour lecteurs d’écran ; saisie manuelle conservée.
• Sans compte du service. Module et données nationales gratuits, quatre interrupteurs, aucune clé.

• Suggérer des adresses pendant la saisie du client : interrupteur général, premier champ.
• Dans le formulaire d'adresse du compte client : adresses natives du compte.
• Dans les formulaires d'adresse de la commande (clients invités et adresses de facturation séparées compris) : invités et facturation distincte inclus.
• Sur le formulaire d'adresse du back-office (adresses des clients, nouvelles commandes) : adresses clients et nouvelles commandes natives.

Ouvrez Configurer dans le Gestionnaire de modules, ou l’entrée Polish Address du menu du back-office. La page unique contient Configuration, Intégrité, Licence, Mise à jour et Assistance dans cet ordre. Les quatre interrupteurs ci-dessus sont suivis d’Enregistrer et sont tous actifs par défaut. Aucun champ de clé, compte ou pays. En multiboutique, choisissez une boutique que vous pouvez gérer. Les réglages sont propres à chaque boutique. Après le formulaire viennent les notes de couverture/service gratuit, saisie manuelle, confidentialité, CSP et services frères. Les textes sont fournis en anglais, allemand, français, polonais, italien et espagnol. Ce sont des langues d’interface, sans promesse de données d’adresse traduites.

Utiliser pour ces pays existe uniquement sur les modules mondiaux. Vide signifie tous les pays du formulaire ; une liste limite le module concerné. GUGiK reste fixe sur PL. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Vous pouvez laisser un service mondial pour les autres destinations et activer Polish Address pour la Pologne. Aucun échec ne provoque un relais automatique.

Autoriser GUGiK dans une politique de sécurité du contenu

Autorisez https://capap.gugik.gov.pl dans connect-src, adresse GUGiK utilisée par le module et les essais du service fournis. Les scripts et styles viennent de votre boutique. Ajoutez cet exemple à votre politique existante en conservant les règles du thème, styles intégrés/jetons de sécurité et autres modules. Avec French Address Autocomplete, autorisez aussi https://data.geopf.fr dans connect-src. Vérifiez les requêtes du navigateur sur votre boutique. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

script-src 'self';
style-src 'self';
connect-src 'self' https://capap.gugik.gov.pl;

Conserver les détails d’appartement et de livraison

Pays, deuxième ligne, nom, entreprise et téléphone restent inchangés. PRG ne contient pas les numéros d’appartement : ajoutez-les après le choix ou gardez appartement, étage et entrée sur la deuxième ligne. Le choix remplace la ligne de rue par l’adresse renvoyée ; un appartement saisi sur cette ligne n’est pas conservé. Vérifiez numéro, code postal et localité avant d’enregistrer. Une rue seule vide le code postal ; numéro et code restent à compléter.

Prérequis

• Plage PrestaShop générale : PS 1.6 – 9.x. Minimum déclaré exact : PrestaShop 1.6.1.0 et PHP 7.1 ou ultérieur.
• Champs natifs et présentation Bootstrap 3, 4 ou 5. La Pologne doit être disponible ; activez-la si vous y livrez.
• Vérifiez que la Pologne est active et disponible sur les formulaires natifs utilisés.

Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Polish Address fonctionne seul.

Testez les formulaires et le thème réellement utilisés. Conservez les requêtes du navigateur avec vos vérifications de déploiement. 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 300 ms de pause. Le navigateur envoie une requête GET directe à GUGiK CAPAP ref/qn avec le texte normalisé dans q, f=json, offs=0, cnt=10, l’emprise fixe polonaise, bboxm=soft, top=and et useExtSvc=true. Une saisie contenant un chiffre utilise idx=pkt pour les points d’adresse, sinon idx=ulc pour les rues. Si possible, ref/ac envoie le dernier mot dans b, a vide, cnt=5 et idx=pkt,ulc ; jusqu’à deux recherches complétées peuvent suivre. Le premier résultat valide non vide interrompt les autres requêtes. Jusqu’à cinq suggestions distinctes apparaissent sur deux lignes : rue/localité et numéro, puis code postal et localité.

Si la recherche attend une réponse, la ligne simple « Recherche des adresses… » apparaît après 600 ms. Chaque requête expire après dix secondes ; une chaîne de recherches complétées peut durer davantage. Aux heures chargées, le service peut ralentir ; la note de couverture mentionne aussi une courte pause nocturne. Le client peut toujours saisir ou modifier son adresse à la main.

Champs de l’adresse choisie

Un point choisi remplit rue et numéro de bâtiment tels que renvoyés, par exemple Marszałkowska 100/102, code postal 00-026 et localité Warszawa. Ici, la barre oblique appartient au numéro du bâtiment : aucun appartement n’est recherché. Les types de voies particuliers sont conservés, comme pl. Zamkowy, sans doubler Aleje dans Aleje Jerozolimskie. Sans rue, localité et numéro sont utilisés. La localité PRG peut différer de la ville postale. Les points exigent une localité, un numéro de bâtiment non vide, un code NN-NNN et, si présent, un statut existant. Les lignes invalides sont écartées. Les rues seules sont recherchées sans chiffre ; leur choix remplit rue et localité et vide le code postal. La sélection utilise l’adresse déjà reçue, sans nouvel appel. Aucune recherche distincte de ville postale, district ou province.

Utiliser pour ces pays existe uniquement sur les modules mondiaux. Vide signifie tous les pays du formulaire ; une liste limite le module concerné. GUGiK reste fixe sur PL. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour. Vous pouvez laisser un service mondial pour les autres destinations et activer Polish Address pour la Pologne. Aucun échec ne provoque un relais automatique.

Dans Clients > Adresses, votre équipe peut choisir une adresse polonaise pour remplir rue, code postal et ville après un appel client. L’interrupteur du back-office est indépendant du compte et du tunnel.

Le code vise aussi les fenêtres natives d’adresse d’une nouvelle commande lorsqu’elles passent par la page des adresses clients. Routes et formulaires personnalisés nécessitent un essai. Le moteur fourni prend en charge les formulaires d’adresse de commande balisés et partage les réglages de service par boutique avec Checkout Revolution.

Sur téléphone, vos clients touchent un résultat sous la rue. Au clavier, les flèches naviguent, Entrée sélectionne et Échap ou Tab ferme la liste. Les lecteurs d’écran reçoivent les annonces de résultats. Le composant commun suit la présentation Bootstrap du thème.

Le crédit affiché est GUGiK (PRG). Sans résultat, la liste reste fermée ; une indisponibilité est annoncée. La saisie manuelle reste possible et l’enregistrement n’exige aucun choix. Le module ne valide pas la livrabilité lors de l’envoi.

Confidentialité et crédit des données

Le navigateur envoie le texte recherché, les options fixes et, si nécessaire, les mots complétés directement à GUGiK sur https://capap.gugik.gov.pl. Aucun paramètre de clé, pays choisi, langue, nom, courriel, téléphone, entreprise ou deuxième ligne n’est ajouté. Tout ce qui est saisi dans la recherche est transmis. Les requêtes n’envoient pas d’identifiants de connexion. La connexion expose l’IP et les informations du navigateur ; l’origine et la page de provenance dépendent de ses règles. Aucun historique de recherche ni relais par la boutique ; les diagnostics omettent recherches et adresses reçues. PrestaShop enregistre normalement l’adresse choisie. Mentionnez ce transfert dans votre politique de confidentialité. Crédit visible : GUGiK (PRG).

• Couverture et disponibilité dépendent de GUGiK. Ni toutes les adresses ni un service continu ne sont garantis. Aucun annuaire postal exhaustif ou usage illimité promis.
• PRG ne contient pas les appartements. Ajoutez-les après sélection ou en deuxième ligne. La localité peut différer de la ville postale. Les points exigent un code NN-NNN valide ; une rue seule nécessite numéro et code manuels.
• Une réponse 429 suspend les requêtes selon Retry-After ou dix secondes. Chaque requête expire après dix secondes ; une chaîne peut durer davantage. La saisie manuelle reste possible, sans relais automatique.
• Les formulaires/thèmes personnalisés et fenêtres de nouvelle commande sur d’autres routes doivent être testés. Les formulaires de commande personnalisés doivent être intégrés au moteur commun.
• Aucune carte, géolocalisation, conservation de coordonnées, validation à l’envoi, sélection automatique du pays ou garantie de livraison. Module gratuit avec mises à jour à vie, sans engagement d’assistance inclus.

• Aucun résultat polonais : sélectionnez la Pologne, vérifiez son activation et les interrupteurs, puis rue complète, numéro et ville.
• Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.
• Rue seule ou aucun résultat : complétez numéro, code postal et ville postale à la main puis vérifiez l’adresse avant d’enregistrer.
• Service indisponible : vérifiez réseau/CSP GUGiK, patientez après une limite et continuez manuellement.
• Formulaire ou présentation personnalisés : testez le formulaire natif, clavier/téléphone et route de commande ; vérifiez les réglages de service partagés de la boutique sélectionnée.