Dutch Address Autocomplete

Dutch Address Autocomplete añade sugerencias PDOK Locatieserver a los formularios nativos de PrestaShop para Países Bajos europeos. Un resultado completo elegido rellena address1, postcode y city, conserva letra o añadido del número y formatea el código postal como 1012 LG. El módulo es gratuito con actualizaciones de por vida, sin compromiso de soporte incluido. PDOK no requiere cuenta, clave o pago por consulta.

Inicio rápido

1. Sube e instala el ZIP en el gestor de módulos. No necesitas cuenta o clave PDOK.
2. Activa Países Bajos como destino si entregas allí. Abre Configurar o la entrada Dutch Address del menú del back office; en multitienda selecciona una tienda que puedas gestionar.
3. En multitienda elige una sola tienda autorizada. Abre Configuración en la página única Ajustes.
4. Elige los interruptores general, cuenta, checkout y back office en ese orden y guarda. Aquí no hay credenciales del servicio o selector de países.
5. Si hace falta, añade https://api.pdok.nl a connect-src en la CSP existente y explica la transferencia en tu aviso de privacidad.
6. Selecciona Países Bajos en un formulario nativo. Escribe 1012 LG y un número en el campo de calle, elige un resultado completo realmente devuelto y revisa añadido, espacio del código postal y ciudad.
7. Prueba entrada manual, invitados, factura separada, Clientes > Direcciones, ventana nativa de pedido nuevo, otro país, móvil y teclado. Revisa la consola. Una búsqueda no demuestra que la dirección sea válida.

Funciones

• Búsqueda neerlandesa. Calle o código postal y número en el campo de calle existente.
• Relleno conjunto. Calle, número con letra o añadido, código postal y ciudad de una selección.
• Fuente oficial. PDOK Locatieserver de Kadaster con datos del registro BAG.
• Formularios nativos. Cuenta, invitados, facturación separada y direcciones del back office.
• Entrada cotidiana. Toques, teclado y anuncios para lectores de pantalla; entrada manual disponible.
• Acceso gratuito. Sin cuenta, clave ni coste por consulta y con interruptores separados para los formularios.

Opciones de configuración

Los cuatro controles visibles son, por orden: Sugerir direcciones mientras el cliente escribe; En el formulario de dirección de la cuenta de cliente; En los formularios de dirección del pedido (incluidos invitados y direcciones de facturación separadas); En el formulario de dirección del back office (direcciones de clientes, pedidos nuevos). Están activos por defecto. Después aparecen Guardar y las notas de cobertura, entrada manual, privacidad y CSP. Apagar el interruptor general detiene las sugerencias en todos los formularios.

Abre Configurar en el gestor de módulos o la entrada Dutch Address del menú del back office. Esta versión tiene una página Ajustes con Configuración, Integridad, Licencia, Actualización y Soporte. Los valores se aplican a una tienda. En multitienda selecciona una tienda autorizada antes de editar.

No hay campo de clave del servicio ni Usar para estos países. Ese selector pertenece a los adaptadores mundiales. La cobertura fija NL precede a un adaptador mundial sin restricciones. Una lista elegida que se solape puede preceder a PDOK; evita NL allí si debe responder PDOK. Una lista mundial vacía significa todos los países del formulario y no cambia tus destinos de venta.

Se incluyen textos fuente ingleses y traducciones de ajustes en neerlandés, alemán, francés, polaco, italiano y español. El inglés usa el texto fuente para las notas PDOK actuales.

Ejemplos de personalización

Permitir PDOK en una Content Security Policy

El origen externo de conexión hallado en este adaptador es https://api.pdok.nl. PDOK no carga SDK, hoja de estilos o fuente remotos. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Une el ejemplo con tu política existente y conserva las reglas para configuración integrada, tema y otros módulos. French Address Autocomplete también necesita https://data.geopf.fr en connect-src.

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

Conservar detalles de apartamento y entrega

