Registro de visitas

Abra Visitas → Cadastrar no menu lateral para lançar um contato com o cliente. Use Visitas → Gerenciar para consultar e manter os registros. No manual, Visitas tem um capítulo próprio, separado de Gestão.

Na tela Cadastrar, a seção Dados da visita usa o mesmo padrão visual do cadastro de Pedidos. Cliente, tipo e potencial ficam alinhados na primeira linha do formulário; as observações ficam logo abaixo. O campo em foco usa uma borda simples, como nos demais formulários.

Registrar contato ou visita

1. Em Cliente, digite o nome, o código ou o CPF/CNPJ e escolha a pessoa na lista exibida logo abaixo do campo. A busca começa no primeiro caractere e informa quando não há cliente ativo encontrado. Confira o código exibido antes do nome.
2. Selecione o Tipo: WhatsApp, Telefone, Presencial ou Outro.
3. Indique o Potencial de negócio de 1 (baixo) a 5 (alto) e, se desejar, escreva o resumo em Observações.
4. Ao abrir Cadastrar, o sistema procura a localização do aparelho. Permita o acesso à localização deste site no navegador e mantenha a localização do aparelho ativa. Depois de preencher os campos, clique em Registrar na barra superior. Se a posição capturada tiver mais de 30 segundos, o sistema obtém uma nova antes de salvar. Sem coordenadas válidas, o registro é bloqueado e um aviso temporário informa o que verificar.

Se aparecer uma mensagem pedindo a preparação da tabela ao tentar Registrar, solicite ao administrador que execute scripts/Database/pessoasatendimento.sql no banco do ERP. O lançamento não é salvo enquanto a tabela ou as colunas de coordenadas não estiverem disponíveis. Em instalações já existentes, o mesmo script precisa ser reaplicado para criar essas colunas.

O formulário não reserva uma faixa para mensagens abaixo dos botões. Erros de seleção, localização ou gravação aparecem em avisos temporários quando a ação é executada.

Gerenciar registros

Visitas → Gerenciar segue a disposição de Pedidos → Gerenciar: filtros compactos e alinhados à esquerda no topo, com a tabela ocupando a área restante. Informe Número, Data inicial, Data final e/ou Pessoa e clique em Buscar. A busca por pessoa aceita código ou parte do nome. Sem filtros, a tabela mostra até 100 atendimentos ativos da empresa, do mais recente para o mais antigo, com data e hora, cliente, colaborador, tipo, potencial, observações e coordenadas quando disponíveis. Role a tabela para conferir as linhas. O histórico de visitas da planilha CRM Inova não é importado.

Na coluna Ações, use o ícone de lápis para abrir o formulário de edição. Altere cliente, tipo, potencial ou observações e clique em Salvar alterações na barra superior; Cancelar edição descarta as mudanças. Use o ícone de lixeira para remover um contato e confirme a ação. Os botões mostram sua função ao passar o cursor e têm nome para navegação por teclado.

Para obter a lista completa, clique em Excel (CSV) ao lado de Buscar. O arquivo inclui todos os contatos ativos que atendem aos filtros, mesmo quando a tela mostra apenas os 100 mais recentes. Latitude e longitude são exportadas em colunas próprias quando registradas.

Regras de negócio

• Apenas um colaborador autenticado pode registrar. O cliente escolhido precisa estar ativo na base de Pessoas acessada no login; a busca não exige empresa no cadastro da pessoa. Digitar um nome sem selecionar a sugestão não identifica o cliente.
• Tipo e potencial de 1 a 5 são obrigatórios. A observação é opcional e aceita até 1.000 caracteres.
• Ao salvar, o sistema grava empresa, colaborador e data/hora do servidor na entidade PessoasAtendimento. O cadastro de clientes, pedidos e orçamentos não é alterado.
• A localização é a posição do aparelho do operador, não o endereço do cliente. É obrigatória para registrar uma nova visita: o navegador precisa fornecer latitude e longitude válidas, com permissão concedida e localização do aparelho ativa. A busca começa ao abrir Cadastrar e é repetida ao salvar se a captura anterior tiver mais de 30 segundos. Se a permissão for negada, a posição falhar ou as colunas de coordenadas não existirem no banco, o registro não é criado. O administrador pode reaplicar scripts/Database/pessoasatendimento.sql para adicionar as colunas em instalações existentes. A edição de visitas já registradas preserva a localização original.
• Ao editar, o sistema altera apenas cliente, tipo, potencial e observações do contato ativo da empresa acessada. Data/hora, colaborador e coordenadas originais são preservados. A validação do cliente e dos campos é a mesma de um novo lançamento.
• Remover marca o contato com status 9; não apaga fisicamente o registro. Ele deixa de aparecer em Gerenciar e de contar como último contato nas consultas que consideram apenas atendimentos ativos.
• Número identifica o atendimento; as datas filtram o momento do registro, incluindo todo o dia final. Pessoa aceita código, nome ou CPF/CNPJ. Todos os filtros se aplicam aos registros ativos da empresa acessada.
• A exportação respeita os mesmos filtros, sem o limite visual de 100 linhas. O arquivo é CSV compatível com Excel, em UTF-8, com separador ponto e vírgula; não é um arquivo .xlsx.
• O painel de Gestão calcula clientes atendidos e carteira com pedidos e orçamentos; os contatos lançados aqui não modificam esses indicadores.