# Digital Product Passport (DPP) — Guía completa > 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… - Página: - Idioma: es - Actualizado el: 2026-07-01 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfdpp/index.md), [en](https://www.datafirefly.com/en/documentation/dfdpp/index.md), [de](https://www.datafirefly.com/de/documentation/dfdpp/index.md), [it](https://www.datafirefly.com/it/documentation/dfdpp/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdpp/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdpp/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdpp/index.md) - Índice: 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 1. En el back-office, abra **Módulos > Gestor de módulos**. 2. Haga clic en **Subir un módulo** y suba `dfdpp.zip`. 3. 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 1. Abra **Catálogo > Pasaportes de producto > Pasaportes**. 2. Haga clic en **Añadir**, seleccione el producto (y la combinación si es necesario). 3. 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.