Compra em Grupo e Preço Degressivo Coletivo: guia completo

Apresentação e pré-requisitos

A Compra em Grupo institui um preço degressivo coletivo: quantos mais compradores houver num produto, mais o preço unitário desce para toda a gente. Define escalões (um limiar de compradores desbloqueia um preço) e o módulo aplica automaticamente o preço do escalão atingido através dos preços específicos nativos do PrestaShop. O preço em vigor é assim apresentado em todo o lado sem qualquer alteração do seu tema: ficha de produto, listagens, carrinho e e-mails.

• Compatível com o 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).
• Não exige qualquer tarefa CRON: o recálculo é comandado pelos eventos de encomenda.
• Arquitetura conforme ao PrestaShop (ModuleAdminController, ObjectModel), sem dependências Composer.

Instalação

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

1. Descarregue o ficheiro dfgroupbuy-1.0.2.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 ficheiro.
4. Depois de instalado, clique em Configurar.

Na instalação, o módulo cria as suas tabelas (campanhas, escalões, participantes), regista os seus hooks e acrescenta o separador Compra em Grupo em Catálogo. Pode criar de imediato a sua primeira campanha.

Definições gerais do módulo

A página de configuração reúne as definições globais, comuns a todas as campanhas:

• Cor principal e cor de destaque: aplicadas ao widget da ficha de produto (barra de progresso, etiquetas, preço em vigor).
• Enviar um e-mail em caso de reembolso retroativo: notifica o comprador quando lhe é atribuído um vale.
• Validade dos vales: número de dias de validade dos vales retroativos (30 por predefinição).
• Intervalo de atualização: frequência de atualização em direto do widget, em segundos (30 por predefinição).

Criar uma campanha de compra em grupo

No separador Catálogo > Compra em Grupo, clique em Adicionar uma campanha. Uma campanha associa um produto a uma grelha de escalões, dentro de uma janela de datas.

• Referência: identificador interno da campanha (livre).
• Produto: pesquise e selecione o produto em causa. Pode visar uma combinação específica ou deixar «todas as combinações».
• Nome e descrição: textos traduzíveis, apresentados no widget.
• Modo de contagem: ver a secção dedicada mais abaixo.
• Apenas encomendas válidas: conta apenas as encomendas confirmadas (recomendado).
• Preço de referência: o preço de partida (riscado) antes de qualquer escalão.
• Data de início / fim: janela de atividade da campanha.
• Reembolso retroativo: ver a secção dedicada.
• Ativa: ativa ou suspende a campanha.

Definir os escalões

Cada escalão associa um limiar (número de compradores, de unidades ou de clientes, consoante o modo) a um preço unitário sem IVA. Acrescente tantos escalões quantos forem necessários, por exemplo:

10 compradores  → 18,00 € sem IVA
50 compradores  → 15,00 € sem IVA
100 compradores → 12,00 € sem IVA

Em cada gravação, o módulo recalcula o escalão em vigor e atualiza o preço específico. Os preços devem ser decrescentes à medida que o limiar aumenta.

Os modos de contagem

O modo de contagem determina o que faz avançar o contador coletivo:

• Encomendas: número de encomendas distintas que contêm o produto.
• Unidades vendidas: quantidade total de unidades do produto vendidas.
• Clientes distintos: número de clientes diferentes que compraram o produto.

A opção Apenas encomendas válidas restringe a contagem às encomendas consideradas válidas pelo PrestaShop (pagamento aceite, etc.), o que evita contar encomendas canceladas ou pendentes.

O preço coletivo em tempo real

Assim que uma encomenda é validada ou muda de estado, o módulo volta a contar a campanha, determina o escalão atingido e atualiza o preço específico aplicado a todos os compradores. O novo preço é apresentado imediatamente em todo o lado, sem qualquer intervenção. Não é necessário qualquer CRON: tudo é comandado pelos eventos de encomenda.

Preço por escalão de quantidade (compra a granel)

No modo Unidades vendidas, um cliente que encomende uma grande quantidade de uma só vez ultrapassa sozinho um escalão: obtém então de imediato o preço desse escalão na sua própria encomenda, sem esperar que o coletivo o atinja. Por exemplo, com um escalão a 10 unidades, um cliente que coloque 10 exemplares no carrinho paga desde logo o preço do escalão 10.

Esta lógica mantém o princípio «melhor preço para todos»: se o preço coletivo em vigor já for mais baixo do que o preço do escalão de quantidade, é o preço coletivo que se aplica. Tudo passa pelos preços específicos nativos (por escalões de quantidade), pelo que o preço correto é apresentado logo no carrinho.

Reembolso retroativo

Quando a opção está ativada, aplica-se o princípio «toda a gente ao melhor preço»: assim que um escalão inferior é desbloqueado, os compradores anteriores recebem automaticamente um vale de desconto igual à diferença entre o preço que pagaram e o novo preço, multiplicada pela quantidade comprada. É enviado um e-mail de notificação se a opção de envio estiver ativa.

• O vale é um código de desconto (CartRule) nominativo, válido pelo número de dias configurado.
• Só recebem vale os compradores que pagaram mais do que o novo preço.
• O preço efetivo de cada participante é atualizado para evitar qualquer duplo reembolso nas descidas seguintes.

O widget na ficha de produto

Na ficha de produto, o módulo apresenta um widget que dá visibilidade à dinâmica coletiva:

• Uma etiqueta e o preço de referência riscado ao lado do preço em vigor.
• O contador coletivo e uma barra de progresso até ao próximo escalão.
• A escala completa dos escalões, com destaque para o escalão em vigor.
• Uma contagem decrescente até ao fim da campanha.
• Uma nota sobre o reembolso retroativo quando a opção está ativa.

O conjunto é atualizado em direto por AJAX, ao intervalo definido nas definições, sem recarregar a página.

FAQ e resolução de problemas

O widget não aparece no produto

Verifique se existe mesmo uma campanha ativa a visar esse produto, se a data de hoje está entre a data de início e a data de fim e se a campanha pertence à loja atual. Se visar uma combinação específica, o widget só aparece nessa combinação.

O preço não desce apesar de o limiar estar atingido

O recálculo é despoletado pela validação das encomendas e pelas mudanças de estado. Se estiver a contar as encomendas válidas, certifique-se de que as encomendas em causa estão mesmo num estado válido. Uma simples alteração seguida de gravação da campanha também força um recálculo.

Um grande comprador não obtém o preço da sua quantidade

O preço por escalão de quantidade só funciona no modo Unidades vendidas e para limiares iguais ou superiores a 2. Nos modos Encomendas ou Clientes, a quantidade de uma encomenda não ultrapassa sozinha nenhum escalão.

Funciona com as combinações?

Sim. Uma campanha pode visar uma combinação específica ou todas as combinações de um produto. Uma campanha que vise uma combinação específica prevalece sobre uma campanha «todas as combinações».

O que acontece na desinstalação?

A desinstalação retira os preços específicos criados pelo módulo, elimina os seus hooks e o seu separador e limpa as suas tabelas. Os vales de desconto já emitidos continuam válidos do lado dos clientes.