DataFirefly Digital Product Passport — Documentación
Instale y utilice Digital Product Passport 2.0 para WooCommerce: asistente de configuración, plantillas sectoriales, editor de pasaportes y vista previa en directo, variaciones, códigos QR y etiquetas, GS1 Digital Link, niveles y claves de acceso, importación/exportación, API REST, normativa y resolución de problemas.
Presentación
DataFirefly Digital Product Passport dota a cada producto de WooCommerce, y a cada variación que lo necesite, de un pasaporte digital de producto: identificadores, fabricante, datos medioambientales, durabilidad y reparación, materiales, componentes, instrucciones, sustancias de interés, documentos y etapas de trazabilidad. Cada pasaporte tiene una dirección pública permanente y un código QR para imprimir en el producto, en su embalaje o en sus documentos.
La versión 2.0 añade una vista general de todo su catálogo, un asistente de configuración con plantillas sectoriales, un editor con grado de cumplimentación y vista previa en directo, pasaportes para variaciones, una página pública diseñada para móviles en 8 idiomas, códigos QR en tamaños de impresión y hojas de etiquetas, GS1 Digital Link, niveles de acceso con claves de acceso, un historial de versiones, importación y exportación CSV/JSON, bloques y una API REST documentada.

Lo que exigen las normas de la UE
El Reglamento (UE) 2024/1781 sobre diseño ecológico para productos sostenibles (ESPR) no hace obligatorio un pasaporte por sí solo: cada grupo de productos necesita un acto delegado, que se aplica al menos 18 meses después de su entrada en vigor. En noviembre de 2026 aún no se había adoptado ningún acto delegado del ESPR que exija un pasaporte. La Comisión prevé primero el hierro y el acero, después los textiles, los neumáticos y el aluminio (2027), los muebles (2028) y los colchones (2029). El pasaporte de baterías del Reglamento (UE) 2023/1542 se aplica a partir del 18 de febrero de 2027 a las baterías LMT, a las baterías industriales de más de 2 kWh y a las baterías de vehículos eléctricos.
El plugin le ayuda a estructurar y publicar los datos. No hace que sus productos sean conformes por sí solo: no está conectado al registro de pasaportes de la UE, no proporciona la copia de seguridad en un proveedor independiente de servicios de pasaportes que exige el ESPR y no ha sido evaluado con respecto a las normas armonizadas para pasaportes. La pantalla Pasaportes > Normativa enumera cada requisito con su estado (Cubierto, Cubierto en parte, No cubierto, Bajo su responsabilidad) y su fuente oficial.

Instalación y actualización
- En Plugins > Añadir plugin > Subir plugin, elija
dfdpp-2.0.0.zipy active DataFirefly Digital Product Passport. - Abra Pasaportes en el menú de administración.
Requisitos: WordPress 6.4 o posterior, WooCommerce 8.2 o posterior, PHP 7.4 a 8.5. Las direcciones públicas funcionan sin necesidad de volver a guardar los enlaces permanentes.
Actualizar desde la versión 1.0
Suba el nuevo zip y elija Reemplazar el actual con el subido. Se conservan los pasaportes, sus identificadores, sus direcciones públicas y sus ajustes; los códigos QR ya impresos siguen funcionando. Los códigos de país se normalizan, se calcula el grado de cumplimentación de cada pasaporte y se registra una primera versión de cada pasaporte publicado. Las opciones de visualización de la versión 1.0 se convierten en niveles de acceso (los datos ocultos pasan a «Solo interno»). Un aviso presenta las novedades.
Asistente de configuración
En una instalación nueva, la vista general ofrece una configuración en tres pasos:
- Su empresa: nombre, dirección y país del fabricante, identificador del agente económico (por ejemplo, su número EORI o su GLN de GS1) y un contacto para la información del producto. Estos datos rellenan previamente cada nuevo pasaporte.
- Sector y visualización: una plantilla sectorial (textiles, baterías, electrónica, muebles u otros productos), el color de marca de la página pública y lo que aparece en las páginas de producto.
- Primeros pasaportes: cree pasaportes en borrador para todos los productos que no tengan uno, o para algunas categorías. No se publica nada.

Vista general de sus pasaportes
Pasaportes > Vista general muestra el número de pasaportes, el grado medio de cumplimentación, los productos sin pasaporte y el próximo plazo de la UE. La tabla puede filtrarse por estado, por sector y por pasaportes incompletos, y permite buscar por producto, GTIN, modelo o SKU. Para cada pasaporte se ven su grado de cumplimentación, los primeros elementos que faltan, su estado, su versión y su última actualización.
Las acciones en lote se aplican a los pasaportes seleccionados: publicar, volver a borrador, archivar, imprimir etiquetas, exportar en CSV o JSON. Debajo de la tabla, cree pasaportes en borrador para los productos que no tengan ninguno, con la plantilla sectorial que prefiera.
Editar un pasaporte
Abra un producto: la pestaña Pasaporte de producto del cuadro de datos del producto contiene el editor. Para un producto sin pasaporte, marque Crear un pasaporte para este producto al guardarlo (se marca automáticamente en cuanto escribe en un campo).

