Pular para o conteúdo principal

Promoção PDV

A tela de Promoção PDV cadastra as regras de desconto automático que o sistema aplica em tempo real no carrinho do PDV (Frente de Caixa). O idworks oferece quatro tipos de promoção, cada um com regras diferentes: Regular (desconto em % ou R$ aplicado em produtos selecionados), Compre e Ganhe (compre X unidades dos itens A e ganhe Y unidades dos itens B grátis), Desconto Progressivo (quanto mais unidades, maior o desconto — por faixa) e Compre Junto (combinação de duas listas de itens com descontos separados, ideal para "ofertas casadas"). Todas as promoções têm vigência (data/hora de início e fim), podem ser acumuladas entre si, podem ser restritas a tipos de pedido específicos (PDV, e-commerce, atacado etc.), políticas comerciais e — opcionalmente — exigir cliente cadastrado.

A tela tem um modo de visualização único, em lista. O cadastro/edição passa por uma modal grande com seções condicionais: cabeçalho geral, "condições para a promoção ser válida" (tipo pedido + política comercial + cliente cadastrado) e um bloco específico do tipo escolhido (faixas progressivas, listas de SKUs, listas de brindes etc.).

O motor de promoções recalcula os preços a cada alteração do carrinho na Frente de Caixa (adicionar item, mudar quantidade, mudar cliente) e também alimenta o selo de promoção que aparece na tela do produto. Toda criação, edição ou exclusão feita aqui é refletida no PDV em segundos — não precisa reabrir o caixa nem aguardar sincronização.

Índice​

Conceito

Condições gerais

Tipo 1 — Regular

Tipo 2 — Compre e Ganhe

Tipo 3 — Desconto Progressivo

Tipo 4 — Compre Junto

Importação e cadastro de itens

Cadastro e edição (CRUD)

Busca

Regras de negócio (avançadas)

Referência rápida

O que é a tela de Promoção PDV?​

É a tela onde você configura todas as promoções automáticas do PDV — o que vai aparecer como desconto no carrinho do operador sem que ele precise fazer nada manualmente. Cada promoção tem um tipo (4 opções), uma vigência, opcionalmente restrições de produtos e condições de pedido. O motor avalia as promoções vigentes a cada alteração do carrinho e devolve o preço final.

📍 Onde: menu lateral → PDV → Promoção PDV.

Quais os 4 tipos de promoção?​

TipoNomeEm uma fraseQuando usar
1RegularDesconto em % ou R$ aplicado a produtos elegíveis"10% off em camisetas até o fim do mês"; "R$ 5,00 off em qualquer pedido acima de R$ 50,00".
2Compre e GanheCompre X unidades de A → ganhe Y unidades de B grátis"Na compra de 3 sabonetes, ganhe 1 desodorante"; "Compre 2 e leve 3".
3Desconto ProgressivoFaixas: "a partir de N unidades, desconto Z""1 un por R$ 50; 3 un por R$ 40 cada; 5 un por R$ 35 cada".
4Compre JuntoDuas listas, duas descontos: a principal e a complementar"Compre uma camisa (10% off) + uma calça (15% off) e ganhe nos dois".

Você escolhe o tipo no início do cadastro — ele não pode ser mudado depois. Para trocar o tipo, exclua e crie uma nova promoção.

O que é o "status" da promoção?​

O status controla o estado derivado da vigência e da exclusão:

StatusSignificado
Ativo (azul)Vigente agora — o sistema aplica no carrinho.
Programada (verde)Cadastrada para começar no futuro — a Data De ainda não chegou.
Finalizada (laranja)A vigência já passou (Data Até < hoje) — o sistema ignora.
Inativa (cinza)Pausada manualmente pelo switch Status da promoção — o sistema ignora.
Excluída (não aparece na lista)Promoção que já foi usada em pedidos e foi excluída — fica oculta mas preserva o histórico.

O status é calculado pelo sistema com base na vigência atual; o switch Status da promoção (Ativo/Inativo) do cabeçalho funciona como uma chave manual — uma promoção que está dentro da vigência mas com o switch em Inativo se comporta como Inativa.

