Referencia de modulos de Shoplex

Shoplex estructura las exigencias de comercio electronico de la Union Europea en 20 modulos independientes. Cada modulo responde a una directiva comunitaria, reglamento europeo o ley nacional especifica. Puede activar o desactivar cada uno de forma individual en el panel WooCommerce > Shoplex.

Diez modulos vienen activados por defecto y diez desactivados. La aplicabilidad de los desactivados depende de los productos y de la operativa de la tienda.

┌────────────────────────────────────────────────────────────────────────┐
│                        Arquitectura de Shoplex                         │
├───────────────────────────────┬────────────────────────────────────────┤
│ Bloque de precios en tienda   │ Proceso de pago (Checkout) y pedidos   │
│ • unit_price (98/6/CE)        │ • legal_checkboxes (2011/83/UE, RGPD)  │
│ • omnibus (2019/2161)         │ • country_compliance (Boton de pago)   │
│ • tax_display (98/6/CE)       │ • vies (IVA B2B 2006/112/CE)           │
│ • shipping_notice (PAngV)     │ • withdrawal (desistimiento 14 dias)   │
│ • from_price (98/6/CE)        ├────────────────────────────────────────┤
├───────────────────────────────┤ Endpoints y formularios legales        │
│ Informacion y seguridad       │ • complaint_template (reclamacion 771) │
│ • delivery_time (2011/83/UE)  │ • cra_readiness (RFC 9116 security.txt)│
│ • consumer_information (771)  │ • dsa_toolkit (art. 16 DSA avisos)     │
│ • gpsr (seguridad 2023/988)   │ • business_info y resolucion litigios  │
└───────────────────────────────┴────────────────────────────────────────┘

---

Resumen de modulos

ID de modulo	Nombre del modulo	Estado inicial	Base legal	Pestana de ajustes
unit_price	Precio unitario	Activado	Directiva 98/6/CE	Precios (shoplex_prices)
omnibus	Precio mas bajo en 30 dias	Activado	Directiva (UE) 2019/2161	Precio mas bajo (shoplex_omnibus)
tax_display	Aviso de IVA	Activado	Directiva 98/6/CE, 2011/83/UE art. 6	IVA (shoplex_taxes)
shipping_notice	Gastos de envio	Activado	Directiva 2011/83/UE art. 6(1)(e)	Precios (shoplex_prices)
from_price	Precio “desde” en variables	Desactivado	Directiva 98/6/CE	Precios (shoplex_prices)
delivery_time	Plazo de entrega	Desactivado	Directiva 2011/83/UE art. 6(1)(g)	Plazo de entrega (shoplex_delivery)
consumer_information	Garantia legal y durabilidad	Activado	Directivas (UE) 2019/771 y 2019/770	Garantias (shoplex_consumer_info)
country_compliance	Reglas especificas por pais	Activado	RDL 7/2021, § 312j BGB, Art. L. 221-14	Cumplimiento por pais (shoplex_country_compliance)
withdrawal	Desistimiento de 14 dias	Desactivado	Directiva 2011/83/UE Anexo I(B)	Checkout (shoplex_checkout)
gpsr	Seguridad de productos (GPSR)	Desactivado	Reglamento (UE) 2023/988	Seguridad (shoplex_gpsr)
legal_checkboxes	Consentimientos en checkout	Activado	Directiva 2011/83/UE art. 8, RGPD art. 7	Checkout (shoplex_checkout)
business_info	Identidad del comerciante	Activado	Directiva 2000/31/CE art. 5	Empresa (shoplex_general)
dispute_resolution	Aviso sobre resolucion de litigios	Activado	Directiva 2013/11/UE, modificada por la Directiva (UE) 2025/2647	Empresa (shoplex_general)
vies	Validacion de NIF-IVA UE	Desactivado	Directiva 2006/112/CE art. 138	IVA VIES (shoplex_vies)
complaint_template	Formulario de reclamacion	Desactivado	Directiva (UE) 2019/771	Pantalla integrada
cra_readiness	Cyber Resilience Act	Desactivado	Reglamento (UE) 2024/2847 / RFC 9116	CRA security.txt (shoplex_cra)
dsa_toolkit	Notificaciones DSA	Desactivado	Reglamento (UE) 2022/2065 art. 16	Shortcode publico
deposit	Deposito de envases (Pfand)	Desactivado	VerpackG § 31; PPWR de la UE	Deposito (shoplex_deposit)
food_information	Informacion alimentaria y nutricion	Desactivado	Reglamento (UE) 1169/2011	Alimentacion (shoplex_food)
consent_manager	Consentimiento de cookies y bloqueo de contenido	Activado	RGPD art. 7; ePrivacy; TDDDG § 25	Consentimiento (shoplex_consent)

---

1. Precio unitario (unit_price)

Base legal

Directiva 98/6/CE relativa a la proteccion de los consumidores en la indicacion de los precios de los productos. En articulos cuantificados por peso, volumen, longitud o superficie es obligatorio mostrar el precio final de venta y el precio por unidad de medida estandar (ej. por 1 kg o 1 litro).

Funcionamiento

Calcula el precio de referencia y lo renderiza de manera inmediata junto al precio del producto en fichas individuales y en listados de categoria. Si un producto carece de datos de peso o volumen, no genera ningun bloque vacio.

Opciones de configuracion (shoplex_prices)

• unit_price_enabled (bool, por defecto: true): Activa el calculo de precio base.
• unit_price_text (string, por defecto: "{price} / {unit}"): Plantilla del aviso. Sustituye {price} con el precio unitario y {unit} con la unidad abreviada.
• unit_price_show_loop (bool, por defecto: true): Habilita la presentacion en catalogos y archivos.

Campos a nivel de producto

En Datos del producto > Shoplex:

• _shoplex_unit_price_product_amount (float): Contenido neto (ej. 500 para un envase de 500 g).
• _shoplex_unit_price_base (float, por defecto: 1 o 1000): Cantidad de referencia (ej. 1000 para 1 kg o 100 para 100 ml).
• _shoplex_unit_price_unit (string select): Unidad de medida (kg, g, l, ml, m, cm, m2, m3, piece).

---

2. Precio mas bajo en 30 dias (omnibus)

Base legal

Directiva (UE) 2019/2161 (Directiva Omnibus), modificando la Directiva 98/6/CE Art. 6 bis. Cualquier anuncio de rebaja de precios debe indicar el precio mas bajo aplicado por el comerciante durante al menos los 30 dias previos a la reduccion.

Funcionamiento

Registra las variaciones de precio en una tabla especializada de la base de datos. Cuando un producto pasa a estado de oferta, calcula el menor importe cobrado en la ventana temporal y muestra el aviso obligatorio en la tienda.

[!NOTE] El registro no tiene efecto retroactivo. Comienza en el momento en que se activa el modulo.

Almacenamiento en base de datos

Tabla: {wp_prefix}shoplex_price_history

Opciones de configuracion (shoplex_omnibus)

• enabled (bool, por defecto: true): Activa el seguimiento y los avisos visuales.
• days (int, por defecto: 30): Periodo de evaluacion retrospectivo (minimo 30 dias).
• display_text (string, por defecto: "Precio mas bajo en los ultimos {days} dias: {price}"): Texto formateado.
• display_on_sale_only (bool, por defecto: true): Limita la visualizacion a articulos actualmente rebajados.
• prune_after_days (int, por defecto: 90): Periodo de conservacion antes de la limpieza automatica de registros antiguos.
• price_count_from (string select: sale_start | today, por defecto: sale_start):
  • sale_start: Evalua los 30 dias inmediatamente anteriores al inicio de la campana (evita distorsiones en descuentos progresivos).
  • today: Evalua los 30 dias anteriores a la fecha actual.

---

3. Aviso de IVA (tax_display)

Base legal

Directiva 98/6/CE y Directiva 2011/83/UE Art. 6. Todo precio orientado al consumidor final debe aclarar si incluye o no los impuestos correspondientes.

Opciones de configuracion (shoplex_taxes y shoplex_prices)

• tax_display_mode (string select: gross | net, por defecto: gross): Determina si se muestra precio con IVA o sin IVA.
• vat_notice_text (string, por defecto: "IVA incl." o "incl. {rate}% IVA"): Aviso para precios con impuestos incluidos.
• vat_notice_net_text (string, por defecto: "IVA no incl."): Aviso para precios netos.
• vat_exempt_notice (string, por defecto: "Operacion exenta de IVA"): Para pequenos comercios bajo regimenes especiales o franquicias de IVA.

---

4. Gastos de envio (shipping_notice)

Base legal

Directiva 2011/83/UE Art. 6(1)(e). Si el coste del transporte no puede calcularse de antemano o se factura por separado, debe constar de manera inmediata junto al precio.

Opciones de configuracion (shoplex_prices)

