Carteira de Clientes no HoopCRM
A Carteira de Clientes permite que você gerencie créditos ou saldos disponíveis de seus clientes dentro do sistema. Você pode adicionar saldo, debitá-lo durante orçamentos ou vendas, e acompanhar todo o histórico de movimentações. Isso é útil para clientes com crédito em aberto, descontos pré-aprovados ou sistemas de cashback.
Neste artigo, você verá:
- O que é Carteira de Clientes
- Como ativar a função?
- Como adicionar saldo inicial do cliente
- Como usar o crédito no orçamento
- Como fica na venda
- Visualizando o histórico da Carteira
- O que acontece quando a venda é cancelada
- O que acontece quando a venda é excluída
O que é Carteira de Clientes
A Carteira de Clientes é um saldo em crédito vinculado a um cliente específico. Funciona como um "pré-pagamento" ou "conta corrente", você pode:
- Adicionar saldo manualmente (cliente depositou, ou você criou um crédito).
- Debitar saldo insira a quantidade de saldo que deseja usar durante orçamentos/vendas.
- Visualizar histórico de todas as movimentações.
- Acompanhar reembolsos automáticos quando vendas são canceladas.
Essa funcionalidade é especialmente útil para:
- Clientes com crédito pré-aprovado.
- Programas de fidelidade ou cashback.
- Clientes que deixaram saldo de vendas anteriores.
- Descontos ou cortesias já creditados.
Como ativar a função?
Para ativar, acesse Meu Perfil → Loja → Carteira de Comissões → Ative a opção "Ativar carteira de crédito do cliente".
|
|
|---|
Como adicionar saldo inicial do cliente
- Acesse Contatos → Clientes no menu principal.
- Selecione o cliente desejado.
- Localize o ícone azul de carteira e clique nele.

- Clique em "Adicionar Saldo".
- Preencha:
- Valor (ex: R$ 500,00)
- Descrição (opcional, ex: "Crédito pré-aprovado", "Devolução anterior")
- Clique em "Adicionar crédito".

O saldo será refletido imediatamente e aparecerá no histórico da carteira.
Como usar o crédito no orçamento
Ao montar um orçamento, você pode descontar automaticamente o saldo do cliente.
- Crie um novo orçamento normalmente em Negócios → Negócios em lista.
- Preencha os dados gerais e insira os produtos em seguida.
- Localize a seção "CRÉDITO CARTEIRA CLIENTE".

- Se o cliente tiver saldo, o sistema exibirá:
- Saldo disponível: R$ XXX
- Usar crédito: Você (vendedor) seleciona quanto o cliente irá usar do seu crédito.
- ✅ Usar o saldo total.
- ✅ Usar parte do saldo (indique o valor).
- ❌ Se não quiser usar saldo, não insira nada.
- O orçamento será criado com o desconto já aplicado.
💡 Exemplo prático:
- Saldo disponível do cliente: R$ 4.000
- Valor do orçamento: R$ 3.000
- Você opta por usar R$ 1.000 do saldo
- Orçamento final: R$ 2.000 (R$ 3.000 - R$ 1.000)
- Novo saldo da carteira: R$ 3.000 (R$ 4.000 - R$ 1.000)
⚠️ Importante: O saldo é debitado apenas quando o orçamento é transformado em venda. Enquanto estiver em status de orçamento, o saldo não é consumido.
Para mais detalhes de como criar orçamentos e gerar vendas, acesse nossos artigos, Como criar orçamentos e Gerar Pedido.
Como fica na venda
- Localize o orçamento que transformou em pedido de venda.
- Na tela de detalhes da venda, localize "Crédito carteira cliente".

Visualizando o histórico da Carteira
Ao acessar a Carteira de um cliente, você visualiza todo o histórico de movimentações.
- Acesse Contatos → Clientes e selecione o cliente.
- Clique novamente no ícone azul da carteira.

Colunas principais:
- Data: Quando a movimentação ocorreu.
- Tipo: Todos, Devolução, Crédito Manual, Uso em Venda, Estorno de Uso.
- Valor: Quanto foi adicionado ou debitado.
- Descrição: Quando você adiciona um saldo e insere uma descrição.
- Pedido/Negócio: Número do negócio para rastreabilidade.
💡 Dica: Você pode utilizar o FILTRO por período ou tipo de movimentação para análises rápidas.
O que acontece quando a venda é cancelada
Quando você cancela uma venda que utilizou saldo da carteira, o valor é automaticamente estornado para o cliente.
Passo a passo:
- Acesse a venda que deseja cancelar.
- Clique em "Cancelar Pedido".
- Confirme o cancelamento.
Efeitos:
- ✅ O saldo é reembolsado à carteira do cliente.
- ✅ Uma entrada de "Estorno de uso" aparece no histórico.
- ✅ O número do negócio fica registrado.
Exemplo:
- Cliente tinha: R$ 500 de saldo
- Venda de R$ 1.500 foi criada com R$ 300 de saldo debitado
- Saldo ficou: R$ 200
- Você cancela a venda
- Saldo volta a: R$ 500 (estorno de R$ 300)
- É exibido no histórico da carteira do cliente.
O que acontece quando a venda é excluída
Importante: Há uma diferença crítica entre cancelar e excluir uma venda.
Cenário 1: Venda é Cancelada (comportamento correto)
✅ Saldo é estornado
✅ Histórico é atualizado
✅ Rastreabilidade mantida
Cenário 2: Venda é Excluída (sem cancelar antes)
❌ Saldo NÃO é estornado
✅ Mas o histórico exibe que a venda foi excluída do sistema
Por quê essa diferença?
Excluir é uma ação permanente e não recomendada. Quando você exclui uma venda sem cancelá-la primeiro, o sistema:
- Remove a venda do banco de dados
- Não refaz o débito de saldo (para manter integridade)
- Registra no histórico
Exemplo:
- Cliente tinha: R$ 500
- Venda de R$ 1.500 foi criada com R$ 300 debitado
- Saldo ficou: R$ 200
- Você EXCLUI a venda (sem cancelar)
- Saldo permanece: R$ 200 (não estorna)
- Histórico mostra que a venda foi excluída do sistema.
⚠️ Aviso: Isso gera uma inconsistência. O cliente perde R$ 300 sem motivo visível. Por isso, sempre cancele antes de excluir.

Como evitar problemas:
- Se precisa desfazer uma venda: clique em "Cancelar Pedido" ao acessar o negócio em questão (não exclua).
- Se precisar realmente excluir, cancele primeiro, depois exclua.
- O histórico ficará transparente.
Fluxo Recomendado
Cliente com Saldo R$ 1.000
↓
Orçamento criado
↓
Transforma em Venda (debita R$ 300 de saldo)
↓
Venda gerada (Saldo: R$ 700)
↓
┌─────────────────────────────────┐
│ Precisa desfazer?
└─────────────────────────────────┘
↙ ↘
Cancelar Excluir
(certo) (errado)
↓ ↓
Estorna R$ 300 Não estorna
Saldo: R$ 1.000 Saldo: R$ 700
(inconsistência!)
Atualizado em: 19/08/2026
Obrigado!