Como funciona a vigência da promoção?​

A vigência é definida pelos campos Data / Hora De e Data / Hora Até, com precisão de segundos. Para uma promoção valer agora, a data/hora atual precisa estar no intervalo definido.

  • A vigência usa o horário de Brasília.
  • O sistema valida no cadastro: a Data Até precisa ser maior que a Data De (se não, o cadastro é bloqueado).
  • Para promoções "para sempre" (sem prazo), use o switch Para sempre? = SIM — o sistema mantém a promoção vigente sem precisar atualizar a data.

Programar a promoção para o futuro é normal: configure a Data De para daqui a 2 dias e ela fica em status Programada até a hora chegar — a partir daí o sistema passa a aplicá-la sozinho.

O que significa "Pode acumular com outros descontos"?​

O switch Pode acumular com outros descontos? define se a promoção pode se somar com outras promoções do mesmo carrinho:

  • SIM: aceita acumular com outras promoções do mesmo tipo cumulativas (ex.: duas promoções Regular cumulativas aplicam ambos os descontos em sequência) e/ou de tipos diferentes (Regular + Progressivo, por exemplo).
  • NÃO: aplica apenas essa promoção no item — descarta as outras do mesmo tipo (deixa o sistema escolher pelo desempate "maior desconto primeiro").

Promoções de tipos diferentes podem se combinar sem o switch, dependendo da lógica do sistema. O switch é decisivo para promoções do mesmo tipo.

O que significa "Pode acumular com preços manuais"?​

O switch Pode acumular com preços manuais? controla o comportamento quando o item já tem desconto manual — ou seja, o "preço de" é diferente do "preço por" por intervenção humana (ex.: tabela de preço promocional manual, alteração feita pelo operador na frente de caixa):

  • SIM: a promoção aplica o desconto em cima do preço já reduzido manualmente. Cliente ganha os dois.
  • NÃO: se já existe diferença entre o "preço de" e o "preço por", o sistema descarta a promoção. Cliente fica só com o preço manual.

Use NÃO para evitar "desconto em cima de desconto" em produtos que já estão na liquidação por preço manual. Use SIM quando a regra do marketing é cumulativa.

O que é "Permitir combinação de skus diferentes"?​

O switch Permitir combinação de skus diferentes muda como a quantidade mínima é contada nas promoções de tipo Compre e Ganhe, Desconto Progressivo e Compre Junto:

  • NÃO (default): a quantidade mínima é contada por SKU. Para "compre 3 unidades", precisa ter 3 do mesmo SKU.
  • SIM: a quantidade mínima soma SKUs diferentes que fazem parte da promoção. Para "compre 3 unidades", pode ser 1 do SKU A + 1 do SKU B + 1 do SKU C, desde que todos os 3 estejam na lista da promoção.

Use SIM para promoções tipo "compre 3 livros quaisquer e ganhe X" — o cliente pode misturar títulos diferentes.

O que é "Apenas quantidade exata"?​

O switch Apenas quantidade exata vale para o Desconto Progressivo e controla o comportamento da faixa:

  • NÃO (default): a faixa é aplicada quando a quantidade atinge ou passa o gatilho. Ex.: faixa "5 un por R$ 35" aplica para 5, 6, 7, 8... unidades, usando o preço R$ 35 em todas.
  • SIM: a faixa só é aplicada quando a quantidade é múltiplo exato do gatilho. O sistema percorre as faixas da maior para a menor encaixando o máximo de blocos exatos, e a sobra (que não fecha um bloco completo) fica sem desconto.

Exemplo com faixas 4 un (10% off) e 2 un (5% off), comprando 9 unidades:

  • Quantidade exata = NÃO: aplica a faixa de 4 un (10% off) em todas as 9 unidades.
  • Quantidade exata = SIM: 4 un com 10% off (1× faixa de 4) + 4 un com 10% off (2× faixa de 4) + 1 un sem desconto. Total: 8 un com desconto, 1 un cheia.

Use SIM para "leve 3 pague 2" e similares onde o desconto é específico por bloco de unidades.

Como restringir a promoção a um tipo de pedido?​

