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

Instalação

Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo com o ficheiro ZIP, ou copie a pasta dfminimums para o diretório /modules/ da loja e clique em Instalar.

Na instalação, o módulo cria duas tabelas (regras de quantidade e mínimos de encomenda), regista os seus hooks e acrescenta dois separadores no menu Catálogo: Mínimos e múltiplos e Encomenda mínima.

Configurações do módulo

A página de configuração do módulo reúne seis configurações.

Ativar as regras de compra

Interruptor geral. Se desativado, nenhuma regra é mostrada nem aplicada na loja. As regras continuam guardadas.

Ajustar as quantidades automaticamente

Quando um cliente adiciona ao carrinho uma quantidade que não respeita uma regra, o módulo substitui-a pela quantidade permitida mais próxima: para cima ao adicionar, para baixo ao remover. Adicionar 7 unidades de um produto vendido por 6 dá 12, passar de 12 para 11 dá 6. As linhas personalizadas nunca são alteradas. Se desativado, a quantidade fica como está e o carrinho fica bloqueado até o cliente corrigir.

Mostrar as condições na página do produto

Mostra uma caixa sob o botão de adicionar ao carrinho com o mínimo, o múltiplo e o máximo aplicáveis ao cliente com sessão iniciada. A caixa aparece também na visualização rápida.

Mostrar uma etiqueta nas listas de produtos

Acrescenta uma etiqueta curta sob o preço das miniaturas de produto, por exemplo «Venda por 6» ou «Mín. 12».

Mostrar as condições sob cada linha do carrinho

Relembra a condição de cada linha e mostra o erro a vermelho quando a quantidade não é permitida.

Cliente em vários grupos

Define que mínimo de encomenda se aplica quando um cliente pertence a vários grupos que têm cada um um mínimo: o do seu grupo predefinido, o mais alto ou o mais baixo.

Criar uma regra de quantidade

Abra Catálogo > Mínimos e múltiplos e clique em Adicionar uma regra.

Aplica-se a

• Um produto: pesquise o produto por nome, referência, EAN ou ID e, se quiser, escolha uma combinação. Uma regra sobre uma combinação tem prioridade sobre uma regra sobre todo o produto.
• Uma categoria: escolha a categoria e indique se as subcategorias estão incluídas. Estão incluídos todos os produtos associados à categoria, seja qual for a sua categoria predefinida.
• Todos os produtos: a regra abrange todo o catálogo.

Grupo de clientes

Mantenha «Todos os grupos de clientes» ou escolha um grupo. Uma regra de grupo aplica-se a todos os clientes que pertencem a esse grupo, mesmo que não seja o seu grupo predefinido.

Mínimo, múltiplo e máximo

• Quantidade mínima: 0 ou 1 significa sem mínimo. Se houver um múltiplo e o mínimo não o for, é arredondado ao múltiplo superior: mínimo 10 por 6 dá 12.
• Venda em múltiplos de: 1 deixa a quantidade livre, 6 só aceita 6, 12, 18, etc.
• Quantidade máxima: 0 significa sem máximo. O máximo deve ser múltiplo do múltiplo escolhido e maior ou igual ao mínimo.

Uma regra deve definir pelo menos um mínimo superior a 1, um múltiplo superior a 1 ou um máximo.

Que regra se aplica

Para cada produto do carrinho aplica-se uma única regra «por produto». O módulo escolhe-a por esta ordem:

1. a prioridade mais alta;
2. com prioridade igual, a regra mais específica: combinação, depois produto, depois categoria (a mais profunda primeiro), depois todos os produtos;
3. com especificidade igual, uma regra de grupo de clientes antes de uma regra para todos os grupos.

Exemplo: uma regra «Vinhos, venda por 6» para todos os clientes e uma regra «Vinhos, venda por 12» para o grupo Profissionais. Um profissional encomenda por 12, um particular por 6.

O painel do módulo no separador Módulos da ficha de produto lista as regras que se aplicam diretamente ao produto e as de categoria ou catálogo que também se podem aplicar.

Sortido livre por categoria

Numa regra de categoria, o campo Forma de contagem oferece dois valores.

• Cada produto separadamente: a regra aplica-se a cada produto da categoria, como uma regra de produto.
• Todos os produtos da categoria em conjunto (sortido livre): o mínimo, o múltiplo e o máximo aplicam-se à soma das quantidades de todos os produtos da categoria presentes no carrinho.

Exemplo: mínimo 12 e múltiplo 6 em sortido livre na categoria Vinhos. O cliente pode levar 4 tintos, 4 brancos e 4 rosés. Com 13 garrafas no total, o carrinho fica bloqueado.

