Uma política é uma campanha promocional nomeada — o seu stack de Black Friday, o seu acordo de fidelização VIP, o seu fim de semana de liquidação. Cada política contém uma árvore de condições (quem se qualifica) e uma ou mais regras de desconto (o que recebem). Crie políticas ilimitadas, ordene por prioridade com arrastar, ative ou pause individualmente sem tocar em código.

Cada regra pode correr em modo Simple (% fixo ou valor fixo no carrinho, produtos ou envio) ou modo Promotion com acesso a todas as 20 fórmulas. Definições por regra incluem código de desconto, prioridade, limites min/máx de desconto, intervalo de datas (válido de / válido até), condições opcionais ao nível da regra e etiqueta multilingue de checkout na linha do carrinho.

Stop on first match termina a avaliação após a primeira política qualificada — útil quando campanhas não devem sobrepor-se. Merge strategy por política controla como várias regras numa política se combinam: stack all discounts, first wins, priority cascade, apenas maior desconto ou unique codes. Estratégia de combinação global por defeito e limite global de desconto em Definições protegem a margem em toda a loja.

A vista de lista de políticas mostra estado, estratégia de combinação, contagem de regras e ações rápidas. Duplicar, exportar JSON, importar de ficheiro ou alternar ativo — tudo no painel de políticas com cada alteração registada no log de auditoria.

O construtor de condições é um editor de árvore AND/OR aninhada — o mesmo padrão dos motores de regras profissionais, renderizado como grupos arrastáveis no back office. Adicione um grupo, escolha um campo, um operador, defina um valor. Aninhe grupos para lógica como: (grupo VIP OU 5+ encomendas anteriores) E (total do carrinho ≥ 100 €) E (categoria Saldos de Verão tem 3+ artigos).

Mais de 30 campos de condição cobrem o contexto completo do carrinho: total do carrinho, subtotal de produtos, custo de envio, contagem de produtos, contagem de SKUs únicos, peso, contagem de regras de carrinho existentes, contagem de encomendas do cliente, gasto vitalício, dia da semana, hora, data, código postal, moeda, país, país de faturação, zona, grupo de clientes, transportadora, módulo de pagamento, estado com sessão/convidado, produtos, categorias, fabricantes, fornecedores, flags virtual/físico, personalização e deteção de desconto existente.

Campos compostos combinam entidade + limiar numa condição — ex. produto #123 qty ≥ 3, categoria #45 total da linha ≥ 50 €. Operadores incluem equals, not equals, maior/menor que, between, in list, not in list, contains, starts with, regex, empty e not empty.

Seletores de produto, categoria, fabricante e grupo usam pesquisa com autocompletar integrada. Uma frase de pré-visualização em tempo real explica o que a árvore corresponde. Utilizadores avançados podem alternar JSON bruto para copiar entre ambientes. As condições reavaliam em cada sincronização de carrinho — adicionar ao carrinho, alterar quantidade, iniciar sessão, mudar morada — o motor reage de imediato.

Mude uma regra para modo Promotion e os campos de valor fixo são substituídos por uma grelha de 20 tipos de promoção, agrupados por família: adjustments, Nth-unit deals, escalões de quantidade, promoções de gastos, BOGO, descontos em linha, prendas e pares de produtos. Clique num mosaico — só aparecem os campos relevantes para essa fórmula.

O seletor de âmbito define que linhas do carrinho entram no cálculo: carrinho inteiro, produtos escolhidos manualmente, categorias ou fabricantes inteiros. Tipos BOGO têm listas comprar/obter com seletores visuais. Tipos de gastos têm limiares e degraus. Tipos de escalão têm tabela em degraus. Tipos de par têm lista A + lista B. Artigo mais barato grátis tem campo free unit count. Promoções em linha permitem cheapest-first ou most-expensive-first.

Por detrás da UI, ConorderdisPromotionCalculator delega em matemática dedicada: unit pool expansion para ciclos BOGO, ordenação de linhas por valor total para cheapest-line-free, aritmética de degraus repetidos para escadas de gastos. O resultado é um valor de desconto preciso — não um palpite arredondado de uma regra de carrinho genérica.

A configuração de promoção sincroniza bidirecionalmente com JSON. Importe uma política de staging, abra o construtor visual, ajuste um limiar, guarde — os dados estruturados mantêm-se consistentes. Chips de resumo de regras no admin mostram a fórmula ativa num relance sem abrir o editor.

O separador Simulator é um fluxo de três passos contra dados reais na sua base de dados — não um carrinho simulado. Passo 1: pesquise carrinhos por ID, nome do cliente ou email. Passo 2: escolha um carrinho da lista em tempo real (mostra cliente, email, total do carrinho, última atualização). Passo 3: execute a avaliação e leia o detalhe completo dos resultados.

Os resultados mostram que políticas corresponderam, quais foram ignoradas (e porquê), valores calculados por regra, linhas de oferta que seriam adicionadas, flags de envio grátis e o desconto total final. Filtro opcional de cliente reduz a lista de carrinhos a uma conta — ideal para reproduzir um ticket de suporte.

Cada execução de simulação é registada no log de auditoria com tipo de evento simulation_run, ID do carrinho, ator (funcionário) e instantâneo do resultado. O marketing pode verificar uma campanha antes de a ativar. O suporte pode explicar por que um carrinho específico recebeu ou não desconto — sem colocar uma encomenda de teste na loja em produção.

