Digital Product Passport (DPP): guia completo

O módulo DataFirefly Digital Product Passport (dfdpp) acrescenta à sua loja PrestaShop 8 ou 9 um sistema completo de passaporte digital de produto conforme ao regulamento europeu ESPR (Ecodesign for Sustainable Products Regulation), aplicável progressivamente a partir de 2027 ao têxtil, às baterias e à eletrónica.

Cada produto recebe um passaporte com identificador único (UUID), uma página pública multilingue acessível por código QR, um registo de componentes (nomenclatura / BOM), um diário dos eventos do ciclo de vida e uma gestão dos certificados de conformidade.

Pré-requisitos

• PrestaShop 8.0.0 a 9.x
• PHP 7.4 no mínimo (8.1+ recomendado)
• Extensão GD ativada (geração dos códigos QR de recurso se o Endroid não estiver disponível)
• Compatível com multiloja e multilingue (FR / EN / ES / DE / IT incluídos; o português traduz-se em Internacional > Traduções)

Instalação

1. No back-office, abra Módulos > Gestor de módulos.
2. Clique em Instalar um módulo e carregue dfdpp.zip.
3. O módulo cria automaticamente as suas tabelas, o seu menu Passaportes de produto em Catálogo e regista as suas rotas públicas.

Configuração

Abra Módulos > dfdpp > Configurar. Estão disponíveis três blocos:

Parâmetros gerais

• Ativar o módulo: interruptor global.
• Criação automática: gera um passaporte em rascunho a cada gravação de produto.
• Categoria ESPR por defeito: têxtil, bateria, eletrónica, mobiliário, calçado ou geral.
• Apresentação pública: ativa a página pública /dpp/{uuid}.
• Separador na ficha de produto: mostra o passaporte num separador da ficha de produto.
• Exportação JSON pública: autoriza o descarregamento do passaporte em formato JSON.

Código QR

• Tamanho (por defeito 220 px) e margem (10 px).
• Nível de correção de erros: M recomendado (equilíbrio densidade / robustez).

Informações da empresa

Nome, número de IVA (NIF), morada e país do operador económico responsável: estas informações aparecem na página pública do passaporte, como exige o ESPR.

Criar um passaporte

Criação automática

Se a opção estiver ativada, é criado um passaporte em estado de rascunho a cada gravação de produto, com a categoria ESPR por defeito. Só se torna visível publicamente depois de publicado manualmente.

Criação manual

1. Abra Catálogo > Passaportes de produto > Passaportes.
2. Clique em Adicionar, selecione o produto (e a declinação se necessário).
3. Preencha os campos e guarde: é gerado automaticamente um UUID v4 único.

Dados do passaporte

O formulário está organizado em cinco blocos:

• Identificação: produto, declinação, categoria ESPR, GTIN, fabricante, país de origem, data de produção, número de lote.
• Sustentabilidade: pegada de carbono (kg CO₂e), pontuação de reciclabilidade, percentagem de conteúdo reciclado, índice de reparabilidade, duração de vida esperada, garantia.
• Conteúdos multilingues: composição dos materiais, instruções de conservação, instruções de triagem e de fim de vida, informações de reparação, informações de segurança, certificados de conformidade (seis campos de texto rico, traduzíveis em cada idioma da loja).
• Componentes, eventos e documentos: geridos em AJAX diretamente na ficha do passaporte (ver abaixo).
• Campos personalizados: um objeto JSON livre para qualquer dado setorial suplementar.

Registo de componentes (BOM)

Cada passaporte pode recensear a sua nomenclatura completa: nome do componente, material, peso (g), percentagem do produto, parte reciclada, caráter reciclável, perigosidade, número CAS, fornecedor e país. Os componentes podem ser aninhados (componente pai / subcomponente) para modelar montagens.

O menu Catálogo > Passaportes de produto > Registo oferece uma vista transversal de todos os componentes da loja, filtrável por material, perigosidade ou fornecedor, prática para as auditorias REACH.

Eventos do ciclo de vida

