Cadastrando um Cliente
Para cadastrar um novo cliente, acesse Clientes no menu lateral e clique em Novo Cliente. O formulário é dividido em quatro seções.
Seção 1 — Tipo de Cliente
Selecione o tipo de pessoa do cliente por meio dos cards disponíveis:
| Tipo | Documento exigido | Quando usar |
|---|---|---|
| Pessoa Física | CPF | Clientes pessoas físicas residentes no Brasil |
| Pessoa Jurídica | CNPJ | Empresas e organizações com registro no Brasil |
| Estrangeiro | ID Estrangeiro | Clientes domiciliados fora do Brasil |
⚠️ O tipo selecionado determina quais campos de identificação, endereço e informações fiscais serão exibidos nas seções seguintes.
Seção 2 — Identificação
| Campo | Obrigatoriedade | Descrição |
|---|---|---|
| CNPJ | Obrigatório (PJ) | CNPJ da empresa com 14 dígitos. Será validado automaticamente |
| CPF | Obrigatório (PF) | CPF com 11 dígitos. Será validado automaticamente |
| ID Estrangeiro | Obrigatório (Est.) | Documento de identificação estrangeiro. Máximo 20 caracteres |
| Nome / Razão Social | Obrigatório | Nome completo (PF) ou razão social (PJ/Est.). Mínimo 2, máximo 60 caracteres |
| Opcional | Endereço de e-mail de contato. Máximo 60 caracteres |
Seção 3 — Endereço
Preenchimento via CEP
Para clientes nacionais (Pessoa Física ou Jurídica), informe o CEP e clique no botão com ícone de lupa. Os campos de logradouro, bairro, município, UF e código IBGE serão preenchidos automaticamente.
💡 O CEP é opcional para clientes, mas facilita o preenchimento dos demais campos de endereço.
Campos de endereço
| Campo | Obrigatoriedade | Descrição |
|---|---|---|
| Logradouro | Obrigatório | Rua, avenida etc. Mínimo 2, máximo 60 caracteres |
| Número | Obrigatório | Número do imóvel ou S/N |
| Complemento | Opcional | Sala, andar, bloco etc. Máximo 60 caracteres |
| Bairro | Obrigatório | Nome do bairro. Mínimo 2, máximo 60 caracteres |
| Município | Obrigatório | Nome do município. Mínimo 2, máximo 60 caracteres |
| UF | Obrigatório | Unidade federativa. Selecione na lista |
| Cód. Município (IBGE) | Obrigatório | Código de 7 dígitos — preenchido via CEP |
| CEP | Opcional | 8 dígitos numéricos (sem traço) |
| Telefone | Opcional | De 6 a 14 dígitos numéricos (com DDD) |
Endereço para clientes estrangeiros
Para clientes do tipo Estrangeiro, os campos de UF e município assumem valores fixos:
- UF:
EX(Exterior) — preenchido automaticamente. - Cód. Município (IBGE):
9999999— preenchido automaticamente. - Município:
EXTERIOR— preenchido automaticamente. - País e Código do País: campos adicionais obrigatórios para identificar o país de origem.
Seção 4 — Informações Fiscais
Indicador de IE do Destinatário
Selecione a situação tributária do cliente em relação ao ICMS:
| Opção | Código | Quando usar |
|---|---|---|
| Contribuinte ICMS | 1 | Cliente com Inscrição Estadual ativa, sujeito ao ICMS |
| Contribuinte Isento | 2 | Cliente isento de IE — o campo IE não deve ser preenchido |
| Não Contribuinte | 9 | Cliente que não é contribuinte do ICMS (padrão para PF e Estrangeiro) |
⚠️ Para clientes Estrangeiros, a única opção válida é Não Contribuinte (9).
Campos fiscais adicionais
| Campo | Obrigatoriedade | Descrição |
|---|---|---|
| IE (Inscrição Estadual) | Condicional | Obrigatório se o indicador for Contribuinte ICMS (1). Proibido se for Isento (2). De 2 a 14 dígitos numéricos |
| ISUF (Inscrição SUFRAMA) | Opcional | Para clientes localizados na Zona Franca de Manaus. De 8 a 9 dígitos |
| IM (Inscrição Municipal) | Opcional | Inscrição Municipal do destinatário. Máximo 15 caracteres |
Concluindo o cadastro
Após preencher todos os campos obrigatórios, clique em Cadastrar Cliente. Se houver erros de validação, os campos com problema serão destacados com mensagens explicativas.
Após o cadastro bem-sucedido, você será redirecionado automaticamente para a lista de clientes.
Editando um cliente
Para editar um cliente, acesse a listagem, clique no ícone de lápis na linha do cliente desejado (ou em Visualizar → Editar). O formulário será aberto com todos os dados pré-preenchidos. Faça as alterações necessárias e clique em Salvar Alterações.
Ativando e desativando clientes
Na listagem, clique no ícone de toggle ao lado do cliente para alterar seu status. Uma caixa de confirmação será exibida antes de efetivar a ação.
- Desativar: o cliente deixa de aparecer nas buscas durante a emissão de documentos fiscais, mas seus dados são preservados.
- Reativar: o cliente volta a ficar disponível para seleção na emissão.