# DfGpsr SW: guia completo

> O DfGpsr SW apresenta nas suas páginas de produto Shopware as informações de segurança tornadas obrigatórias pelo regulamento (UE) 2023/988, o regulamento geral de segurança dos produtos (GPSR), aplicável desde…

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

O DfGpsr SW apresenta nas suas páginas de produto Shopware as informações de segurança tornadas obrigatórias pelo regulamento (UE) 2023/988, o regulamento geral de segurança dos produtos (GPSR), aplicável desde 13 de dezembro de 2024. O Shopware não oferece nada de nativo sólido neste ponto. O DfGpsr SW preenche esse vazio com campos personalizados por produto, valores de recurso globais configuráveis por canal de venda, e apresentação automática sob a descrição do produto. A extensão foi deliberadamente construída sem componente de administração à medida e sem JavaScript no storefront: um único ZIP instala-se de forma idêntica no Shopware 6.5, 6.6 e 6.7, sem qualquer compilação. Este guia cobre a instalação, a configuração global, o preenchimento por produto, a tradução, a personalização do template e a resolução de problemas.

O DfGpsr SW é uma ferramenta técnica de apresentação. Ajuda-o a apresentar as informações exigidas, mas a exatidão e a completude dos dados introduzidos continuam a ser da sua responsabilidade, tal como a avaliação da aplicabilidade do regulamento aos seus produtos. Este guia não constitui aconselhamento jurídico. Em Portugal, a fiscalização do mercado cabe à ASAE.

## O que o GPSR impõe

Na venda online, o regulamento (UE) 2023/988 impõe que cada oferta apresente claramente, antes da compra:

- o **fabricante**: nome, morada postal e endereço eletrónico;
- a **pessoa responsável estabelecida na UE** (artigo 16.º) quando o fabricante está estabelecido fora da União: nome, morada postal e endereço eletrónico;
- as **advertências e informações de segurança** na língua do país visado.

O DfGpsr SW cobre estas três exigências, mais uma lista de documentos de segurança (manuais, fichas de dados de segurança, certificados) e um interruptor de ocultamento para as referências fora do âmbito do regulamento.

## Instalação

1. Transfira o arquivo `DfGpsr-v1.0.0.zip` a partir da sua conta DataFirefly.
2. Copie a pasta descomprimida `DfGpsr` para `custom/plugins/` do seu Shopware, ou instale o ZIP em **Administração → Extensões → As minhas extensões → Carregar extensão**.
3. Execute a instalação e a ativação: ``` bin/console plugin:refresh bin/console plugin:install --activate DfGpsr bin/console cache:clear ```
4. Na instalação, a extensão cria o seu conjunto de campos personalizados `df_gpsr` na entidade produto. Na desinstalação sem conservação dos dados, esse conjunto de campos e todos os seus valores são eliminados.

Compatível com Shopware 6.5.x, 6.6.x e 6.7.x numa única base de código. Não é necessário qualquer build de storefront ou de administração, e a extensão não acrescenta qualquer dependência Composer. É isso que garante a instalação idêntica nas três versões, incluindo a nova administração da 6.7.

## Configuração global (valores de recurso)

Abra **Extensões → As minhas extensões → DataFirefly GPSR Compliance → ⋯ → Configurar**. A configuração está organizada em cartões:

- **Geral**: ativar a apresentação do bloco, mostrar ou não o título da secção, e uma opção de apresentação forçada mesmo sem dados (reservada a theming e depuração).
- **Fabricante por predefinição**: nome, morada postal e email usados quando um produto não define o seu próprio fabricante.
- **Pessoa responsável na UE por predefinição**: nome, morada postal e email.
- **Textos de segurança por predefinição**: advertências e informações de segurança genéricas.

Todos estes valores são configuráveis **por canal de venda** graças ao seletor nativo do Shopware no topo da configuração. Selecione um canal para lhe atribuir valores específicos, ou deixe «Todos os canais de venda» para valores comuns.

Se vende a sua própria marca, preencha o fabricante uma só vez na configuração global: todo o catálogo fica coberto sem tocar nos produtos. Os campos por produto servem então apenas para as exceções.

## Preencher um produto

Abra um produto em **Catálogos → Produtos**, e depois o separador **Especificações → Campos personalizados**. O grupo **GPSR: segurança do produto** reúne os seguintes campos:

- **Ocultar as informações GPSR para este produto**: interruptor a ativar para as referências fora do âmbito do regulamento.
- **Fabricante**: nome, morada postal, endereço de email.
- **Pessoa responsável na UE**: nome, morada postal, endereço de email.
- **Advertências** e **Informações de segurança**: editores de texto formatado.
- **Documentos de segurança**: um por linha, no formato `Etiqueta|URL` ou apenas um URL.

A regra de resolução é simples: para cada campo, a extensão usa o valor do produto se estiver preenchido, caso contrário recorre ao valor predefinido do canal de venda. O campo «Documentos» não tem valor de recurso global, é próprio de cada produto.

### Formato dos documentos de segurança

Introduza um documento por linha. São aceites dois formatos:

```
Manual de utilização|https://exemplo.com/manual.pdf
Ficha de dados de segurança|https://exemplo.com/fds.pdf
https://exemplo.com/certificado.pdf
```

Com o formato `Etiqueta|URL`, a etiqueta torna-se o texto clicável; um URL isolado aparece tal como está. Todas as ligações abrem num novo separador.

## Tradução

Os campos são campos personalizados normais do Shopware: traduzem-se produto a produto através do seletor de idioma da administração, no topo da ficha do produto. Preencha por exemplo as advertências em português para o idioma PT, e depois passe para DE para introduzir a versão alemã.

As **etiquetas do bloco no storefront** (título «Segurança do produto», «Fabricante», «Pessoa responsável na UE» e outras) são fornecidas nativamente em cinco idiomas: francês, inglês, alemão, espanhol e italiano. Aparecem automaticamente segundo o idioma do canal de venda, sem configuração.

Lembre-se de fornecer as advertências na língua de cada país visado: o GPSR exige que as informações de segurança sejam compreensíveis pelo consumidor do mercado em causa.

## Apresentação no storefront

O bloco GPSR é injetado automaticamente na página de detalhe do produto, logo a seguir à descrição, no bloco Twig `page_product_detail_description_content_text`. Apresenta o fabricante e a pessoa responsável lado a lado, e depois as advertências, as informações de segurança e a lista de documentos. O bloco oculta-se automaticamente quando não há dados disponíveis, nem no produto nem na configuração global.

### Personalizar o template

O componente de apresentação está isolado em `views/storefront/component/df-gpsr/gpsr-info.html.twig` e é injetado através de `views/storefront/page/product-detail/description.html.twig`. Para mover o bloco ou alterar a sua renderização, sobreponha um destes dois ficheiros no seu tema. O estilo de base é inline e deliberadamente neutro, fácil de substituir pelas suas próprias classes.

## FAQ e resolução de problemas

**O GPSR aplica-se à minha loja?** Se vende produtos de consumo não alimentares a clientes situados na UE, muito provavelmente sim. O regulamento aplica-se desde 13 de dezembro de 2024 à maioria dos produtos, incluindo os vendidos online e importados de países terceiros.

**O bloco não aparece.** Verifique que a opção «ativar a apresentação» está marcada na configuração, que o produto ou a configuração global contém pelo menos um dado, e que o interruptor «Ocultar» não está ativo no produto. Limpe a cache depois de qualquer alteração de configuração.

**O bloco aparece mas vazio.** É provavelmente a opção «apresentar mesmo sem dados» deixada ativa: desative-a para voltar ao comportamento normal (ocultamento automático).

**Os meus campos personalizados aparecem como simples campo de texto na administração 6.7.** O mapeamento dos componentes de campos personalizados evoluiu com a administração Meteor. Se um campo de morada aparecer como input simples em vez de uma área de texto, é apenas um pormenor de apresentação da administração sem impacto no storefront; comunique-o ao suporte para um ajuste.

**Os valores predefinidos não se aplicam.** Verifique que preencheu a configuração para o canal de venda certo. Um valor definido em «Todos os canais de venda» é substituído por um valor específico do canal se este existir.

**O que acontece na desinstalação?** Com a opção de eliminação dos dados, o conjunto de campos `df_gpsr` e todos os valores introduzidos nos produtos são eliminados. Sem essa opção, os dados são conservados para uma reinstalação posterior.