No cabeçalho do modal, na seção "Quais as condições para a promoção ser válida?", preencha o seletor multi-select TIPO PEDIDO. A promoção só será aplicada quando o pedido em montagem for de um dos tipos selecionados.

  • Vazio = vale para todos os tipos de pedido.
  • O sistema valida em tempo real: se o pedido é de outro tipo, a promoção é descartada.

Use isso para promoções exclusivas do PDV (selecione só "Venda PDV"), ou exclusivas do e-commerce (selecione "Venda E-commerce"), por exemplo.

Os tipos de pedido precisam estar ativos na tela Tipo Pedido — se você selecionar um inativo, o cadastro é bloqueado.

Como restringir a promoção a uma política comercial?​

Mesmo bloco do TIPO PEDIDO, mas no seletor POLÍTICA COMERCIAL. A promoção é aplicada apenas quando o item do carrinho está casado com uma das políticas comerciais selecionadas.

  • Vazio = vale para todas as políticas.
  • Útil para criar promoções só para o atacado ou só para o varejo, por exemplo.

Como permitir só clientes cadastrados?​

Ative o switch ATIVAR PARA CLIENTES CADASTRADOS? = SIM. A promoção é aplicada apenas quando o pedido em montagem tem cliente identificado (CPF/CNPJ, telefone ou e-mail informado no Passo 1 da Frente de Caixa).

Use para promoções de clube de fidelidade, "5% off só para cliente cadastrado", ou para incentivar o cadastro no caixa.

Se você esquece de ativar e a campanha era "exclusiva clientes", todo mundo ganha o desconto.

Quando usar Promoção Regular?​

A Promoção Regular é o tipo mais comum e flexível. Use quando a regra é:

  • "X% off" ou "R$ Y off" no item ou no pedido inteiro.
  • Desconto vinculado a marcas, categorias, produtos ou SKUs específicos (ou todos).
  • Desconto condicionado a faixa de valor do pedido ("acima de R$ 100, 10% off").

Exemplos:

  • "20% off em toda a categoria Calçados durante o feriado."
  • "R$ 10,00 off em pedidos acima de R$ 100,00."
  • "5% off na marca Nike + Adidas (exceto SKUs em liquidação)."

Como cadastrar uma Promoção Regular?​

  1. Criar Promoção → preencher cabeçalho (Conta, Tipo = Regular, Nome, Descrição, vigência).
  2. Configure os flags do cabeçalho conforme a regra (Acumular sim/não, Cliente cadastrado sim/não etc.).
  3. (Opcional) Restringir a Tipo Pedido / Política Comercial.
  4. No bloco PROMOÇÃO REGULAR, escolha o TIPO DE DESCONTO:
    • Percentual — preencha % Desconto (0 a 100).
    • Nominal (R$) — preencha R$ Desconto (valor absoluto).
  5. No bloco A QUAIS ITENS ESTA PROMOÇÃO SERÁ APLICADA?, escolha:
    • Aplicar a todos os produtos (default) — sem restrições por item.
    • Aplicar aos produtos que atendem a todas as restrições a seguir — restrição por Categorias / Marcas / Produtos / SKUs.
  6. (Opcional) Valor mínimo do pedido / Valor máximo do pedido — limita a aplicação à faixa de R$ do pedido total.
  7. Salvar.

A regra fica disponível na vigência. O motor aplica automaticamente.

Como restringir os produtos da Promoção Regular?​

Escolha Aplicar aos produtos que atendem a todas as restrições a seguir e preencha uma ou mais das 4 listas:

RestriçãoO que filtra
CATEGORIASCategorias de SKU (árvore — Categorias e subcategorias).
MARCASMarcas cadastradas.
PRODUTOSProdutos "pai" — aplicar a promoção em todas as variações do produto de uma vez (ex.: a camisa modelo X, em todos os tamanhos e cores).
SKU, KIT, CAIXA, INSUMO E MATÉRIA PRIMAItens vendáveis específicos (uma cor/tamanho específico).