O diário retraça a vida do produto: conceção, matéria-prima, fabrico, controlo de qualidade, distribuição, primeira venda, revenda, reparação, recondicionamento, reciclagem, fim de vida. Cada evento tem uma data, um local, um ator (nome + papel), uma descrição e um URL de prova facultativo.

A vista Catálogo > Passaportes de produto > Eventos centraliza todos os eventos com filtro por tipo.

Documentos e certificados

Anexe a cada passaporte os certificados exigidos: declaração CE, REACH, RoHS, REEE, regulamento europeu das baterias, OEKO-TEX, GOTS, Rótulo Ecológico, FSC, ISO 14001 / 9001, PEF, EPD ou outro. Cada documento tem um número, um emissor, datas de validade e um URL de ficheiro.

Pontuação de conformidade ESPR

O módulo avalia cada passaporte segundo regras próprias da sua categoria ESPR e mostra uma pontuação em 100 acompanhada de um nível:

• Conforme: pontuação ≥ 90 sem ponto bloqueante.
• Parcial: pontuação ≥ 60.
• Rascunho: dados incompletos.
• Não conforme: pontos bloqueantes presentes.

A lista das verificações e dos pontos bloqueantes é detalhada na ficha do passaporte; o botão Recalcular atualiza a pontuação depois de uma alteração.

Página pública e código QR

Cada passaporte publicado está acessível no endereço https://a-sua-loja.pt/dpp/{uuid} e o seu código QR em PNG em /dpp/{uuid}/qr.png (parâmetro ?size= aceite de 80 a 800 px, cache do navegador de 24 h).

A página pública apresenta: visual e identidade do produto, código QR, indicadores de sustentabilidade, composição, tabela dos componentes, conservação e reparação, instruções de triagem, cronologia do ciclo de vida, certificados, informações de segurança e contactos do operador responsável. Incorpora uma marcação JSON-LD schema.org para o posicionamento.

Apresentação na ficha de produto

Se a opção estiver ativada, aparece um separador Passaporte digital na ficha de produto do front-office com o código QR, os indicadores-chave e a ligação para a página pública. Um bloco de recurso pode também aparecer sob a descrição.

RGPD e diário de acessos

As consultas públicas podem ser registadas de forma anonimizada: o endereço IP é transformado em hash SHA-256 com um salt diário e a chave secreta da loja; não é conservado nenhum dado pessoal explorável. A opção pode ser desativada na configuração.

Multiloja e multilingue

Os passaportes estão associados a uma loja (contexto multishop respeitado) e todos os conteúdos editoriais existem em cada idioma ativo. O módulo é entregue traduzido em francês, inglês, espanhol, alemão e italiano (formato XLIFF, modificável via Internacional > Traduções); é por aí que se acrescenta o português.

Desinstalação e conservação dos dados

Na desinstalação, a configuração e os separadores de administração são eliminados, mas as tabelas de dados são conservadas: o regulamento ESPR impõe a disponibilidade do passaporte durante toda a vida do produto. Para uma eliminação definitiva, elimine manualmente as tabelas ps_dfdpp_*.

Resolução de problemas

A página /dpp/{uuid} devolve um 404

• Verifique que o passaporte está publicado e que a apresentação pública está ativada.
• Limpe a cache do PrestaShop (Parâmetros avançados > Desempenho) para regenerar as rotas.
• Verifique a reescrita de URL (URLs amigáveis ativados).

O código QR não aparece

• Verifique que a extensão PHP GD está ativa se a sua instalação não fornecer o Endroid QR Code.

O separador não aparece na ficha de produto

• Ative a opção Separador na ficha de produto na configuração e verifique que o seu tema suporta o hook displayProductExtraContent.

Histórico de versões

• 1.0.0: versão inicial: passaportes UUID, página pública multilingue, códigos QR, componentes aninhados, eventos do ciclo de vida, documentos, pontuação de conformidade ESPR por categoria, exportação JSON / JSON-LD, diário de acessos RGPD, multiloja.