• shipping_costs_notice_enabled (bool, por defecto: true): Activa el aviso.
• shipping_costs_text (string, por defecto: "mas gastos de envio"): Texto con enlace a la politica de envio de la tienda.

---

5. Precio “desde” en productos variables (from_price)

Base legal

Directiva 98/6/CE. Principio de claridad frente a rangos de precios enganosos.

Funcionamiento

Reemplaza el intervalo estandar de WooCommerce (ej. 10,00 € - 50,00 €) por una indicacion limpia de partida (desde 10,00 €).

Opciones de configuracion (shoplex_prices)

• from_price_enabled (bool, por defecto: false): Habilita el precio base.
• from_price_text (string, por defecto: "desde {price}"): Plantilla personalizable.

---

6. Plazo de entrega (delivery_time)

Base legal

Directiva 2011/83/UE Art. 6(1)(g). Informacion previa sobre el plazo en el que el comerciante se compromete a entregar los bienes.

Opciones de configuracion (shoplex_delivery)

• default_delivery_time (Term ID, por defecto: 0): Valor por defecto de la tienda.
• display_format (string, por defecto: "Plazo de entrega: {time}"): Texto de salida.
• show_in_loop (bool, por defecto: false): Muestra el plazo en listados de catalogo.

---

7. Garantia legal y durabilidad (consumer_information)

Base legal

Directivas (UE) 2019/771 y 2019/770 y en Espana el Real Decreto-ley 7/2021 (TRLGDCU).

Funcionamiento

Muestra el aviso de garantia legal de conformidad y, si existen, periodos de garantia comercial de durabilidad o actualizaciones de software para bienes con elementos digitales.

[!NOTE] En compradores de Espana, Shoplex ajusta automaticamente el plazo legal a 3 anos (36 meses) segun exige el Real Decreto-ley 7/2021.

Campos por producto

• _shoplex_durability_guarantee_months (int): Meses de garantia comercial adicional.
• _shoplex_update_period_months (int): Meses de soporte y actualizaciones de software.
• _shoplex_repair_info (textarea): Disponibilidad de recambios e instrucciones de reparacion.

---

8. Normas nacionales de la UE (country_compliance)

Base legal

Art. 98.2 TRLGDCU (Espana), § 312j BGB (Alemania), Art. L. 221-14 (Francia) y registros medioambientales (Punto Verde, LUCID, EPR, BDO).

Consulte la Guia de cumplimiento legal por pais para todos los detalles normativos.

---

9. Derecho de desistimiento de 14 dias (withdrawal)

Base legal

Directiva 2011/83/UE Anexo I(B). Derecho irrenunciable del consumidor a desistir del contrato en el plazo de 14 dias naturales sin alegar motivo.

Funcionamiento

1. Formulario publico mediante el shortcode [shoplex_withdrawal_form].
2. Accion integrada en Mi cuenta > Pedidos.
3. Acceso para compras como invitado mediante enlaces criptograficos magic-link (validez de 30 minutos).
4. Proteccion con tasa limite para impedir escaneos de correos y numeros de pedido.
5. Emision de acuses de recibo en formato HTML para el cliente y el comercio.

---

10. Seguridad de productos (gpsr)

Base legal

Reglamento (UE) 2023/988 (GPSR) sobre la seguridad general de los productos. Obligacion de identificar fabricante, responsable en la UE, codigos identificativos e instrucciones de seguridad.

Campos a nivel de producto

• _shoplex_gpsr_manufacturer_name: Nombre o razon social del fabricante.
• _shoplex_gpsr_manufacturer_address: Direccion postal del fabricante.
• _shoplex_gpsr_manufacturer_contact: Correo electronico o formulario de contacto.
• _shoplex_gpsr_responsible_person: Operador economico responsable en la UE.
• _shoplex_gpsr_responsible_address: Direccion postal en territorio de la UE.
• _shoplex_gpsr_responsible_contact: Email de contacto del responsable comunitario.
• _shoplex_gpsr_product_identifier: Referencia, lote, modelo o numero de serie.
• _shoplex_gpsr_safety_warnings: Advertencias e informacion sobre riesgos en el idioma del mercado.
• _shoplex_gpsr_instructions: Instrucciones de ensamblaje, uso y seguridad.

---

11. Consentimientos en checkout (legal_checkboxes)

Base legal

Directiva 2011/83/UE Art. 8, RGPD Art. 7 y renuncia expresa al desistimiento en contenidos digitales antes de la descarga (Directiva 2011/83/UE Art. 16.m).