Importante: a relação entre as 4 listas é E (AND) — o item precisa passar em todas as restrições preenchidas. Se você preencher CATEGORIAS=Calçados e MARCAS=Nike, vale apenas para SKUs Nike que também sejam Calçados. Se a marca preenchida não tem item na categoria, a promoção nunca aplica.

Quando uma restrição é vazia, ela não filtra (passa todos). É exatamente assim que você cria "Calçados de qualquer marca" — preencha só CATEGORIAS=Calçados e deixe MARCAS vazia.

O que é "Iguais a" vs. "Diferentes de" na restrição?​

Cada uma das 4 restrições tem um seletor próprio ao lado (com as opções Iguais a: e Diferentes de:):

  • Iguais a: (default, =1) → "aplicar NOS itens da lista". Ex.: "MARCAS Iguais a Nike, Adidas" → vale só para Nike e Adidas.
  • Diferentes de: (=0) → "aplicar em TUDO MENOS os itens da lista" (lista de exclusão). Ex.: "MARCAS Diferentes de Marca X, Marca Y" → vale para qualquer marca exceto X e Y.

Use Diferentes de quando é mais fácil listar o que fica de fora do que listar o que entra (ex.: "promoção em todas as marcas, menos as 3 marcas premium").

Como definir valor mínimo/máximo do pedido?​

No bloco "Quais as condições para a promoção ser válida?" da Promoção Regular, preencha:

  • Valor mínimo do pedido — promoção só vale se o total do pedido for ≥ esse valor.
  • Valor máximo do pedido — promoção só vale se o total do pedido for ≤ esse valor.

Use os dois juntos para criar uma faixa: "vale para pedidos entre R$ 100 e R$ 500". Use apenas o mínimo para incentivar tickets maiores ("acima de R$ 200, 10% off"). Use apenas o máximo (raro) para travar promoções em compras gigantes.

A tela valida na hora: o mínimo não pode ser maior que o máximo — aparece o alerta "O valor mínimo do pedido não pode ser maior que o valor máximo".

Quando usar Compre e Ganhe?​

A promoção Compre e Ganhe é a clássica oferta "compre X e ganhe Y grátis". Use quando:

  • Você quer girar estoque de um item de baixa saída usando-o como brinde de outro.
  • Quer fazer "pague 2 leve 3" com produtos iguais ou diferentes.
  • Quer dar amostras grátis para incentivar o teste de um produto novo.

Exemplos:

  • "Na compra de 3 unidades de sabonete X, ganhe 1 desodorante Y grátis."
  • "Compre 2 camisas, ganhe 1 boné de brinde."

Como cadastrar uma promoção Compre e Ganhe?​

  1. Criar Promoção → Tipo = Compre e ganhe → cabeçalho geral.
  2. Configure os flags (Cumulative, AllowDifferentItemQuantitySum etc.).
  3. (Opcional) Restrições gerais (Tipo Pedido, Política Comercial, Cliente cadastrado).
  4. No bloco PROMOÇÃO COMPRE E GANHE:
    • QUANTIDADE MÍNIMA — quantas unidades dos itens "que devem ser comprados" o cliente precisa pegar para ativar.
    • ITENS QUE DEVEM SER COMPRADOS — lista de SKUs que entram no gatilho.
    • ITENS DE BRINDE — lista de SKUs que serão dados gratuitamente quando o gatilho for atingido.
  5. Salvar.

Atenção: o switch Permitir combinação de skus diferentes afeta como a quantidade mínima é contada. Veja a FAQ dedicada.

Como funciona o brinde no carrinho?​

Quando a quantidade mínima dos itens em ITENS QUE DEVEM SER COMPRADOS é atingida:

  • Para cada item na lista de ITENS DE BRINDE, o motor verifica se ele já está no carrinho.
  • Se está → zera o preço total da linha (mantém a quantidade existente).
  • Se não está → adiciona automaticamente ao carrinho com quantidade 1 e preço 0.

O nome do brinde aparece como "Compre e ganhe - <nome da promoção>" na linha do item zerado, e o identificador da promoção fica anotado no pedido para auditoria. O cliente sai com os brindes na nota fiscal, com valor unitário R$ 0,00.

