Swiss Address Autocomplete

Swiss Address Autocomplete es un módulo PrestaShop gratuito para introducir direcciones de Suiza y Liechtenstein. El cliente elige una sugerencia bajo el campo de calle para rellenar calle y número, código postal de cuatro cifras y ciudad. geo.admin.ch ofrece datos del registro oficial suizo de direcciones de edificios de swisstopo, sin cuenta, clave ni coste por búsqueda.

Inicio rápido

1. Instala el ZIP del módulo en PrestaShop. Sin cuenta geo.admin.ch, clave ni configuración de pago.
2. Abre Configurar o la entrada Swiss Address del menú del back office; en multitienda elige una tienda que puedas gestionar.
3. Comprueba que el país de destino, Suiza o Liechtenstein, esté disponible y activo para los formularios de tienda que uses.
4. Elige por orden los interruptores general, cuenta, pedido y administración, luego guarda. Sin selector de países aquí.
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 el origen geo.admin.ch a una CSP existente y menciona la conexión del navegador en tu política de privacidad.
7. Elige Suiza y prueba Bahnhofstrasse 10 Zürich o añade un código postal. Para Liechtenstein, elige ese país y prueba Vaduz o Schaan. Revisa calle, número, código de cuatro cifras y ciudad. Prueba entrada manual, invitados, factura, personal/nuevo pedido, Francia y anchura de móvil.

Funciones

• Sugerencias de calles de Suiza y Liechtenstein. Datos oficiales de edificios swisstopo en formularios nativos de cuenta y pedido, incluidos invitados.
• Campos rellenados juntos. Calle y número, código postal de cuatro cifras y ciudad de la dirección elegida.
• Cobertura fija de Suiza y Liechtenstein. Busca con calle y número; el texto del código postal también puede acotar resultados.
• Administración. La misma ayuda postal para el equipo en Clientes > Direcciones.
• Entrada cotidiana. Táctil, teclado y anuncios para lectores de pantalla; se mantiene la entrada manual.
• Sin cuenta del servicio. Módulo y datos nacionales gratuitos, cuatro interruptores y ninguna 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 Swiss Address del menú del back office. Una página contiene Configuración, Integridad, Licencia, Actualización y Soporte. Los cuatro interruptores aparecen en el orden indicado, luego Guardar; todos están activos por defecto. No hay campo de clave, cuenta o país. En multitienda elige una tienda autorizada. Después aparecen notas de cobertura/servicio gratuito/código postal, entrada manual, privacidad y CSP, y luego los servicios de la familia. Hay textos en inglés, alemán, francés, polaco, italiano y español; no significa datos de direcciones en seis idiomas. La sección Soporte no concede soporte incluido.

geo.admin.ch sirve Suiza y Liechtenstein cuando eliges el país correspondiente en el formulario. Los resultados corresponden al país elegido, como Vaduz y Schaan para Liechtenstein. Al elegir Francia, las sugerencias suizas cesan; French Address Autocomplete puede responder con BAN si está activo para ese formulario. El módulo no cambia tus destinos de envío.

Google Address Autocomplete o Fetchify Address Autocomplete pueden servir otros países con su propia configuración. Una búsqueda suiza fallida no cambia automáticamente de servicio.

Usar para estos países pertenece a los módulos mundiales de la familia. La lista limita su cobertura; vacía significa todos los países disponibles en el formulario. Swiss Address queda fijo en CH + LI y no tiene ese campo. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.

Ejemplos de personalización

Permite geo.admin.ch en tu política de seguridad del contenido

Origen externo obtenido del código: https://api3.geo.admin.ch en connect-src. No se carga SDK suizo ni hoja de estilos externa. Integra el ejemplo en tu política actual conservando las reglas del tema, del código integrado, de los valores de un solo uso y de otros módulos. Con French Address Autocomplete permite también https://data.geopf.fr en connect-src. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.

script-src 'self';
style-src 'self';
connect-src 'self' https://api3.geo.admin.ch;

Conserva piso y detalles de entrega

Escribe apartamento o piso en la segunda línea antes de elegir. Esa línea queda intacta. Revisa calle, número, código y ciudad antes de guardar. No se rellena un cantón; complétalo a mano si tu formulario lo exige. Las sugerencias son opcionales y la búsqueda por código no es un directorio exhaustivo.

Instalación

Requisitos

• Rango general de PrestaShop: PS 1.6 – 9.x. Mínimo declarado exacto: PrestaShop 1.6.1.0 y PHP 7.1 o posterior.
• Campos de dirección nativos con presentación Bootstrap 3, 4 o 5. El país de destino, Suiza o Liechtenstein, debe estar disponible y activo en la tienda si envías allí.
• Este módulo no requiere cuenta del servicio, clave, pagos ni instalación de datos de cantones. Completa a mano los cantones obligatorios.

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

Swiss Address funciona solo. La instalación no certifica cada plataforma, tema o respuesta del servicio. 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. Un GET directo del navegador envía searchText, type=locations, origins=address, limit=10 y sr=4326 a SearchServer de geo.admin.ch. Solo se conservan etiquetas de direcciones numeradas legibles con código de cuatro cifras y ciudad. Se filtran duplicados y aparecen hasta cinco opciones. La elección usa la dirección ya devuelta sin otra consulta.