La cabecera muestra el anillo de cumplimentación, el estado (Borrador, Publicado, Archivado), el botón Vista previa en directo y el enlace a la página pública. Las secciones aparecen a la izquierda con el número de elementos que faltan; utilice las teclas de flecha para moverse entre ellas.
- Identificación: sector del producto (determina los elementos esperados), GTIN con verificación del dígito de control, modelo, lo que cubre el pasaporte (un modelo, un lote o un artículo único), lote, número de serie, país de fabricación.
- Fabricante y agente económico: fabricante, identificador del agente económico, agente económico responsable en la UE (importador o representante autorizado), contacto, fecha de fabricación, centro e identificador de la instalación.
- Medio ambiente: huella de carbono con su unidad y su método de cálculo, contenido reciclado, proporción reciclable, vida útil prevista, peso.
- Durabilidad y reparación: puntuación de reparabilidad, clase de reparabilidad, garantía comercial, piezas de recambio y actualizaciones de software.
- Datos sectoriales: campos propuestos para el sector, por ejemplo los países de hilatura, tejeduría, acabado y confección para los textiles, o la categoría, la química, la capacidad, la tensión, la energía, la vida útil en ciclos y las proporciones de cobalto, litio, níquel y plomo reciclados para las baterías.
- Materiales, Componentes, Instrucciones (uso, cuidado, reparación, seguridad, reciclaje, fin de vida), Conformidad y documentos y Trazabilidad.
Los campos esperados para el sector llevan un punto. Los valores se comprueban mientras escribe (GTIN, rangos numéricos, fechas, direcciones web); los valores no válidos que se envíen de todos modos se rechazan al guardar, se enumeran en un aviso y se señalan en el campo, y el pasaporte no se publica hasta que se corrijan.
Materiales y componentes
Añada una fila por material: código (plásticos, fibras textiles, metales, químicas de baterías…) o nombre libre, proporción en el producto, peso, proporción reciclada, renovable o de base biológica, origen, número CAS y, si es necesario, el componente al que pertenece. Se muestra el total de las proporciones, que no debe superar el 100 %.

Los componentes tienen nombre, tipo, peso, origen, proveedor y país del proveedor, así como los indicadores «Sustituible», «Reciclable» y «Contiene materias primas fundamentales». Los documentos (declaración de conformidad, manuales, certificados…) pueden elegirse en la biblioteca de medios.
Vista previa en directo
Vista previa en directo muestra la página pública con sus cambios sin guardar, en un móvil o un ordenador. Se actualiza mientras escribe.

Variaciones
En la pestaña Variaciones, marque Pasaporte de producto propio para esta variación: la variación recibe su propio GTIN, modelo, lote, número de serie, huella de carbono, peso y código QR. El resto de los datos se hereda del pasaporte del producto. El pasaporte del producto enumera los pasaportes de las variaciones.
Códigos QR y etiquetas
La sección Código QR y etiquetas del editor muestra la dirección codificada, la versión QR y su corrección de errores, y ofrece:
- SVG (vectorial, para impresión), PNG 1024 px y PNG 20, 30 o 50 mm, 300 dpi;
- una etiqueta imprimible con el código QR, el nombre del producto, el GTIN, el lote o el número de serie y la dirección;
- el identificador del pasaporte, la página pública, la dirección GS1 Digital Link y los datos JSON.

Para imprimir varias etiquetas, seleccione pasaportes en la vista general y elija Imprimir etiquetas. Imprima al 100 % y mantenga el margen blanco alrededor del código.

La página pública del pasaporte
La dirección pública tiene la forma yourdomain.com/dpp/{identifier}/. La página está diseñada para móviles y sigue el idioma del móvil del visitante (8 idiomas, con un menú de idioma). Muestra el producto, su sector e identificadores, las cifras clave, la composición de materiales, los componentes, los datos sectoriales, las instrucciones, la información y los documentos de conformidad, la cronología de trazabilidad, el fabricante, el código QR (descargar, compartir, imprimir) y los detalles del pasaporte (identificador, fechas, versión y huella SHA-256).


La página es accesible con teclado y lector de pantalla, se adapta al modo oscuro y se imprime correctamente. También ofrece sus datos en JSON (/dpp/{identifier}.json) e incluye JSON-LD schema.org. En las páginas de producto, una pestaña Pasaporte de producto (o una tarjeta debajo del resumen) enlaza con el pasaporte.