Comportamento: se você cadastra 3 itens diferentes como brinde, todos os 3 são adicionados/zerados juntos. Para dar um único brinde à escolha do cliente, isso precisa ser tratado na operação (o sistema não tem essa lógica de "escolha um").

Quando usar Desconto Progressivo?​

A promoção Desconto Progressivo é a clássica "leve mais, pague menos". Use quando:

  • Quer incentivar volume de compra com descontos crescentes por faixa.
  • Quer fazer "leve 3 pague 2" via faixa de preço fixo.
  • Tem produtos em caixas fechadas (12, 24, 48 unidades) com desconto por quantidade.

Exemplos:

  • "1 unidade R$ 50; 3 un por R$ 40 cada; 5+ por R$ 35 cada."
  • "10% off a partir de 3 unidades; 20% off a partir de 6; 30% off a partir de 12."

Como cadastrar um Desconto Progressivo?​

  1. Criar Promoção → Tipo = Desconto progressivo → cabeçalho geral.
  2. (Opcional) Restrições gerais.
  3. No bloco PROMOÇÃO DESCONTO PROGRESSIVO:
    • PRODUTOS — produtos pai aos quais a promoção se aplica (use quando quer pegar todas as variações de uma vez).
    • SKU, KIT, CAIXA, INSUMO E MATÉRIA PRIMA — SKUs específicos.
    • Switch VALOR FIXO (R$) / DESCONTO (%) — define o tipo de desconto das faixas.
  4. Preencher as faixas (uma por linha):
    • QUANTIDADE MÍNIMA (Quantity) — a partir de quantas unidades vale.
    • % DESCONTO ou VALOR FIXO UNITÁRIO (R$) — desconto da faixa.
  5. Use o botão + Adicionar Regra de Desconto para criar mais faixas (até 10).
  6. (Opcional) Ative ExactlyQuantity se quiser comportamento de "leve N pague M".
  7. Salvar.

Você precisa informar PRODUTOS ou SKU — pelo menos um dos dois. Pode usar os dois juntos.

Cada QUANTIDADE MÍNIMA precisa ser única entre as faixas. Duas faixas com a mesma quantidade são bloqueadas no salvamento.

Qual a diferença entre "% Desconto" e "Valor Fixo (R$)"?​

Você escolhe um dos dois modos (switch no topo do bloco de Desconto Progressivo) que vale para todas as faixas:

  • DESCONTO (%) — cada faixa tem um percentual de desconto aplicado sobre o preço de venda atual. Ex.: faixa "3 un, 10% off" reduz o preço unitário em 10%.
  • VALOR FIXO UNITÁRIO (R$) — cada faixa tem um preço unitário fixo (substitui o preço de venda). Ex.: faixa "3 un, R$ 8,00" → cada unidade sai por R$ 8,00, independente do preço de tabela.

Use % Desconto para campanhas estilo "quanto mais leva, maior o desconto". Use Valor Fixo quando quer um preço negociado fixo por faixa de quantidade (ex.: distribuidor que tem tabela de "R$ unitário por caixa de N").

Como funciona a regra de "Quantidade Exata"?​

Veja a FAQ O que é "Apenas quantidade exata"? para a explicação geral.

Em detalhe (para o Desconto Progressivo):

Quando Quantidade exata = SIM, o sistema:

  1. Ordena as faixas em ordem decrescente de quantidade (maior primeiro).
  2. Para cada faixa, calcula quantos blocos exatos cabem na quantidade restante.
  3. Se cabe pelo menos um bloco, aplica essa faixa nesse total — gerando uma linha de carrinho por bloco aplicado (cada uma com seu preço).
  4. Reduz a quantidade restante.
  5. Repete para a próxima faixa.
  6. A sobra final (que não fecha um bloco completo de nenhuma faixa) vira uma linha separada sem desconto.

Exemplo concreto: faixas [6 un: R$ 10/un], [3 un: R$ 12/un], comprando 10 unidades com preço cheio R$ 15:

