> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://hoopdecor.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](#4-o-que-e-carteira-de-clientes)
* [Como ativar a função?](#3-como-ativar-a-funcao)
* [Como adicionar saldo inicial do cliente](#4-como-adicionar-saldo-inicial-do-cliente)
* [Como usar o crédito no orçamento](#4-como-usar-o-saldo-no-orcamento)
* [Como fica na venda](#4-como-usar-o-saldo-na-venda)
* [Visualizando o histórico da Carteira](#4-visualizando-o-historico-da-carteira)
* [O que acontece quando a venda é cancelada](#4-o-que-acontece-quando-a-venda-e-cancelada)
* [O que acontece quando a venda é excluída](#4-o-que-acontece-quando-a-venda-e-excluida)

#### 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".

| ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot1_1gpbvyq.png =217xauto) | ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_ia11zx.gif) |
| ---- |

#### Como adicionar saldo inicial do cliente
1. Acesse **Contatos** → **Clientes** no menu principal.
2. Selecione o cliente desejado.
3. Localize o ícone azul de carteira e clique nele.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot1_h85you.png =862xauto)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_1figun8.gif =599xauto)

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.
1. Crie um novo orçamento normalmente em **Negócios** → **Negócios em lista**.
2. Preencha os dados gerais e insira os produtos em seguida.
3. Localize a seção **"CRÉDITO CARTEIRA CLIENTE**".

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot3_og9dcj.png =830xauto)

4. 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.
5. 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](https://hoopdecor.crisp.help/pt-br/article/como-criar-um-orcamento-no-hoopcrm-40p3qm/) e [Gerar Pedido](https://hoopdecor.crisp.help/pt-br/article/gerar-pedido-no-hoopcrm-1d4d4i4/).

#### Como fica na venda
1. Localize o orçamento que transformou em pedido de venda.
2. Na tela de detalhes da venda, localize **"Crédito carteira cliente"**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot4_1nw86zy.png =856xauto)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot5_hh5lra.png =832xauto)

**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:
1. Acesse a venda que deseja cancelar.
2. Clique em **"Cancelar Pedido"**.
3. 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:
1. Remove a venda do banco de dados
2. **Não refaz** o débito de saldo (para manter integridade)
3. 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**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot6_23zffv.png =868xauto)

##### Como evitar problemas:
1. **Se precisa desfazer uma venda:** clique em **"Cancelar Pedido"** ao acessar o negócio em questão (não exclua).
2. Se precisar realmente excluir, **cancele primeiro**, depois exclua.
3. 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!)
```