Ajustes
En Pasaportes > Ajustes (administradores y gestores de la tienda):
- Página pública: prefijo de URL (efecto inmediato), página independiente o dentro del tema, idiomas, indexación en buscadores, visualización en las páginas de producto, herencia de las variaciones, publicación automática, pasaportes de productos que ya no se venden (se mantienen en línea por defecto).
- Valores por defecto de la empresa: valores rellenados previamente en los nuevos pasaportes y sector por defecto.
- Acceso a los datos y API: el nivel de acceso de cada tipo de dato, las claves de acceso y la API REST.
- Códigos QR y etiquetas: dirección del pasaporte o GS1 Digital Link, corrección de errores, color (solo colores oscuros), formato de descarga, tamaño de las etiquetas.
- Apariencia: color de marca (el color del texto sobre él se elige para que sea legible) y logotipo.
- Datos y desinstalación: eliminarlo todo al eliminar el plugin (desmarcado por defecto).
Niveles y claves de acceso
Para cada tipo de dato —fabricante, centro de fabricación, medio ambiente, huella de carbono, durabilidad, instrucciones, conformidad, documentos, componentes, nombres de proveedores, materiales, trazabilidad, quién realizó cada etapa, datos sectoriales—, elija Público, Partes autorizadas (clave de acceso) o Solo interno. Los nombres de los proveedores son internos por defecto. Los identificadores, el nombre del producto y el país de fabricación son siempre públicos.

Cree una clave de acceso para una autoridad, un reparador, un reciclador o un socio: se muestra una sola vez y después se almacena como hash. El destinatario la envía en la cabecera X-DPP-Access-Key al leer la dirección JSON o la API. Puede revocar una clave en cualquier momento.
GS1 Digital Link
Cuando un pasaporte tiene un GTIN válido, recibe una dirección GS1 Digital Link en su dominio, como yourdomain.com/01/09506000134352/10/LOT42 (con el lote o el número de serie según lo que cubra el pasaporte). El plugin responde a estas direcciones y redirige al pasaporte; ?linkType=linkset devuelve la lista de enlaces. En los ajustes de QR puede elegir codificar esta dirección en los códigos QR.
Importación y exportación
Pasaportes > Importar / exportar:
- Exportar todos los pasaportes, o los de un estado, en CSV o JSON. El JSON conserva todas las listas (materiales, componentes, etapas, documentos). Guárdelo como copia de seguridad.
- Importar un archivo CSV (coma, punto y coma o tabulación) o JSON. Las filas se emparejan por
uuid, después porproduct_idy después porsku. El plugin muestra primero lo que se creará, actualizará u omitirá, con advertencias; no se escribe nada antes de que usted confirme. Las celdas CSV vacías no borran los datos existentes. Parta de la plantilla CSV.
Bloques, shortcodes y desarrolladores
- Bloques Pasaporte de producto (tarjeta con código QR, solo QR o enlace) y Código QR del pasaporte.
- Shortcodes
[dfdpp_passport product="123" layout="card|qr|link" qr="no" size="112"]y[dfdpp_qr product="123" size="160"]; sinproduct, se utiliza el producto actual. - API REST
dfdpp/v1:GET /passport/{uuid},/qr,/revisions,/by-product/{id},/by-gtin/{gtin};GET|POST /passports;POST|DELETE /passport/{id};POST /passport/{id}/publish|unpublish|archive. Las llamadas de escritura requieren un usuario autorizado a editar el producto (las contraseñas de aplicación funcionan). Descripción:/wp-json/dfdpp/v1/openapi. - WP-CLI:
wp dfdpp status,list,publish,unpublish,qr,export. - Plantilla: copie
templates/passport.phpenyour-theme/dfdpp/passport.php. Filtrodfdpp_passport_payload; accionesdfdpp_passport_created,dfdpp_passport_saved,dfdpp_public_head.
Resolución de problemas
La página pública devuelve un error 404
El pasaporte está en borrador o archivado, o su producto nunca se ha publicado. La vista general muestra el motivo. Los pasaportes de productos que ya no se venden siguen en línea, salvo que haya elegido ocultarlos.
Un valor no se guarda
Un aviso enumera los valores rechazados después de guardar y los campos se señalan en el editor. Corríjalos y vuelva a guardar.
Mi caché de páginas muestra datos restringidos
Los datos restringidos solo se envían a las solicitudes con una clave de acceso o procedentes de su equipo. Si utiliza una caché de páginas, haga que varíe según la cabecera X-DPP-Access-Key y las cookies de inicio de sesión (el plugin envía la cabecera Vary correspondiente).
Desinstalación
Al desactivar el plugin se conservan todos los datos. Al eliminarlo también se conservan los pasaportes, de modo que una reinstalación los recupera con sus direcciones. Para eliminarlo todo (tablas, ajustes, claves de acceso), marque Eliminar todos los pasaportes y ajustes en Ajustes > Datos y desinstalación antes de eliminar el plugin.
Soporte
El soporte se presta por correo electrónico en francés e inglés en support@datafirefly.com. Indique las versiones del plugin, de WordPress y de WooCommerce.