Por que existe
Cadastrar um cliente aqui evita ter que digitar CPF/CNPJ, razão social e endereço toda vez que uma nota fiscal for emitida: na tela de emissão (Notas Fiscais), basta escolher o cliente da lista.
01
Listagem
- Razão social
- Nome da empresa ou nome completo da pessoa cliente.
- CPF/CNPJ
- Documento do cliente, já formatado com pontuação.
- E-mail / Cidade-UF
- Dados de contato e localização, quando preenchidos (mostram “-” se vazios).
- Status
- Selo “Ativo” ou “Inativo”.
A busca (“Buscar por razão social ou CPF/CNPJ...”) é automática assim que o usuário para de digitar — não existe botão de busca separado. Não há filtro visual por status: a lista sempre traz ativos e inativos juntos, diferenciados pelo selo.
Abre o formulário em branco para cadastrar.
Abre o formulário preenchido com os dados daquele cliente.
Alterna o cliente entre ativo e inativo. Não apaga nada — um cliente inativo continua existindo no cadastro, só deixa de aparecer como opção nas telas de emissão de nota.
Apaga o cadastro definitivamente e sem volta. Pede confirmação antes.
Desativar × Excluir — não são a mesma coisa
- Desativar é reversível — o cliente continua no cadastro e no histórico, só some das opções de nova nota.
- Excluir é definitivo. Se o cliente já foi usado em ao menos uma nota fiscal emitida, a exclusão falha — o sistema recusa para não quebrar o histórico das notas já emitidas. Nesse caso, use “Desativar”.
02
Novo cliente / Editar cliente
Dados gerais
- * CPF/CNPJ
- Só aceita números, até 14 dígitos. Precisa ter exatamente 11 (CPF) ou 14 (CNPJ) dígitos. Não pode haver dois clientes com o mesmo documento.
- Botão “Buscar”
- Ao lado do CPF/CNPJ — funciona só para CNPJ (14 dígitos): consulta a Receita Federal e preenche automaticamente razão social e endereço completo, poupando digitação.
- * Razão social
- Nome da empresa ou pessoa, exatamente como deve aparecer na nota fiscal.
- Contato do cliente, se preenchido precisa ter formato válido.
- Inscrição municipal
- Número de inscrição do cliente na prefeitura, exigido em alguns municípios para emitir NFS-e para esse tomador.
Endereço
- CEP, Logradouro, Número, Bairro, Cidade, UF
- Endereço do cliente — todos opcionais.
- Código IBGE do município
- Código oficial que identifica a cidade sem ambiguidade — preenchido automaticamente pela busca de CNPJ.
- Cliente ativo
- Interruptor visível apenas ao editar (um cliente novo já nasce ativo).
Regras importantes
- CPF/CNPJ e Razão social são obrigatórios; sem eles o salvamento é recusado.
- CPF/CNPJ duplicado é bloqueado tanto ao criar quanto ao editar.
Não disponível hoje
A tela de edição de um cliente não mostra um histórico das notas fiscais emitidas para ele — esse cruzamento ainda não existe na interface.