# Gerar Códigos de Desconto em Massa no PrestaShop 8 e 9: documentação > 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. Os códigos distribuem-se por email,… - Página: - Idioma: pt - Atualizado em: 2026-09-24 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/bulk-coupon-codes-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/bulk-coupon-codes-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/bulk-coupon-codes-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/bulk-coupon-codes-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/bulk-coupon-codes-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/bulk-coupon-codes-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/bulk-coupon-codes-prestashop/index.md) - Índice: ## 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. Os códigos distribuem-se por email, em PDF para imprimir com código QR ou por exportação CSV, e cada lote tem as suas estatísticas de utilização. ## Instalação 1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e selecione `dfbulkcoupons-1.1.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á. 3. O módulo ativa a funcionalidade das regras de carrinho se estiver desativada. Atualização a partir da 1.0.0: carregue o novo ZIP por cima do anterior. O script de atualização adiciona as colunas de envio e impressão e o hook do link direto, sem alterar os lotes existentes. ## Criar um lote Clique em **Novo lote** e preencha o formulário de cima para baixo. ### Lote O **nome do lote** aparece nas estatísticas e 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, outro ou um nome livre). Serve para comparar campanhas na tabela de desempenho por canal. ### Formato dos códigos Um código é composto por prefixo, parte aleatória e sufixo. Na parte aleatória, `X` é uma letra ou algarismo, `A` uma letra e `#` um algarismo. Os outros caracteres, como hífenes, mantêm-se. Exemplo: prefixo `VERAO-` e parte `XXXX-XXXX` dão `VERAO-K7MQ-3HWD`. O conjunto de caracteres «Fáceis de ler» exclui 0, O, 1, I e L para evitar erros de escrita. São necessários pelo menos 4 caracteres aleatórios, e o formato tem de oferecer pelo menos 20 vezes mais combinações do que códigos pedidos: a pré-visualização e o contador de combinações indicam-no durante a escrita. ### Destinatários e quantidade - **Códigos anónimos**: indique o número de códigos, de 1 a 200 000. Distribuem-se livremente. - **Um código pessoal por cliente dos grupos selecionados**: um código por cliente ativo dos grupos assinalados, com a opção «Apenas subscritores da newsletter». - **Um código pessoal por cliente de uma lista de emails**: cole os endereços, um por linha ou separados por vírgulas. Os endereços sem conta de cliente são ignorados e contabilizados. Um código pessoal só funciona para a conta de cliente a que está atribuído. ### Desconto O nome apresentado aos clientes aparece no carrinho e na fatura, em cada idioma. Tipos: percentagem, montante fixo (com ou sem IVA, numa moeda), envio gratuito ou oferta (é oferecida a combinação predefinida do produto). Uma percentagem ou um montante aplica-se a toda a encomenda sem envio ou a um produto específico. Uma percentagem também se pode aplicar ao produto mais barato ou aos produtos da restrição. ### Validade e utilização Datas de início e fim, **utilizações por código** e **utilizações por cliente**: indique 1 e 1 para códigos de uso único. Montante mínimo de encomenda (com moeda, impostos e envio), prioridade, opção «Não acumulável com outros descontos», apresentação do código no carrinho do titular (apenas códigos pessoais) e ativação imediata. ### Restrições Restrição por produtos, categorias ou marcas com uma quantidade mínima de produtos correspondentes, grupos de clientes autorizados, países de entrega autorizados e, em multiloja, lojas autorizadas. Um campo vazio não impõe nenhuma restrição. ## Geração dos códigos Depois de validar, a página de geração cria os códigos em blocos de 250 com uma barra de progresso. Mantenha a página aberta. Se for fechada, a geração retoma onde parou na próxima abertura do lote (link **Retomar** na lista). Cada código é uma regra de carrinho cuja descrição começa por `[DFBC#id]`, visível em Catálogo > Descontos. ## Página do lote ### Estatísticas Códigos gerados, códigos utilizados e taxa de utilização, encomendas validadas, encomendas de novos clientes (clientes sem encomenda validada anterior), faturação sem IVA e encomenda média, desconto concedido sem IVA e rácio faturação / desconto, códigos ainda utilizáveis. Seguem-se um gráfico das utilizações por dia, os 15 códigos mais utilizados e as 30 últimas encomendas. Só as encomendas validadas contam para a faturação e o desconto, convertidos na moeda predefinida. ### Gerir o lote - **Dados**: nome, canal e nota interna. O novo nome é copiado para a descrição das regras de carrinho. - **Fim da validade**: aplica-se a todos os códigos do lote. - **Adicionar códigos**: para um lote de códigos anónimos, com o mesmo formato e as mesmas regras. - **Desativar ou ativar todos os códigos**, **eliminar os códigos nunca utilizados**, **duplicar** ou **eliminar** o lote. As encomendas anteriores mantêm o desconto. ### Lista de códigos O botão **Ver os códigos** mostra os códigos 50 por página, com separadores por estado: disponível, utilizado, esgotado, expirado, desativado. A pesquisa faz-se pelo início do código ou pelo email do cliente. Para cada código: cópia do código ou do 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. ## Enviar os códigos por email Disponível para os lotes de códigos pessoais, no painel **Distribuição** da página do lote. 1. Para cada idioma, altere o assunto e a mensagem. Variáveis disponíveis: `{firstname}`, `{lastname}`, `{code}`, `{discount}`, `{valid_until}`, `{shop_name}`, `{link}`. O email mostra sempre o código numa moldura, o desconto, a data de fim e um botão que aplica o código ao carrinho. 2. Clique em **Enviar-me um email de teste**: segue para o seu endereço de funcionário, no seu idioma, com um código do lote. 3. Escolha os destinatários: códigos ainda não enviados (e os que falharam), ou todos os códigos novamente como 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 de email ou fornecedor SMTP e clique em **Guardar e enviar**. O envio faz-se 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 repetidos no envio seguinte dos códigos não enviados. Os emails usam as definições de **Parâmetros Avançados > Email**. Se o envio estiver desativado aí, um aviso é mostrado no topo da página. ## Imprimir os códigos O botão **Imprimir os códigos** gera um PDF A4: - **Cartões**: 10 por página (95 x 55 mm), com linhas 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 linhas de corte. Escolha os códigos (não utilizados nunca impressos, todos os não utilizados ou todos), quantos (até 2000 por ficheiro) e quantos 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. A opção «Marcar estes códigos como impressos» evita imprimir os mesmos códigos duas vezes. ## Link direto e código QR Cada código tem um endereço do tipo `https://a-sua-loja.pt/module/dfbulkcoupons/apply?code=CODIGO`. Abre a loja e aplica o código ao carrinho. Se o visitante ainda não tiver carrinho, ou se o carrinho não cumprir as condições (montante mínimo, produtos, conta do titular), o código fica guardado 30 dias no cookie e é aplicado assim que o carrinho as cumprir. 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. ## Exportações CSV Os ficheiros estão em UTF-8 com separador ponto e vírgula e abrem-se diretamente no Excel. - **Códigos** (todos, não utilizados ou utilizados): código, estado, utilizações, utilizações restantes, datas de validade, email, nome 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 com e sem IVA, moeda. ## Desempenho por canal Assim que vários canais são utilizados, a lista de lotes mostra uma tabela por canal: número de lotes e de códigos, códigos utilizados, taxa, encomendas, faturação e desconto sem IVA, ordenada por faturação. ## Desinstalação A desinstalação elimina as tabelas do módulo (lotes, histórico de envio e 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 e a geração retoma. Se a base de dados recusar as inserções, é mostrada uma mensagem de erro precisa. - **«Este formato deixa muito poucas combinações»**: adicione caracteres aleatórios ou use o alfabeto completo. - **Emails com falha**: verifique Parâmetros Avançados > Email com um email de teste e volte a enviar os códigos não enviados. - **O código QR não reduz o carrinho**: abra o carrinho, o código é aplicado assim que as suas condições forem cumpridas. Para um código pessoal, o cliente tem de ter sessão iniciada na sua conta.