Digital Product Passport (DPP) — Guía completa
Instalar y configurar el módulo Pasaporte Digital de Producto: código QR por producto, registro de componentes, trazabilidad del ciclo de vida y conformidad ESPR 2027.
El módulo DataFirefly — Digital Product Passport (dfdpp) añade a su tienda PrestaShop 8 o 9 un sistema completo de pasaporte digital de producto conforme al reglamento europeo ESPR (Ecodesign for Sustainable Products Regulation), aplicable progresivamente a partir de 2027 para el textil, las baterías y la electrónica.
Cada producto recibe un pasaporte con identificador único (UUID), una página pública multilingüe accesible mediante código QR, un registro de componentes (lista de materiales / BOM), un diario de eventos del ciclo de vida y una gestión de certificados de conformidad.
Requisitos
- PrestaShop 8.0.0 a 9.x
- PHP 7.4 mínimo (8.1+ recomendado)
- Extensión GD activada (renderizado QR de respaldo si Endroid no está disponible)
- Compatible con multitienda y multilingüe (FR / EN / ES / DE / IT incluidos)
Instalación
- En el back-office, abra Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y suba
dfdpp.zip. - El módulo crea automáticamente sus tablas, su menú Pasaportes de producto bajo Catálogo y registra sus rutas públicas.
No se incluye ninguna biblioteca externa: el módulo utiliza Endroid QR Code suministrado con el núcleo de PrestaShop (v3, v4 o v5 detectada automáticamente), con un renderizado GD de respaldo.
Configuración
Abra Módulos > dfdpp > Configurar. Hay tres bloques disponibles:
Parámetros generales
- Activar el módulo — interruptor global.
- Creación automática — genera un pasaporte borrador con cada guardado de producto.
- Categoría ESPR por defecto — textil, batería, electrónica, mobiliario, calzado o general.
- Visualización pública — activa la página pública
/dpp/{uuid}. - Pestaña de ficha de producto — muestra el pasaporte en una pestaña de la ficha de producto.
- Exportación JSON pública — permite descargar el pasaporte en formato JSON.
Código QR
- Tamaño (por defecto 220 px) y margen (10 px).
- Nivel de corrección de errores — M recomendado (equilibrio densidad / robustez).
Información de la empresa
Nombre, número de IVA, dirección y país del operador económico responsable — esta información aparece en la página pública del pasaporte, como exige el ESPR.
Crear un pasaporte
Creación automática
Si la opción está activada, se crea un pasaporte en estado borrador con cada guardado de producto, con la categoría ESPR por defecto. Solo será visible públicamente cuando se publique manualmente.
Creación manual
- Abra Catálogo > Pasaportes de producto > Pasaportes.
- Haga clic en Añadir, seleccione el producto (y la combinación si es necesario).
- Rellene los campos y guarde: se genera automáticamente un UUID v4 único.
Desde la ficha de producto del back-office, la pestaña Pasaporte digital permite crear o abrir directamente el pasaporte del producto en edición.
Datos del pasaporte
El formulario está organizado en cinco bloques:
- Identificación — producto, combinación, categoría ESPR, GTIN, fabricante, país de origen, fecha de producción, número de lote.
- Sostenibilidad — huella de carbono (kg CO₂e), puntuación de reciclabilidad, porcentaje de contenido reciclado, índice de reparabilidad, vida útil esperada, garantía.
- Contenidos multilingües — composición de materiales, instrucciones de cuidado, instrucciones de eliminación y fin de vida, información de reparación, información de seguridad, certificados de conformidad (seis campos de texto enriquecido, traducibles a cada idioma de la tienda).
- Componentes, eventos y documentos — gestionados por AJAX directamente en la ficha del pasaporte (ver más abajo).
- Campos personalizados — un objeto JSON libre para cualquier dato sectorial adicional.
Registro de componentes (BOM)
Cada pasaporte puede recoger su nomenclatura completa: nombre del componente, material, peso (g), porcentaje del producto, parte reciclada, reciclabilidad, peligrosidad, número CAS, proveedor y país. Los componentes pueden anidarse (componente padre / subcomponente) para modelar ensamblajes.
El menú Catálogo > Pasaportes de producto > Registro ofrece una vista transversal de todos los componentes de la tienda, filtrable por material, peligrosidad o proveedor — práctico para las auditorías REACH.
Eventos del ciclo de vida
El diario traza la vida del producto: diseño, materia prima, fabricación, control de calidad, distribución, primera venta, reventa, reparación, reacondicionamiento, reciclaje, fin de vida. Cada evento lleva una fecha, un lugar, un actor (nombre + rol), una descripción y una URL de evidencia opcional.
La vista Catálogo > Pasaportes de producto > Eventos centraliza todos los eventos con filtro por tipo.
Documentos y certificados
Adjunte a cada pasaporte los certificados exigidos: declaración CE, REACH, RoHS, RAEE, reglamento de baterías UE, OEKO-TEX, GOTS, Ecolabel, FSC, ISO 14001 / 9001, PEF, EPD u otros. Cada documento lleva un número, un emisor, fechas de validez y una URL de archivo.
Un certificado caducado se marca como bloqueante por el motor de conformidad y reduce la puntuación del pasaporte.
Puntuación de conformidad ESPR
El módulo evalúa cada pasaporte según reglas propias de su categoría ESPR y muestra una puntuación sobre 100 acompañada de un nivel:
- Conforme — puntuación ≥ 90 sin puntos bloqueantes.
- Parcial — puntuación ≥ 60.
- Borrador — datos incompletos.
- No conforme — puntos bloqueantes presentes.
La lista de verificaciones y puntos bloqueantes se detalla en la ficha del pasaporte; el botón Recalcular actualiza la puntuación tras cualquier modificación.
Página pública y código QR
Cada pasaporte publicado es accesible en https://su-tienda.com/dpp/{uuid} y su código QR PNG en /dpp/{uuid}/qr.png (parámetro ?size= aceptado de 80 a 800 px, caché de navegador de 24 h).
La página pública presenta: imagen e identidad del producto, código QR, indicadores de sostenibilidad, composición, tabla de componentes, cuidado y reparación, instrucciones de eliminación, cronología del ciclo de vida, certificados, información de seguridad y datos del operador responsable. Incluye marcado JSON-LD schema.org para el SEO.
Imprima el código QR en la etiqueta, el folleto o el embalaje del producto: es el modo de acceso previsto por el ESPR para el consumidor final, los reparadores y los recicladores.
Visualización en la ficha de producto
Si la opción está activada, aparece una pestaña Pasaporte digital en la ficha de producto del front-office con el código QR, los indicadores clave y el enlace a la página pública. También puede mostrarse un bloque de respaldo bajo la descripción.
RGPD y registro de accesos
Las consultas públicas pueden registrarse de forma anonimizada: la dirección IP se cifra con SHA-256, una sal diaria y la clave secreta de la tienda — no se conserva ningún dato personal explotable. La opción puede desactivarse en la configuración.
Multitienda y multilingüe
Los pasaportes están vinculados a una tienda (contexto multitienda respetado) y todos los contenidos editoriales existen en cada idioma activo. El módulo se entrega traducido al francés, inglés, español, alemán e italiano (formato XLIFF, editable en Internacional > Traducciones).
Desinstalación y conservación de datos
Al desinstalar, se eliminan la configuración y las pestañas de administración, pero las tablas de datos se conservan: el reglamento ESPR exige la disponibilidad del pasaporte durante toda la vida del producto. Para una eliminación definitiva, elimine manualmente las tablas ps_dfdpp_*.
Solución de problemas
La página /dpp/{uuid} devuelve un 404
- Compruebe que el pasaporte está publicado y que la visualización pública está activada.
- Vacíe la caché de PrestaShop (Parámetros avanzados > Rendimiento) para regenerar las rutas.
- Compruebe la reescritura de URL (URL amigables activadas).
El código QR no se muestra
- Compruebe que la extensión PHP GD está activa si su instalación no incluye Endroid QR Code.
La pestaña no aparece en la ficha de producto
- Active la opción Pestaña de ficha de producto en la configuración y compruebe que su tema soporta el hook
displayProductExtraContent.
Historial de versiones
- 1.0.0 — Versión inicial: pasaportes UUID, página pública multilingüe, códigos QR, componentes anidados, eventos del ciclo de vida, documentos, puntuación de conformidad ESPR por categoría, exportación JSON / JSON-LD, registro de accesos RGPD, multitienda.