Registro de atendimentos

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

Também é possível começar pelo Gestão → Painel → Carteira: dois cliques no cliente abrem a aba Atendimento · Cadastrar com ele selecionado. Confira o nome e complete os demais campos antes de registrar. A abertura da aba não grava o atendimento.

Na tela Cadastrar, a seção Dados do atendimento 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 atendimento

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. No celular, permita o acesso à localização deste site no navegador e mantenha a localização do aparelho ativa. O sistema começa a captura ao abrir a tela e a repete ao salvar se a posição tiver mais de 30 segundos. Sem coordenadas válidas, o registro é bloqueado e um aviso temporário informa o que verificar. No desktop, a localização é opcional. Depois de preencher os campos, clique em Registrar na barra superior.

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. Sem a tabela, nenhum atendimento é salvo. No celular, as colunas de coordenadas também são necessárias; em instalações já existentes, o mesmo script pode ser reaplicado para criá-las.

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

Atendimento → Gerenciar segue a disposição de Pedidos → Gerenciar: filtros compactos e alinhados à esquerda no topo, com a tabela ocupando a área restante. Data inicial e Data final vêm preenchidas com o primeiro e o último dia do mês vigente; altere ou limpe as datas para consultar outro período. Informe também Número e/ou Pessoa, se precisar, e clique em Buscar. A busca por pessoa aceita código ou parte do nome. A tabela mostra até 100 atendimentos ativos da empresa que atendem aos filtros, 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.

Para editar, dê dois cliques na linha do atendimento ou use o ícone de lápis na coluna Ações. O sistema abre o atendimento na aba Atendimento · Editar. Altere cliente, tipo, potencial ou observações e clique em Salvar alterações na barra superior. Volte à aba Atendimento · Gerenciar para consultar a lista; clique em Buscar para atualizá-la. O ícone de mapa abre as coordenadas no Google Maps em outra aba e aparece somente quando há latitude e longitude válidas. Use o ícone de lixeira para remover um contato e confirme a ação. Os ícones ficam centralizados na altura da linha, 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. No modo mobile, registrar um novo atendimento exige latitude e longitude válidas fornecidas pelo navegador; se a permissão for negada, a captura falhar ou as colunas não existirem no banco, o lançamento é bloqueado. A posição é procurada ao abrir a tela e atualizada ao salvar quando tiver mais de 30 segundos. No desktop, a tela não solicita localização e o atendimento pode ser salvo sem coordenadas, inclusive em bancos antigos sem essas colunas. A edição 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; asAs datas filtram o momento do registro, incluindo todo o dia final. O intervalo inicial corresponde ao mês vigente no aparelho, do primeiro ao último dia, e pode ser alterado ou limpo. Pessoa aceita código, nome ou CPF/CNPJ. Todos os filtros se aplicam aos registros ativos da empresa acessada. O identificador interno do atendimento continua sendo usado para abrir e editar o registro.
• O ícone de mapa usa as coordenadas guardadas no atendimento para abrir o Google Maps. Registros sem um par válido de latitude e longitude não mostram essa ação; abrir o mapa não altera o atendimento.
• 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.