As regras de sortido livre são verificadas além da regra própria de cada produto. Um vinho vendido à unidade continua disponível à unidade, desde que o total da categoria cumpra a regra de sortido livre.

Mínimos de encomenda por grupo

Abra Catálogo > Encomenda mínima e clique em Adicionar um mínimo de encomenda.

• Grupo de clientes: um mínimo por grupo. A entrada «Todos os clientes (predefinido)» aplica-se aos clientes cujos grupos não têm um mínimo próprio.
• Montante mínimo: indicado na moeda predefinida da loja, convertido automaticamente para carrinhos noutra moeda. Os portes nunca estão incluídos.
• Montante com IVA: Não compara o montante com o total dos produtos sem IVA, o habitual em B2B.
• Descontar os vales: Sim usa o total depois das regras do carrinho e dos vales.

O que o cliente vê

Quando o carrinho não cumpre uma regra, o módulo preenche a chave minimalPurchaseRequired do carrinho, a mesma que o PrestaShop usa para o seu próprio montante mínimo. O botão de encomenda fica desativado e o alerta nativo do carrinho mostra «O seu carrinho ainda não cumpre as condições de compra.» seguido do detalhe de cada problema: quantidade não permitida com as quantidades possíveis, total de uma categoria em sortido livre, montante em falta para atingir o mínimo de encomenda.

A verificação repete-se ao abrir a página de encomenda: um cliente que tente aceder diretamente volta ao carrinho.

Na loja, os campos de quantidade seguem a regra. No tema Classic, os botões TouchSpin avançam de múltiplo em múltiplo. No Hummingbird, os botões +/- saltam diretamente para a quantidade permitida seguinte ou anterior.

Importação e exportação CSV

A importação encontra-se no topo da lista de regras. O ficheiro aceita o separador ; ou , e precisa de uma linha de cabeçalho com pelo menos a coluna scope. Colunas reconhecidas:

• name: nome interno, gerado se estiver vazio;
• scope: product, category ou all;
• product_id ou product_reference;
• combination_reference: referência da combinação;
• category_id e include_subcategories (0 ou 1);
• apply_mode: per_product ou cumulative (sortido livre);
• group_id: 0 para todos os grupos;
• min_qty, multiple, max_qty, priority, active.

A caixa «Eliminar primeiro todas as regras existentes desta loja» substitui todo o conjunto de regras. As linhas com erro são listadas com o seu número e não bloqueiam as outras. O botão Exportar CSV gera o mesmo formato, útil para copiar regras de uma loja para outra. É possível descarregar um ficheiro de exemplo a partir do bloco de importação.

Boas práticas

• Comece por uma regra ampla (categoria ou catálogo) e acrescente depois as exceções por produto: a regra mais específica ganha sem mexer na prioridade.
• Use a prioridade apenas quando uma regra menos específica deve ganhar, por exemplo uma regra de categoria que se deve impor a todos os seus produtos.
• Teste com uma conta de cliente de cada grupo envolvido: as regras de grupo não são visíveis para um visitante sem sessão iniciada.
• Depois de uma alteração, limpe a cache se a loja usar um módulo de cache de página completa.

Resolução de problemas

O cliente não consegue descer abaixo de uma quantidade, embora nenhuma regra o exija

Verifique a quantidade mínima nativa da ficha de produto (separador Stock ou Quantidades, conforme a versão) e volte a pô-la em 1.

O carrinho fica bloqueado com a mensagem nativa de montante mínimo

É o mínimo nativo de Parâmetros da loja > Configurações de encomendas. Defina-o como 0 se só os mínimos por grupo devem contar.

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

O tema não usa os seletores padrão do Classic ou do Hummingbird. A regra continua a ser aplicada no servidor: o carrinho é corrigido ou bloqueado. Contacte-nos com o nome do tema para uma adaptação.

Um módulo de checkout numa só página deixa passar a encomenda

O módulo de terceiros ignora minimalPurchaseRequired. Teste-o numa loja de testes e contacte-nos indicando o seu nome.

Compatibilidade

• PrestaShop 8.0 a 9.x, o mesmo ZIP cobre os dois ramos.
• Temas Classic e Hummingbird.
• Multiloja: regras e mínimos são guardados por loja.
• Arquitetura ModuleAdminController, sem dependências Composer, PHP 7.2 ou superior.
• Interface disponível em inglês, francês, espanhol, alemão, italiano, neerlandês, polaco e português.