Lançamento / Resgate de Pontos¶
Movimentações > Lançamento / Resgate de Pontos
O que é¶
O módulo de Lançamento e Resgate de Pontos é o coração do programa de fidelidade do Master Key. Ele permite registrar manualmente pontuações para clientes — seja creditando pontos decorrentes de compras, promoções ou correções manuais, seja processando o resgate de pontos acumulados em troca de produtos.
A pontuação no sistema é gerenciada pela tabela PONTUACAO, que registra cada movimentação com um tipo específico: P (Pontuação Recebida), R (Pontuação Resgatada), E (Pontuação Expirada) e D (Pontuação Devolvida). O saldo disponível para resgate é calculado em tempo real e atualizado pela procedure ATUALIZA_SALDOPONTUACAO a cada gravação ou exclusão.
Quando o cliente resgata pontos, ele escolhe produtos cadastrados com custo em pontos (campo PR_PONTOSRESGATE). O sistema valida que o saldo disponível é suficiente, gera os itens de resgate e, se configurado, emite uma Nota Fiscal de saída para formalizar a entrega dos brindes ou produtos resgatados.
Como acessar¶
No menu principal, clique em Movimentações → Lançamento / Resgate de Pontos.
Onde impacta o sistema¶
- Tabela PONTUACAO (PT_): cada linha representa uma movimentação de pontos — crédito, resgate, expiração ou devolução.
- Tabela RESGATE_PROD / dataset de resgate (RP_): itens de produto vinculados ao registro de resgate.
- Tabela CLIENTES (CL_): o saldo de pontos é associado ao código do cliente.
- Tabela PRODUTOS (PR_): somente produtos com
PR_PONTOSRESGATE > 0e ativos podem ser resgatados. - Tabela VENDAS / VENDITEM: quando o resgate gera Nota Fiscal, cria registros de venda.
Como lançar ou resgatar pontos¶
Lançamento manual de pontos (crédito)¶
- Clique em Novo (
Alt+N). O sistema inicia um novo registro com o tipo padrão Resgate (R). Para lançar pontuação, altere o Tipo para Pontuação. - Informe o código do Cliente e pressione Tab para validar. Use
F3para pesquisar pelo nome. - Preencha o campo Data.
- Informe o número do Documento de referência (opcional — ex.: número da nota de compra).
- Informe o número de Pontos a creditar.
- Preencha a Descrição do lançamento para identificar a origem dos pontos.
- Clique em Gravar (
Alt+G). O sistema atualiza automaticamente o saldo do cliente.
Resgate de pontos por produto¶
- Clique em Novo (
Alt+N). O tipo Resgate já é selecionado automaticamente. - Informe o código do Cliente e pressione Tab. O campo Total Disponível para Resgate exibirá o saldo atual do cliente.
- Preencha o campo Data.
- Na seção Resgate de Pontos, informe a Quantidade do item a ser resgatado.
- Informe o código do Produto a ser resgatado (deve ter custo em pontos cadastrado). Use
F3para pesquisar apenas produtos elegíveis para o saldo disponível. - Clique em Adicionar para incluir o produto na lista de resgate. O campo Total Disponível é atualizado a cada adição.
- Repita os passos 4–6 para adicionar mais produtos, enquanto houver saldo suficiente.
- Clique em Gravar (
Alt+G). O sistema distribui os pontos resgatados entre os lançamentos de pontuação disponíveis (DistribuiSaldoPontuacao). - Se configurado, clique em Gerar NF para emitir a Nota Fiscal dos produtos resgatados.
Campos desta tela¶
| Campo | O que é | Observações |
|---|---|---|
| Sequencial | Número sequencial do registro | Gerado automaticamente |
| Cliente | Código do cliente | Pesquisável via F3; aceita apenas clientes do tipo C ou A |
| Nome do Cliente | Nome do cliente | Preenchido automaticamente após validação |
| Data | Data da movimentação | Obrigatório |
| Tipo | Tipo da movimentação | P = Pontuação Recebida, R = Resgatada, E = Expirada, D = Devolvida |
| Pontos | Quantidade de pontos da movimentação | Para tipo P: crédito; para tipo R: débito |
| Saldo | Saldo de pontos deste lançamento | Calculado automaticamente |
| Documento | Número do documento de referência | Ex.: número da NF de compra |
| Recibo | Número do recibo | Referência interna |
| Controle | Número de controle da venda associada | Preenchido automaticamente em pontações geradas por venda |
| Descrição | Texto descritivo da movimentação | Ex.: "Resgate", "Aniversário", "Promoção" |
| Produto (resgate) | Código do produto a ser resgatado | Somente produtos com custo em pontos e ativos |
| Qtde (resgate) | Quantidade do produto a resgatar | Mínimo: 1 |
| Total Disponível para Resgate | Saldo total de pontos disponíveis do cliente | Atualizado em tempo real |
| Pontuação Total (grid) | Soma dos pontos consumidos pelos itens do resgate | Calculado automaticamente |
Regras e comportamentos do sistema¶
- Tipo Expirado/Devolvido: não é possível inserir registros com esses tipos manualmente. Se tentado, o sistema exibe: "Não é possível inserir registros de expiração/devolução!" e força o tipo para Resgate.
- Exclusão de pontuação expirada: "Impossível excluir pontuação do tipo Expirada!"
- Exclusão com saldo diferente dos pontos: para lançamentos do tipo Pontuação (P), só é possível excluir se o saldo for igual à quantidade de pontos. Caso contrário: "Impossível excluir Pontuação quando a quantidade de pontos for diferente do Saldo!"
- Exclusão de resgate/devolução: ao excluir um resgate ou devolução, o sistema redistribui automaticamente o saldo nos lançamentos de pontuação originais (
RedistribuiSaldoPontuacao). - Saldo insuficiente: ao tentar gravar um resgate sem pontos suficientes, o sistema exibe: "Sem saldo de pontos suficiente para o resgate!"
- Produto inelegível para resgate: produtos inativos, do tipo serviço ou sem custo em pontos cadastrado não aparecem na pesquisa e geram: "Produto Inexistente/Inativo ou não pode ser resgatado! Verifique."
- Excluir da lista de resgate: é possível remover um item da lista de resgate clicando no ícone de exclusão na última coluna do grid. O sistema pede confirmação.
- Limite de itens por nota: se configurado o parâmetro de itens máximos por NF, ao exceder o limite o sistema avisa: "Atingiu Limite de Itens por Nota".
- Série padrão: a geração de NF exige série padrão configurada. Sem ela: "Serie Padrão para Vendas não Informada. Verifique!"
- Caixa aberto: a geração de NF requer o caixa aberto. Caso contrário: "O Caixa não está aberto!"
- Dados adicionais da NF: se os dados adicionais (CFOP, data de saída etc.) não forem preenchidos antes de gerar a NF, o sistema solicita: "Falta informar os dados adicionais para Geração da NF!"
- Código de cliente inválido: "Código não Cadastrado"
- Legenda de cores na barra de status: cada tipo de movimentação possui cor distinta — cinza (Recebida), azul-petróleo (Resgatada), vermelho (Expirada), verde-claro (Devolvida).
Dúvidas frequentes¶
Como sei o saldo atual de pontos de um cliente? Ao selecionar o cliente em um novo registro de resgate, o campo Total Disponível para Resgate mostra imediatamente o saldo atual. É possível também consultar o histórico completo de movimentações na aba de consulta, filtrando pelo nome ou código do cliente.
Posso estornar um resgate já gravado?
Sim. Localize o registro de resgate na lista de consulta, abra-o e utilize o botão Excluir (Alt+E). O sistema redistribuirá os pontos de volta aos lançamentos originais de pontuação. Registros do tipo Expirado não podem ser excluídos.
Os pontos gerados nas vendas são lançados automaticamente aqui? Os pontos gerados pelo processo de venda são inseridos diretamente na tabela PONTUACAO com o controle da nota. Este módulo serve para consulta e para lançamentos/resgates manuais que não foram originados por uma venda.
Quais produtos podem ser resgatados?
Somente produtos ativos, não-serviços e com o campo custo em pontos (PR_PONTOSRESGATE) maior que zero. A pesquisa via F3 filtra automaticamente apenas os elegíveis dentro do saldo disponível do cliente na quantidade informada.
O que acontece quando o resgate gera NF? O sistema cria um registro de venda (VENDAS/VENDITEM) com os produtos resgatados, aplicando o CFOP padrão configurado nos Parâmetros e ajustando o CFOP para operações interestaduais quando necessário. Ao final, exibe: "Foram geradas as Notas Fiscais de CONTROLE [número]".