Use o simulador após cada edição de política, antes do go-live de Black Friday e ao importar políticas de staging. É a rede de segurança que separa gestão promocional empresarial de "alterar e esperar".

O separador Dashboard é a sua sala de controlo de promoções. Cartões KPI num período selecionável (30 / 90 / 180 / 365 dias) mostram: total de aplicações de desconto, encomendas afetadas, total de desconto arredondado na moeda da loja e contagem de políticas ativas. Os números vêm do log de auditoria — eventos reais, não estimativas.

Os gráficos de tendência Chart.js visualizam a atividade de descontos em três granularidades: diária (janela configurável), semanal e mensal. Altere o tipo de gráfico por defeito em Definições. Um gráfico circular detalha aplicações por código de desconto para ver que regras COD-* disparam realmente em produção.

O painel também mostra entradas recentes de auditoria — últimas alterações de políticas, simulações, aplicações de desconto na frente de loja — para resolução de problemas num relance sem abrir o log completo. Período analítico, janelas dia/semana/mês dos gráficos e tipo de gráfico por defeito são configuráveis em Definições → Analytics.

Para agências e operadores multiloja: o painel responde à pergunta que o marketing sempre faz — "A nossa promoção está realmente a correr?" — com dados, não intuição.

O separador dedicado Audit log é um diário completo de eventos — não um ficheiro de debug enterrado nos logs do servidor. Cada linha guarda carimbo de data/hora, tipo de evento, ator (nome do funcionário, nome do cliente ou SYSTEM), resumo legível, referência de encomenda ligada, código de desconto, valor, ID do carrinho e ID da política.

11 tipos de evento são acompanhados: discount_applied (sincronização de carrinho em tempo real), order_discount (encomenda colocada), policy_created, policy_updated, policy_deleted, policy_toggled, policy_duplicated, policy_imported, policy_exported, settings_updated e simulation_run. Cada evento regista a sua origem: front office, back office ou system.

Clique em View em qualquer linha para abrir um modal de detalhe com o instantâneo JSON completo — linhas de desconto aplicadas, diff de política, output de simulação ou payload de alteração de definições. Aplicações de desconto guardam discount_snapshot para reconstruir exatamente o que o cliente viu no checkout.

A lista suporta exportação CSV nativa PrestaShop para revisões financeiras e de conformidade. Colunas unidas mostram referência de encomenda, nome do cliente e nome do funcionário sem cruzamento manual. Quando um cliente pergunta "porque recebi este desconto?", a resposta está a uma pesquisa de distância.

Na página de encomenda no back office (hook displayAdminOrder), um painel mostra que políticas de Descontos condicionais de encomenda contribuíram para essa encomenda — nome da política, código de desconto, valor e instantâneo. A verdade histórica sobrevive mesmo que a política seja depois editada ou eliminada.

As políticas são documentos JSON portáteis. Export descarrega a política completa — árvore de condições, todas as regras, configs de promoção, estratégia de combinação, posições — pronta para controlo de versões ou entrega a outra loja. Import carrega um ficheiro JSON e cria uma nova política (ou atualiza, conforme o fluxo) com entrada no log policy_imported.

Duplicar clona uma política com um clique no menu de ações da lista — copia cada regra, renomeia com sufixo, regista policy_duplicated. Perfeito para criar "Black Friday v2" a partir de "Black Friday v1" sem reconstruir 15 regras manualmente.

Fluxo típico de agência: construir e simular em staging → exportar JSON → importar em produção → executar simulador novamente → ativar. Configurações de Black Friday movem-se entre lojas de clientes em minutos. Cada transferência é rastreável no log de auditoria.

O separador Settings centraliza o comportamento de toda a loja. Interruptor principal ativar/desativar. Global merge strategy por defeito para novas políticas. Global discount cap — desconto total máximo por carrinho em todas as políticas (0 = ilimitado). Alternar Free items as gift — materializar produtos grátis como linhas de oferta nativas PrestaShop vs desconto inline.

Disable auto-add impede a injeção automática de regras de carrinho quando quer controlo manual. Debug log escreve rastos verbosos do motor para suporte. A secção Analytics configura período de gráfico por defeito, janelas diárias/semanais/mensais e tipo de gráfico por defeito.

Cada gravação de definições regista settings_updated no log de auditoria com instantâneo antes/depois. Sem deriva silenciosa de configuração.

Os descontos materializam-se como regras de carrinho nativas PrestaShop com prefixo COD-*. Aparecem no resumo do carrinho, checkout, confirmação de encomenda, faturas e notas de crédito — exatamente como regras de carrinho criadas manualmente. Sem hacks de tema. Sem linhas de produto negativas falsas.

O motor liga-se a actionCartSave, adicionar/remover produto, init do front controller, validação de encomenda e validação de regra de carrinho — recalculando sempre que o contexto do carrinho muda. O estado do carrinho persiste em conorderdis_cart com instantâneo aplicado, instantâneo de oferta e ID de regra de carrinho ligado para sincronização idempotente.

As políticas são shop-scoped (id_shop) em configurações multiloja. Cada loja do seu grupo pode executar stacks promocionais independentes. PrestaShop 9.x, 8.x e 1.7.x partilham uma base de código via camada de compatibilidade integrada.

Etiquetas multilingues de checkout por regra (conorderdis_rule_lang) garantem que a linha de desconto se lê corretamente em cada idioma ativo da loja.