Clientes
Clientes — Rastreabilidade (Portal Easypac)
A tela de Clientes é onde você mantém o cadastro dos clientes da empresa: pessoas físicas ou jurídicas, com documento (CPF ou CNPJ), inscrição e endereço.
Visão Geral
A tela de Clientes é onde você mantém o cadastro dos clientes da empresa: pessoas físicas ou jurídicas, com documento (CPF ou CNPJ), inscrição e endereço. Outras telas da rastreabilidade usam esse cadastro quando precisam escolher um cliente.
A tela tem uma listagem com filtros por empresa e situação, um formulário de cadastro novo e um formulário de edição. Não é possível excluir clientes: para retirar um cliente de uso, altere a situação dele para Inativo.
Pré-requisitos
Para usar a tela de Clientes, você precisa da permissão correspondente à ação desejada e de ao menos uma empresa vinculada ao seu usuário.
Um cliente só aparece na listagem se estiver vinculado a uma empresa.
Permissões e Perfis de Acesso
- Abrir a listagem de Clientes: permissão de visualizar clientes.
- Cadastrar cliente (Novo): permissão de criar clientes.
- Editar cliente: permissão de editar clientes.
- Ver empresas no filtro e no formulário: são oferecidas apenas as empresas vinculadas ao seu usuário.
Fluxo Operacional
Fluxo — consultar a listagem de clientes
- Abra Rastreabilidade → Clientes. A grade abre com os clientes ativos da sua empresa padrão.
- Se precisar, abra o painel Filtros, ajuste Empresa e Situação e clique em Filtrar, ou digite na caixa Pesquisar.
- Selecione uma linha e clique em Editar, ou dê duplo clique na linha, para abrir o cliente.
Fluxo — cadastrar um novo cliente
- Na listagem, clique em Novo.
- Preencha o formulário (Descrição e Situação são obrigatórias) e clique em Salvar.
- Aparece “Operação efetuada com sucesso.” e a tela volta para a listagem.
Fluxo — editar um cliente
- Na listagem, selecione a linha e clique em Editar, ou dê duplo clique na linha.
- Altere os campos desejados e clique em Salvar, ou clique em Cancelar para voltar sem gravar.
- Após salvar, aparece “Operação efetuada com sucesso.” e a tela volta para a listagem.
Fluxo — inativar um cliente
- Abra a edição do cliente.
- Altere a Situação para Inativo e clique em Salvar.
- O cliente continua cadastrado e passa a aparecer apenas quando o filtro Situação inclui Inativo.
Interface e Comportamentos da Tela
Listagem de clientes
A grade exibe as colunas Id, Descrição, Empresa e Situação (Ativo ou Inativo), com os clientes mais recentes primeiro. As colunas podem ser ordenadas clicando no cabeçalho.
A caixa de busca pesquisa por código, descrição, empresa e situação.
Botões da listagem
- Editar: abre a edição do cliente selecionado. O duplo clique na linha faz o mesmo.
- Novo: abre o formulário de cadastro.
Filtros
O painel Filtros começa recolhido e tem o botão Filtrar:
- Empresa: a sua empresa padrão já vem marcada; também há a opção “Todos”.
- Situação: “Ativo” já vem marcado; também há a opção “Todas”.
Deixar um filtro sem seleção equivale a não filtrar por ele. Ao voltar do formulário pelo botão Cancelar, a listagem mantém os filtros aplicados; após salvar, os filtros voltam ao padrão.
Formulário do cliente
O formulário tem o painel “Dados do Cliente”, com os campos:
- Empresa, Tipo de Pessoa e Situação (obrigatória).
- Descrição (obrigatória).
- CPF/CNPJ e Inscrição.
- CEP, Endereço, Número e Complemento.
- Bairro, Cidade, UF e País.
Os botões são Salvar e Cancelar. No cadastro novo, a sua empresa padrão e a situação “Ativo” já vêm marcadas. Na edição, o formulário vem preenchido com os dados do cliente.
Campo CPF/CNPJ
O campo CPF/CNPJ só fica disponível depois que você escolhe o Tipo de Pessoa:
- Pessoa Física: o campo aceita CPF.
- Pessoa Jurídica: o campo aceita CNPJ, inclusive com letras.
- Em branco: o campo fica desabilitado e o conteúdo é apagado.
A tela não confere se o CPF ou o CNPJ é válido.
Outros campos
- CEP: pode ficar vazio, mas, se preenchido, precisa estar completo.
- Número: aceita apenas números. Use o Complemento para “S/N” ou letras.
- UF: inclui os estados do Brasil e a opção EX Estrangeiro.
Feedbacks ao Usuário
Mensagens do formulário
| Situação | Feedback | Texto exibido |
|---|---|---|
| CEP preenchido incompleto | Erro; o campo CEP é destacado e nada é gravado | “Formato do CEP inválido.” |
| Cliente salvo (novo ou edição) | Sucesso | “Operação efetuada com sucesso.” |
| Salvar edição de cliente que não existe mais | Erro | “Cadastro não encontrado” |
Situações sem mensagem
| Situação | O que acontece |
|---|---|
| Descrição ou Situação vazias | O formulário não é enviado e os campos são destacados |
| Cancelar | Volta à listagem sem gravar |
Troubleshooting
A opção Clientes não aparece ou o acesso é negado
O que fazer: solicitar ao administrador a permissão de visualizar clientes.
O botão Novo leva à página de acesso negado
O que fazer: solicitar ao administrador a permissão de criar clientes.
O botão Editar leva à página de acesso negado
O que fazer: solicitar ao administrador a permissão de editar clientes.
O botão Editar está desabilitado
O que fazer: clicar numa linha da grade para selecioná-la.
A listagem abre vazia ou sem o cliente procurado
Mensagem exibida: “Nenhum registro encontrado”
O que fazer: a grade abre filtrada pela sua empresa padrão e só com clientes ativos. Abrir o painel Filtros, incluir a situação Inativo ou outras empresas e clicar em Filtrar. Se o cliente ainda não aparecer, ele pode estar sem empresa vinculada — acionar o suporte técnico.
Cliente inativado não aparece na grade
O que fazer: marcar Inativo (ou “Todas”) no filtro Situação e clicar em Filtrar.
Os filtros voltaram ao padrão depois de salvar
O que fazer: reaplicar os filtros e clicar em Filtrar. Somente o botão Cancelar do formulário mantém os filtros.
A busca não filtra a grade
O que fazer: digitar ao menos 3 caracteres ou pressionar Enter.
Buscar “cli”, “cliente” ou “rastr” traz todos os clientes
O que fazer: esses termos fazem parte da classificação comum a todos os clientes. Pesquisar pela descrição, pelo código ou pelo nome da empresa.
Ordenar por Descrição ordena pela empresa
O que fazer: os cabeçalhos Descrição e Empresa estão trocados na ordenação: clique em Empresa para ordenar pela descrição e em Descrição para ordenar pela empresa. Informar o problema ao suporte técnico.
“Formato do CEP inválido.” ao salvar
Mensagem exibida: “Formato do CEP inválido.”
O que fazer: completar o CEP ou apagar o campo. Depois de corrigir, o campo pode continuar destacado até recarregar a página, mas a gravação é aceita.
Clicar em Salvar não faz nada
O que fazer: preencher Descrição e Situação e conferir os campos destacados. Se nenhum campo estiver destacado, acionar o suporte técnico.
O campo CPF/CNPJ está desabilitado
O que fazer: escolher o Tipo de Pessoa (Pessoa Física ou Pessoa Jurídica).
O campo Número não aceita “S/N” nem letras
O que fazer: informar apenas números e usar o campo Complemento para observações.
A UF ou a Empresa do cliente mudou depois de salvar
O que fazer: as listas de UF e Empresa não têm opção em branco; sem escolha, fica marcada a primeira opção (por exemplo, AC na UF). Conferir UF e Empresa antes de salvar e corrigir o cadastro, se necessário.
Uma data digitada no Complemento ou na Descrição foi gravada invertida
O que fazer: datas digitadas como “12/05/2024” em campos de texto são gravadas como “2024-05-12”. Escrever a data de outra forma, por exemplo “12/05/24”.
A edição do cliente não abre e mostra uma mensagem de erro
O que fazer: atualizar a listagem e tentar novamente. Se persistir, acionar o suporte técnico.
A grade fica em “Carregando…” ou vazia sem mensagem
O que fazer: recarregar a página. Se persistir, acionar o suporte técnico informando o horário.
Casos de Uso
Caso 1 — Cadastrar um cliente pessoa jurídica
Marcos abre Rastreabilidade → Clientes e clica em Novo. Mantém a empresa padrão, escolhe Tipo de Pessoa “Pessoa Jurídica” e Situação “Ativo”, digita a Descrição “Frigorífico Boa Carne Ltda”, o CNPJ, o CEP e a UF “GO”. Clica em Salvar, vê “Operação efetuada com sucesso.” e o novo cliente aparece no topo da listagem.
Caso 2 — Inativar um cliente
Paula pesquisa “Boa Carne”, seleciona o cliente e clica em Editar. Altera a Situação para “Inativo” e salva. O cliente deixa de aparecer na listagem padrão; para vê-lo de novo, ela marca “Inativo” no filtro Situação e clica em Filtrar.
Caso 3 — Consultar clientes de várias empresas
Rui, vinculado a três empresas, abre a listagem, abre o painel Filtros, marca “Todos” em Empresa e “Todas” em Situação e clica em Filtrar. Ele dá duplo clique em um cliente, confere os dados e clica em Cancelar: a listagem volta com os filtros que ele tinha aplicado.