# Quantidade mínima e venda por múltiplos: documentação DataFirefly Minimums

> O que faz o módulo O DataFirefly Minimums define um mínimo, um múltiplo obrigatório (vendido por 6, por 12) e um máximo por produto, combinação, categoria, marca ou para todo…

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

## O que faz o módulo

O DataFirefly Minimums define um mínimo, um múltiplo obrigatório (vendido por 6, por 12) e um máximo por produto, combinação, categoria, marca ou para todo o catálogo, opcionalmente para um único grupo de clientes e um período. Define também um valor mínimo de encomenda por grupo de clientes. Cada regra é novamente verificada no servidor, desde a adição ao carrinho até à criação da encomenda: um pedido direto não permite contorná-la.

![Página de produto: vendido por caixa de 6, mínimo 12 para profissionais, quantidades permitidas e número de caixas](https://www.datafirefly.com/wp-content/uploads/2026/11/pagina-produto-vendido-por-caixa-dfminimums-pt.webp)

Página de produto: vendido por caixa de 6, mínimo 12 para profissionais, quantidades permitidas e número de caixas

## Instalação

Instale o ZIP em **Módulos > Gestor de módulos > Carregar um módulo**. O módulo cria as suas tabelas, regista os seus hooks e adiciona dois separadores em **Catálogo**: **Mínimos e múltiplos** e **Encomenda mínima**. A versão 2.0.0 funciona no PrestaShop 1.7.8, 8 e 9 com o mesmo ZIP.

Atualização a partir da 1.0.0: carregue o ZIP 2.0.0 por cima do anterior. As regras e encomendas mínimas são mantidas, as novas colunas e definições são adicionadas automaticamente.

## Visão geral

A página de configuração abre com uma visão geral: número de regras ativas por alvo, encomendas mínimas, lista das verificações feitas no servidor, eventos contados nos últimos 30 dias (quantidades ajustadas, alterações recusadas, páginas de encomenda bloqueadas, encomendas recusadas) e verificações de coerência. O módulo só conta eventos reais: não estima nenhum efeito nas vendas.

![Visão geral: regras ativas, verificações no servidor, eventos medidos e verificações de coerência](https://www.datafirefly.com/wp-content/uploads/2026/11/visao-geral-minimos-multiplos-dfminimums-pt.webp)

Visão geral: regras ativas, verificações no servidor, eventos medidos e verificações de coerência

As verificações de coerência assinalam regras que visam um produto, categoria, marca ou grupo eliminado, regras terminadas, mínimos arredondados, máximos ignorados, regras ambíguas (mesmo alvo, grupo e prioridade), produtos com stock abaixo do mínimo e a quantidade mínima nativa das páginas de produto.

## Definições

![Definições: ajustar ou recusar, seletor por múltiplos, mínimo nativo, webservice e back office](https://www.datafirefly.com/wp-content/uploads/2026/11/definicoes-minimos-multiplos-dfminimums-pt.webp)

Definições: ajustar ou recusar, seletor por múltiplos, mínimo nativo, webservice e back office

- **Ativar as regras de compra**: interruptor geral. Desativado, nada é apresentado nem aplicado; as regras são mantidas.
- **Quantidade não permitida ao adicionar ao carrinho**: _ajustá-la_ à quantidade permitida mais próxima e avisar o cliente (para cima ao adicionar, para baixo ao retirar), ou _recusar_ a alteração indicando as quantidades permitidas.
- **Seletor de quantidade por múltiplos**: os botões + e - da página do produto, da vista rápida, das listas de produtos (Hummingbird) e do carrinho passam de uma quantidade permitida para a seguinte.
- **Condições na página do produto, selo nas listas, condições nas linhas do carrinho, barra de progresso**: cada apresentação pode ser desativada.
- **Cliente em vários grupos**: encomenda mínima do grupo predefinido, a mais alta ou a mais baixa.
- **Valor mínimo de compra nativo**: aplicam-se ambos, ou o mínimo do módulo substitui o nativo para os clientes que têm um.
- **Encomendas pelo webservice e pelo back office**: as encomendas pelo webservice são verificadas por predefinição e recusadas com um erro explícito; as do back office não, para encomendas por telefone e exceções.
- **Medir ajustes e bloqueios**: só é guardado o ID do carrinho, os registos são eliminados após 90 dias.
- **Manter as regras ao desinstalar**.

## Regras de quantidade

Abra **Catálogo > Mínimos e múltiplos**. A lista mostra o alvo, o grupo de clientes, as condições, o período e a prioridade de cada regra. As regras podem ser duplicadas e ativadas ou desativadas em massa.

![Regras de quantidade: alvo, grupo de clientes, condições, período e prioridade visíveis na lista](https://www.datafirefly.com/wp-content/uploads/2026/11/lista-regras-quantidade-prioridades-dfminimums-pt.webp)

Regras de quantidade: alvo, grupo de clientes, condições, período e prioridade visíveis na lista

### Criar uma regra

- **Aplica-se a**: um produto (pesquisa por nome, referência, EAN ou ID e, opcionalmente, uma combinação), uma categoria (com ou sem subcategorias), uma marca ou todos os produtos.
- **Modo de contagem**: cada produto e cada combinação separadamente; cada produto com as combinações somadas (tamanhos e cores combinados); ou todos os produtos visados juntos (sortido livre).
- **Grupo de clientes**: todos os grupos ou um grupo. Os visitantes sem sessão pertencem ao grupo Visitante, as encomendas sem conta ao grupo Convidado.
- **Mínimo, múltiplo, máximo**: o mínimo é arredondado ao múltiplo (5 por 6 dá 6). O máximo tem de ser um múltiplo e pelo menos a menor quantidade permitida: caso contrário, o formulário recusa-o e propõe dois valores.
- **Nome da embalagem**, por idioma: «caixa» dá «Vendido por caixa de 6».
- **Prioridade** e **período** opcional (de / até).

O bloco **O que os clientes vão ver** mostra as mensagens e o selo durante a introdução, com os avisos.

![Formulário de regra: grupo, mínimo, múltiplo, nome da embalagem e pré-visualização para os clientes](https://www.datafirefly.com/wp-content/uploads/2026/11/formulario-regra-pre-visualizacao-dfminimums-pt.webp)

Formulário de regra: grupo, mínimo, múltiplo, nome da embalagem e pré-visualização para os clientes

## Que regra se aplica

Para cada linha de produto do carrinho aplica-se uma única regra. É escolhida por esta ordem:

1. a prioridade mais alta;
2. o alvo mais preciso: combinação, produto, categoria (a mais profunda primeiro), marca, todo o catálogo;
3. uma regra para um grupo do cliente antes de uma regra para todos os grupos;
4. a regra mais recente.

As regras de sortido são verificadas além disso: somam todos os produtos de uma categoria, de uma marca ou de toda a encomenda. A quantidade mínima nativa da página do produto é mantida: quando é mais alta, aumenta o mínimo da regra, arredondado ao múltiplo.

O **Simulador** responde à pergunta para um produto, uma combinação, um grupo de clientes ou um cliente (e-mail) e uma quantidade: lista cada regra candidata, a aplicada, porque as outras não o são, as condições efetivas, o veredito para a quantidade, o stock e a encomenda mínima.

![Simulador «Que regra se aplica?»: regras candidatas, vencedora, motivo e quantidade testada](https://www.datafirefly.com/wp-content/uploads/2026/11/simulador-que-regra-se-aplica-dfminimums-pt.webp)

Simulador «Que regra se aplica?»: regras candidatas, vencedora, motivo e quantidade testada

O separador **Módulos** da página do produto mostra as condições efetivas por grupo de clientes, as regras do produto e as regras herdadas.

![Separador do produto: condições efetivas por grupo de clientes, regras do produto e regras herdadas](https://www.datafirefly.com/wp-content/uploads/2026/11/separador-produto-condicoes-por-grupo-dfminimums-pt.webp)

Separador do produto: condições efetivas por grupo de clientes, regras do produto e regras herdadas

## Encomendas mínimas por grupo

Abra **Catálogo > Encomenda mínima**. Um mínimo por grupo, mais um mínimo predefinido opcional para todos os clientes sem mínimo próprio. Cada mínimo escolhe a sua base: com ou sem impostos, antes ou depois dos vales, com ou sem os portes estimados no carrinho. Os valores são introduzidos na moeda predefinida e convertidos à taxa de câmbio atual.

![Encomendas mínimas por grupo de clientes: com ou sem IVA, descontos, portes e mínimo nativo](https://www.datafirefly.com/wp-content/uploads/2026/11/encomenda-minima-por-grupo-clientes-dfminimums-pt.webp)

Encomendas mínimas por grupo de clientes: com ou sem IVA, descontos, portes e mínimo nativo

## O que o cliente vê

A página do produto mostra as condições de compra, as quantidades permitidas e o número de embalagens. O seletor de quantidade começa numa quantidade permitida e avança por múltiplos.

![Combinações mistas: T-shirts de 10 em 10, todos os tamanhos somados](https://www.datafirefly.com/wp-content/uploads/2026/11/combinacoes-mistas-de-10-em-10-dfminimums-pt.webp)

Combinações mistas: T-shirts de 10 em 10, todos os tamanhos somados

Quando o stock é inferior ao mínimo e as encomendas sem stock são recusadas, o cliente vê o motivo e o botão de adicionar ao carrinho fica desativado.

![Stock abaixo do mínimo: mensagem explícita e botão de adicionar ao carrinho desativado](https://www.datafirefly.com/wp-content/uploads/2026/11/stock-abaixo-do-minimo-dfminimums-pt.webp)

Stock abaixo do mínimo: mensagem explícita e botão de adicionar ao carrinho desativado

As listas de produtos mostram um selo («Vendido por 6», «Mín. 4»). Com o Hummingbird, o seletor de quantidade das miniaturas também segue a regra.

![Listas de produtos: selos «Vendido por 6», «Mín. 4» e seletor de quantidade por múltiplos](https://www.datafirefly.com/wp-content/uploads/2026/11/selos-minimo-lista-produtos-dfminimums-pt.webp)

Listas de produtos: selos «Vendido por 6», «Mín. 4» e seletor de quantidade por múltiplos

No carrinho, cada linha recorda a sua condição. Uma quantidade não permitida é explicada, com botões para passar às quantidades permitidas mais próximas, e o botão de encomenda fica desativado com o motivo.

![Carrinho: quantidade não permitida explicada na linha, botões «Mudar para 12 / 18» e encomenda bloqueada](https://www.datafirefly.com/wp-content/uploads/2026/11/carrinho-quantidade-nao-permitida-dfminimums-pt.webp)

Carrinho: quantidade não permitida explicada na linha, botões «Mudar para 12 / 18» e encomenda bloqueada

Uma barra de progresso indica o valor em falta para atingir a encomenda mínima do cliente, no computador e no telemóvel.

![Barra de progresso até à encomenda mínima do grupo: 66,60 de 150 sem IVA, valor em falta indicado](https://www.datafirefly.com/wp-content/uploads/2026/11/barra-progresso-encomenda-minima-dfminimums-pt.webp)

Barra de progresso até à encomenda mínima do grupo: 66,60 de 150 sem IVA, valor em falta indicado

![No telemóvel: progresso até à encomenda mínima e motivo do bloqueio no carrinho](https://www.datafirefly.com/wp-content/uploads/2026/11/encomenda-minima-telemovel-dfminimums-pt.webp)

No telemóvel: progresso até à encomenda mínima e motivo do bloqueio no carrinho

Quando uma quantidade é ajustada automaticamente, o cliente é avisado uma vez no resumo do carrinho.

![Quantidade ajustada automaticamente de 13 para 18 com uma mensagem, encomenda mínima atingida](https://www.datafirefly.com/wp-content/uploads/2026/11/quantidade-ajustada-automaticamente-dfminimums-pt.webp)

Quantidade ajustada automaticamente de 13 para 18 com uma mensagem, encomenda mínima atingida

## Verificações no servidor

- **Adição ao carrinho e alterações de quantidade**, por AJAX ou URL direto: ajustadas ou recusadas conforme a definição.
- **Página de encomenda**: um carrinho fora das regras é devolvido ao carrinho com os motivos.
- **Acesso direto a um módulo de pagamento** (por exemplo a página de validação da transferência): redirecionamento para o carrinho, nenhuma encomenda é criada.
- **Criação da encomenda**: última verificação antes de a guardar, seja qual for o ponto de entrada. As notificações de um prestador de pagamento sem a sessão do cliente nunca são bloqueadas, porque o cliente pode já ter pago: são registadas.
- **Webservice e back office**: conforme as definições.

O valor mínimo de compra nativo do PrestaShop também é imposto na criação da encomenda, enquanto o PrestaShop só o verifica na página de encomenda.

## Importação e exportação CSV

Abra **Importar / exportar**. O tipo de ficheiro é reconhecido pelo cabeçalho: regras de quantidade (coluna `scope`) ou encomendas mínimas (coluna `amount`). **Apenas verificar** está assinalado por predefinição: o relatório indica cada linha como OK ou com erro e nada é guardado. A substituição das regras existentes só acontece se todas as linhas forem válidas, numa única transação. As exportações neutralizam fórmulas de folhas de cálculo e podem ser reimportadas tal como estão.

![Importação CSV com verificação prévia: relatório linha a linha, nada é guardado antes da validação](https://www.datafirefly.com/wp-content/uploads/2026/11/importacao-csv-regras-verificacao-dfminimums-pt.webp)

Importação CSV com verificação prévia: relatório linha a linha, nada é guardado antes da validação

Colunas das regras de quantidade: `name`, `scope` (product, category, manufacturer, all), `product_id` ou `product_reference`, `combination_reference`, `category_id`, `include_subcategories`, `manufacturer_id`, `apply_mode` (per_product, product_total, cumulative), `group_id`, `min_qty`, `multiple`, `max_qty`, `priority`, `active`, `date_from`, `date_to`, `pack_label_xx`. Colunas das encomendas mínimas: `group_id`, `amount`, `tax_incl`, `after_discounts`, `include_shipping`, `active`. Os ficheiros da versão 1.0.0 são aceites.

## Resolução de problemas

### O mínimo é mais alto do que o da regra

A quantidade mínima nativa da página do produto é mais alta: prevalece, arredondada ao múltiplo. O simulador e as verificações de coerência indicam-no.

### O cliente não consegue atingir o mínimo

O stock é inferior ao mínimo e as encomendas sem stock são recusadas. Reponha o stock, permita encomendas sem stock ou baixe o mínimo.

### O carrinho está bloqueado pela mensagem do mínimo nativo

É o valor mínimo de compra de **Parâmetros da loja > Definições de encomendas**. Coloque-o a 0 ou escolha «substitui» nas definições.

### Os botões +/- avançam de 1 em 1

O tema não usa os seletores padrão. A regra continua a ser aplicada no servidor: a quantidade é ajustada ou recusada e a encomenda bloqueada.

## Compatibilidade

- PrestaShop 1.7.8, 8.x e 9.x, o mesmo ZIP (testado com PHP 7.4, 8.1 e 8.5).
- Temas Classic e Hummingbird.
- Multiloja: regras e mínimos guardados por loja.
- Multimoeda: valores convertidos à taxa de câmbio atual.
- Interface em inglês, francês, espanhol, alemão, italiano, neerlandês, polaco e português.
