Belgian Address Autocomplete

Belgian Address Autocomplete es un módulo gratuito de PrestaShop para introducir direcciones belgas. Una sugerencia numerada rellena calle y número, código postal de cuatro cifras y localidad. Usa los registros oficiales de Flandes, Bruselas y Valonia sin cuenta, clave ni coste por consulta.

Inicio rápido

1. Instala el ZIP del módulo en PrestaShop. No necesitas cuenta del servicio, clave ni preparar pagos.
2. Abre Configurar o la entrada Belgian Address del menú del back office; en multitienda elige una tienda autorizada.
3. Comprueba que Bélgica esté activa y disponible en los formularios nativos de dirección que uses.
4. Elige por orden los interruptores general, cuenta, pedido y administración, luego guarda. Aquí no hay selector de países.
5. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.
6. Añade los tres orígenes regionales a la CSP existente y describe las conexiones del navegador en tu política de privacidad.
7. Selecciona Bélgica y escribe rue royale 10 bru. Comprueba Rue Royale 10, 1000, Bruxelles si se devuelven. Añade el piso en la segunda línea. Prueba solo calle, entrada manual, invitados, factura, equipo/nuevo pedido, Francia con French Address Autocomplete y móvil.

Funciones

• Sugerencias belgas. Registros regionales oficiales en cuenta y pedido nativos, incluidos invitados.
• Campos rellenados juntos. Calle y número, código de cuatro cifras y localidad tras elegir un resultado numerado.
• Cobertura belga fija. Flandes, Bruselas y Valonia juntos; pisos y calles solas se completan a mano.
• Administración. Ayuda para el equipo en Clientes > Direcciones.
• Entrada cotidiana. Toques, teclado y avisos para lectores de pantalla; entrada manual disponible.
• Sin cuenta del servicio. Módulo y datos regionales gratuitos, cuatro interruptores y sin clave.

Opciones de configuración

• Sugerir direcciones mientras el cliente escribe: interruptor general, primero en el formulario.
• En el formulario de dirección de la cuenta de cliente: direcciones nativas de cuenta.
• En los formularios de dirección del pedido (incluidos invitados y direcciones de facturación separadas): invitados y direcciones de factura separadas incluidos.
• En el formulario de dirección del back office (direcciones de clientes, pedidos nuevos): direcciones de clientes y nuevos pedidos nativos.

Abre Configurar en el Gestor de módulos o la entrada Belgian Address del menú del back office. La página única tiene las secciones Configuration, Integrity, License, Update y Support (nombres en inglés). Los cuatro interruptores aparecen en ese orden, seguidos de Guardar. Todos están activos de inicio. No hay campo de clave, cuenta o país del servicio. En multitienda elige una tienda que puedas gestionar; los ajustes se guardan para esa tienda. Tras el formulario aparecen notas de cobertura/servicio gratuito, entrada manual, privacidad, CSP y servicios relacionados. Hay textos en inglés, alemán, francés, polaco, italiano, español y neerlandés; no implica datos de direcciones en siete idiomas.

Usar para estos países solo aparece en módulos mundiales. Vacío significa todos los países del formulario; una lista limita ese módulo. Belgian Address permanece fijo en BE. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Puedes dejar un servicio mundial para los demás destinos. Un error no relanza automáticamente otra búsqueda en otro servicio.

Ejemplos de personalización

Permite las tres regiones belgas en tu Content Security Policy

Orígenes connect-src deducidos del código: https://geo.api.vlaanderen.be, https://geoservices.irisnet.be y https://geoservices.wallonie.be. No se carga SDK ni estilo externo. Combina el ejemplo con tu política existente y conserva reglas del tema, inline/nonces y otros módulos. Con French Address Autocomplete permite también https://data.geopf.fr en connect-src.

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

Conserva piso y detalles de entrega

País, segunda línea, nombre, empresa y teléfono quedan intactos. Añade o conserva piso, buzón, planta, entrada y edificio en la segunda línea. Comprueba calle, número, código postal y localidad antes de guardar. Una calle sola necesita todavía un número. Elegir una calle de Flandes vacía el código postal; Bruselas y Valonia conservan el devuelto. Completa los datos que falten a mano.

Instalación

Requisitos

• Rango general PrestaShop: PS 1.6 – 9.x. Mínimo exacto declarado: PrestaShop 1.6.1.0 y PHP desde 7.1.
• Campos nativos y presentación Bootstrap 3, 4 o 5. Bélgica debe estar disponible; actívala si entregas allí.
• Comprueba que Bélgica esté activa y disponible en los formularios nativos de dirección que uses.

Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Belgian Address funciona solo.

Instalar no certifica disponibilidad ni todas las combinaciones de plataforma y tema. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.

Cómo funciona

Las sugerencias empiezan tras tres caracteres y 300 ms de pausa. Cuatro GET directos consultan en paralelo Flandes, Bruselas en francés y neerlandés, y Valonia. Flandes usa c=10&q=..., Bruselas spatialReference=4326, language=fr o nl fijo y address, Valonia address. Filtros de prefijos de palabras y números reducen resultados vagos, normalizando mayúsculas y acentos. Hasta cinco resultados distintos se unen por turnos, sin duplicados de calle, código y localidad. Si Valonia no da una fila válida y la búsqueda tiene al menos tres palabras, reintenta una vez sin la última palabra, filtrando aún con el texto completo. Solo para Valonia, apóstrofos y operadores pasan a espacios. Tras un resultado útil los servicios lentos tienen un segundo más antes de cancelarse. Otras regiones pueden dar resultados aunque una falle.

