OSS IVA UE – Precio con IVA (GeoIP MaxMind)

Presentación

El módulo adapta los precios con IVA al país del visitante mediante selección manual o detección local MaxMind. Cada producto conserva su grupo de reglas fiscales. El selector muestra el tipo general de referencia; los productos con tipos reducidos mantienen sus propios tipos.

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

Revise los tipos y grupos fiscales afectados en la vista previa y confirme los cambios. Cada producto conserva su grupo de reglas fiscales.

Selector de país front-office

Sin una dirección real, el país seleccionado sirve para estimar precios, también en la ventana de confirmación al añadir al carrito. La dirección fiscal válida del carrito tiene prioridad según la configuración de entrega/facturación de PrestaShop. El cliente conectado puede elegir una dirección guardada y confirmar su uso para la entrega. Los gastos y los impuestos se recalculan; se conserva una dirección de facturación existente. No se crean direcciones ficticias.

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

Active la vista previa, seleccione los países disponibles y el país de respaldo, y revise los grupos de clientes autorizados. Puede desactivar la vista previa sin perder la configuración.

Pestaña Impuestos

En el asistente Impuestos, seleccione los grupos asignados a sus productos o prepare grupos nuevos. Revise los tipos anteriores y nuevos antes de confirmar. La vista previa no crea datos y los productos nunca se reasignan automáticamente. Los grupos compartidos entre tiendas y las reglas regionales o combinadas requieren revisión en la configuración nativa. Los tipos reducidos dependen del producto y del territorio.

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.

Introduzca su ID de cuenta y una clave con permiso de descarga de GeoLite2 Country. Descargue la base desde Avanzado y compruebe su estado. PHP necesita cURL, Phar y zlib. La detección consulta la base local. Si una actualización falla, se conserva la base anterior. Dejar la clave vacía conserva la guardada. Configure solo las direcciones o rangos reales de sus proxies de confianza; Cloudflare tiene una opción independiente.

Resumen de IVA

Seleccione un periodo y abra la vista previa o descargue el CSV. Las ventas siguen la fecha del pedido y los abonos su fecha de emisión, incluso para ventas anteriores. Los importes históricos se separan por tienda, moneda, país, tipo y componente, incluido el transporte. Las filas ambiguas se señalan para revisión. El resumen no determina la elegibilidad OSS ni sustituye una declaración. Un reembolso sin abono no se deduce automáticamente.

Actualización

Haga una copia de seguridad e instale el nuevo archivo. Se conservan los ajustes. Compruebe productos con tipo general y reducido, y el carrito con sus direcciones. Las cachés y CDN deben distinguir el país y la sesión.

Requisitos previos

• PrestaShop 1.7.8, 8.2 o posterior, 9.1 o posterior (8.0, 8.1 y 9.0 no compatibles); PHP 7.4 como mínimo, según los requisitos de su versión de PrestaShop.
• Cuenta MaxMind y clave de descarga GeoLite2 Country para GeoIP; extensiones PHP cURL, Phar y zlib para descargar la base.

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

Sin una dirección real, el país seleccionado sirve para estimar precios. La dirección fiscal válida del carrito tiene prioridad según la configuración de entrega/facturación de PrestaShop. El cliente conectado puede elegir una dirección guardada y confirmar su uso para la entrega. Los gastos y los impuestos se recalculan; se conserva una dirección de facturación existente. No se crean direcciones ficticias.

¿El módulo es compatible con mi tema?

Utilice los hooks estándar o el hook personalizado para colocar el selector. Compruebe su visualización y el carrito con su tema y extensiones.

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 2.0.1

• Precio con IVA del país seleccionado también en la ventana de confirmación al añadir al carrito
• Precio con IVA del país seleccionado mantenido en la ficha de un producto ya presente en el carrito

Versión 2.0.0

• Precios con IVA más fiables según el país y el tipo de cada producto
• Prioridad de la dirección fiscal del carrito para calcular los precios
• Selección de la dirección de entrega con confirmación del cliente
• Vista previa de los tipos y grupos fiscales antes de aplicar cambios
• Actualización de los tipos de IVA de referencia
• Descargas MaxMind seguras, conservando la base anterior si falla una actualización
• Resumen de IVA y exportación CSV basados en ventas y abonos históricos, incluido el transporte
• Carga de países optimizada y cálculo del resumen de IVA bajo demanda
• Conservación de los ajustes existentes durante la actualización

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