Promoções

🛂 Permissões: promotion.view, promotion.create, promotion.edit, promotion.delete 📍 Caminho: Clientes & Vendas → Promoções

Promoções aplicam descontos em massa sobre o preço dos produtos durante um período. Diferente do cupom (digitado pelo cliente), a promoção é automática: vale para qualquer comprador na loja.

Tipos de desconto

Tipo	Descrição
PERCENTAGE	Desconto percentual (ex.: 15% off).
FIXED_AMOUNT	Desconto em valor absoluto (ex.: R$ 5 off).

Escopo (quais produtos a promoção atinge)

Escopo	Descrição
ALL	Todos os produtos ativos do tenant.
CATEGORY	Produtos das categorias selecionadas.
SPECIFIC	Apenas produtos explicitamente selecionados.

Período de validade

• Data de início e Data de término são opcionais.
• Sem datas → a promoção fica ativa indefinidamente (até ser desativada manualmente).
• Com datas → ativada/desativada automaticamente.

Como funciona internamente

Quando uma promoção está vigente, a plataforma calcula o preço promocional e o cacheia no produto (promotional_price + active_promotion_id). Esse cache é consumido pela loja online, pelos pedidos e pelo agente de IA, garantindo que todos vejam o mesmo valor.

Como criar

1. Em Clientes & Vendas → Promoções, clique em Nova Promoção.
2. Preencha:
   • Nome (interno + exibido na loja)
   • Descrição (opcional)
   • Tipo de desconto (PERCENTAGE ou FIXED_AMOUNT)
   • Valor (ex.: 15 para 15% ou R$ 15)
   • Escopo (ALL / CATEGORY / SPECIFIC)
   • Se CATEGORY: selecione as categorias.
   • Se SPECIFIC: selecione os produtos.
   • Data de início / término (opcional)
   • Ativa — toggle
3. Salve.

Como pausar / encerrar

• Para pausar temporariamente, abra a promoção e desligue o toggle Ativa.
• Para encerrar, defina a Data de término no passado, ou exclua a promoção (preserve registros se possível desativando).

Regras importantes

• O valor de desconto precisa ser positivo (validado).
• Se houver mais de uma promoção aplicável a um produto, a plataforma usa a regra mais favorável calculada pelo cache.
• Promoções ignoram tabelas de preço — atuam sobre o preço_base (não sobre o preço da tabela). Avalie quando combinar.
• Cupons são aplicados depois da promoção, sobre o subtotal já com desconto.

Boas práticas

• Para ações sazonais (Black Friday, Natal), use escopo ALL com período definido — fácil de auditar.
• Para liquidação de categoria (ex.: "Inverno -30%") use CATEGORY.
• Para itens-âncora ou queima de estoque, use SPECIFIC.
• Comunique a promoção no banner da home (ver Configurações da loja) — o cliente precisa ver o gancho.
• Audite após o término: relatórios em Visão Geral → Análise de Vendas mostram impacto em receita e ticket médio.