# Conformidade GPSR (segurança dos produtos): guia completo

> Apresentação O módulo Conformidade GPSR (datafireflygpsr) prepara a sua loja para o Regulamento (UE) 2023/988 relativo à segurança geral dos produtos, aplicável desde 13 de dezembro de 2024. Apresenta em…

- Página: <https://www.datafirefly.com/pt/documentation/datafireflygpsr/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/datafireflygpsr/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflygpsr/index.md), [es](https://www.datafirefly.com/es/documentation/datafireflygpsr/index.md), [de](https://www.datafirefly.com/de/documentation/datafireflygpsr/index.md), [it](https://www.datafirefly.com/it/documentation/datafireflygpsr/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafireflygpsr/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflygpsr/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O módulo **Conformidade GPSR** (`datafireflygpsr`) prepara a sua loja para o **Regulamento (UE) 2023/988** relativo à segurança geral dos produtos, aplicável desde 13 de dezembro de 2024. Apresenta em cada ficha de produto o **fabricante**, o **responsável estabelecido na União Europeia**, as **advertências de segurança** e os **pictogramas regulamentares**, no idioma do cliente.

O módulo fornece as ferramentas técnicas para recolher e apresentar as informações exigidas. A conformidade regulamentar depende também da exatidão das informações que introduzir e da análise de risco de cada produto. Não substitui aconselhamento jurídico.

**Em Portugal** — A autoridade de fiscalização do mercado para o GPSR é a ASAE. O regulamento é diretamente aplicável, sem necessidade de transposição, pelo que as obrigações descritas neste guia são as mesmas de qualquer outro Estado-Membro. O regulamento exige que as advertências e as informações de segurança sejam prestadas na língua do país onde o produto é comercializado: numa loja que venda para Portugal, o texto tem de estar em português.

## Compatibilidade

- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- MySQL 5.7+ ou MariaDB 10.3+
- Loja única e multiloja
- Tema Classic, Hummingbird e temas personalizados
- Interface e dados fornecidos em francês, inglês, espanhol, alemão e italiano
- Sem dependências (nem Composer nem framework) e sem CDN

## Instalação

1. No back-office, abra **Módulos > Gestor de módulos**.
2. Clique em **Instalar um módulo** e selecione o ficheiro `datafireflygpsr.zip`.
3. Depois de instalado, clique em **Configurar**.

Na instalação, o módulo cria as suas tabelas, regista os seus hooks (recursos do back-office e do front-office, separador da ficha de produto, bloco de apresentação na loja), acrescenta o menu **Catálogo > GPSR** e cria dados de exemplo: quatro pictogramas (advertência, idade 0-3 anos, marcação CE, inflamável) e duas advertências-tipo (risco de asfixia, vigilância de um adulto), traduzidos nos cinco idiomas.

## Primeiros passos

1. Crie os seus **operadores económicos** (no mínimo um fabricante e, se necessário, um responsável na UE) em **Catálogo > GPSR > Operadores**.
2. Verifique ou complete a biblioteca de **pictogramas** e de **advertências**.
3. Na configuração do módulo, defina eventualmente um fabricante e um responsável na UE **predefinidos**.
4. Abra uma ficha de produto, vá ao separador **GPSR**, preencha as informações e clique em **Gravar GPSR**.
5. Verifique a apresentação do lado da loja, na ficha de produto.

## Configuração do módulo

- **Ativar a apresentação GPSR**: ativa ou desativa a apresentação das informações na loja.
- **Modo de apresentação**: _Separador dedicado_ (um separador «Segurança do produto» na ficha) ou _Bloco em linha_ (por baixo das informações do produto).
- **Apresentar os pictogramas**: mostra ou oculta a grelha de pictogramas na loja.
- **Apresentar as advertências**: mostra ou oculta a lista de advertências na loja.
- **Ocultar se vazio**: não apresenta qualquer caixa quando um produto não tem dados GPSR preenchidos.
- **Fabricante predefinido** e **Responsável na UE predefinido**: operadores aplicados automaticamente aos produtos sem valor específico (ver «Valores predefinidos»).

## Gerir os operadores económicos

Os operadores económicos são geridos uma única vez e reutilizados em todo o catálogo, a partir de **Catálogo > GPSR > Operadores**. Estão disponíveis quatro **tipos**:

- **Fabricante**: a entidade que produz o bem ou o manda produzir em seu nome.
- **Importador**: a entidade que coloca no mercado da União um produto proveniente de um país terceiro.
- **Mandatário**: a pessoa mandatada pelo fabricante para agir em seu nome na UE.
- **Responsável na UE**: a pessoa responsável estabelecida na União, exigida quando o fabricante está fora da UE.

Cada operador tem a sua denominação social, morada completa, país, e-mail, telefone, sítio web e número de IVA.

Corrija uma morada uma única vez no operador: a alteração repercute-se instantaneamente em todos os produtos que o utilizam, sem ter de reintroduzir produto a produto.

## Gerir os pictogramas

Em **Catálogo > GPSR > Pictogramas**, crie, altere ou elimine os pictogramas de segurança. Cada pictograma tem um código, uma imagem (SVG ou PNG, carregada no módulo), uma posição de apresentação e, em cada idioma, um nome e uma legenda.

- São fornecidos quatro pictogramas de origem: advertência geral, faixa etária 0-3 anos, marcação CE e produto inflamável.
- Pode criar tantos quantos forem necessários e carregar as suas próprias imagens.

