← Anterior: [Categorias, ABC e Etiquetas](https://iurru.com/manual/Catalogo-apoio) · [Manual](https://iurru.com/manual/) · Próxima: [Fornecedores](https://iurru.com/manual/Fornecedores)

# Clientes

**Menu:** Clientes

## O que é um cliente, aqui

Um "cliente" no sistema não é só um nome pra colar numa venda — é a
**identidade que amarra tudo o que essa pessoa ou empresa faz na loja**:

- toda venda vinculada a ele entra no **histórico de compras**;
- fiado vira **saldo devedor** e **notas com vencimento**, cobradas e
  rastreadas por cliente;
- veículos cadastrados alimentam a Oficina e a busca por placa no PDV;
- compras acumulam **pontos de fidelidade**, que viram desconto (cashback)
  em compras futuras;
- descontos e prazos de pagamento **padrão** (definidos aqui, uma vez)
  aplicam sozinhos em toda venda nova pro mesmo cliente, sem o vendedor
  precisar lembrar a condição comercial combinada com ele.

Ou seja: cadastrar um cliente é o que transforma "uma venda avulsa" em
"histórico de relacionamento" — sem cliente vinculado, a venda existe mas
fica solta, sem crédito, sem pontos, sem consulta por nome depois.

**Quem pode ver o quê:** a ficha completa (histórico de compras e notas de
fiado) só é visível pra financeiro, administrador e desenvolvedor — vendedor,
caixa e estoquista cadastram e editam o cliente normalmente, mas não veem o
que ele já comprou nem o detalhe da dívida dele. Ver
[Usuários e permissões](https://iurru.com/manual/Usuarios-e-permissoes#papéis) pra entender por quê.

---

## Cadastrar

1. Clique em **Novo cliente**.
2. Preencha os campos.
3. **Salvar**.

Para editar, selecione o cliente na lista à esquerda — há busca por nome e
filtro por tipo. A ficha abre em **abas**, cada uma cobrindo uma parte
diferente do relacionamento com esse cliente:

| Aba | O que mostra |
| --- | --- |
| **Dados** | O cadastro em si — os campos abaixo |
| **Histórico** | Toda venda já feita pra esse cliente, concluída ou estornada (só financeiro+) |
| **Notas** | O que ele deve em fiado, nota por nota, com vencimento (só financeiro+) |
| **Veículos** | Placas cadastradas — alimenta a Oficina e a busca por veículo no PDV |
| **Fidelidade** | Pontos, cashback e histórico do programa de fidelidade, se ativo |

Histórico e Notas ficam atrás de permissão porque são informação financeira
sensível (quanto o cliente compra, quanto deve) — um vendedor comum edita o
cadastro (telefone, endereço, veículo) sem enxergar essa parte. Ver
[Usuários e permissões](https://iurru.com/manual/Usuarios-e-permissoes#papéis).

### Campos

| Campo | Pra que serve |
| --- | --- |
| **Tipo de cliente** | Pessoa física, Pessoa jurídica, Oficina parceira ou Distribuidor — só classificação/filtro, não muda regra nenhuma de preço ou desconto sozinho (isso é o campo **Tabela de preço**, separado) |
| **Nome / exibição** | O nome que aparece na busca de cliente do PDV — capriche, é por ele que o vendedor vai achar o cliente rápido |
| **CPF / CNPJ** | Único no sistema — não aceita duplicado. Usado pra identificar o cliente sem ambiguidade (dois "João Silva" diferentes) |
| **Razão social**, **Nome fantasia**, **Inscrição estadual** | Dados fiscais de pessoa jurídica — preenchimento livre, o sistema não obriga nem valida contra o Tipo de cliente escolhido |
| **Telefone**, **E-mail** | Contato — usados também no cadastro de notas fiscais quando o módulo de NF-e está ativo |
| **Endereço** e **Endereço de entrega** | Podem ser diferentes — útil pra oficina que fatura num endereço e recebe peça noutro |
| **Contato (nome)** e **Cargo** | Pra empresas — quem especificamente atende do outro lado, quando o cliente é uma pessoa jurídica com vários funcionários |
| **Tabela de preço** | Varejo, Atacado, Especial ou Oficina — define **qual preço de venda** esse cliente paga; aplicada automaticamente ao vincular o cliente numa venda do PDV, sem o vendedor escolher manualmente |
| **Desconto padrão (%)** | Desconto que já vem sugerido em toda venda nova desse cliente — o vendedor ainda pode ajustar na hora, isso só evita ter que lembrar/negociar de novo toda vez |
| **Prazo de pagamento padrão (dias)** | Condição comercial de referência (informativa) — não é o mesmo mecanismo do vencimento das notas de fiado (ver aba **Notas**, mais abaixo), que é definido linha a linha na hora da venda |
| **Limite de crédito** | Teto do fiado — a venda a prazo é **recusada** se `saldo devedor atual + valor da nova venda` passar desse número. Ver [PDV — fiado](https://iurru.com/manual/PDV#fiado) |
| **Saldo em aberto** | Quanto o cliente deve hoje, somando todo fiado ainda não pago. **Não edite à mão** no dia a dia — o sistema atualiza sozinho a cada venda fiada e a cada recebimento; o campo só é editável aqui pra ajuste pontual (ex.: importar o saldo inicial de outro sistema) |
| **Prazo de cobrança (dias)** | Quantos dias depois da venda o sistema considera razoável cobrar, informativo |
| **Observações** | Texto livre — anotações internas sobre o cliente (combinados, histórico de conversa, restrições). Não confundir com as **Notas** de fiado, que são as contas a receber dele, não anotações de texto |

**Excluir** é permanente e o sistema pede confirmação ("Excluir este cliente
permanentemente?"). Diferente de [Usuários](https://iurru.com/manual/Usuarios-e-permissoes), clientes
não têm um estado "inativo" — é cadastrado ou excluído, sem meio-termo. Se o
cliente tem histórico de compras, pense duas vezes antes de excluir.

---

## Veículos do cliente

Painel **Veículos do cliente**: **placa, marca, modelo, ano** e observações.
Um cliente pode ter **vários veículos** cadastrados (ex.: oficina com frota,
ou cliente com carro e moto) — não é um campo único no cadastro, é uma lista
própria dentro da ficha.

**Pra que serve, na prática:**
- [Oficina](https://iurru.com/manual/Oficina): ao abrir uma OS pra esse cliente, o veículo já vem
  pronto pra escolher, sem digitar de novo placa/modelo;
- Consulta por placa no balcão: o vendedor digita a placa e já acha o
  cliente dono dela, mesmo sem lembrar o nome;
- Filtro de compatibilidade no PDV: com um veículo selecionado, a busca de
  produto pode filtrar só o que é compatível com aquele carro/moto.

---

## Histórico de compras

Painel **Histórico de compras**, dentro da ficha do cliente — só visível pra
quem tem permissão `clients.view_credit` (financeiro, administrador ou
desenvolvedor; ver [Quem pode ver o quê](#quem-pode-vê-o-quê)). Um vendedor
comum atende o cliente no PDV normalmente, mas não abre esse painel.

Lista **todas** as vendas já feitas pra esse cliente: **data, itens, forma de
pagamento e total**, mais recente primeiro. Vendas estornadas aparecem
**riscadas**, mas continuam na lista — nada some do histórico, só fica
marcado como cancelado.

Clicando em **Detalhe** abre a compra completa — produtos, quantidades, valor
unitário, subtotal, formas de pagamento usadas (inclusive se foi
[fiado](#notas), parcelado ou não) e a situação atual dela.

### Editar uma compra já fechada
Com permissão, é possível corrigir a compra depois de fechada (inclusive
**remover item**) — o caminho pra "digitei a quantidade errada ontem" sem
precisar estornar a venda inteira. O sistema ajusta sozinho, na mesma
operação:

- o **estoque** dos itens alterados (devolve ou desconta a diferença);
- o **saldo devedor** do cliente, quando a venda tinha fiado — editar o valor
  de uma venda fiada recalcula quanto o cliente ainda deve;
- se a venda tinha [nota de fiado](#notas) associada, a nota é recalculada
  junto — não fica desalinhada do valor novo da venda.

### Pra que serve, além de "ver o passado"
- Decidir **limite de crédito** e forma de cobrar um cliente recorrente —
  histórico de compras grande e pontual (sem atraso) é argumento pra abrir
  mais crédito; ver [Fidelidade](#fidelidade-do-cliente) também entra nessa
  conta;
- Conferir uma reclamação ("comprei isso e não é bem o que eu pedi") sem
  precisar vasculhar o [PDV](https://iurru.com/manual/PDV) por data;
- Auditoria interna — todo ajuste em venda fica registrado, então dá pra ver
  não só o que foi vendido, mas o que foi **corrigido depois**.

---

## Notas

Aba **Notas**: lista as contas a receber do cliente que ainda estão **em
aberto ou parciais** — a nota some da lista assim que é quitada, não fica
marcada como "paga" ali.

### De onde vêm as notas

Não existe cadastro manual nesta aba — a lista é o reflexo automático do
fiado fechado no [PDV](https://iurru.com/manual/PDV#fiado). Toda venda paga com **Fiado** gera, na
hora do fechamento, um lançamento a receber (a mesma tabela que o módulo
[Financeiro](https://iurru.com/manual/Financeiro) usa para todo "a receber" da empresa, não uma
estrutura própria de Clientes) — a aba Notas apenas filtra e mostra os
lançamentos daquele cliente específico.

### Uma linha por parcela, não por venda

- Venda fiada **sem parcelamento** → vira **uma nota única**, vencendo na
  data da venda — uma linha na lista.
- Venda fiada **parcelada** (campos **Parcelas** / **Vencimento** no PDV, ver
  [PDV — fiado](https://iurru.com/manual/PDV#fiado)) → **cada parcela é uma linha separada**, com o
  seu próprio vencimento. A lista **não agrupa as parcelas de volta numa
  nota só por venda**: uma venda de R$ 300 fechada em 3× aparece como
  **três linhas** de R$ 100, todas com o mesmo número de venda e
  identificadas por `(1/3)`, `(2/3)`, `(3/3)` ao lado dele. Pagar a 1ª
  parcela quita só ela — a 2ª e a 3ª continuam na lista, em aberto, até
  vencerem e serem pagas cada uma na sua vez.

Nota vencida aparece **em vermelho**; nota prestes a vencer (poucos dias)
aparece em destaque também.

### Receber fiado

| Ação | Efeito |
| --- | --- |
| **Pagar** (numa nota da lista) | Quita **só aquela nota/parcela**, no valor exato dela — parcela não aceita pagamento parcial |
| **Receber saldo geral** | Abate do saldo devedor total, das contas mais antigas primeiro — aceita valor parcial |

Forma de pagamento: dinheiro, débito, crédito ou PIX.

**Moeda:** escolha a moeda em que o cliente está pagando (ex.: guarani). Em
moeda estrangeira aparece o campo **Cotação**, no mesmo sentido do cadastro
(ex.: ₲ por R$ 1 para o guarani, R$ por US$ 1 para o dólar), já preenchido com
a cotação do dia cadastrada em
[Config. da empresa](https://iurru.com/manual/Compras-e-NF#moeda-padrão-e-câmbio) e editável.
**Quitar tudo** em moeda estrangeira quita exatamente o saldo em reais; o
valor na moeda é o que aparece no campo. O valor é digitado na moeda recebida e o
sistema mostra o equivalente em reais, que é o que abate a dívida. No **Pagar**
de uma nota, o valor em reais é o da nota e aparece quanto receber na moeda
escolhida. Moeda e cotação ficam registradas no pagamento e no caixa.

**Estornar um pagamento já feito** (nota que já foi quitada e por isso não
aparece mais aqui) **não fica nesta aba** — é em
[Financeiro → Estornar parcela paga](https://iurru.com/manual/Financeiro#estornar-parcela-paga): abra
o lançamento parcelado correspondente e estorne a parcela específica de lá. O
estorno devolve o valor pro saldo devedor do cliente e a nota volta a
aparecer aqui, em aberto.

### O que o sistema garante

- O valor **nunca pode ser maior que o saldo devedor** do cliente — nem maior
  que o saldo da nota escolhida.
- O recebimento **entra no caixa do dia** como movimento de recebimento de
  fiado → [Caixa](https://iurru.com/manual/Caixa).
- **Sem caixa aberto o recebimento não é bloqueado**: a dívida é do cliente, não
  da sessão. O pagamento fica registrado, apenas sem movimento de caixa.

O saldo em aberto do cliente é atualizado na hora, liberando limite para novas
compras a prazo. Também aparece consolidado, junto de outros clientes em
atraso, em [Financeiro → Clientes em atraso](https://iurru.com/manual/Financeiro#clientes-em-atraso).

---

## Fidelidade do cliente

### O que é, em resumo

Programa de pontos: **toda venda concluída pra esse cliente vira pontos**
(quando a fidelidade está ativa, tanto no sistema todo quanto pra esse
cliente específico). Pontos sozinhos não valem nada numa venda — primeiro
precisam ser **resgatados**, virando **saldo de cashback** (um valor em
R$), que aí sim pode ser usado como desconto numa compra futura.

**A fórmula exata**, com o padrão de fábrica (1 ponto por R$1,00, R$0,01 por
ponto no resgate):

```
Pontos ganhos = total líquido da venda (já com desconto) × pontos por real, arredondado pra baixo
Cashback do resgate = pontos resgatados × valor por ponto, arredondado a centavos
```

Exemplo: venda de R$300 líquidos → 300 pontos. Resgatando os 300, viram
R$3,00 de cashback (1% de retorno, no padrão de fábrica — a loja pode
configurar um retorno maior). Ver a fórmula completa, com todos os campos de
configuração, em [Fidelidade e alertas](https://iurru.com/manual/Fidelidade-e-alertas#fidelidade).

### O painel

Disponível quando o programa está habilitado para o cliente:

- **Pontos** acumulados e **cashback disponível** (dois saldos separados —
  ver acima);
- **Resgatar pontos** — converte pontos em saldo de cashback (não é desconto
  direto na hora; o cashback gerado é usado numa venda depois, no PDV);
- **Ajuste manual** — corrige o saldo de pontos à mão, com motivo escrito.
  Só quem administra usuários pode fazer isso;
- **Histórico (últimas 30)** movimentações, classificadas em **Ganho**
  (venda concluída), **Resgate** (converteu pontos em cashback, ou gastou
  cashback numa venda), **Ajuste** (manual) e **Expirado** (saldo de pontos
  zerado por inatividade — ver regra completa no link abaixo);
- botões **Ativar / Desativar** a fidelidade **só para este cliente** — não
  mexe no programa dos outros clientes nem apaga o saldo dele, só pausa
  ganhar/resgatar/usar cashback enquanto desativado.

Quando o programa não está habilitado (nem geral, nem pra esse cliente), o
painel informa "Fidelidade não habilitada para este cliente."

As regras completas — cada campo de configuração, a regra exata de
expiração, quem pode fazer ajuste manual — ficam em
[Fidelidade e alertas](https://iurru.com/manual/Fidelidade-e-alertas#fidelidade).

---

## Relacionado

- [PDV — fiado](https://iurru.com/manual/PDV#fiado) — como a venda a prazo é validada
- [Oficina](https://iurru.com/manual/Oficina) — OS vinculada ao cliente e ao veículo

---

← Anterior: [Categorias, ABC e Etiquetas](https://iurru.com/manual/Catalogo-apoio) · [Manual](https://iurru.com/manual/) · Próxima: [Fornecedores](https://iurru.com/manual/Fornecedores)
