PS PrestaShop Iniciante

Gerar Códigos de Desconto em Massa no PrestaShop 8 e 9: documentação

Instalar o módulo, criar um lote com o assistente, proteger os códigos, enviá-los por email, imprimi-los com código QR, exportá-los e acompanhar os resultados de cada campanha.

Atualizado Versão do módulo 2.0.0

Apresentação

O módulo cria lotes de códigos de desconto únicos que partilham as mesmas regras. Cada código é uma regra de carrinho nativa do PrestaShop: funciona no carrinho, aparece na fatura e continua válido se o módulo for desinstalado. Os códigos distribuem-se por email, por impressão em PDF com código QR, por link direto ou por exportação CSV, e cada lote tem as suas próprias estatísticas.

O painel resume todos os lotes: códigos gerados e utilizados, encomendas validadas, volume de negócios sem IVA e desconto concedido. A lista pode ser filtrada por nome, estado ou canal, e uma barra mostra a taxa de utilização de cada lote.

Painel dos lotes de códigos promocionais: indicadores, filtros e taxa de utilização
Painel dos lotes de códigos promocionais: indicadores, filtros e taxa de utilização

Instalação e atualização

  1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e selecione dfbulkcoupons-2.0.0.zip.
  2. A instalação cria o separador Catálogo > Descontos > Códigos promocionais em massa. O botão Configurar do módulo também leva até lá.

Compatibilidade: PrestaShop 1.7.8, 8 e 9, PHP 7.1 a 8.5, temas Classic e Hummingbird.

Atualização a partir da 1.0 ou da 1.1: carregue o novo ZIP por cima do antigo. Os lotes, os códigos, as estatísticas e as definições de envio são mantidos. A atualização acrescenta um índice de unicidade nos códigos e a proteção do link direto.

Criar um lote

Clique em Novo lote. Um assistente em seis passos orienta-o: Campanha, Códigos, Desconto, Condições, Restrições e Revisão. Nada é criado antes do último passo. Pode voltar a qualquer passo através da barra de progresso, e um resumo à direita mostra em tempo real um exemplo de código, o desconto, a validade e o nível de segurança.

1. Campanha

O nome do lote é utilizado nas estatísticas e nas exportações. O canal indica onde os códigos serão distribuídos (email, newsletter, SMS, redes sociais, influenciadores, afiliados, impressos, loja física, apoio ao cliente ou um nome livre). Serve para comparar as campanhas. Uma nota interna é opcional.

2. Códigos

  • Códigos anónimos: de 1 a 200.000 códigos, para distribuir livremente. Botões de escolha rápida propõem 100, 500, 1.000, 5.000 e 10.000.
  • Grupos de clientes: um código pessoal por cliente ativo dos grupos assinalados (contas de convidado excluídas), com a opção «Apenas subscritores da newsletter». É apresentado o número de clientes de cada grupo.
  • Lista de emails: um código pessoal por conta de cliente encontrada na lista colada. Os endereços sem conta são ignorados e o seu número é indicado.

Um código pessoal só funciona para a conta de cliente à qual está atribuído.

O formato é composto por um prefixo, uma parte aleatória e um sufixo. Na parte aleatória, X é uma letra ou um algarismo, A uma letra e # um algarismo; os outros caracteres, como os hífenes, são mantidos. Os formatos prontos a usar escolhem-se com um clique. O conjunto «Fáceis de ler» exclui 0, O, 1, I e L. A pré-visualização mostra três exemplos, o número de combinações possíveis e um indicador de segurança.

Assistente de criação: formato dos códigos, pré-visualização e indicador de segurança
Assistente de criação: formato dos códigos, pré-visualização e indicador de segurança

3. Desconto

Tipos: percentagem, montante fixo (sem IVA ou com IVA, numa moeda, com opção de utilização parcial), envio gratuito ou oferta (combinação predefinida do produto). Uma percentagem ou um montante aplica-se a toda a encomenda sem o envio ou a um produto específico; uma percentagem também pode visar o produto mais barato ou os produtos da restrição. O nome apresentado ao cliente aparece no carrinho e na fatura, em cada idioma.

Assistente de criação: tipo de desconto e nome mostrado aos clientes
Assistente de criação: tipo de desconto e nome mostrado aos clientes

4. Condições

Datas de início e de fim (fuso horário da loja), utilizações por código e por cliente (1 e 1 para códigos de utilização única), montante mínimo com moeda, impostos e envio, e prioridade. A opção Códigos exclusivos, ativada por predefinição, impede a utilização de dois códigos do lote na mesma encomenda, bem como com outro desconto que também seja exclusivo. Para os códigos pessoais, o código pode ser mostrado no carrinho do seu titular. Os códigos podem ser criados desativados para serem ativados mais tarde.

5. Restrições

