Visão geral
Cadastrar um cliente preenche a ficha que será usada em vendas, serviços, entregas e notas fiscais. O formulário tem 3 abas: Dados Gerais, Endereço e Observações.
Legenda: Aba Dados Gerais com identificação, dados tributários e contatos.
Quando utilizar
- Para adicionar um novo cliente à base
- Para atualizar informações de um cliente existente (trocar telefone, endereço, status, etc.)
- Para cadastrar cliente rápido durante uma venda/agendamento (versão simplificada)
Como fazer
1. Abrir o cadastro
Opção A - Lista de Clientes (completo):
- Em Clientes, clique em Novo cliente.
- Preencha as 3 abas e salve.
Opção B - Durante Venda/PDV/Agendamento (rápido):
- No seletor de cliente, clique no botão "+" ou "Novo cliente".
- Preencha apenas nome, e-mail e telefone.
- O cliente é salvo e já selecionado no fluxo atual.
Dica
> Use a Opção A para cadastros completos (com endereço, documentos, observações). Use a Opção B para agilizar no balcão/PDV e complete depois na lista de Clientes.
2. Aba "Dados Gerais"
#### Identificação
- Nome ou Razão Social (obrigatório) - nome que aparecerá em documentos e buscas.
- Status - Ativo / Inativo / Bloqueado. Padrão: Ativo.
#### Dados Tributários
Tipo de pessoa - escolha no início, muda os campos abaixo:
| Pessoa Física | Pessoa Jurídica |
|---|---|
| CPF (validado) | CNPJ (validado + consulta automática) |
| RG | Inscrição Estadual (com opção "Isento") |
| Data de nascimento | Nome Fantasia |
| Nome da mãe | Inscrição Municipal |
| Nome do pai | CRT: 1-Simples / 3-Normal / 4-MEI |
| Contribuinte: 1-ICMS / 2-Isento / 9-Não contribuinte |
Consulta CNPJ automática - ao sair do campo CNPJ (14 dígitos), o sistema busca na Receita Federal e preenche: razão social, nome fantasia, endereço, telefone, e-mail, regime tributário (CRT). Funciona só para PJ.
#### Contatos
- E-mail - validado; usado para notas fiscais, comunicações, login no marketplace.
- Celular (WhatsApp) - principal; usado para notificações, WhatsApp de aniversário, agendamentos.
- Telefone Fixo - opcional.
- Site - opcional; validado como URL.
#### Imagem do cliente
- Clique na área da foto para enviar imagem (PNG, JPG, WEBP até 5 MB).
- Recorte quadrado automático.
- Aparece no avatar da lista, detalhes e seleção em vendas/serviços.
3. Aba "Endereço"
#### Endereço Principal
- CEP - digite e o sistema preenche rua, bairro, cidade, UF (busca automática).
- Complete: Número (ou marque "S/N"), Complemento, Tipo (Casa, Apartamento, Comercial, Outro).
- Este endereço é usado como padrão em entregas e notas fiscais.
#### Endereço de Cobrança (opcional)
- Marque "Endereço de cobrança diferente" se a nota fiscal deve ir para outro endereço.
- Preencha os mesmos campos do endereço principal.
- Se desmarcar depois, o endereço de cobrança salvo é removido.
Importante
> Endereços são salvos em tabela separada. Um cliente pode ter múltiplos endereços cadastrados via API, mas o formulário mostra/edita apenas o principal e o de cobrança.
4. Aba "Observações"
- Campo livre para anotações internas.
- Exemplos: "Prefere atendimento pela manhã", "Alergia a látex", "Cliente VIP - dar prioridade", "Não ligar após 18h".
- Só sua equipe vê - não aparece para o cliente em nenhum canal.
5. Salvar
- Clique em Salvar (ou Salvar e continuar se estiver editando).
- Validações: nome obrigatório, CPF/CNPJ válidos e únicos, e-mail/telefone/CEP/URL válidos.
- Se houver erro, a aba com erro ganha indicador vermelho e o campo fica destacado.
Editando um cliente existente
- Na lista, clique em Editar (ícone de lápis) no card/linha do cliente.
- Ou no detalhe, clique em Editar cliente.
- Altere o que precisar - os mesmos campos e validações do cadastro.
- Salve.
Dica
> Ao editar, o sistema mostra o indicador de alterações não salvas. Se sair sem salvar, pergunta se deseja descartar.
Pessoa Física vs Pessoa Jurídica - resumo prático
| Situação | Use |
|---|---|
| Consumidor final, autônomo sem CNPJ | Pessoa Física (CPF + RG) |
| Empresa, MEI, loja, prestador com CNPJ | Pessoa Jurídica (CNPJ + IE + CRT) |
| Estrangeiro sem CPF/CNPJ brasileiro | Selecione PJ e deixe CNPJ vazio (campo "foreign" interno) |
Dicas importantes
- CPF/CNPJ único - não cadastra duplicado. Se avisar "já existe", busque o cliente existente e edite.
- Consulta CNPJ - funciona só para PJ com CNPJ válido de 14 dígitos. Se não encontrar, preencha manualmente.
- Data de nascimento - habilita automações de aniversário (cupom, WhatsApp, notificação) no plano Crescer.
- E-mail - se o cliente for comprar no marketplace, use o mesmo e-mail da conta dele.
- Observações - use para contextualizar a equipe; evite dados sensíveis (LGPD).
Problemas comuns
| Problema | Causa provável | Solução |
|---|---|---|
| "CPF inválido" | Dígitos verificadores errados | Confira o CPF; use só números ou formato 000.000.000-00 |
| "CNPJ não encontrado" | CNPJ inexistente ou Receita indisponível | Preencha manualmente; tente novamente depois |
| "Já existe cliente com este CPF/CNPJ" | Duplicata real | Busque o cliente existente e edite |
| "CEP não encontrado" | CEP novo ou digitado errado | Confira no site dos Correios; preencha manualmente |
| Imagem não carrega | Arquivo > 5 MB ou formato não suportado | Use PNG/JPG/WEBP até 5 MB |
Perguntas frequentes
Posso cadastrar cliente sem CPF/CNPJ?
Sim, mas não recomendado. Sem documento, não emite nota fiscal e o sistema não impede duplicatas por nome.
Como mudo o endereço principal?
Edite o cliente, vá na aba Endereço, altere o CEP e campos, salve.
O endereço de cobrança aparece na nota fiscal?
Sim, se preenchido e marcado como diferente. Caso contrário, usa o endereço principal.
Consigo ver quem editou o cliente por último?
Não há log de alterações visível na interface. Para auditoria, contate o suporte.
Posso cadastrar vários telefones/e-mails?
O formulário tem 1 e-mail, 1 celular e 1 fixo. Para mais contatos, use Observações ou cadastre como clientes separados (ex: "Empresa X - Compras", "Empresa X - Financeiro").
A imagem do cliente aparece no PDV?
Sim, no seletor de cliente do PDV e na tela de venda.