Continua a ser responsável pela escolha dos pictogramas adequados a cada produto, segundo a regulamentação aplicável.

## Gerir as advertências

Em **Catálogo > GPSR > Advertências**, gere a biblioteca de advertências de segurança. Cada advertência tem um código, uma posição e, em cada idioma, o seu texto.

- São fornecidas duas advertências-tipo: risco de asfixia (peças pequenas) e utilização sob a vigilância de um adulto.
- Os textos estão traduzidos nos cinco idiomas e são personalizáveis.

Os textos fornecidos não incluem o português. Numa loja que venda para Portugal, escreva a versão portuguesa de cada advertência e de cada legenda de pictograma antes de colocar o módulo em produção: a informação de segurança na língua do país de comercialização é uma exigência do regulamento, não uma questão de conforto de leitura.

## Preencher os dados GPSR de um produto

Abra uma ficha de produto no back-office: é acrescentado um separador **GPSR**. Aí encontra:

- a seleção do **fabricante** e do **responsável na UE** entre os seus operadores;
- os campos **GTIN** e **número de lote**;
- as **advertências** aplicáveis (caixas de seleção);
- a grelha de **pictogramas** selecionáveis;
- uma zona de **informação de segurança complementar** em texto livre, multilingue.

Clique em **Gravar GPSR** para guardar.

A gravação dos dados GPSR passa por um **controlador AJAX dedicado**, independente do formulário de produto do Symfony. É uma opção de arquitetura deliberada: garante um comportamento idêntico e fiável no PrestaShop 8 e 9, cujas páginas de produto diferem profundamente. O botão «Gravar GPSR» é, por isso, distinto do botão «Gravar» da ficha de produto.

## Valores predefinidos e recurso automático

Se a maioria dos seus produtos partilhar o mesmo fabricante ou o mesmo responsável na UE, defina-os uma vez na configuração do módulo como **valores predefinidos**. Qualquer produto sem fabricante ou responsável específico herda automaticamente esses valores na apresentação da loja. Só terá de preencher manualmente as exceções.

## Apresentação do lado do cliente

Consoante o modo escolhido, as informações GPSR aparecem:

- num **separador dedicado** da ficha de produto, através do hook `displayProductExtraContent`;
- ou num **bloco em linha** por baixo das informações do produto, através do hook `displayProductAdditionalInfo`.

O bloco apresenta o fabricante, o responsável na UE, as advertências, os pictogramas (com as suas legendas), a informação complementar e, quando existem, o GTIN e o número de lote. A opção **Ocultar se vazio** evita qualquer caixa vazia nos produtos por preencher.

## Painel de cobertura

O menu **Catálogo > GPSR** abre um painel que indica a percentagem do catálogo com dados GPSR preenchidos: número de produtos cobertos, número de operadores, de pictogramas e de advertências. Ajuda-o a identificar os produtos que faltam completar.

## Multilingue

As advertências, as legendas dos pictogramas e a informação complementar são traduzíveis em francês, inglês, espanhol, alemão e italiano. A apresentação segue automaticamente o idioma ativo do cliente, tal como exige o regulamento, que impõe informações de segurança na língua do país de comercialização. As legendas de interface traduzem-se em **Parâmetros avançados > Traduções > Traduções dos módulos instalados**, escolhendo `datafireflygpsr`. O português não faz parte dos idiomas fornecidos: acrescente-o aí, além dos campos multilingues de cada advertência e pictograma.

## Compatibilidade com o PrestaShop 9

O módulo foi concebido e testado do PrestaShop 8.0 ao 9.x:

- os controladores do back-office utilizam `ModuleAdminController`, compatível com o 8 e o 9;
- a gravação dos dados do produto passa por um controlador AJAX dedicado, em vez do formulário de produto do Symfony;
- o controlador AJAX devolve diretamente JSON, sem override de assinatura incompatível.

## FAQ e resolução de problemas

### O separador GPSR não mostra os meus operadores

Verifique se criou mesmo pelo menos um operador em **Catálogo > GPSR > Operadores** e se está ativo. As listas pendentes da ficha de produto só propõem operadores ativos.

### As informações não aparecem na loja

Certifique-se de que a apresentação GPSR está ativada na configuração e de que o produto tem dados preenchidos (ou de que existe um fabricante ou responsável predefinido) e limpe depois a cache do PrestaShop. Se a opção **Ocultar se vazio** estiver ativa, um produto sem dados não apresenta nada, propositadamente.

### O clique em «Gravar GPSR» não guarda nada

O botão «Gravar GPSR» é distinto do botão «Gravar» da ficha de produto e desencadeia um pedido AJAX dedicado. Limpe a cache, recarregue a página do produto e verifique na consola do navegador se nenhuma extensão está a bloquear o pedido.

### Como acrescentar o meu próprio pictograma?

Em **Catálogo > GPSR > Pictogramas**, crie um pictograma, carregue a sua imagem (SVG ou PNG) e preencha o nome e a legenda em cada idioma.

### É compatível com o PrestaShop 9?

Sim. O módulo foi concebido e testado do PrestaShop 8.0 ao 9.x, tanto em loja única como em multiloja.

## Desinstalação

A desinstalação elimina as tabelas do módulo e os seus separadores de administração e remove os hooks. Os operadores, pictogramas, advertências e associações de produto são apagados. Se prevê reinstalar, guarde previamente uma cópia de segurança da sua base de dados.