Si un servicio tarda, aparece «Buscando direcciones…»; tras diez segundos la petición suiza termina y la entrada manual sigue disponible.

Campos de la dirección elegida

El adaptador quita marcas y decodifica las entidades admitidas en la etiqueta del servicio. El texto anterior al código/ciudad en negrita aporta calle y último elemento numerado. Calle, espacio y número rellenan address1; NNNN rellena postcode; la ciudad rellena city. No cambia mayúsculas ni proporciona datos de cantón. País, segunda línea y campos personales/empresa/teléfono no se rellenan. Una edición, cambio de país, campo ausente o límite de longitud pueden impedir el relleno.

geo.admin.ch sirve Suiza y Liechtenstein cuando eliges el país correspondiente en el formulario. Los resultados corresponden al país elegido, como Vaduz y Schaan para Liechtenstein. Al elegir Francia, las sugerencias suizas cesan; French Address Autocomplete puede responder con BAN si está activo para ese formulario. El módulo no cambia tus destinos de envío.

Google Address Autocomplete o Fetchify Address Autocomplete pueden servir otros países con su propia configuración. Una búsqueda suiza fallida no cambia automáticamente de servicio.

Usar para estos países pertenece a los módulos mundiales de la familia. La lista limita su cobertura; vacía significa todos los países disponibles en el formulario. Swiss Address queda fijo en CH + LI y no tiene ese campo. Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.

En Clientes > Direcciones, el equipo puede introducir una dirección de Suiza o Liechtenstein tras una consulta telefónica. Una elección rellena los campos nativos de calle, código y ciudad. El interruptor de administración es independiente de cuenta y pedido, junto con el interruptor general.

El código también contempla ventanas nativas de dirección de nuevos pedidos servidas por AdminAddresses. Las rutas y formularios personalizados necesitan revisión. Cuando Checkout Revolution usa este motor compartido de direcciones, utiliza los mismos ajustes de este servicio por tienda.

En el móvil, el cliente toca un resultado bajo la calle. Con teclado, usa flechas e Intro; Escape o Tab cierra la lista. Los lectores de pantalla reciben anuncios de resultados. La lista compartida sigue la presentación Bootstrap del tema.

La lista muestra el crédito © swisstopo. Sin coincidencias permanece cerrada; un error del servicio anuncia que no hay sugerencias disponibles. Se mantiene la entrada y edición manual. Guardar no exige una elección ni valida direcciones de entrega al enviar.

Privacidad y crédito de los datos

Todo lo escrito en la búsqueda se envía como searchText, incluido código postal o datos personales escritos en ese campo. No hay parámetros separados de nombre, correo, teléfono, empresa, segunda línea, idioma o país elegido. Credenciales desactivadas y límite de diez segundos. La conexión directa expone la IP y puede enviar datos del navegador (cabeceras Origin y Referer) según sus reglas. El módulo no guarda historial ni usa un proxy de tienda; el diagnóstico omite textos y respuestas. PrestaShop guarda normalmente las direcciones elegidas. Crédito visible: © swisstopo. Explica la transferencia en tu política de privacidad.

Límites que debes conocer

• Cobertura, orden y disponibilidad dependen de geo.admin.ch; no se garantizan todas las direcciones ni servicio continuo. Escribir un código postal no garantiza resultados exhaustivos ni un uso ilimitado.
• Solo direcciones numeradas legibles con código de cuatro cifras y ciudad se convierten en opciones. Completa cantón y demás datos obligatorios.
• Las respuestas 429 pausan peticiones según Retry-After o diez segundos. Tiempo agotado, errores de red y respuestas inválidas dejan entrada manual; sin cambio automático de servicio.
• Formularios/temas personalizados y ventanas de nuevos pedidos con otras rutas necesitan pruebas. Cuando Checkout Revolution usa este motor compartido de direcciones, utiliza los mismos ajustes de este servicio por tienda.
• Sin mapa, geolocalización, almacenamiento de coordenadas, validación al enviar, país automático ni garantía de entrega. Módulo gratuito con actualizaciones de por vida, sin promesa de soporte incluido.

Si no aparecen sugerencias

• Sin resultados en Suiza o Liechtenstein: elige el país de destino, comprueba estado activo e interruptores general/formulario y prueba calle completa + número + ciudad o código.
• Funciona junto a French Address Autocomplete, Google Address Autocomplete y Fetchify Address Autocomplete; mantenlos todos actualizados a la última versión.
• Campos inesperados o ausentes: revisa la dirección numerada elegida y completa a mano cantón u otros detalles obligatorios.
• Sugerencias no disponibles: revisa red/CSP para api3.geo.admin.ch, espera tras un límite y continúa a mano.
• Formulario personalizado o problema visual: prueba un formulario nativo, móvil/teclado y ruta de nuevo pedido; revisa los ajustes del servicio compartidos por tienda.