PassoRestanteFaixa testadaBlocosQuantidade aplicadaPreço unit.Linha gerada
1106 un16R$ 106 un × R$ 10 = R$ 60
243 un13R$ 123 un × R$ 12 = R$ 36
Sobra1——1R$ 151 un × R$ 15 = R$ 15

O carrinho final tem 3 linhas do mesmo SKU: 6 un / 3 un / 1 un, totalizando R$ 111. A divisão fica explícita para o cliente entender o cálculo.

Quando Quantidade exata = NÃO (default), o sistema aplica a primeira faixa (do maior para o menor) cuja quantidade mínima é alcançada pela quantidade do item. No mesmo exemplo (10 un, faixas 6 e 3), aplicaria R$ 10/un em todas as 10 unidades = R$ 100.

Quantas faixas posso cadastrar?​

Até 10 faixas por promoção de Desconto Progressivo. A interface esconde o botão + Adicionar Regra de Desconto quando atinge esse limite. Para passar de 10, você precisa criar uma nova promoção.

Quando usar Compre Junto?​

A promoção Compre Junto é desenhada para vendas combinadas com descontos diferenciados em cada lista. Use quando:

  • Quer vender "kit montado" — ex.: "comprou o produto A + o acessório B, ganha desconto nos dois".
  • Quer combinar produto principal + complementar (camisa + calça, móvel + cadeira, notebook + mouse).

Exemplos:

  • "Compre 1 camisa (lista principal, 10% off) + 1 calça (lista complementar, 15% off) = ambos com desconto."
  • "Compre 1 notebook (5% off) + 1 mouse (50% off)."

A diferença para o Compre e Ganhe é que aqui os dois itens são vendidos (com desconto), não há item grátis.

Como cadastrar uma promoção Compre Junto?​

  1. Criar Promoção → Tipo = Compre junto → cabeçalho geral + restrições.
  2. No bloco LISTA PRINCIPAL:
    • QUANTIDADE MÍNIMA — quantas unidades da lista principal o cliente precisa comprar.
    • DESCONTO (em %) — desconto que se aplica nos itens da lista principal.
    • SKU, KIT, CAIXA, INSUMO E MATÉRIA PRIMA — lista principal.
  3. No bloco DESCONTOS ADICIONAIS:
    • DESCONTO (em %) — desconto na lista complementar.
    • SKU, KIT, CAIXA, INSUMO E MATÉRIA PRIMA — lista complementar.
  4. Salvar.

A promoção ativa quando o cliente atinge a quantidade mínima da lista principal E adiciona pelo menos 1 item da lista complementar. Quando ativa, os dois itens recebem seus respectivos descontos.

Qual a diferença entre lista principal e desconto adicional?​

AspectoLista PrincipalDescontos Adicionais (complementar)
Campo do descontoDESCONTO (% na seção LISTA PRINCIPAL)DESCONTO (% na seção DESCONTOS ADICIONAIS)
Tem quantidade mínima?Sim (campo QUANTIDADE MÍNIMA)Não — basta 1 unidade
O que ativa a promoção?Atingir a quantidade mínimaTer pelo menos 1 item da lista no carrinho

Resumo: a lista principal é o gatilho (com quantidade); a lista complementar é o plus (basta estar no carrinho). Os dois descontos são aplicados em paralelo nos itens das duas listas.

Como importar lista de SKUs ou Produtos via Excel?​

Os campos de lista de SKUs / Produtos têm um botão upload (ícone de seta para cima) ao lado. Clique e selecione um arquivo .xlsx ou .xls com a estrutura:

  • Aba chamada Produtos e Skus.
  • Coluna AU = código (o código que aparece na tela do produto).
  • Coluna C = nome (descritivo).
  • Coluna D = tipo (Sku ou Produto — usado para o filtro).

A planilha é processada pelo navegador (não sobe para o servidor). Avisos:

  • "Não há itens do tipo Sku/Produto na planilha" → coluna D vazia ou com outro valor.
  • "Não há dados válidos na planilha. Verifique se as colunas AU (Código) e C (Nome) estão preenchidas." → faltam essas colunas.

A planilha modelo é a mesma de outras telas (exportada do cadastro de SKUs). Para gerar, exporte os produtos/skus de Produtos → reaproveite o arquivo aqui.

