OSS IVA UE – Precio con IVA (GeoIP MaxMind)

Presentación

OSS IVA UE – Precio con IVA (GeoIP MaxMind) es un módulo PrestaShop que muestra automáticamente los precios con la tasa de IVA del país de cada visitante, sin necesidad de configuración multi-tienda. Gracias a la detección GeoIP, tus clientes ven inmediatamente la tasa de IVA correcta desde el momento en que llegan a tu sitio, ofreciendo una experiencia de compra transparente y conforme al régimen OSS europeo.

Sin este módulo, PrestaShop muestra por defecto el IVA de tu país a todos los visitantes. El precio solo cambia en el momento del checkout, cuando el cliente introduce su dirección de entrega — una fuente frecuente de confusión y abandono del carrito. Con OSS IVA UE – Precio con IVA (GeoIP MaxMind), un visitante francés ve los precios con el 20% de IVA, un visitante alemán con el 19%, un visitante belga con el 21%, y así sucesivamente para todos los países europeos.

Puntos fuertes:

• Visualización instantánea del IVA local para cada visitante europeo
• Creación automática de todos los impuestos EU en unos pocos clics
• Sin necesidad de configuración multi-tienda
• Selector de país personalizable con vista previa en tiempo real
• Compatible con PrestaShop 8 y 9

Funcionalidades

Detección automática del país mediante GeoIP

El módulo identifica el país del visitante a través de su dirección IP gracias a la base de datos MaxMind GeoLite2. Los precios se muestran inmediatamente con la tasa de IVA correspondiente, sin ninguna acción por parte del visitante. Si la detección falla, se utiliza el país predeterminado configurado en el módulo.

Creación automática de impuestos europeos

Un asistente de 3 pasos guía la configuración completa de los impuestos para todos los países de la Unión Europea. Selecciona tus grupos de reglas fiscales, elige los países correspondientes, y el módulo crea automáticamente todos los impuestos y reglas necesarios en tu base de datos PrestaShop. Cada país muestra su estado: configurado (verde), parcial (naranja) o no configurado (rojo).

Selector de país front-office

Un selector integrado permite a los visitantes cambiar manualmente de país en cualquier momento. Los precios se actualizan automáticamente. Para los clientes conectados con varias direcciones en diferentes países, el selector muestra únicamente sus países y permite alternar entre sus direcciones.

Plantillas y personalización de la visualización

Cinco plantillas predefinidas están disponibles: Mínima (solo nombre del país), Con bandera (bandera + nombre), Completa (bandera + país + IVA), Compacta (bandera + código ISO) y Personalizada. La elección de una plantilla precarga las opciones, pero cada detalle permanece totalmente personalizable. Una vista previa en tiempo real permite visualizar los cambios de forma instantánea.

Funcionalidades adicionales

• Restricción por grupo de clientes: Limita la funcionalidad a grupos específicos (Visitante, Invitado, Cliente) o aplícala a todos dejando la selección vacía
• Hook personalizado: Coloca el selector en cualquier lugar de tu tema mediante Smarty ({hook h='displayWeprestaOSS'}) o Twig ({{ renderhook('displayWeprestaOSS') }})
• Gestión avanzada de países: Activa únicamente los países a los que realizas envíos, con indicadores de estado de impuestos
• Cookie configurable: Define la duración de memorización de la elección del visitante (valor 0 para cookie de sesión únicamente)
• Responsive: Funciona perfectamente en móvil y escritorio

Instalación

1. Descarga el módulo desde tu área de cliente WePresta
2. En el back office de PrestaShop, ve a Módulos > Gestor de módulos
3. Haz clic en Subir un módulo y selecciona el archivo ZIP
4. Accede a la configuración del módulo para configurar tus impuestos

Configuración

Pestaña General

Define el país predeterminado utilizado cuando la detección GeoIP falla o no se ha realizado ninguna selección manual. Por defecto, se utiliza el país de la tienda PrestaShop — elige el país donde se encuentra la mayoría de tus clientes. También puedes restringir la funcionalidad a grupos de clientes específicos: déjalo vacío para aplicarla a todos, o selecciona grupos específicos.

Pestaña Impuestos

Un flujo de trabajo en 3 pasos para crear automáticamente todos los impuestos europeos:

1. Grupos de reglas fiscales: Selecciona grupos existentes o deja que el módulo cree nuevos. Si tus productos ya están asociados a grupos fiscales, selecciónalos para añadir las reglas europeas. Las tasas marcadas como "Opcional" pueden omitirse si no las necesitas.
2. Selección de países: Visualiza todos los países con sus tasas de IVA (estándar, reducida, reducida 2, superreducida) y su estado de configuración. Selecciona únicamente los países a los que realizas envíos.
3. Confirmación: Revisa el resumen de acciones (número de impuestos y reglas fiscales a crear) antes de validar. Haz clic en Ejecutar para iniciar la creación. Luego puedes verificar en Internacional → Impuestos que todo se haya creado correctamente.

Pestaña Países

Gestiona qué países aparecen en el selector front-office. Un país solo se muestra a los visitantes si cumple 3 condiciones: activo en el módulo (pestaña Países), impuestos configurados (pestaña Impuestos) y país habilitado para envíos en PrestaShop (Internacional → Localización → Países).

Pestaña Visualización

Personaliza completamente la apariencia del selector de país. Elige su posición mediante un hook estándar de PrestaShop (displayNav1, displayNav2, displayTop…) o un hook personalizado. Selecciona una plantilla base entre las 5 opciones disponibles, y luego ajusta cada detalle según tus necesidades. La vista previa en tiempo real en el lado derecho de la pantalla refleja inmediatamente tus cambios.

Pestaña Avanzado

Configura la duración de la cookie (en días) para memorizar la elección del visitante. El valor 0 crea una cookie de solo sesión, eliminada al cerrar el navegador.

Configura la geolocalización GeoIP creando una cuenta gratuita en maxmind.com y generando una clave de licencia. El módulo descarga automáticamente la base de datos GeoLite2.

Requisitos previos

• PrestaShop 8.x o 9.x
• PHP 8.1 o superior
• Cuenta MaxMind gratuita (para la detección GeoIP)

FAQ

Los impuestos no se crean

Asegúrate de haber hecho clic en "Ejecutar" en el paso 3 del flujo de creación. Consulta los logs de PrestaShop para identificar posibles errores.

La detección GeoIP no funciona

Verifica que GeoIP esté activado en la pestaña Avanzado y que la base de datos GeoIP esté descargada (estado "OK"). La detección no funciona en entorno localhost (IP local).

El selector de país no aparece

Comprueba 3 puntos: el selector está activado en la pestaña Visualización, al menos un país está activo en la pestaña Países y el hook está correctamente configurado en tu tema.

Los precios no cambian cuando cambio de país

Asegúrate de que los impuestos estén configurados para ambos países, que tus productos estén asociados a los grupos de reglas fiscales correctos y vacía la caché de PrestaShop.

Un país no aparece en el selector

Un país solo aparece si está activo en el módulo (pestaña Países), sus impuestos están configurados (pestaña Impuestos) y está activo en PrestaShop (Internacional → Localización → Países).

El cliente ve un precio diferente entre la navegación y el checkout

Para los clientes conectados, el módulo utiliza sus direcciones reales. Un cambio de precio puede ocurrir si el cliente modifica su dirección de entrega en el checkout. Para los visitantes, verifica la configuración GeoIP.

¿El módulo es compatible con mi tema?

Sí, el módulo es compatible con todos los temas PrestaShop. Puedes utilizar los hooks estándar o un hook personalizado para posicionar el selector exactamente donde desees.

Soporte

Contáctanos a través de tu área de cliente WePresta o por correo electrónico para cualquier pregunta o asistencia técnica.

Changelog

Versión 1.0.0

• Versión inicial
• Detección automática del país mediante GeoIP (MaxMind GeoLite2)
• Creación automática de impuestos europeos en 3 pasos
• Selector de país front-office con 5 plantillas
• Restricción por grupo de clientes
• Soporte de hooks estándar y personalizados
• Gestión de clientes conectados con direcciones múltiples
• Cookie configurable para la memorización de la elección del visitante