Escribe piso, apartamento o indicaciones de entrega en la segunda línea antes de elegir. Esa línea queda intacta, igual que país, nombre, empresa y teléfono. Completa una calle sola con número y código postal antes de guardar. El adaptador no proporciona provincia. El cliente puede editar los campos normales.

Instalación

Requisitos

• Compatibilidad general PrestaShop: PS 1.6 – 9.x. Mínimo exacto declarado: PrestaShop 1.6.1.0; PHP 7.1 o posterior.
• Campos de dirección nativos y presentación Bootstrap 3, 4 o 5. Comprueba temas y formularios personalizados por separado.
• Países Bajos en el formulario e interruptores relevantes activos. Sin cuenta, clave ni compra de consultas PDOK.

Si tienes instalado un módulo de direcciones antiguo, las sugerencias neerlandesas pueden quedar desactivadas y la página de ajustes del módulo te indica qué módulo actualizar. 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 una pausa de 300 ms. El adaptador hace una GET a PDOK suggest con texto, filtros fijos de direcciones y calles y nombres de campos. Solicita diez registros, elimina los incorrectos y duplicados, prioriza direcciones completas y muestra como máximo cinco. Una calle sola aparece únicamente sin direcciones completas y sin cifras en la consulta. La lista no es exhaustiva.

La selección rellena directamente desde la sugerencia sin una segunda consulta. Un registro completo válido tiene número entero positivo, una letra opcional, un añadido alfanumérico opcional de 1-4 caracteres, código postal neerlandés y ciudad. Los formatos no admitidos se descartan. El código postal recibe espacio y mayúsculas; la letra se une al número y el añadido sigue a un guion.

Qué campos se rellenan al elegir una dirección

Un resultado completo proporciona calle, número con la letra o añadido devuelto, código postal y ciudad. La letra se une al número, por ejemplo 12A; el añadido sigue a un guion, como Damrak 12-H. El código postal lleva espacio y mayúsculas en formato PrestaShop, como 1012 LG. Los ejemplos describen el formato y no aseguran una dirección devuelta.

País elegido, nombre, empresa, teléfono y segunda línea ya escrita quedan intactos. El cliente puede mantener allí piso, apartamento o instrucciones y editar el resultado. Una sugerencia de solo calle no aporta número ni código postal y hay que completarlos a mano. Este adaptador no rellena una provincia.

Qué destinos reciben sugerencias neerlandesas

Las sugerencias PDOK cubren Países Bajos europeos cuando Países Bajos está seleccionado en el formulario. El módulo no ofrece cobertura del Caribe neerlandés ni mundial. Cambiar de país detiene las sugerencias neerlandesas; otro servicio instalado puede responder según su propia cobertura y configuración.

French Address Autocomplete puede atender sus destinos franceses junto a PDOK para Países Bajos. Google Address Autocomplete y Fetchify Address Autocomplete mantienen sus ajustes de países. La cobertura fija precede a un servicio mundial sin restricciones; evita listas elegidas que se solapen. Una búsqueda fallida no se repite automáticamente mediante otro servicio.

Dónde recibe ayuda el equipo en el back office

En Clientes > Direcciones, el personal recibe sugerencias en el campo de calle nativo. Puede escribir el código postal y número recibidos por teléfono, elegir una dirección devuelta y revisar calle, código postal y ciudad antes de guardar. La letra o añadido del número que devuelva el servicio se conserva.

La integración también se dirige a la ventana nativa de dirección de un pedido nuevo cuando la sirve AdminAddresses. Otras ventanas y formularios personalizados necesitan una comprobación propia. El interruptor del back office es independiente de cuenta y checkout nativo. Cuando Checkout Revolution usa este motor compartido de direcciones, utiliza los mismos ajustes de este servicio por tienda.

Cómo funciona la lista en móvil y con teclado