Como editar uma promoção existente?​

Na lista de promoções:

  • Duplo-clique na linha (atalho rápido).
  • Ou clique no ícone de lápis à direita.

A modal abre com todos os campos preenchidos. O Tipo vem bloqueado (não pode mudar). Altere o que precisar e clique em Salvar.

Comportamento das listas: o que você deixa preenchido na modal vira a versão final. Se remover todos os itens de uma lista (por exemplo, esvaziar MARCAS) e salvar, os vínculos antigos são apagados.

Pré-requisito: privilégio Editar Promoção PDV.

Posso mudar o tipo de uma promoção depois de criada?​

Não. O Tipo é imutável depois de criado — o seletor fica desabilitado na edição. Para "mudar de tipo", você precisa:

  1. Excluir a promoção antiga.
  2. Criar uma nova com o tipo desejado.

Por isso, decida o tipo com cuidado no cadastro inicial.

Como excluir uma promoção?​

Na lista, clique no ícone de lixeira e confirme a modal "Confirma deletar esse registro?". O sistema escolhe automaticamente uma de duas operações:

  • Exclusão definitiva: se a promoção nunca foi usada em pedidos, ela é apagada por completo do cadastro.
  • Exclusão preservando histórico: se a promoção já foi usada em pelo menos 1 pedido, ela passa para o status Excluída — some das listas, do PDV e do motor de promoções, mas continua referenciada nos pedidos antigos.

Isso preserva o histórico de descontos aplicados — sem isso, relatórios e auditoria fiscal de pedidos antigos quebrariam.

Pré-requisito: privilégio Deletar Promoção PDV.

Como inativar uma promoção sem excluir?​

Edite a promoção e desligue o switch Status da promoção (de ATIVO para INATIVO). Salve. A promoção continua visível na lista (status Inativa, cor cinza) mas o motor ignora no cálculo do carrinho.

Vantagem sobre excluir: você consegue reativar depois sem cadastrar de novo. Ideal para promoções sazonais que repetem (Black Friday, Dia das Mães etc.).

Como filtrar a lista de promoções?​

Botão de funil no topo direito → painel Filtros. Filtros disponíveis:

FiltroO que filtra
ContaEmpresa do grupo (aparece em multi-account).
Tipo1=Regular, 2=Compre e Ganhe, 3=Desconto Progressivo, 4=Compre Junto.
StatusAtivo, Programada, Finalizada, Inativa (Excluída fica fora por default).
Nome da promoçãoTexto livre — busca parcial.
Data DeIntervalo aplicado sobre o campo Data De da promoção.
Data AtéIntervalo aplicado sobre o campo Data Até da promoção.

Combine à vontade. Em seguida, Buscar. Para resetar, Limpar.

O que mostra a coluna STATUS em cores?​

A coluna STATUS da lista usa cores para sinalizar o estado da promoção:

CorHexStatus
🔵 Azul#0091CEAtivo
🟢 Verde#18AA8CProgramada
🟠 Laranja#F8AC5AFinalizada
⚪ Cinza#B2BBC0Inativa / Excluída / Default

O status é calculado pelo sistema com base na vigência (Data De/Até) e no switch Status da promoção (Ativo/Inativo).

Como o sistema decide qual promoção aplicar quando há várias?​

Quando o mesmo item do carrinho bate em mais de uma promoção vigente, o sistema faz:

  1. Calcula o desconto preliminar de cada promoção aplicável.
  2. Ordena por maior desconto primeiro (o cliente sempre ganha o melhor desconto disponível).
  3. Aplica em sequência, respeitando o switch Pode acumular com outros descontos:
    • Mantém a primeira (a de maior desconto).
    • Mantém também as subsequentes desde que mesmo tipo + ambas Acumular=SIM (acumulam) OU tipo diferente (deixa o resto da lógica decidir).
  4. Para cada promoção mantida, recalcula o preço do item (cada promoção opera em cima do preço já reduzido pela anterior).

