{"count":45,"tools":[{"name":"obter_posicao_atual","description":"ONDE o(s) veículo(s) está(ão) AGORA — última posição conhecida (tempo real): lat/lng, endereço, velocidade, ignição. Com vehicle_id, um veículo (\"onde está a van X?\"). SEM vehicle_id, retorna TODA a frota numa única chamada — use assim para comparar/listar todos os veículos de uma vez (nunca chame veículo por veículo). Para o trajeto passado, use `listar_trackings_por_periodo`.","service":"lastPoints","method":"GET","path":"/api/v1/last-points","params":["vehicle_id"]},{"name":"listar_trackings_por_periodo","description":"TRAJETO percorrido por um veículo entre duas datas — pontos de rastreamento do histórico (por onde andou). Use para \"qual a rota do dia X?\", \"por onde passou ontem?\". Para a posição atual, use `obter_posicao_atual`.","service":"lastPoints","method":"GET","path":"/api/v1/trackings-route-date","params":["start_date","end_date","vehicle_id"]},{"name":"obter_ultimo_trecho_rota","description":"Pontos do ÚLTIMO trecho de rota de um veículo (o segmento mais recente). Nicho — normalmente prefira `obter_posicao_atual` (posição agora) ou `listar_trackings_por_periodo` (histórico).","service":"lastPoints","method":"GET","path":"/api/v1/last-break-route-point","params":["file_route_id","vehicle_id"]},{"name":"buscar_info_modulo","description":"Dados técnicos do módulo/rastreador de um veículo, buscando por número de série OU placa.","service":"lastPoints","method":"GET","path":"/api/v1/get-specific-module-info","params":["type","value"]},{"name":"listar_veiculos","description":"Lista todos os veículos cadastrados da frota (dados de cadastro: placa, modelo, etc.). Use para uma visão geral da frota. Para procurar por placa/grupo com filtros e paginação, use `buscar_veiculos`.","service":"vehicle","method":"GET","path":"/api/v2/vehicles","params":["vehicle_id"]},{"name":"buscar_veiculo_por_id","description":"Retorna os dados cadastrais detalhados de UM veículo pelo seu ID interno.","service":"vehicle","method":"GET","path":"/api/v2/vehicle/{vehicle_id}","params":["vehicle_id"]},{"name":"listar_gatilhos_km_veiculo","description":"Lista os marcos/gatilhos de odômetro CONFIGURADOS (KM cadastrado para lembretes). Com vehicle_id, de um veículo; SEM vehicle_id, de todos os veículos numa chamada. NÃO é a distância percorrida — para \"quanto rodou num período\", use `obter_relatorio_km`.","service":"vehicle","method":"GET","path":"/api/v2/vehicles/km","params":["vehicle_id"]},{"name":"listar_gatilhos_horimetro_veiculo","description":"Lista os marcos/gatilhos de horímetro CONFIGURADOS (horas cadastradas para lembretes). Com vehicle_id, de um veículo; SEM vehicle_id, de todos. Não é o total de horas de uso.","service":"vehicle","method":"GET","path":"/api/v2/vehicles/hourmeter","params":["vehicle_id"]},{"name":"listar_grupos_veiculos","description":"Lista os grupos de veículos da organização (categorias/agrupamentos da frota), com paginação.","service":"vehicle","method":"GET","path":"/api/v2/vehicles/groups","params":["group_name","per_page","page","status"]},{"name":"buscar_veiculos","description":"Procura veículos por placa, grupo ou tipo, com filtros e paginação. Use quando o usuário procura veículos por um critério (\"veículos do grupo X\", \"carro de placa ABC\"). Para listar a frota inteira sem critério, use `listar_veiculos`.","service":"trackings","method":"GET","path":"/api/v1/list-vehicles","params":["search_term","vehicle_id","status","group_id","limit","offset"]},{"name":"obter_relatorio_km","description":"Distância percorrida (KM rodados) por UM veículo num período. Use para \"quanto o carro rodou essa semana/mês?\". É a rodagem real — não confundir com os gatilhos de odômetro (`listar_gatilhos_km_veiculo`). Para a frota toda, use `obter_relatorio_km_frota`.","service":"trackings","method":"GET","path":"/api/v1/report-km","params":["start_date","end_date","vehicle_id","limit","offset"]},{"name":"obter_relatorio_km_frota","description":"Distância percorrida (KM rodados) por TODOS os veículos da frota num período. Use para \"quanto a frota rodou?\". Para um veículo só, use `obter_relatorio_km`.","service":"trackings","method":"GET","path":"/api/v1/report-all-vehicle-km","params":["start_date","end_date","filter_group"]},{"name":"obter_relatorio_rotas","description":"Relatório de rotas/viagens de UM veículo num período: paradas, trechos, tempos. Use para \"as viagens/paradas do veículo X na semana\". Para comparar VÁRIOS veículos de uma vez, use `obter_relatorio_rotas_grupo`. Difere de `listar_trackings_por_periodo` (pontos brutos do trajeto).","service":"trackings","method":"GET","path":"/api/v1/routes-reports","params":["start_date","end_date","vehicle_id","limit","offset"]},{"name":"obter_relatorio_rotas_grupo","description":"Relatório de rotas/viagens de VÁRIOS veículos num período, numa única chamada. Use para comparar as viagens/paradas de um conjunto de veículos (\"compare as rotas dos carros 12, 15 e 20 essa semana\") — não chame `obter_relatorio_rotas` veículo por veículo.","service":"trackings","method":"GET","path":"/api/v1/routes-reports-group","params":["start_date","end_date","vehicles_ids","limit","offset"]},{"name":"obter_rotas_por_motorista","description":"Rotas/viagens feitas por um MOTORISTA num período (agrupado por motorista, não por veículo). Use para \"por onde o motorista X rodou?\".","service":"trackings","method":"GET","path":"/api/v1/driver-per-route","params":["start_date","end_date","driver_id","limit","offset"]},{"name":"listar_motoristas","description":"Lista os motoristas da organização (nome, CNH, status), com busca e paginação. Use para \"quais os motoristas?\", \"buscar motorista X\".","service":"driver","method":"GET","path":"/api/v1/list","params":["search_term","status","offset","limit"]},{"name":"obter_relatorio_motoristas","description":"Relatório consolidado de motoristas: CNH (validade/pontos), multas e indicadores de condução por período. Use para análises/relatórios de motoristas, não para uma listagem simples (essa é `listar_motoristas`).","service":"driver","method":"GET","path":"/api/v1/retrieve_report_fleet_driver_information","params":["indicators_start_date","indicators_end_date"]},{"name":"obter_odometro_atual_veiculo","description":"Leitura de odômetro MAIS RECENTE do rastreador de um veículo (KM atual do hodômetro). Use para \"qual a quilometragem atual do carro?\". Para distância rodada num período, use `obter_relatorio_km`.","service":"driver","method":"GET","path":"/api/v1/retrieve_vehicle_odometer","params":["vehicle_id"]},{"name":"listar_pontos_de_interesse","description":"Lista os pontos de interesse (POIs) cadastrados — locais nomeados como bases, clientes, cercas. Use para \"quais os pontos cadastrados?\". Para achar um POI por nome/endereço digitando, use `sugerir_pontos_de_interesse`.","service":"poi","method":"GET","path":"/api/v1/points_of_interest","params":["name","address","type_id","per_page","page"]},{"name":"sugerir_pontos_de_interesse","description":"Autocomplete de POIs por nome/endereço (rankeado por relevância e proximidade). Use quando o usuário digita um termo parcial para achar um ponto (\"procurar posto perto de...\").","service":"poi","method":"GET","path":"/api/v1/points_of_interest/suggest","params":["q","lat","lng","limit"]},{"name":"listar_tipos_de_ponto","description":"Lista os TIPOS/categorias de ponto de interesse (ex.: posto, cliente, base) — a taxonomia, não os pontos em si.","service":"poi","method":"GET","path":"/api/v1/point_types","params":["name","status"]},{"name":"listar_abastecimentos","description":"Lista os abastecimentos individuais (cada evento: data, litros, valor, posto, veículo). Use para \"os abastecimentos do carro X\". Para totais/gráfico consolidado, use `resumo_abastecimentos`.","service":"fuels","method":"GET","path":"/api/v1/fuels","params":["start_date","end_date","vehicle_id","vehicle_ids","driver_ids","limit","page"]},{"name":"resumo_abastecimentos","description":"Números CONSOLIDADOS de abastecimento no período (totais/dashboard: gasto total, litros, médias). Use para \"quanto gastei de combustível?\". Para a lista item a item, use `listar_abastecimentos`.","service":"fuels","method":"GET","path":"/api/v1/retrive_fuel_dashboard_information","params":["start_period","end_period","vehicle_ids","driver_ids"]},{"name":"consumo_combustivel_por_veiculo","description":"Consumo de combustível consolidado POR VEÍCULO no período (média km/l, gasto por carro). Use para comparar eficiência entre veículos.","service":"fuels","method":"GET","path":"/api/v1/fuels/consumption_by_vehicle","params":["start_date","end_date","vehicle_id"]},{"name":"listar_multas","description":"Lista as multas individuais (cada infração: data, valor, veículo, motorista, gravidade). Use para \"as multas do período/veículo\". Para totais consolidados, use `resumo_multas`.","service":"fines","method":"GET","path":"/api/v1/list_fines","params":["search_term","start_date","end_date","vehicle_ids","driver_ids","page","per_page"]},{"name":"obter_multa","description":"Detalhes de UMA multa específica pelo ID.","service":"fines","method":"GET","path":"/api/v1/get_fine","params":["fine_id"]},{"name":"resumo_multas","description":"Números CONSOLIDADOS de multas no período (totais/dashboard: quantidade, custo, por gravidade). Use para \"quanto de multa no mês?\". Para a lista, use `listar_multas`.","service":"fines","method":"GET","path":"/api/v1/get_fines_dashboard","params":["start_date","end_date","driver_ids","vehicle_ids"]},{"name":"multas_por_motorista","description":"Multas consolidadas POR MOTORISTA (quantidade, custo e pontos na CNH por condutor). Use para \"qual motorista tem mais multas?\".","service":"fines","method":"GET","path":"/api/v1/fines_per_driver","params":["start_date","end_date","driver_ids","search_term"]},{"name":"listar_manutencoes","description":"Lista as ordens de manutenção (cada serviço: veículo, tipo, status, custo, datas). Use para \"as manutenções do veículo X\". Para totais consolidados, use `resumo_manutencoes`.","service":"maintenance","method":"GET","path":"/api/v1/list_maintenance","params":["maintenance_status","search_term","vehicle_ids","plan_ids","per_page","page"]},{"name":"obter_manutencao","description":"Detalhes de UMA ordem de manutenção específica pelo ID.","service":"maintenance","method":"GET","path":"/api/v1/get_detailed_maintenance","params":["maintenance_id"]},{"name":"resumo_manutencoes","description":"Números CONSOLIDADOS de manutenção no período (totais/dashboard: custo total, por tipo). Use para \"quanto gastei de manutenção?\". Para a lista, use `listar_manutencoes`.","service":"maintenance","method":"GET","path":"/api/v1/retrive_dashboard_information","params":["start_period","end_period","group_vehicle_ids"]},{"name":"listar_planos_manutencao","description":"Lista os PLANOS de manutenção (regras preventivas: trocar óleo a cada X km, etc.). Não são ordens executadas — para essas use `listar_manutencoes`.","service":"maintenance","method":"GET","path":"/api/v1/list_plans","params":["search_label","vehicle_ids","per_page","page"]},{"name":"listar_itens_do_plano","description":"Itens de um plano de manutenção específico (o que o plano cobre: peças/serviços e sua periodicidade).","service":"maintenance","method":"GET","path":"/api/v1/list_plan_items","params":["plan_id","search_term","per_page","page"]},{"name":"listar_usuarios","description":"Lista os USUÁRIOS do sistema (contas de login da organização), com busca e paginação. Atenção: usuário ≠ motorista — para motoristas use `listar_motoristas`.","service":"user","method":"GET","path":"/api/v1/list_user","params":["search_term","status","limit","offset"]},{"name":"obter_usuario","description":"Retorna os dados de um usuário (conta de login) específico pelo ID.","service":"user","method":"GET","path":"/api/v1/get_user","params":["user_id"]},{"name":"listar_niveis_de_acesso","description":"Lista os níveis de acesso / perfis de permissão da organização (papéis que definem o que cada usuário pode fazer).","service":"user","method":"GET","path":"/api/v1/access_levels","params":["name","per_page","page"]},{"name":"listar_eventos_camera","description":"Eventos de VIDEOTELEMETRIA / câmera Jimi por período (fadiga, distração, uso de celular, colisão — detectados pela câmera de IA). Difere de `listar_eventos_direcao_agressiva` (sensores de direção) e `listar_eventos` (cercas/alarmes gerais).","service":"jimi","method":"GET","path":"/api/v1/list_events","params":["start_date","end_date","driver_ids","vehicle_ids","event_types","search_term","page","limit"]},{"name":"resumo_eventos_camera","description":"Números consolidados (dashboard) dos eventos de câmera Jimi no período. Para a lista item a item, use `listar_eventos_camera`.","service":"jimi","method":"GET","path":"/api/v1/retrieve_dashboard","params":["start_date","end_date","vehicle_ids","driver_ids"]},{"name":"obter_dados_chip","description":"Dados do chip (SIM/conectividade) do rastreador por número de série.","service":"jimi","method":"GET","path":"/api/v1/get_chip_data","params":["serial_number"]},{"name":"listar_comandos","description":"Lista os comandos enviados aos rastreadores (bloqueio, desbloqueio, etc.) com status e data. Use para \"quais comandos foram enviados ao veículo X?\".","service":"command","method":"GET","path":"/v1/command","params":["search_term","type_command","vehicle_id","status","offset","limit"]},{"name":"listar_tipos_comando","description":"Lista os TIPOS de comando disponíveis (a taxonomia: bloqueio, desbloqueio, etc.), não os comandos enviados.","service":"command","method":"GET","path":"/v1/command/types","params":[]},{"name":"obter_status_firmware","description":"Status da atualização de firmware de um rastreador pelo número de série.","service":"command","method":"GET","path":"/v1/command/status-firmware/{serial_number}","params":["serial_number"]},{"name":"listar_eventos","description":"Eventos GERAIS de rastreamento por período: entrada/saída de cerca, alarmes de pacote, ignição, etc. É o \"o que aconteceu\" padrão. Para direção agressiva use `listar_eventos_direcao_agressiva`; para câmera use `listar_eventos_camera`.","service":"packetAlarmEvents","method":"GET","path":"/api/v1/events","params":["start_date","end_date","vehicle_id","driver_id","type_event_id","limit","offset"]},{"name":"listar_eventos_direcao_agressiva","description":"Eventos de DIREÇÃO AGRESSIVA por período (frenagem/aceleração bruscas, curva forte, excesso de velocidade — via sensores/telemetria). Difere de `listar_eventos_camera` (câmera de IA) e `listar_eventos` (cercas/alarmes gerais).","service":"packetAlarmEvents","method":"GET","path":"/api/v1/harsh_behavior/list_harsh_behavior_events","params":["start_period","end_period","driver_ids","vehicle_ids","limit","offset"]},{"name":"resumo_eventos","description":"Números consolidados (dashboard) de eventos por período. Para a lista item a item, use `listar_eventos`.","service":"packetAlarmEvents","method":"GET","path":"/api/v1/events/retrive_dashboard_information","params":["start_period","end_period","vehicle_ids","driver_ids"]}]}