MAGENTO 2 · CHECKOUT · DIRECCIÓN · DIAGNÓSTICO
Kowal Checkout Address Validation
Comprueba sintaxis de correo, formato de teléfono y código postal, y muestra avisos NIP/VAT. Separa la validación bloqueante del frontend del diagnóstico backend log-only.
Reglas por país · Avisos NIP/VAT · Registros sin datos completos
CÓMO FUNCIONA EN LA PRÁCTICA
01 · Activas los mecanismos adecuados
Configuras frontend y log-only independientemente.
02 · El cliente completa la dirección
Los mensajes indican formatos incorrectos.
03 · Analizas el diagnóstico
El backend registra infracciones sin bloquear las ventas.
Descubre las funciones, el uso y la configuración del módulo.
Magento 2 Checkout Address Validation reduce errores en datos introducidos al comprar. Comprueba correo, teléfono, código postal y NIP/VAT y ofrece mensajes claros antes de que los datos incorrectos lleguen a preparación.
Menos correcciones manuales para atención, logística y contabilidad, y menor riesgo de problemas de envío y documentación comercial.
Control de sintaxis de correo y formato sencillo de teléfono con un signo + opcional.
Reglas por país para Polonia, Alemania, Chequia, Eslovaquia y EE. UU.
Avisos no bloqueantes, reglas por país y comprobación del dígito de control del NIP polaco.
El frontend puede detener valores claramente incorrectos e indicar el campo que corregir. El diagnóstico backend funciona en modo log-only, de modo que detectar un problema no debería bloquear checkout, API ni el guardado de direcciones.
¿Bloquea un código postal incorrecto?
La validación frontend puede impedir avanzar e indicar los datos que corregir.
¿Qué países tienen reglas postales?
Polonia, Alemania, Chequia, Eslovaquia y EE. UU.
¿Comprueba el NIP polaco?
Sí, incluido el dígito de control; los avisos NIP/VAT no bloquean.
¿Puede el backend bloquear el pedido?
El diagnóstico funciona en log-only para no interrumpir las ventas.
Stores → Configuration → Sales → Checkout → Checkout Address Validation ofrece Enable Frontend Validation y Enable Backend Log-Only Diagnostics. Ambos están activados por defecto.
El frontend controla el formulario estándar de dirección de entrega, incluido el correo del invitado. El backend registra infracciones para diagnóstico y no rechaza por ellas checkout, API ni el guardado de direcciones.
El teléfono admite dígitos y un + inicial opcional. Los códigos postales se comprueban según PL, DE, CZ, SK y US; la validación rechaza espacios en blanco.
NIP/VAT recibe avisos de formato, prefijo y, para NIP polaco, dígito de control. No confirma la existencia de dirección, funcionamiento de correo o teléfono ni registro fiscal en registros externos.
El registro backend incluye campo, regla infringida, país, longitud, Store ID y un identificador de carrito con hash. Estos registros no incluyen valores completos del cliente.
La integración frontend utiliza componentes del checkout estándar Magento y RequireJS. En Hyvä u otro checkout comprueba cómo conectar las reglas; el paquete no contiene un adaptador Hyvä específico.
Paquete kowal/module-checkout-validation, módulo Kowal_CheckoutValidation. Tras configurar el acceso al repositorio de Kowal, instala el paquete, activa el módulo, actualiza Magento y limpia la cache. En producción, incluye la compilación y el despliegue de contenido estático de acuerdo con el proceso de la tienda.
1. Activas los mecanismos adecuados
Configuras frontend y log-only independientemente.
2. El cliente completa la dirección
Los mensajes indican formatos incorrectos.
3. Analizas el diagnóstico
El backend registra infracciones sin bloquear las ventas.
El cliente introduce un correo con espacio o un teléfono con caracteres no permitidos. El checkout indica el campo que debe corregir.
El aviso NIP/VAT sigue siendo no bloqueante. El backend permite analizar formatos sin interrumpir el guardado de direcciones ni el pedido.
¿Quieres adaptar el módulo a tu tienda? Consulta sobre la implementación de Kowal Checkout Address Validation y comenta la configuración o las ampliaciones necesarias.
| Conformidad con la plantilla | Luma / Blank, KOWAL |
|---|
Recibirás por correo electrónico los datos de acceso al repositorio Composer, es decir, la dirección de correo electrónico del cliente y el token de licencia, después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de e-mail de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.
composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-checkout-validationDespués de instalar el paquete, actualiza Magento y limpia la caché:
php bin/magento setup:upgrade
php bin/magento cache:flushEn el entorno de producción, realiza también la compilación DI y el despliegue de archivos estáticos de acuerdo con el proceso de despliegue de la tienda.
