Belgian Address Autocomplete

Belgian Address Autocomplete is a free PrestaShop module for entering Belgian addresses. Choosing a numbered suggestion fills street and house number, four-digit postcode and town. It uses the official address registers of Flanders, Brussels and Wallonia, without an account, key or cost per lookup.

Quick start

1. Upload and install the module ZIP in PrestaShop. No service account, key or payment setup is needed.
2. Open Configure, or the Belgian Address entry in the back office menu; in multishop select one shop you can manage.
3. Check that Belgium is active and available on the native address forms you use.
4. Choose the overall, account, checkout and back office switches, in that order, and save. There is no country selector here.
5. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.
6. Merge the three regional origins into an existing CSP and mention the browser connections in your privacy notice.
7. Select Belgium and type rue royale 10 bru. Choose Rue Royale 10, 1000, Bruxelles when returned. Add the box manually on line two. Test street-only completion, manual entry, guest, invoice, staff/new-order, France with French Address Autocomplete and phone width.

Features

• Belgian address suggestions. Official regional registers in native account and checkout forms, including guests.
• Filled together. Street and house number, four-digit postcode and town from a numbered choice.
• Fixed Belgium coverage. Flanders, Brussels and Wallonia together; box details and street-only results need manual completion.
• Back office. The same postal address help for staff in Customers > Addresses.
• Everyday entry. Phone taps, keyboard navigation and screen-reader announcements; manual entry remains.
• No service account. A free module using free regional data, with four separate switches and no key.

Configuration options

• 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 Belgian Address entry in the back office menu. This release has one Settings page with Configuration, Integrity, License, Update and Support sections. The four switches above appear in that order, followed by Save. All default to on. There is no provider key, account or country field. In multishop select one authorized shop; settings are stored for that shop. After the form the notes cover coverage/free service, manual entry, privacy and CSP, followed by the shared sibling-service note. English, German, French, Polish, Italian, Spanish and Dutch settings strings are supplied; this does not promise address data in seven languages.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. Belgian Address remains fixed to BE. 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 Belgian Address for Belgium. No failed search automatically retries another service.

Customization examples

Allow the three Belgian regions in your Content Security Policy

The source-derived connect-src origins are https://geo.api.vlaanderen.be, https://geoservices.irisnet.be and https://geoservices.wallonie.be. No remote SDK or stylesheet is loaded. Merge this example into your existing policy, preserving theme rules, inline/nonces and other modules. With French Address Autocomplete also allow https://data.geopf.fr in connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://geo.api.vlaanderen.be https://geoservices.irisnet.be https://geoservices.wallonie.be;

Retain apartment and delivery details

The selected country, second address line, name, company and telephone stay unchanged. Add or keep box, flat, floor, entrance and building details on line two. Check street, house number, postcode and town before saving. A street-only choice still needs a house number. Flanders street-only results clear the postcode; Brussels and Wallonia keep it when returned. Complete missing details manually.

Installation

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. Belgium must be available; activate it if you deliver there.
• Check that Belgium 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. Belgian Address works alone.

Installation does not certify service availability or every platform/theme combination. Runs beside French Address Autocomplete, Google Address Autocomplete and Fetchify Address Autocomplete; keep all of them at their latest version.

How it works

Suggestions begin after three characters and a 300 ms pause. Four direct GET requests ask Flanders, Brussels in French and Dutch, and Wallonia in parallel. Flanders uses c=10&q=...; Brussels uses spatialReference=4326, fixed language=fr or nl, and address; Wallonia uses address. Word-prefix and numeric filters reduce fuzzy matches, with case/accent folding. Up to five distinct results merge round-robin, deduplicated by street, postcode and town. If Wallonia has no matching row and the query has at least three words, it retries once without the last word, still checking the full query. Apostrophes and search operators become spaces for Wallonia only. A usable regional result gives the slower services one more second before cancellation; other regions can supply rows despite a failure.

The plain line “Searching addresses…” appears after 600 ms while a search is pending. Each HTTP request gives up after ten seconds. The Wallonia retry can extend the whole search beyond ten seconds; there is no single ten-second overall deadline. Customers can keep entering the address manually throughout.

Selected address fields

Selection fills address1, postcode and city from the returned suggestion without another lookup. Flanders splits street/number from a four-digit postcode and town; Brussels uses the separate street, number, postcode and municipality fields; Wallonia parses level 4 addresses, moves a leading number to the end and removes trailing town underscores. Four-digit postcodes stay unspaced. Returned letters or slash suffixes can remain, but box numbers are added manually after the pick. Typed box details must match the returned address line and can produce no results. Street rows appear only with no valid numbered result and no typed digit. Flanders street picks clear postcode; Brussels/Wallonia keep a returned postcode. Complete the house number and any missing postcode manually. No province or special streetless-locality mode is supplied. Options have two lines: street and number, then postcode + town.

Use for these countries is available on worldwide siblings only. Empty means all countries available to the form; a selected list restricts that sibling. Belgian Address remains fixed to BE. 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 Belgian Address for Belgium. No failed search automatically retries another service.

Staff entering an address after a telephone enquiry get suggestions in Customers > Addresses. Choosing a Belgian 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. Checkout Revolution can load the same engine for its own address forms and reuse these per-shop service settings.

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 © Digitaal Vlaanderen, paradigm.brussels, SPW. 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 typed street-search text to all three regional services, using q for Flanders and address for Brussels and Wallonia. Fixed options include the Flanders result limit and the Brussels spatial reference and French/Dutch language. Wallonia gets cleaned text and may get one shortened retry; the full query still filters results. No key, selected-country, page-language, name, email, telephone, company or second-line parameter is added. Anything typed in the search is transmitted. Connections expose the visitor IP and may carry browser/origin/referrer information under browser policy. Credentials are disabled. Each HTTP request times out after ten seconds; a retry may extend the search. Selection is local. No search history or shop proxy is implemented; diagnostics omit queries and returned addresses. PrestaShop saves the chosen address normally. Mention these connections in your privacy notice. Visible credit: © Digitaal Vlaanderen, paradigm.brussels, SPW.

Honest limits

• Regional-register scope does not guarantee every address, freshness, continuous availability or unlimited use. Recorded fixtures do not certify current results or streetless-place coverage.
• Malformed rows are discarded and prefix matches can include longer names or numbers. Box, flat and building details need manual entry after selection. Street-only results need a number and sometimes a postcode; Flanders street-only choices clear postcode. Inspect the address before saving.
• HTTP 429 pauses only the affected host according to Retry-After or ten seconds; Brussels shares its pause across both languages. Other regions can still supply results. Each request times out after ten seconds, with a possible Wallonia retry. Manual entry remains; no failover to another installed service.
• Custom forms/themes and differently routed new-order windows need checking. Checkout Revolution can use 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.

Troubleshooting

• No Belgian results: select Belgium, 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 the regional services, 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 service settings for this shop.