Wo WooCommerce Intermedio

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.

Actualizado Versión del módulo 2.0.0

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.

DataFirefly Pasaporte digital de producto – Vista general de los pasaportes: cumplimentación, productos sin pasaporte y próximo plazo europeo
Vista general de los pasaportes: cumplimentación, productos sin pasaporte y próximo plazo europeo
En resumen: instale el plugin, siga la configuración en Pasaportes, complete la pestaña Pasaporte de producto de un producto, revise la Vista previa en directo, publique y, después, imprima el código QR.

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.

DataFirefly Pasaporte digital de producto – Normativa y cobertura: ESPR y pasaporte de la batería, lo que cubre el plugin
Normativa y cobertura: ESPR y pasaporte de la batería, lo que cubre el plugin
La información de un pasaporte se facilita bajo la responsabilidad del agente económico que introduce el producto en el mercado. Compruebe con un asesor jurídico las normas que se aplican a sus productos.

Instalación y actualización

  1. En Plugins > Añadir plugin > Subir plugin, elija dfdpp-2.0.0.zip y active DataFirefly Digital Product Passport.
  2. 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:

  1. 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.
  2. 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.
  3. Primeros pasaportes: cree pasaportes en borrador para todos los productos que no tengan uno, o para algunas categorías. No se publica nada.
DataFirefly Pasaporte digital de producto – Asistente de configuración con plantillas por sector: textil, baterías, electrónica, muebles
Asistente de configuración con plantillas por sector: textil, baterías, electrónica, muebles

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.

Un pasaporte publicado cuyo producto aún no está publicado permanece oculto al público: la vista general lo marca como «Oculto: producto no público».

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).

DataFirefly Pasaporte digital de producto – Editor del pasaporte en la ficha de producto, con grado de cumplimentación y controles
Editor del pasaporte en la ficha de producto, con grado de cumplimentación y controles

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 %.

DataFirefly Pasaporte digital de producto – Composición de materiales con control de porcentajes y enlace a los componentes
Composición de materiales con control de porcentajes y enlace a los componentes

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.

DataFirefly Pasaporte digital de producto – Vista previa en directo de la página pública del pasaporte en el móvil
Vista previa en directo de la página pública del pasaporte en el móvil

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.
DataFirefly Pasaporte digital de producto – Código QR para imprimir (SVG, PNG 20, 30, 50 mm), etiquetas y GS1 Digital Link
Código QR para imprimir (SVG, PNG 20, 30, 50 mm), etiquetas y GS1 Digital Link

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.

DataFirefly Pasaporte digital de producto – Hoja de etiquetas imprimible con los códigos QR de varios pasaportes
Hoja de etiquetas imprimible con los códigos QR de varios pasaportes
La dirección codificada en el código QR nunca cambia, aunque cambie más adelante el prefijo de URL: el prefijo anterior redirige al nuevo.

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).

DataFirefly Pasaporte digital de producto – Página pública del pasaporte: cifras clave, materiales, componentes, instrucciones, documentos
Página pública del pasaporte: cifras clave, materiales, componentes, instrucciones, documentos
DataFirefly Pasaporte digital de producto – Pasaporte de la batería en el móvil, tal como se ve tras escanear el código QR
Pasaporte de la batería en el móvil, tal como se ve tras escanear el código QR

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.

DataFirefly Pasaporte digital de producto – Pestaña «Pasaporte de producto» en la ficha de producto de WooCommerce
Pestaña «Pasaporte de producto» en la ficha de producto de WooCommerce

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.

DataFirefly Pasaporte digital de producto – Niveles de acceso a los datos, claves de acceso para partes autorizadas y API REST
Niveles de acceso a los datos, claves de acceso para partes autorizadas y API REST

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.

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 por product_id y después por sku. 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"]; sin product, 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.php en your-theme/dfdpp/passport.php. Filtro dfdpp_passport_payload; acciones dfdpp_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.

Eliminar los datos hace desaparecer las páginas a las que remiten sus códigos QR impresos. Exporte antes sus pasaportes.

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.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte