alarmes_pendentes
ChatGPTAlarmes da tela Visualizar Alarmes: totais por situação e por tipo e os 100 mais recentes, cada um com a situação (ativo ou normalizado, reconhecido ou não). Comece por situacao = ativos para ver o que precisa de atenção agora; para o histórico completo use consultar_eventos. Tipos: 1=Cerca, 2=Velocidade, 3=Ignição, 5=Sensores, 9=Emergência, 10=Pânico, 12=Odômetro Digital, 13=Ponto de Interesse.
buscar_endereco
ChatGPTConverte um endereço escrito em coordenadas (latitude e longitude). Devolve até 5 candidatos; confira se o primeiro é o local pretendido antes de usar. Informe rua, número, cidade e estado para um resultado preciso.
configuracao_veiculos
ChatGPTComo cada veículo está configurado no cadastro: grupo, motorista, odômetro, horímetro e os alertas (velocidade máxima e tolerância, alertas de posição e cerca vinculada, restrição de ignição com os horários, sensores, emergência, pânico, motor ocioso, envio por e-mail). Use para responder por que um alerta foi ou não foi gerado.
consultar_eventos
ChatGPTLista eventos da frota (alarmes, excesso de velocidade, cerca, ignição etc.) em um período, do mais recente para o mais antigo. Códigos de tipo: 1=Cerca Eletrônica, 2=Excesso de Velocidade, 3=Ignição, 5=Sensores, 7=Falha do Módulo, 8=Falha do Módulo, 9=Emergência, 10=Pânico, 12=Odômetro, 13=POI, 14=Rota, 16=Apontamento, 18=Motor Ocioso, 19=Parada Proibida, 20=Mot. Não Identificado, 4=Alteração de Informações, 15=Navegação, 17=Acesso ao Sistema. Os acessos ao sistema (17: login e logout, com o usuário) e as alterações de informações (4: quem alterou o quê nos cadastros) só aparecem quando o tipo é informado. Paginada por cursor: "total" é o total real do filtro; enquanto vier proximo_cursor, repita a chamada com os mesmos filtros e cursor = proximo_cursor. Para exportar tudo em CSV, use exportar_dados.
dados_do_cliente
ChatGPTSó para administradores. Dados cadastrais de um cliente: razão social, CNPJ/CPF, contato, telefones, endereço, plano, veículos contratados e cadastrados, usuários ativos e os e-mails de alerta. Informe o parâmetro cliente (código em listar_clientes).
diagnostico_modulos
ChatGPTSó para administradores. Lista os veículos cujo módulo (rastreador) pode estar com problema, pelos critérios do relatório Listagem de Veículos: há quantos dias não comunica e quantas falhas o módulo informou no período (GPS inoperante, GPS não fixa, erro de CRC, módulo energizado, detecção de movimento, resets). Traz operadora, número de série, última posição com endereço e uma legenda do que cada sinal costuma indicar. Use para analisar a saúde do parque de módulos e sugerir a causa provável e a próxima ação para cada caso.
endereco_da_posicao
ChatGPTConverte latitude e longitude em endereço (rua, número, bairro, cidade, estado), com a fazenda/talhão ou o ponto de interesse do cliente quando houver. Para a posição atual de um veículo use posicao_veiculo, que já traz o endereço.
execucoes_rota
ChatGPTVezes em que os veículos percorreram uma rota em um período: horário de entrada e saída em cada ponto de checagem, tempo real contra o previsto e se o trecho foi feito no prazo, atrasado ou adiantado.
exportar_dados
ChatGPTExporta dados completos em arquivo, sem limite de linhas. Formatos: csv, json, geojson e kml (os dois últimos para viagens e pontos, para programas de mapa) e shp (Shapefile em .zip: tipo shape, ou formato shp em viagens/pontos). Entrega: link (padrão), um link temporário para baixar, que vale 30 minutos; ou resposta (entrega = resposta), o conteúdo do arquivo dentro desta resposta, num bloco à parte, até 100 KB (o .zip em base64), para quem não consegue abrir o link, como um ambiente sem acesso ao site do SegControle. Tipos: eventos e apontamentos (até 92 dias), viagens de um veículo com endereços, todos os pontos do percurso de um veículo e shape (até 31 dias), e a lista completa de veículos (de um cliente ou de todos os clientes). shape gera, como a tela Gerar Arquivo Shape, os pontos em que o veículo foi desligado e, com incluir_trajeto, o trajeto inteiro como linha; só para os clientes que têm essa tela. Use quando os dados não cabem numa resposta ou para processar em planilha, script ou programa de mapa.
guia_do_sistema
ChatGPTComo fazer as coisas nas telas do SegControle: configurar alertas (velocidade, ignição, motor ocioso, e-mail), cadastrar veículos, grupos, motoristas, usuários, cercas, pontos de interesse e rotas, gerar relatórios, reconhecer alarmes, compartilhar a localização, lembretes de manutenção. Use sempre que o usuário perguntar como ou onde fazer algo no sistema, e responda com os passos devolvidos, sem inventar telas ou campos. Sem assunto, devolve o índice do guia.
historico_trajeto
ChatGPTPor onde um veículo andou em um período: lista de viagens (de ligar a desligar) com horário, origem e destino com endereço, distância, duração, velocidade máxima, motorista e paradas com o motor ligado, mais os totais do período. Quando o cliente usa atividades, cada viagem traz a atividade (e, no caso raro de a atividade mudar no meio da viagem, a lista dos trechos em atividades). Período máximo: 7 dias, ou 31 com compacto = true (uma linha curta por viagem, sem links nem detalhes das paradas). Viagens paginadas (total real, proxima_pagina); o resumo sempre considera o período inteiro. Para todos os pontos do percurso ou um período longo em arquivo, use exportar_dados.
lembretes_manutencao
ChatGPTLembretes cadastrados no Odômetro Digital (troca de óleo, revisão): quilometragem do aviso, odômetro atual e quantos km faltam, do mais próximo ao mais distante.
listar_aparelhos
ChatGPTSó para administradores. Aparelhos instalados nos veículos: número de série, hardware, firmware, operadora, linha e SIM card, modelos de GPS e modem. Por cliente, ou em todos os clientes com busca.
listar_atividades
ChatGPTAtividades cadastradas, com o tipo (Produtivo, Improdutivo ou null quando não classificado) e os veículos que estão em cada uma agora, e os tipos de apontamento cadastrados, também com o tipo. Para tempo e km por atividade use relatorio_atividades; para quando cada veículo mudou de atividade, trocas_atividade.
listar_cercas
ChatGPTLista as cercas eletrônicas do cliente: nome, centro, veículos vinculados a cada uma (com o monitoramento ativo ou não e se a cerca está violada) e quais veículos da frota estão dentro dela agora, pela última posição.
listar_clientes
ChatGPTLista os clientes (frotas) que este usuário pode consultar, com o código usado no parâmetro "cliente" das outras ferramentas, a situação do cadastro (ativo/inativo), o plano e quantos veículos ativos e inativos e grupos cada um tem. Paginada: "total" é o total real; percorra as páginas até proxima_pagina vir null. O cadastro não guarda a data de entrada do cliente.
listar_grupos
ChatGPTGrupos de veículos do cliente, com a quantidade de veículos ativos e inativos e os e-mails que recebem os alertas de cada tipo (velocidade, posição, ignição, sensores, emergência, pânico, manutenção).
listar_motoristas
ChatGPTLista os motoristas cadastrados: nome, CPF, telefones, registro, CNH com vencimento e situação, se está ativo e o veículo que dirige agora. Para saber só quem está com a CNH vencida ou a vencer, use motoristas_cnh.
listar_pontos_interesse
ChatGPTLista os pontos de interesse (POI) cadastrados pelo cliente, com grupo, nome, coordenada e raio. Use para achar a coordenada de um local conhecido da frota (garagem, cliente, obra).
listar_rotas
ChatGPTLista as rotas cadastradas: nome, pontos de checagem em ordem (coordenada, raio, tempo previsto desde o ponto anterior e tolerância) e os veículos vinculados a cada rota.
listar_usuarios
ChatGPTUsuários da empresa no SegControle: login, nome, e-mail, se está ativo, horário de acesso e os direitos de cada um. Senhas não são informadas.
listar_veiculos
ChatGPTLista os veículos da frota com placa, descrição, tipo, grupo, motorista atual, se está ligado, última posição e última velocidade. Por padrão só os ativos; incluir_inativos traz também os desativados (campo ativo). Com com_endereco, traz também o endereço de cada um. Paginada (total real, proxima_pagina). O sistema não guarda histórico de troca de placas.
motoristas_cnh
ChatGPTLista motoristas ativos com CNH vencida ou que vence nos próximos dias.
posicao_veiculo
ChatGPTRetorna a última posição conhecida de um veículo (endereço, latitude, longitude, data/hora, velocidade, motorista), um link do Google Maps e link_navegador, que abre o mapa do SegControle acompanhando o veículo ao vivo. Quando há um status mais recente que a posição (ex.: Server Check), vem também ultimo_status, com o próprio link para vê-lo como ponto fixo no mapa.
quilometragem_frota
ChatGPTQuilômetros rodados por veículo em um período, pela diferença do odômetro registrado nos eventos (cada vez que o veículo liga ou desliga), mais o odômetro e o horímetro atuais. É uma estimativa rápida para a frota toda; para um veículo com precisão de trajeto use historico_trajeto. Período máximo: 92 dias.
relatorio_apontamentos
ChatGPTApontamentos do período, como o Relatório de Apontamentos do sistema: motorista, apontamento, tipo (Produtivo/Improdutivo), início, fim, duração, veículo, km e local (endereço) do início e do fim, mais os totais por tipo, por apontamento e por motorista. Os apontamentos são pareados por motorista e nome, em ordem de tempo; o que não tem início ou fim no período vem com o campo vazio e não soma duração. Período máximo: 31 dias. Paginada (total real, proxima_pagina); os totais consideram todos. Para o arquivo completo, exportar_dados com tipo apontamentos.
relatorio_atividades
ChatGPTUso da frota por atividade, como o Relatório de Atividades do sistema: por linha, atividade, tipo (Produtivo/Improdutivo), veículo e grupo, com tempo total na atividade, tempo com o motor ligado, tempo em movimento, km e o percentual do tempo ligado e dos km no resultado; subtotais do agrupamento e totais do período, inclusive produtivo × improdutivo. agrupar_por: veiculo (veículo × atividade), atividade (atividade × veículo) ou grupo (grupo × atividade). Tempo ligado e km seguem a regra da tela (só conta com o motor ligado); o tempo total é o tempo corrido na atividade, ligado ou desligado; a regra completa vem em regra_de_contagem. Lê o rastreio veículo a veículo: para frotas grandes filtre por grupo ou placa; se o tempo acabar, a resposta vem com parcial = true e os veículos que faltaram. Período máximo: 31 dias. Linhas paginadas (total real, proxima_pagina); subtotais e totais consideram todas.
relatorio_utilizacao
ChatGPTUtilização da frota em um período de até 92 dias, agrupada por veículo, por motorista ou por grupo: número de viagens, quilômetros, horas com o veículo ligado e dias com uso. Use para comparativos mensais, ranking de motoristas e uso por grupo; para o trajeto detalhado de um veículo use historico_trajeto.
resumo_eventos
ChatGPTTotais de eventos em um período: por tipo, por veículo (top 20) e por motorista (top 20), mais o número de alarmes. Use antes de consultar_eventos para ter a visão geral.
trocas_atividade
ChatGPTHistórico de trocas de atividade dos veículos no período: data e hora em que a troca passou a valer, veículo, atividade anterior e nova, a origem (tela Troca de Motoristas e Atividades, com quando foi pedida e o usuário, ou teclado do veículo) e, por veículo, em que atividade terminou o período e desde quando. Lista também os pedidos feitos na tela que não chegaram a valer (o veículo ainda não foi ligado, ou outro pedido veio depois). A troca pedida na tela só vale quando o veículo é ligado de novo. Lê o rastreio veículo a veículo (ver relatorio_atividades). Período máximo: 31 dias. Paginada (total real, proxima_pagina).
veiculos_no_local
ChatGPTQuais veículos estiveram dentro de um raio em torno de um local em um período, com horário de chegada, saída e permanência de cada visita. O local pode ser uma coordenada (latitude e longitude) ou um endereço escrito; a resposta mostra qual endereço foi encontrado. Para um ponto de interesse cadastrado, pegue a coordenada em listar_pontos_interesse. Período máximo: 3 dias.
veiculos_todos_clientes
ChatGPTVeículos de todos os clientes que este usuário pode consultar, numa listagem só: cliente, placa, padrão da placa (mercosul, antigo ou fora_do_padrao), descrição, grupo, tipo, se está ativo e a última comunicação. Use para achar uma placa sem saber o cliente, consolidar a frota ou listar placas fora do padrão Mercosul. Paginada (total real, proxima_pagina).