Ecom Checkaddress — Validación de direcciones y códigos postales por país

Descripción

Cada dirección mal escrita es un paquete devuelto

Envío de ida, envío de vuelta, reembolso y una hora de atención al cliente. Y el cliente enfadado, que además no vuelve.

Lo que casi nadie sabe es que PrestaShop no valida nada de esto. Lo único que hace es aplicar una plantilla de formato guardada en cada país. Y de fábrica esa plantilla es idéntica en media Europa:

Traducido: PrestaShop da por bueno cualquier número de cinco cifras.

El problema es más grave de lo que parece

Estos son datos reales, comprobables:

• 28001 es Madrid en España… y también Albemarle, Carolina del Norte en Estados Unidos.
• 28000 no existe en España, pero sí en Francia: es Chartres.
• El rango español (01xxx–52xxx) está íntegramente contenido dentro del francés (01xxx–98xxx).

No existe ni un solo código postal español de cinco dígitos que sea imposible en Francia por su numeración. Por eso Ecom Checkaddress nunca valida un código postal aislado: cada consulta lleva el país como clave.

Qué hace exactamente

• Comprueba mientras el cliente escribe. Sin recargar, sin esperas.
• Detecta el país equivocado. «Ese código postal sí existe en: Italia (Bari, Bari). Comprueba que el país elegido es el correcto.»
• Contrasta la ciudad con las poblaciones reales de ese código postal, tolerando acentos, mayúsculas y erratas.
• Autocompleta la ciudad al escribir el CP, si el campo está vacío.
• Obliga a confirmar antes de pagar. Si algo no cuadra, añade una casilla obligatoria junto a los términos y condiciones usando el mecanismo nativo de PrestaShop: el botón de confirmar pedido queda bloqueado. Sin overrides ni parches de plantilla.
• Deja constancia. Registra qué se avisó y si el cliente lo aceptó. Tu prueba ante una reclamación de transporte.

Gratis de verdad, y sin depender de nadie

Los datos vienen de GeoNames (licencia Creative Commons Attribution 4.0), se descargan con un botón desde el back-office y se guardan en tu base de datos. Consulta local en menos de 1 milisegundo, sin cuotas, sin claves y sin que un servicio caído te tumbe el checkout.

Más de 120 países con validación completa. Y si quieres validar también el nombre de la calle y el número, puedes conectar opcionalmente Google Address Validation: el módulo trae las instrucciones de alta paso a paso, los enlaces directos y un botón para comprobar que la clave funciona.

Pensado para no perder ventas

• Fail-open por defecto. Si un país no está importado o la API no responde, el cliente compra con normalidad. Un falso positivo cuesta una venta; el módulo está diseñado para no provocarlos.
• Tres modos: solo avisar, avisar y exigir aceptación (recomendado), o bloquear.
• Configurable por comprobación: código postal, ciudad, provincia y calle, cada una por separado.

Ficha técnica

• PrestaShop 1.7.6 – 9.x · PHP 7.4 – 8.3
• Compatible con checkout nativo y módulos one-page checkout
• Sin Composer, sin Guzzle, sin dependencias externas
• Multitienda · Multiidioma
• Incluye español, portugués y francés completos (309 cadenas), inglés como idioma base
• Modo depuración con registro propio
• Documentación técnica, de desarrollo y guía de usuario incluidas

Antes de comprar, con honestidad

La provincia solo se valida donde PrestaShop la pide. En Italia, EE.UU., Canadá, México, Argentina o Australia se valida de verdad. En España, Francia, Alemania y Portugal, PrestaShop no incluye provincias de serie y el cliente nunca escribe ninguna: ahí el módulo la muestra deducida del código postal, a título informativo. La validación de país, código postal y ciudad funciona igual en todos.

Cobertura de datos. GeoNames publica 121 países. Algunos con limitaciones de copyright: Irlanda y Malta solo primeras letras, Reino Unido y Países Bajos sin el código completo, Canadá solo los 3 primeros caracteres, y Grecia sin fichero. En esos casos se valida el formato, que ya es más de lo que hace PrestaShop.