v1.0.1 · actualizado el 20/10/2026
Validado con el validador oficial de PrestaShop
Módulo para validar el código postal en PrestaShop
Módulo gratuito para validar el código postal en PrestaShop.
Avisa al cliente, mientras escribe la dirección, si el código postal no existe en el país o no corresponde a la población o a la provincia. Menos paquetes devueltos, sin bloquear nunca la compra.
- PS 1.7
- PS 8
- PS 9
- Descarga inmediata desde «Mis módulos»
- Actualizaciones desde tu cuenta
Desarrollado y mantenido por Kebes, agencia PrestaShop Expert nivel 3 con más de 15 años desarrollando para PrestaShop.
Con este módulo puedes validar el código postal en PrestaShop en el momento en que el cliente escribe su dirección: comprueba que existe en el país elegido y que corresponde a la población y a la provincia. Es gratuito y compatible con PrestaShop 1.7.8, 8 y 9.
El problema: paquetes que vuelven por un código postal mal escrito
PrestaShop da por bueno cualquier código de cinco cifras en España, Francia o Italia. Un 08001 con la población Madrid, un 28000 en España (no existe: es de Chartres, en Francia) o un 99999 pasan sin aviso. Cada uno es un paquete devuelto, un reenvío y un cliente molesto.
El módulo lo detecta al momento y le dice al cliente qué falla y qué sería lo correcto, para que lo corrija antes de pagar. No bloquea nunca: si la dirección es buena aunque no esté en los datos, el cliente compra igual.
Funciones
- Aviso en vivo bajo el código postal: código que no existe en el país (y en qué otro país sí existe), población o provincia que no corresponden, o formato que no es del país. Tolera acentos, artículos, nombres en dos lenguas y erratas de teclado.
- Población y provincia rellenas solas cuando están vacías y el código postal tiene una sola opción. Nunca sobrescribe lo que ha escrito el cliente.
- Casilla de confirmación en el pago: si la dirección sigue con aviso, el cliente confirma que es correcta antes de pedir. Si la corrige, la casilla desaparece.
- Nota en el pedido para quien prepara el envío: el pedido lleva en su nota privada (solo en el back office) qué fallaba y si el cliente lo confirmó. Se añade a lo que ya haya.
- Checkout de una página: funciona con el proceso de compra de PrestaShop y con el módulo oficial ps_onepagecheckout.
- Sin overrides: no toca el núcleo y usa los estilos del tema (Classic, Hummingbird y temas hijos).
Códigos postales incluidos y actualizables
Trae los códigos postales de España, Francia, Portugal e Italia, cargados al instalar. Se actualizan con un botón y se pueden añadir otros países. Los datos son de GeoNames y, en Francia, también de la base oficial de La Poste, para reconocer los municipios fusionados en los últimos años. Si tu servidor no puede descargar, subes el fichero a mano.
No ralentiza el checkout
La comprobación se hace en el navegador con ficheros de códigos postales del propio módulo: escribir una dirección no hace ninguna petición a tu servidor. En el resto de páginas el módulo no hace nada. Medido en una tienda real, la página del pedido tarda lo mismo con el módulo que sin él.
Compatibilidad
Compatible con PrestaShop 1.7.8, 8 y 9. Probado en PrestaShop 1.7.8.11, 8.2.7, 9.1.4 y 9.2.0 (también con ps_onepagecheckout), con PHP 7.4, 8.3 y 8.4. Con otros módulos de compra en una página (onepagecheckoutps, supercheckout, thecheckout) no se instala.
Instalación
Descarga el zip y súbelo en Módulos › Gestor de módulos › Subir un módulo. Funciona sin configurar nada; en la configuración eliges el modo (avisar o pedir confirmación), los países y qué se comprueba.
Preguntas frecuentes
¿Bloquea la compra si el código postal no cuadra?
No. Avisa bajo el campo y, en el modo recomendado, pide confirmarlo con una casilla antes de pagar. Nunca impide guardar la dirección ni terminar el pedido.
¿Y si avisa en una dirección que es correcta?
Puede ser un código muy nuevo o un municipio recién fusionado. Actualiza el país en la pestaña Datos; si solo falla la población, puedes desactivar esa comprobación y dejar la del código postal.
¿Comprueba la provincia en España?
PrestaShop no pide la provincia en las direcciones de España de serie, así que el módulo la muestra como información. Si tu tienda la pide, también la comprueba, como en Italia.
¿Comprueba la calle y el número?
No. Comprueba país, código postal, población y provincia, que es donde están casi todos los errores; no usa servicios de pago de terceros.
¿Funciona en servidores nginx?
Sí, permitiendo los ficheros .json de la carpeta de datos del módulo. En Apache y LiteSpeed lo hace el propio módulo, y la pestaña Datos comprueba que funciona.
Si además facturas a empresas y particulares, el módulo gratuito para validar el DNI avisa de los números de identificación mal escritos. Más módulos en el catálogo de veomod.com.
Changelog
1.0.1 – 2026-10-20
- `.htaccess` en la carpeta del módulo que impide abrir sus ficheros PHP directamente.
- Código revisado con el validador oficial de PrestaShop (formato, cabeceras y buenas prácticas). Sin cambios de funcionamiento.
1.0.0 – 2026-10-18
Nuevo: aviso bajo el código postal cuando no existe en el país, no corresponde a la población o a la provincia, o no tiene el formato del país.
Nuevo: población y provincia rellenas solas cuando el código tiene una sola opción.
Nuevo: casilla de confirmación en el paso de pago, también con ps_onepagecheckout.
Nuevo: nota privada en el pedido con el aviso y si el cliente lo confirmó.
Nuevo: códigos postales de España, Francia, Portugal e Italia incluidos, actualizables con un botón.
Compatibilidad
| PrestaShop | Versión del módulo | Estado |
|---|---|---|
| 1.7.8 – 9.2 | 1.0.1 | Compatible |
| 1.7.7 y anteriores | — | No compatible |
Ficha técnica
- Versión
- 1.0.1
- Idiomas
- Español, Inglés
- Idiomas del soporte
- Español, Inglés
¿Funcionará en tu tienda? Pregúntanos antes de comprar
Si necesitas una función concreta, o tu versión de PrestaShop no aparece como probada, cuéntanoslo. Muchas veces funciona igual. Y si nos pides una función que mejora el módulo y puede servir a más tiendas, la añadimos en una próxima versión sin coste para ti. Te responde quien ha programado el módulo.