Restrição por produtos (pesquisa por nome, referência ou ID), categorias ou marcas (listas filtráveis), com uma quantidade mínima de produtos correspondentes. Grupos de clientes, países de entrega e, em multiloja, lojas autorizados. Um campo deixado vazio não impõe qualquer restrição.

6. Revisão

O último passo resume o lote (códigos, exemplo, desconto, validade, utilização e restrições) com um link de edição para cada passo. O botão Criar e gerar os códigos inicia a geração.

Revisão do lote antes da geração dos códigos
Revisão do lote antes da geração dos códigos

Segurança dos códigos

  • Os códigos são gerados por um gerador criptograficamente seguro, comparados com todos os códigos de desconto existentes e protegidos por um índice único na base de dados.
  • Um formato deve ter pelo menos 6 caracteres aleatórios e oferecer pelo menos 10.000 combinações por código pedido. O indicador mostra a probabilidade de um visitante encontrar um código válido escrevendo ao acaso: demasiado fácil (recusado), aceitável, forte ou muito forte.
  • O link direto aceita no máximo 10 códigos desconhecidos por ligação em 15 minutos, para impedir que seja utilizado para adivinhar códigos.
  • As exportações CSV neutralizam as fórmulas de folha de cálculo em cada célula.

Geração dos códigos

