Introdução
A rotina R1240 – Central de Promoções tem por objetivo permitir o cadastro, edição, exclusão e visualização de cupons promocionais (vouchers de desconto) que podem ser aplicados em vendas no sistema.
Trata-se de uma interface administrativa para o controle de promoções comerciais, com filtros e uma grade principal que exibe as promoções cadastradas.
Atenção: A aplicação de cupons descrita nesta rotina está disponível exclusivamente na R11 (Fast Checkout). Não é compatível com a R419 ou outras rotinas de pagamento.
Descrição
Facilitar a gestão de vouchers promocionais, permitindo:
Criação de campanhas promocionais.
Definição de períodos de validade dos cupons.
Controle do status ativo/inativo.
Consulta rápida por código, nome ou filtros de data.
Tela Principal
A tela exibe uma grade de promoções e possui filtros de busca no topo da interface. Abaixo da grade estão os botões de ação.
Ações disponíveis
Novo: abre o formulário para cadastro de nova promoção.
Alterar: permite editar os dados de uma promoção existente.
Excluir: remove a promoção selecionada.
Exibir: permite visualizar os dados da promoção em modo de leitura (sem edição).
Campos da Grade Principal
Campo | Descrição |
|---|---|
Cód | Código identificador único da promoção. |
NomePromoção | Nome descritivo da promoção. |
TipoAplicacaoCupom | Tipo de aplicação do cupom (ex: por valor, percentual, por produto etc.). |
Cod. Cupom | Código do cupom que será inserido no momento da venda. |
DataCadastro | Data e hora de criação da promoção (formato DD/MM/AA hh:mm:ss). |
DataInicio | Data e hora de início da validade do cupom (formato DD/MM/AA hh:mm:ss). |
DataVencimento | Data e hora de término da validade (formato DD/MM/AA hh:mm:ss). |
Ativo | Indica se a promoção está ativa ( Sim / Não). |
Configurações
Para usar a rotina e cadastrar uma nova promoção, o usuário tem que ter acesso à rotina e seus direitos, que podem ser liberados pelas rotinas [R697 - Liberação de Rotina por Usuário] e [R696 - Liberação de Rotina por Grupo de Usuário].
Para poder usar as promoções da [R1240 - Central de Promoções] na [R11 - Fast Chekcup], também é necessário ativar o parâmetro por estabelecimento [P1403 - Valida Cupons de Desconto pela Central de Promoções?], que pode ser configurado pela rotina [R33 - Parâmetros por Estabelecimento].
Fluxo de Utilização
Cadastro de Promoções
As promoções devem ser previamente cadastradas e ativadas na rotina [R1240 - Central de Promoções].
É possível definir regras como: visibilidade do cupom, período de validade, itens ou categorias participantes (grupo, família, linha, marca, estabelecimento, ou lista de itens).
Tipos de aplicação
Durante o fechamento ou geração de uma O.S., na tela de pagamentos da O.S, o usuário poderá aplicar cupons de duas maneiras:
Ao preencher o campo "Cupom" com um código de cupom válido, e sair do campo, o cupom é aplicado automaticamente:
Ao clicar no botão "Cupom", o sistema analisa automaticamente os itens da cotação e identifica todos os cupons cadastrados na R1240 que atendem aos critérios definidos. Em seguida, é exibido um modal com a lista de cupons disponíveis. Nesse modal, o usuário pode selecionar múltiplos cupons simultaneamente e aplicá-los de uma só vez clicando no botão "Aplicar Cupons" :
Modal de Seleção de Cupom
Os cupons do modal vem com as seguintes informações:
Código do cupom
Valor do desconto
Tipo do desconto (percentual ou valor fixo)
Ao abrir, o modal lista todos os cupons visíveis ao vendedor que podem ser aplicados na cotação.
Seleção visual: quando um cupom é selecionado, ele fica destacado com uma cor levemente mais escura, indicando que está marcado para aplicação.
Cupons manuais: se um cupom for digitado manualmente, ele também passa a ser exibido no modal, mas com uma indicação especial que identifica sua origem como "aplicado manualmente".
Para remover um cupom já selecionado, basta desmarcá-lo no modal e clicar novamente em "Aplicar Cupons". O desconto será recalculado automaticamente.
Aplicação Automática do Desconto
- É possível aplicar mais de um cupom por cotação.
Caso um item seja elegível para mais de um cupom, o sistema aplica aquele que resultar no menor preço final para o item.
- Se um cupom aplicado for totalmente substituído por outro mais vantajoso para todos os itens, ele é automaticamente desvinculado da cotação para evitar o consumo indevido.
- O desconto é aplicado imediatamente nos itens correspondentes, e a cotação reflete o novo valor.
Antes da aplicação:
Depois, utilizando o cupom de 25 %:
Regras de Aplicação
- Quantidade de cupons: múltiplos cupons podem ser aplicados na mesma cotação, desde que cada um seja válido para pelo menos um item.
- Seleção automática: ao selecionar múltiplos cupons no modal, o sistema aplica automaticamente o mais vantajoso para cada item, considerando o desconto efetivo.
- Validação de itens: descontos são aplicados apenas em itens que atendam às regras da promoção.
- Persistência visual: todos os cupons válidos permanecem listados no modal para consulta, mesmo após a aplicação, incluindo os digitados manualmente.
Especificações Técnicas
Esta seção é voltada para usuários com perfil técnico e descreve detalhes internos da implementação da R1240:
Os campos
PrecoUnitarioePrecoTabelados itens da O.S. são atualizados com base no valor do cupom.Caso o valor total da O.S. não seja recalculado automaticamente, a recomendação é sair e retornar à tela de pagamento.