Durante una búsqueda, tras 600 ms aparece la línea sencilla «Buscando direcciones…» (fuente: «Searching addresses…»). Cada petición HTTP termina tras diez segundos. El reintento valón puede alargar la búsqueda total; no existe un único límite global de diez segundos. El cliente puede seguir escribiendo a mano durante todo el proceso.

Campos de la dirección elegida

Elegir rellena address1, postcode y city sin otra consulta. Flandes separa calle/número, código de cuatro cifras y localidad; Bruselas entrega calle, número, código y municipio separados; Valonia analiza direcciones de nivel 4, mueve un número inicial al final y retira guiones bajos finales de la localidad. El código queda con cuatro cifras sin espacios. Pueden conservarse letras y sufijos con barra devueltos, pero los pisos se añaden a mano tras elegir. El piso escrito debe coincidir con la línea devuelta y puede no dar resultados. Las calles solas aparecen sin dirección numerada válida y sin cifra escrita. Elegir una calle de Flandes vacía el código, Bruselas/Valonia conservan el devuelto. Completa número y código que falten. Sin provincia ni modo especial para localidades sin calles. Dos líneas muestran calle/número y luego código + localidad.

Usar para estos países solo aparece en módulos mundiales. Vacío significa todos los países del formulario; una lista limita ese módulo. Belgian Address permanece fijo en BE. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Puedes dejar un servicio mundial para los demás destinos. Un error no relanza automáticamente otra búsqueda en otro servicio.

En Clientes > Direcciones el equipo puede elegir una dirección belga después de una consulta telefónica para rellenar calle, código postal y localidad. El interruptor de administración es independiente de cuenta y pedido.

El código también contempla las ventanas nativas de dirección de un nuevo pedido servidas por la página de direcciones de clientes. Las rutas y formularios propios necesitan una prueba. Checkout Revolution puede cargar el mismo motor para sus formularios de dirección y reutilizar estos ajustes del servicio para cada tienda.

En el móvil toca un resultado bajo la calle. Con teclado, las flechas recorren la lista y Enter elige; Escape o Tab la cierra. Los lectores de pantalla reciben avisos de resultados. El componente compartido sigue la presentación Bootstrap del tema.

La atribución visible es © Digitaal Vlaanderen, paradigm.brussels, SPW. Si no hay coincidencias la lista queda cerrada, y se anuncia la indisponibilidad del servicio. Puedes escribir y editar a mano. Guardar nunca exige una sugerencia ni valida la posibilidad de entrega.

Privacidad y crédito de los datos

El navegador envía el texto de calle a las tres regiones, con q para Flandes y address para Bruselas/Valonia. Las opciones fijas incluyen límite de resultados, referencia espacial e idiomas francés/neerlandés de Bruselas. Valonia recibe texto limpio y quizá un reintento abreviado, siempre filtrado con el texto completo. No añade parámetros de clave, país elegido, idioma de página, nombre, correo, teléfono, empresa ni segunda línea. Todo el texto buscado se transmite. Las conexiones exponen IP y posibles datos del navegador (cabeceras Origin y Referer) según las reglas del navegador. Las credenciales están desactivadas. Cada petición HTTP caduca tras diez segundos; un reintento puede alargar la búsqueda. Elegir es local. Sin historial ni proxy de tienda; los registros de diagnóstico omiten búsquedas y direcciones devueltas. PrestaShop guarda la dirección normalmente. Describe las conexiones en tu política de privacidad. Crédito visible: © Digitaal Vlaanderen, paradigm.brussels, SPW.

Límites que debes conocer

• Los registros regionales no garantizan cada dirección, actualidad, disponibilidad continua ni uso ilimitado. Las respuestas grabadas no certifican resultados actuales o localidades sin calles.
• Se descartan filas mal formadas; los prefijos pueden coincidir con nombres o números más largos. Piso, buzón y edificio se añaden tras elegir. Las calles solas necesitan número y a veces código postal; Flandes vacía ese código. Revisa la dirección antes de guardar.
• HTTP 429 pausa solo el servidor afectado según Retry-After o diez segundos; ambos idiomas de Bruselas comparten la pausa. Otras regiones pueden dar resultados. Cada petición caduca tras diez segundos, con posible reintento valón. Entrada manual disponible; sin cambio a otro servicio instalado.
• Formularios/temas propios y rutas distintas del nuevo pedido necesitan pruebas. Checkout Revolution puede usar el motor compartido.
• Sin mapa, geolocalización, coordenadas guardadas, validación al enviar, selección automática del país ni garantía de entrega. Actualizaciones de por vida sin promesa de soporte incluido.

Si no aparecen sugerencias

• Sin resultados belgas: comprueba que Bélgica esté activa y revisa los interruptores y escribe calle completa, número y localidad.
• Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.
• Solo calle o sin resultado: completa número, código postal y localidad postal a mano y revisa la dirección antes de guardar.
• Servicio indisponible: revisa red/CSP de los servicios regionales, espera tras un límite y sigue manualmente.
• Formulario o diseño propio: prueba formulario nativo, teclado/móvil y ruta de pedido; revisa los ajustes del servicio para esta tienda.