Casillas para terminos y condiciones, politica de privacidad, renuncia al desistimiento digital, consentimiento para comunicaciones comerciales y envio de datos a agencias de transporte. Los consentimientos quedan registrados en los metadatos del pedido.

---

12. Identidad del comerciante (business_info)

Base legal

Directiva 2000/31/CE Art. 5 y Ley 34/2002 (LSSI-CE) en Espana. Datos obligatorios: denominacion social, CIF/NIF, domicilio fiscal, email, telefono y datos registrales (Registro Mercantil).

---

13. Resolucion de litigios (dispute_resolution)

Base legal

La plataforma de resolucion de litigios en linea de la UE se ha cerrado. El Reglamento (UE) 524/2013 fue derogado con efectos desde el 20 de julio de 2025 por el Reglamento (UE) 2024/3228. La Directiva 2013/11/UE, modificada por la Directiva (UE) 2025/2647, establece el marco europeo de resolucion alternativa de litigios. Este modulo solo ofrece un aviso editable. Adapte el texto a la normativa nacional aplicable a su tienda e incluya el enlace a la entidad ADR correspondiente cuando sea obligatorio.

---

14. Validacion de NIF-IVA UE (vies)

Base legal

Directiva 2006/112/CE Art. 138 (Exencion de IVA en entregas intracomunitarias B2B).

Comprueba el NIF de empresas europeas en tiempo real contra la API VIES de la Comision Europea, registrando el identificador oficial de la consulta como prueba pericial fiscal en el pedido.

---

15. Formulario de reclamacion (complaint_template)

Base legal

Directiva (UE) 2019/771. Modelo de declaracion de disconformidad ante defectos del producto.

Uso mediante shortcode:

[shoplex_complaint_template]

o exportacion en HTML listo para impresion desde el panel de administracion.

---

16. Cyber Resilience Act (cra_readiness)

Base legal

Reglamento (UE) 2024/2847 (CRA) y estandar RFC 9116. Publica el archivo obligatorio de comunicacion de vulnerabilidades en /.well-known/security.txt.

---

17. Digital Services Act (dsa_toolkit)

Base legal

Reglamento (UE) 2022/2065 (DSA) Art. 16. Mecanismo obligatorio de notificacion y accion contra contenidos o productos ilegales en plataformas de comercio electronico.

Uso mediante shortcode:

[shoplex_dsa_report]

---

18. Deposito de envases (deposit)

Anade al carrito una cuota de deposito configurable y no sujeta a impuestos, y muestra un aviso en la ficha del producto. El modulo viene desactivado. Los campos _shoplex_deposit_type y _shoplex_deposit_units indican la categoria del deposito y el numero de envases. Las variaciones pueden heredar estos valores del producto principal.

Los importes predeterminados son 0,25 EUR para envases de un solo uso, 0,08 EUR para botellas reutilizables de cerveza, 0,15 EUR para botellas reutilizables de agua mineral y 0,25 EUR para latas. Puede cambiar los importes en los ajustes shoplex_deposit. El modulo calcula la cuota y muestra el aviso, pero no registra devoluciones fisicas ni reembolsa depositos.

---

19. Informacion alimentaria (food_information)

Muestra los datos introducidos en Datos del producto > Shoplex: ingredientes, alergenos, valores nutricionales, Nutri-Score, contenido de alcohol, cantidad neta, lugar de origen y datos del operador de la empresa alimentaria. El modulo viene desactivado y contempla la informacion alimentaria del Reglamento (UE) 1169/2011.

Los valores nutricionales se introducen como pares clave:valor separados por barras verticales, por ejemplo energy_kcal:250|fat:12|salt:0.9. Algunas claves admitidas son energy_kj, energy_kcal, fat, saturated_fat, carbohydrates, sugars, fibre, protein y salt. Solo se muestran los datos rellenados.

---

20. Consentimiento de cookies y bloqueo de contenido (consent_manager)

Muestra un banner con las categorias Necesarias, Analitica, Marketing y Preferencias. Integra Google Consent Mode v2 y puede retener contenido incrustado de YouTube, Vimeo, Google Maps, OpenStreetMap y SoundCloud hasta que el visitante otorgue su consentimiento. El visitante puede volver a abrir sus preferencias. El modulo viene activado y se configura en shoplex_consent.

El bloqueo se aplica a los contenidos multimedia compatibles incrustados en el contenido y las descripciones cortas. No bloquea cualquier script de terceros.