En el móvil, el cliente toca una sugerencia bajo el campo de calle. Las flechas recorren la lista, Intro elige y Escape o Tab la cierra. Los lectores de pantalla reciben el número de resultados. La lista compartida admite presentación Bootstrap 3, 4 y 5 y permanece junto a los campos que el cliente ya está rellenando.

La lista identifica PDOK Locatieserver (Kadaster, BAG). Sin coincidencia utilizable queda cerrada y la entrada manual sigue disponible. Si el servicio tarda en responder, aparece brevemente «Buscando direcciones…» bajo el campo de la calle y luego desaparece; tras 10 segundos sin respuesta, escribe la dirección a mano. Un error de red o servicio puede mostrar un aviso breve sin obligar a elegir. El cliente revisa el destino: esta ayuda no valida la dirección al enviar ni garantiza la entrega.

Consultas, direcciones guardadas y privacidad

La GET directa del navegador envía q (texto), rows=10, fq=type:(adres OR weg) y fl (lista fija de campos). No envía clave, parámetro del país elegido, idioma de página o identificador de sesión. No añade explícitamente nombre, correo, teléfono, empresa o segunda línea; todo texto en la búsqueda pasa a la consulta. Las credenciales entre orígenes están desactivadas.

PDOK recibe la IP mediante la conexión y puede recibir información del navegador (cabeceras Origin y Referer) según la política del navegador. Explica la transferencia en tu aviso de privacidad. El módulo no determina consentimiento, cumplimiento legal o retención del proveedor. No implementa un proxy de búsqueda ni historial de direcciones buscadas en la tienda. El guardado normal sigue siendo el de PrestaShop.

La lista muestra PDOK Locatieserver (Kadaster, BAG). No se muestra ninguna atribución CC BY adicional. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.

Límites que debes conocer

• Cobertura. Solo Países Bajos europeos. Sin Caribe neerlandés ni garantía de datos completos, actuales o resultado para cada código postal y número.
• Disponibilidad. Red, navegador, CSP o PDOK pueden detener las sugerencias. Un 429 implica Retry-After o diez segundos de pausa; tiempo de espera de diez segundos. Sin cambio automático de servicio.
• Selección incompleta. Una calle sola vacía el código postal y no tiene número. Completa a mano. Los formatos incorrectos se descartan.
• Formularios nativos. Ventanas propias de cuenta, checkout y pedido y temas particulares necesitan verificación. El pedido nuevo apunta a AdminAddresses.
• Valores conservados. País, segunda línea, nombre, empresa y teléfono quedan intactos. PDOK no proporciona provincia.
• Protecciones. País o campos cambiados, campos ausentes o valores demasiado largos pueden impedir un relleno tardío.
• Asignación y paquetes. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión. Si tienes instalado un módulo de direcciones antiguo, las sugerencias neerlandesas pueden quedar desactivadas y la página de ajustes del módulo te indica qué módulo actualizar.
• Entrada manual. Sin selección obligatoria, validación al enviar, geolocalización, mapa o garantía de entrega. Las actualizaciones de por vida no incluyen compromiso de soporte.

Si no aparecen sugerencias

• Sin sugerencias: revisa Países Bajos, interruptores general y del formulario, destinos activos e Integridad. Si tienes instalado un módulo de direcciones antiguo, las sugerencias neerlandesas pueden quedar desactivadas y la página de ajustes del módulo te indica qué módulo actualizar.
• Bloqueo CSP: permite https://api.pdok.nl en connect-src y conserva las reglas de scripts y estilos. Revisa la consola; el ejemplo no es una política completa.
• Falta código postal o añadido: elige un resultado completo. La calle sola requiere datos manuales; los formatos incorrectos se descartan. No edites una captura para inventar resultados.
• Otro país o servicio: PDOK es fijo para NL. Los demás servicios conservan sus ajustes. Evita listas elegidas que se solapen; no hay cambio tras error.
• Servicio ausente o relleno rechazado: espera tras un límite, revisa red y campos y continúa a mano. Las sugerencias no bloquean el envío ni confirman la entrega.