Os códigos são criados em blocos de 500, com uma barra de progresso, a velocidade e o tempo restante. Um botão permite pausar e retomar. Pode sair da página: a geração retoma onde parou na próxima vez que abrir o lote. Cada bloco é guardado na totalidade ou não é guardado. No final, são apresentados os primeiros códigos com atalhos para a exportação CSV, o envio por email, a impressão e as estatísticas. Cada código é uma regra de carrinho cuja descrição começa por [DFBC#id], visível em Catálogo > Descontos.

Geração dos códigos concluída com os primeiros códigos do lote
Geração dos códigos concluída com os primeiros códigos do lote

Página do lote

Cada lote tem um cabeçalho comum (estado, desconto, formato, validade) e separadores: Visão geral, Códigos, Email (códigos pessoais) e Impressão.

Visão geral

Códigos gerados, códigos utilizados e taxa de utilização, encomendas validadas, encomendas de novos clientes, volume de negócios sem IVA e encomenda média, desconto concedido e rácio volume de negócios/desconto. Um resumo mostra os códigos gerados, ainda utilizáveis e utilizados pelo menos uma vez. O painel Distribuição reúne o email, a impressão, a exportação e o link direto. Seguem-se o gráfico das encomendas por dia, os códigos mais utilizados, as exportações e as últimas encomendas. Apenas as encomendas validadas contam para o volume de negócios e o desconto, convertidos na moeda predefinida.

Vista geral do lote: faturação, desconto concedido, códigos usados e encomendas por dia
Vista geral do lote: faturação, desconto concedido, códigos usados e encomendas por dia
Códigos mais usados, exportações CSV e últimas encomendas do lote
Códigos mais usados, exportações CSV e últimas encomendas do lote

Gerir o lote

  • Dados: nome, canal e nota interna. O novo nome é transposto para a descrição das regras de carrinho.
  • Fim da validade: aplica-se a todos os códigos do lote.
  • Adicionar códigos a um lote de códigos anónimos, com o mesmo formato e as mesmas regras.
  • Duplicar o lote, desativar ou ativar todos os códigos.
  • Zona de perigo: eliminar os códigos nunca utilizados, ou eliminar o lote. É pedida uma confirmação; as encomendas anteriores mantêm o seu desconto.

Lista de códigos

O separador Códigos mostra os códigos em páginas de 50, filtrados por estado (disponível, utilizado, esgotado, expirado, desativado) com o número de códigos de cada estado. A pesquisa incide sobre o início do código ou o email do cliente. Para cada código: cópia do código ou do seu link direto, utilizações, utilizações restantes, data de envio, última encomenda, ativação ou desativação, e link para a regra de carrinho nativa.

Códigos de um lote com estados, pesquisa e ligação direta
Códigos de um lote com estados, pesquisa e ligação direta

Enviar os códigos por email

Disponível para os lotes de códigos pessoais, no separador Email.

  1. Para cada idioma, altere o assunto e a mensagem. As variáveis {firstname}, {lastname}, {code}, {discount}, {valid_until}, {shop_name} e {link} inserem-se com um clique. A pré-visualização é atualizada durante a escrita.
  2. Clique em Enviar-me um email de teste: é enviado para o seu endereço de funcionário, no seu idioma.
  3. Escolha os destinatários: códigos ainda não enviados (e códigos com falha), ou todos os códigos para um lembrete. A opção «Apenas os clientes que aceitaram a newsletter» está assinalada por predefinição.
  4. Defina o número de emails por minuto para ficar abaixo do limite do seu servidor e, em seguida, clique em Guardar e enviar.

O envio é feito em pacotes de 10, com uma barra de progresso e um botão de pausa. Cada cliente recebe a versão no idioma da sua conta. Os códigos já utilizados, desativados ou expirados e as contas eliminadas ou desativadas são ignorados. Os emails recusados pelo servidor são listados e enviados novamente no próximo envio.

Envio dos códigos pessoais por email: mensagem por idioma, pré-visualização e envio cadenciado
Envio dos códigos pessoais por email: mensagem por idioma, pré-visualização e envio cadenciado

O cliente recebe o seu código destacado numa moldura, o desconto, a data de fim e um botão que aplica o código ao seu carrinho. É incluída uma versão em texto para os programas de email que não apresentam HTML.

Email recebido pelo cliente com o código pessoal e o botão que o aplica ao carrinho
Email recebido pelo cliente com o código pessoal e o botão que o aplica ao carrinho

Os emails são enviados segundo a configuração de Parâmetros avançados > Email. Se o envio estiver aí desativado, um aviso indica-o no topo da página.

Imprimir os códigos

O separador Impressão gera um PDF A4:

  • Cartões: 10 por página (95 x 55 mm), com marcas de corte.
  • Etiquetas: 21 por folha (63,5 x 38,1 mm, folhas 3 x 7 comuns).
  • Folhetos: 4 por página em formato A6, com marcas de corte.

Escolha os códigos (não utilizados nunca impressos, todos os não utilizados ou todos), o seu número (2.000 por ficheiro no máximo) e o número de códigos a ignorar no início. Defina o título, as condições (variáveis {valid_until}, {shop_name}, {customer}), a cor de destaque, o código QR, o nome da loja e, para os códigos pessoais, o nome do cliente. Uma pré-visualização de um cartão é atualizada em tempo real. A opção «Marcar estes códigos como impressos» evita voltar a imprimir os mesmos códigos.

Impressão dos códigos em PDF: cartões, etiquetas ou folhetos com código QR
Impressão dos códigos em PDF: cartões, etiquetas ou folhetos com código QR
Folha PDF de cartões de códigos com código QR, pronta a imprimir
Folha PDF de cartões de códigos com código QR, pronta a imprimir

Cada código tem um endereço do tipo https://a-sua-loja.pt/module/dfbulkcoupons/apply?code=CODE. Este abre a loja e aplica o código ao carrinho, com uma mensagem de confirmação no idioma do visitante (temas Classic e Hummingbird). Se o carrinho estiver vazio, o código é guardado durante 30 dias e aplicado assim que for adicionado um produto. Se o carrinho ainda não cumprir as condições, o motivo é apresentado e o código é aplicado automaticamente assim que as cumprir. Para um código pessoal, o visitante é convidado a iniciar sessão e, em seguida, o código é aplicado. Este link está por trás dos códigos QR impressos, no botão dos emails, na lista de códigos e na exportação CSV.

Ligação direta: o código é aplicado automaticamente ao carrinho (tema Hummingbird)
Ligação direta: o código é aplicado automaticamente ao carrinho (tema Hummingbird)

Exportações CSV

Os ficheiros estão em UTF-8 com ponto e vírgula como separador, e podem ser abertos diretamente no Excel.

  • Códigos (todos, não utilizados ou utilizados): código, estado, utilizações, utilizações restantes, datas de validade, email, nome próprio e apelido do cliente, última utilização, última encomenda, data de envio, data de impressão, link direto.
  • Utilização por encomenda: data, ID, referência e estado da encomenda, encomenda validada ou não, código, cliente, desconto e total sem IVA e com IVA, moeda.

Desempenho por canal e pesquisa de um código

Assim que são utilizados vários canais, o painel apresenta uma tabela por canal: lotes, códigos, códigos utilizados, taxa, encomendas, volume de negócios sem IVA e desconto sem IVA, ordenada por volume de negócios. O bloco Procurar um código encontra o lote, o titular, a data de fim e o estado de um código que um cliente lhe comunique.

Desinstalação

A desinstalação elimina as tabelas do módulo (lotes, histórico de envio e de impressão). Os códigos já gerados continuam a ser regras de carrinho ativas em Catálogo > Descontos.

Resolução de problemas

  • A geração para: volte a abrir o lote ou clique em Retomar. É apresentada uma mensagem precisa se a base de dados recusar as inserções; nenhum código parcial é deixado.
  • «Este formato é demasiado fácil de adivinhar»: adicione caracteres aleatórios ou mude para o alfabeto completo.
  • Emails com falha: verifique Parâmetros avançados > Email com um email de teste e, em seguida, reinicie o envio dos códigos não enviados.
  • O código QR não reduz o carrinho: a mensagem apresentada indica a condição em falta. Para um código pessoal, o cliente tem de iniciar sessão na sua conta.
  • «Foram testados demasiados códigos»: a proteção do link direto é levantada automaticamente ao fim de 15 minutos.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte