Referência — Cadastro de Cliente

Sobre a tela

A tela Clientes (menu → Clientes) cadastra as pessoas que recebem os serviços. É a base das ordens de serviço: uma OS sempre referencia um cliente cadastrado.

A tela tem duas formas de uso:

1. Listagem — busca, edição, remoção e acesso rápido aos clientes;
2. Formulário (Novo Cliente / Editar) — cadastro completo em blocos, com a aba Comodato disponível apenas na edição.

1. Listagem de clientes

Item	Descrição
Busca	Filtra em tempo real por nome, CPF ou celular
Novo Cliente	Botão no topo que abre o formulário de cadastro
Colunas	Nome, CPF, Celular, Cidade, Status e botão de ações (⋮)
Ações por linha (⋮)	Editar (abre o formulário preenchido) e Remover (pede confirmação)
Paginação	Navegação entre páginas no rodapé da listagem

Remover é definitivo

A exclusão de um cliente não pode ser desfeita. Antes de remover, confira se o cliente não tem histórico de ordens ou equipamentos em comodato — o sistema pode bloquear a exclusão para preservar o histórico.

2. Formulário — bloco "Dados Gerais"

Primeiro bloco do formulário, com as informações principais do cliente.

Campo	Tipo	Obrig.	Descrição
Nome	Texto	Sim	Nome completo do cliente, como aparece nas ordens e documentos
CPF	Texto com máscara automática 000.000.000-00	Não	Documento do cliente. A máscara é aplicada enquanto digita
Status	Seleção (Ativo / Inativo)	Não	Ativo: pode receber novas ordens. Inativo: fica oculto das buscas de nova OS (mantém o histórico)
E-mail	Texto (formato e-mail)	Não	Usado para envio do termo de conclusão e comunicações
Referência	Texto	Não	Como o cliente conheceu a empresa (ex.: indicação, Google). Usado para análise de aquisição de clientes

3. Formulário — bloco "Contato"

Campo	Tipo	Obrig.	Descrição
Telefone	Texto com máscara (00) 0000-0000	Não	Telefone fixo do cliente
Celular	Texto com máscara (00) 00000-0000	Não	Celular do cliente — é o contato usado pelo técnico no atendimento

4. Formulário — bloco "Endereço"

Campo	Tipo	Obrig.	Descrição
Logradouro	Texto	Sim	Rua ou avenida do endereço do cliente
Número	Texto	Não	Número do imóvel
Complemento	Texto	Não	Apto, bloco, sala, etc.
CEP	Texto com máscara 00000-000	Não	Ao sair do campo, o sistema busca o endereço automaticamente (base oficial dos Correios) e preenche logradouro, complemento, cidade e bairro
Cidade	Seleção com busca	Sim	Cidade do cliente. Ao trocar a cidade, o bairro é limpo (o bairro pertence à nova cidade)
Bairro	Seleção com busca	Não	Só habilita depois que uma cidade é selecionada — garante que o bairro pertence à cidade escolhida

Preenchimento automático de CEP

O CEP usa o serviço ViaCEP: digite os 8 números, saia do campo e aguarde. Se o CEP for válido, logradouro, complemento, cidade e bairro são preenchidos automaticamente. Se o bairro não for encontrado na base, selecione manualmente após o preenchimento da cidade.

5. Formulário — bloco "Observações"

Campo	Tipo	Obrig.	Descrição
Observações	Texto (multilinha)	Não	Anotações internas relevantes sobre o cliente (restrito à equipe)

6. Botões do formulário

Botão	O que faz
Salvar (novo) / Atualizar (edição)	Grava o cadastro. Os campos com * são obrigatórios
Cancelar	Volta para a listagem sem salvar

7. Aba "Comodato" (somente na edição)

Disponível apenas quando o cliente já cadastrado é aberto para edição (e o perfil tem permissão de visualizar movimentações). Mostra os equipamentos emprestados ao cliente:

Item da lista	Descrição
Número de série	O serial do equipamento (identificação única)
Produto · SKU	Nome do produto e código interno
Status	Situação do equipamento (ex.: Em comodato)
Desde	Data em que o empréstimo foi registrado
Saiu de	Localização de onde o equipamento saiu
OS	Protocolo da ordem de serviço vinculada ao empréstimo (se houver)

Ações disponíveis na aba:

Ação	Descrição
Emprestar equipamento	Abre o modal de empréstimo (veja Comodato → Emprestar)
Histórico	Abre a trilha completa do equipamento (por onde passou, com quem esteve)
Devolver	Abre o modal de devolução, registrando o retorno do equipamento ao estoque

Permissões

Ação	Permissão necessária
Ver a aba	movimentacoes.visualizar
Emprestar / Devolver	movimentacoes.criar

Regra de negócio

Só entram em comodato equipamentos com controle de serial e status Disponível. A devolução precisa de uma localização de destino — o equipamento nunca "some" do sistema.

Termos usados nesta tela

Termo	Significado
Comodato	Empréstimo de um equipamento ao cliente durante a prestação do serviço. Cada empréstimo fica registrado com rastreio (veja o glossário)
SKU	O código interno de referência do produto
Serial	A identificação única de um equipamento individual

Próximos passos

Com o cliente cadastrado, você já pode abrir uma Ordem de Serviço para ele ou consultar o guia completo de Gestão de Clientes.