Exemplo: item com 2 promoções vigentes — A=10% off (Acumular=NÃO), B=5% off (Acumular=SIM):

  • Ordenação: A primeiro (maior desconto).
  • A é aplicada, B é descartada (A não é cumulativa).
  • Preço final: original × (1 - 0.10).

Outro exemplo: A=10% (Acumular=SIM), B=5% (Acumular=SIM), ambas Regular:

  • Ordenação: A, B.
  • A aplica: novo preço = original × 0.90.
  • B aplica em cima: preço = (original × 0.90) × 0.95 ≈ original × 0.855 ≈ 14.5% off total.

A ordem é sempre do melhor para o cliente — você não "perde" descontos pela ordem de cadastro.

Como o "Acumular com outros descontos" funciona na prática?​

O switch Pode acumular com outros descontos é uma opção do dono da promoção de "deixar acumular ou não" com outras do mesmo tipo:

  • Mesmo tipo (ex.: duas Regulares):
    • Ambas com Acumular=SIM → acumulam (primeira aplica, segunda em cima).
    • Pelo menos uma com Acumular=NÃO → o sistema mantém só a de maior desconto.
  • Tipos diferentes (ex.: Regular + Compre e Ganhe):
    • O sistema avalia cada tipo na sua lógica (Regular ajusta preço, Compre e Ganhe adiciona brinde, etc.). Acabam coexistindo, mas o switch não atua entre tipos diferentes.

Boa prática: quando criar campanhas que podem coexistir, deixe Acumular=SIM em todas (para clientes felizes); quando criar uma campanha exclusiva (a única que vale naquele item), deixe Acumular=NÃO.

Como o sistema sabe que um preço foi alterado manualmente?​

O sistema compara o preço de tabela com o preço de venda atual do item no carrinho:

  • Se forem iguais → não há desconto manual.
  • Se forem diferentes → houve alteração (preço promocional manual definido na tabela de preços, ajuste feito pelo operador na Frente de Caixa, ou política comercial com tabela diferente).

Quando há essa diferença E a promoção está com Pode acumular com preços manuais? = NÃO, a promoção é descartada para esse item específico. Para garantir que o desconto manual prevaleça (sem acumular com a promoção), use NÃO.

Em quanto tempo uma promoção nova começa a valer no PDV?​

Em segundos. Toda criação, edição ou exclusão feita na tela de Promoção PDV é refletida no PDV imediatamente — o operador não precisa fechar e reabrir a Frente de Caixa, e o sistema não tem janela de sincronização noturna.

Internamente, o sistema mantém a lista de promoções vigentes pronta para consulta rápida (em memória), e essa memória é atualizada na hora a cada salvamento. O resultado prático: você cadastra uma promoção, vai até o PDV em outro terminal, adiciona o produto no carrinho — o desconto já aparece.

Promoções Programadas (com Data De no futuro) também valem o mesmo: assim que a data chega, a próxima venda no PDV já aplica a regra.

O que acontece com promoções de pedidos antigos quando excluo a regra?​

Quando uma promoção que foi usada em pedidos é excluída, ela passa para o status Excluída — preservada no cadastro mas oculta nas listas. Isso garante:

  • O pedido antigo preserva a referência à promoção aplicada (nome, percentual, valor do desconto).
  • Relatórios fiscais/contábeis que envolvem o pedido continuam consultáveis.
  • A promoção não aparece mais na lista, no PDV nem no motor — então não é mais aplicada em novos pedidos.

Não é possível restaurar uma promoção excluída pela tela. Por isso, quando a intenção é só "pausar", prefira inativar (switch Status da promoção = INATIVO) em vez de excluir — assim você consegue reativar depois.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar Promoção PDVAcesso à tela e à lista. Sem isso, a tela não aparece no menu.
Criar Promoção PDVBotão Criar Promoção e ação de salvar uma nova promoção.
Editar Promoção PDVÍcone de lápis, duplo-clique na linha e ação de salvar alterações.
Deletar Promoção PDVÍcone de lixeira (exclusão definitiva ou preservando histórico, conforme a regra).

Sem Criar/Editar/Deletar, o usuário só consegue consultar a lista (e abrir o detalhe se tiver o Editar).