# DF Quantity Tiers: documentação

> Apresentação e pré-requisitos O DF Quantity Tiers transforma os descontos por quantidade nativos do PrestaShop num bloco de venda claro e clicável. O módulo não introduz nenhuma lógica de preços…

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

## Apresentação e pré-requisitos

O DF Quantity Tiers transforma os descontos por quantidade nativos do PrestaShop num bloco de venda claro e clicável. O módulo não introduz nenhuma lógica de preços nova: lê os preços específicos « a partir de N unidades » já configurados no seu catálogo e apresenta-os sob a forma de cartões ou de tabela, com um botão de adição ao carrinho para cada escalão.

- Compatível com PrestaShop 8.0 a 9.x, tema Classic e temas derivados.
- PHP 7.4 a 8.3.
- Multiloja e multilingue (FR/EN/ES/DE/IT).
- Nenhum override de ficheiros: apenas hooks nativos.

Os escalões provêm de **Catálogo > Produto > Preço > Preços específicos**, campo « A partir da quantidade ». Se um produto não tiver preços específicos por quantidade, o bloco não é apresentado para esse produto.

O pacote de traduções cobre FR, EN, ES, DE e IT. Numa loja em português, traduza o título do bloco (campo multilingue na configuração) e as cadeias do front-office (« Melhor oferta », mensagens de incentivo, menções « s/ IVA » e « c/ IVA ») em **Internacional > Traduções > Módulos instalados**, caso contrário aparecem em inglês.

## Instalação

Instale o módulo como qualquer módulo PrestaShop:

1. Descarregue o arquivo `dfquantitytiers-1.1.0.zip` a partir da sua conta de cliente.
2. No back-office, vá a **Módulos > Gestor de módulos**.
3. Clique em **Instalar um módulo** e carregue o arquivo.
4. Depois de instalado, clique em **Configurar**.

Na instalação, o módulo regista os seus hooks, cria a sua tabela de estatísticas e pré-preenche um título de bloco traduzido nos cinco idiomas. Os seus preços degressivos existentes aparecem imediatamente nas fichas de produto em causa.

## Atualização a partir da 1.0.0

A atualização para a 1.1.0 faz-se normalmente a partir do Gestor de módulos. O script de upgrade integrado cria a tabela de estatísticas, regista o novo hook da página do carrinho e aplica os valores por defeito das novas opções (modo fiscal, JSON-LD, incentivo no carrinho, estatísticas, etiquetas de embalagem). Não é necessária nenhuma ação manual e a sua configuração existente é conservada.

## Configuração geral

A página de configuração reúne o conjunto das definições de apresentação:

- **Título do bloco**: texto apresentado acima dos escalões, traduzível por idioma.
- **Disposição**: « Cartões » (recomendado, um cartão por escalão) ou « Tabela compacta » (uma linha por escalão).
- **Posição na ficha de produto**: sob o bloco de compra (hook `displayProductAdditionalInfo`, por defeito) ou diretamente sob o preço (hook `displayProductPriceBlock`).
- **Cor de destaque**: aplicada ao escalão « Melhor oferta », aos badges e aos botões.
- **Apresentação da poupança**: em percentagem, em montante, ou ambos.
- **Mostrar o preço total do escalão**: acrescenta o total para a quantidade do escalão.
- **Mostrar o escalão « à unidade »**: mostra o preço base como primeiro escalão de comparação.

O escalão que oferece o maior desconto unitário recebe automaticamente o badge « Melhor oferta ». Quando o cliente altera a quantidade, o cartão correspondente à sua escolha é realçado em tempo real.

## Modo fiscal (B2B)

O modo fiscal determina se os preços dos escalões são apresentados sem IVA ou com IVA incluído:

- **Automático**: segue a definição de apresentação do grupo de clientes atual (comportamento padrão do PrestaShop).
- **Forçar s/ IVA**: mostra sistematicamente os preços sem IVA, com a menção « s/ IVA » ao lado de cada preço unitário. Ideal para uma loja profissional.
- **Forçar c/ IVA**: mostra sistematicamente os preços com IVA incluído, com a menção « c/ IVA ».

O modo escolhido aplica-se tanto aos cartões da ficha de produto como ao bloco de incentivo do carrinho.

## Etiquetas de embalagem

Pode associar uma etiqueta comercial a cada quantidade, por exemplo « caixa » ou « palete ». No campo **Etiquetas de embalagem**, introduza uma associação por linha no formato `quantidade=etiqueta`:

```
12=Caixa de 12
48=Meia palete
96=Palete
```

A etiqueta aparece sob a quantidade do escalão correspondente. Este campo é traduzível: preencha-o em cada idioma a partir do seletor de idioma do formulário.

## Incentivo para o escalão seguinte

Estão disponíveis dois mecanismos de incentivo, ativáveis de forma independente.

### Na ficha de produto

Uma barra de progresso mostra uma mensagem do tipo « Adicione mais 3 unidade(s) para poupar 15 % », recalculada em tempo real consoante a quantidade introduzida. Quando o cliente atinge o escalão mais vantajoso, a mensagem passa a « Está a beneficiar do melhor desconto! ».

### Na página do carrinho

Para cada produto do carrinho cujo escalão superior continua alcançável, o módulo mostra sob o carrinho um bloco « Adicione mais N unidades para passar a X € / unidade », acompanhado de um botão de adição num clique. O botão usa o mecanismo nativo de atualização do carrinho do PrestaShop e depois recarrega a página. Se nenhum escalão superior for alcançável, não é mostrado nenhum bloco.

## Dados estruturados (JSON-LD)

Quando a opção está ativada, o módulo acrescenta à ficha de produto uma marcação JSON-LD do tipo `AggregateOffer`, com uma oferta por escalão e a quantidade elegível associada. Isto permite aos motores de pesquisa compreender os seus intervalos de preço por quantidade.

Se o seu tema ou outro módulo SEO já gerar uma marcação `Offer` completa para os seus produtos, desative esta opção para evitar uma marcação duplicada assinalada na Search Console.

## Estatísticas de cliques por escalão

Quando a opção está ativada, cada clique num botão de adição por escalão é registado de forma anónima: produto, declinação, quantidade e desconto do escalão clicado. Não é usado nenhum dado pessoal nem cookie, o que torna a função conforme ao RGPD.

A página de configuração mostra um painel dos últimos 30 dias: número total de cliques e top das combinações produto / escalão / desconto mais clicadas. Estes dados ajudam-no a calibrar os seus descontos identificando os escalões que desencadeiam realmente adições ao carrinho.

## FAQ e resolução de problemas

### O bloco não aparece num produto

Verifique que o produto tem preços específicos com uma quantidade inicial superior a 1, e que esses preços se aplicam ao grupo de clientes, à moeda e ao país atuais. O escalão base sozinho não desencadeia a apresentação se não existir nenhum escalão de desconto.

### O botão de adição não funciona com o meu tema

O módulo apoia-se no botão de adição ao carrinho padrão do tema Classic. Num tema fortemente personalizado, certifique-se de que o campo de quantidade e o botão de adição seguem a marcação padrão do PrestaShop.

### Funciona com as declinações?

Sim. Os escalões são recalculados para cada combinação e o bloco atualiza-se automaticamente na mudança de declinação, sem recarregar a página.

### O que acontece na desinstalação?

A desinstalação remove de forma limpa os hooks, as variáveis de configuração e a tabela de estatísticas. Não fica nenhum dado residual na base de dados.