Quantidade mínima e venda por múltiplos: documentação DataFirefly Minimums
Instalação, regras de quantidade (mínimo, múltiplo, máximo), prioridades e simulador, encomendas mínimas por grupo, verificações no servidor, importação CSV e resolução de problemas.
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.

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.

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

- 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.

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.

Que regra se aplica
Para cada linha de produto do carrinho aplica-se uma única regra. É escolhida por esta ordem:
- a prioridade mais alta;
- o alvo mais preciso: combinação, produto, categoria (a mais profunda primeiro), marca, todo o catálogo;
- uma regra para um grupo do cliente antes de uma regra para todos os grupos;
- 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.

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.

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.

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.

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.

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.

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.

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


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

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.

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.