Polish Address Autocomplete: setup and help

• Polish address suggestions. Official GUGiK PRG data on native account and checkout forms, including guests.
• Filled together. Street and returned building number, NN-NNN postcode and locality.
• Fixed Poland coverage. Villages without streets supported; street-only results need completion and flats are added manually.
• Back office. The same postal address help for staff in Customers > Addresses.
• Everyday entry. Touch, keyboard and screen-reader announcements; manual entry stays available.
• No service account. Free module and national data, four switches and no key.

• Suggest addresses while the customer types: overall switch, first in the form.
• On the address form in the customer account: native account addresses.
• On the checkout address forms (guests and separate invoice addresses included): native checkout.
• On the address form in the back office (customer addresses, new orders): native Customers > Addresses.

Open Configure in Module Manager, or the Polish Address entry in the back office menu. One settings page contains Configuration, Integrity, License, Update and Support in that order. The four switches above appear in order, followed by Save; all default to on. No provider key, account or country field. In multishop select one shop you can manage. Settings are saved per shop. After the form come coverage/free-service, manual-entry, privacy and CSP notes, then the sibling-service note. Settings texts are supplied in English, German, French, Polish, Italian and Spanish. These are interface languages, not a promise of translated address data.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. GUGiK remains fixed to PL. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Polish Address for Poland. No failed search automatically retries another service.

Allow GUGiK in your Content Security Policy

Allow https://capap.gugik.gov.pl in connect-src, the GUGiK origin used by the module and the supplied service probes. Scripts and styles are served by your shop. Merge this example into your existing policy, preserving theme rules, inline styles/nonces and other modules. With French Address Autocomplete also allow https://data.geopf.fr in connect-src. Check the browser requests and policy on your shop. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.

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

Retain apartment and delivery details

The selected country, second address line, name, company and telephone remain unchanged. PRG does not contain flat numbers: add the flat after selecting a result or keep it on line two with floor or entrance details. A pick replaces the street line with the returned address, so it does not preserve a flat typed there. Check the building number, postcode and locality before saving. A street-only choice clears the postcode; complete number and postcode manually.

Requirements

• General PrestaShop range: PS 1.6 – 9.x. Exact declared floor: PrestaShop 1.6.1.0, PHP 7.1 or later.
• Native address fields and Bootstrap 3, 4 or 5 presentation. Poland must be available; activate it if you deliver there.
• Check that Poland is active and available on the native address forms you use.

Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. Polish Address works alone.

Test on the forms and theme your shop actually uses. Keep the browser request evidence with your deployment checks. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.

Suggestions begin after three characters and a 300 ms pause. The browser sends a direct GET to GUGiK CAPAP ref/qn, with the normalized text in q, f=json, offs=0, cnt=10, the fixed Polish bounding box, bboxm=soft, top=and and useExtSvc=true. A query containing a digit uses idx=pkt for address points; otherwise it uses idx=ulc for streets. When eligible, ref/ac sends the last word in b, empty a, cnt=5 and idx=pkt,ulc; up to two completed searches can follow. The first nonempty valid result wins and cancels the others. Up to five unique suggestions are shown, on two lines: street/locality and number, then postcode and locality.

While a search is pending, the plain line “Searching addresses…” appears after 600 ms. Each individual request gives up after ten seconds; a chain of completion requests can take longer overall. At busy times the service can be slower; the module’s coverage note also mentions a brief nightly pause. Customers can always enter or edit the address by hand.

Selected address fields

A chosen address point fills street and building number as returned, for example Marszałkowska 100/102, postcode 00-026 and locality Warszawa. The slash here belongs to the returned building number; it is not a flat lookup. Nonordinary street types are retained, such as pl. Zamkowy, without doubling Aleje in Aleje Jerozolimskie. Villages without streets use locality and number. The locality comes from PRG and may differ from the postal town. Address-point rows need a locality, a nonempty building number, an NN-NNN postcode and, when present, existing status. Invalid or unrecognized rows are dropped. Street-only suggestions are used when the query has no digit; they fill street and locality while clearing postcode. Selection reuses the returned address without another retrieval call. No separate postal-town, district or province lookup is made.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. GUGiK remains fixed to PL. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version. For example leave a worldwide service for other destinations and enable Polish Address for Poland. No failed search automatically retries another service.

Staff entering an address after a telephone enquiry get suggestions in Customers > Addresses. Choosing a Polish address fills the same native street, postcode and town fields. The back office switch is independent of the account and checkout switches.

The code also targets native new-order address windows served by the customer address page. Custom routes and third-party forms need checking. The bundled engine supports marked checkout address forms and uses per-shop service settings shared with Checkout Revolution.

On a phone, tap a result beneath the street field. With a keyboard, use the arrows and Enter to select; Escape or Tab dismisses the list. Screen readers receive result announcements. The shared dropdown uses the theme’s Bootstrap presentation.

The list shows the credit GUGiK (PRG). No match leaves the list closed, and service failure announces that suggestions are unavailable. Customers keep manual entry and editing. Saving an address never requires a suggestion, and the module does not validate delivery addresses on submission.

Privacy and data credit

The browser sends the typed street-search text, fixed search options and, where applicable, last-word completions directly to GUGiK at https://capap.gugik.gov.pl. No key, selected-country, language, name, email, phone, company or second-line parameter is added. Anything entered in the search field is sent. Requests disable credentials. The direct connection exposes visitor IP and browser information; origin and referring-page information follow browser policy. No search-history feature or shop proxy is implemented, and diagnostics omit queries and returned addresses. Normal chosen addresses save through PrestaShop. Mention this transfer in your privacy notice. Visible credit: GUGiK (PRG).

• Coverage and availability depend on GUGiK; neither every address nor continuous service is guaranteed. No exhaustive postcode directory or unlimited-use promise.
• PRG has no flats. Add them after selection or on line two. Locality can differ from postal town. Address points need a valid NN-NNN code; street-only choices need manual number and postcode completion.
• 429 responses pause according to Retry-After or ten seconds. Every request times out after ten seconds; chained searches may last longer. Manual entry remains and no automatic service failover occurs.
• Custom forms/themes and differently routed new-order windows need checking. Custom checkout forms need integration with the shared engine.
• No map, geolocation, coordinate storage, submit-time validation, automatic country selection or delivery guarantee. Free module with lifetime updates, no included support commitment.

• No Polish results: select Poland, check its active status and the overall/form switches, then try full street + number + town.
• Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.
• Street-only or no result: complete the house number, postcode and post town manually, and check the address before saving.
• Unavailable suggestions: inspect browser network/CSP for GUGiK, wait after a rate limit and continue manual entry.
• Custom form or layout issue: test a native address form, phone/keyboard use and the new-order route; check the shared service settings for the selected shop.