📖 Documentação

Como funciona

Faça upload da planilha da sua frota — o sistema detecta automaticamente as colunas, agrupa os registros por veículo e entrega em segundos um dashboard completo com financeiro, eficiência, SLA, regional e telemetria. Sem configuração manual.

Passo 01
Prepare sua planilha
Exporte os dados da sua frota em Excel (.xlsx) ou CSV a partir do seu TMS, sistema de rastreamento ou planilha própria. O sistema reconhece automaticamente os nomes de coluna mais comuns — você não precisa renomear nada. Cada linha pode representar uma viagem, um CTe ou qualquer registro operacional; o agrupamento por PLACA_CAVALO é feito automaticamente.

💡 Nunca usou o sistema antes? Baixe a planilha modelo com 150 registros fictícios prontos para testar — o cabeçalho já está colorido por tipo de coluna (obrigatório, recomendado, telemetria).
Passo 02
Faça o upload
Arraste o arquivo para a área de upload ou clique para selecionar. O sistema realiza automaticamente uma verificação de segurança (extensão, fórmulas maliciosas e consulta a base de antivírus) antes de processar qualquer dado. Todo o processamento acontece diretamente no seu browser — os dados brutos nunca saem do browser. Apenas KPIs e identificadores de frota por veículo são salvos no histórico.

Se alguma coluna não for reconhecida automaticamente, um mapeador visual é exibido para você associar manualmente cada campo — sem necessidade de alterar o arquivo original. O resultado fica salvo no histórico da sua conta e estará disponível na próxima visita sem precisar fazer novo upload.
Passo 03
Analise o dashboard
Em segundos, o dashboard exibe KPIs e gráficos interativos organizados em 7 módulos. Use os filtros de gestor, placa, região e período para refinar qualquer análise.
Custo Total
R$ 1,2M
▲ 12%
KM Rodados
125.4K
▲ 8%
Entregas
2.456
▲ 15%
Custo / km
Custo / região
Sudeste
Sul
Nordeste
C-Oeste
Eficiência
87%
SLA Entregas
96%
No prazo
● Obrigatório — sem essas colunas o dashboard não exibe análise útil ● Recomendado — habilita módulos e gráficos adicionais
⚠️
Sem uma coluna de consumo o dashboard fica inutilizável: score zerado para todos os veículos, sem detecção de anomalias, sem rankings de eficiência e sem KPIs de custo de combustível. Inclua COMBUSTIVEL_L (litros totais), MEDIA_KM_L (km/l) ou uma coluna l/100km — qualquer uma das três é suficiente.
PLACA_CAVALO obrig. KM_RODADO obrig. COMBUSTIVEL_L obrig.* MEDIA_KM_L obrig.* GESTOR recomend. DATA_EMISSAO recomend. VALOR_FRETE recomend. UF_ORIGEM recomend. QTD_VOLUMES recomend.
ABC4D481250298.44.19Carlos Andrade01/05/20268500SP14
ABC4D48980234.24.18Carlos Andrade04/05/20266200GO11
DEF1G571540368.14.18Carlos Andrade01/05/202612000MS20
MNO7K44820512.51.60Roberto Santos02/05/20267800MT9
... demais registros — o sistema agrupa por PLACA_CAVALO automaticamente ...

* COMBUSTIVEL_L e MEDIA_KM_L são alternativos — inclua pelo menos uma das duas (ou uma coluna l/100km). O sistema soma os litros por placa e calcula km/l automaticamente. Cada linha pode ser um registro distinto de transporte; o agrupamento por placa é automático.

Níveis de cobertura do dashboard
⚠ Incompleto — sem análise útil
O dashboard abre e agrupa veículos, mas sem score, sem anomalias e sem custo. Não recomendado para uso real.
PLACA_CAVALO
KM_RODADO
✓ Análise essencial de frota
Score real por veículo, detecção de anomalias, rankings de eficiência, custo de combustível e KPIs financeiros estimados.
PLACA_CAVALO
KM_RODADO
+ COMBUSTIVEL_L (ou MEDIA_KM_L)
✦ Análise completa
Habilita módulo Gestor, filtros, receita real, custo real, marcha lenta, análise por período e módulo Regional.
+ GESTOR
+ DATA_EMISSAO
+ VALOR_FRETE
+ CUSTO_COMBUSTIVEL
+ Marcha lenta [l/h]
+ UF_ORIGEM
+ QTD_VOLUMES
⚡ Telemetria
Taxa de utilização, horas parado, velocidade média e gráfico Uso do Motor. Exportado de rastreadores (Samsara, Cobli, Onixsat etc.).
+ Horas motor
+ Horas condução
+ Horas parado
+ Velocidade média
Referência de colunas aceitas
Obrigatório — sem essas colunas o dashboard não realiza análise útil
PLACA_CAVALO obrigatório
Identificador único do veículo. O sistema agrupa todos os registros com a mesma placa para consolidar os KPIs
Aceita: PLACA_CAVALO · Placa · Placas · Veículo · Vehicle · Veiculo · ds_placa
KM_RODADO obrigatório
Quilômetros percorridos em cada registro. A soma por veículo gera o KM total e os KPIs de km/dia
Aceita: KM_RODADO · Distância percorrida [km] · Distância [km] · km · Quilometragem · km_total · vl_km_rodado · vl_km_rodado_efetivo
Consumo de combustível obrigatório — pelo menos uma das opções abaixo
Sem dados de consumo o sistema não calcula score, não detecta anomalias e não exibe KPIs de eficiência. Use qualquer uma das três formas:
Opção A — Litros totais
Total de litros consumidos no registro. O sistema calcula km/l e l/100km automaticamente pela divisão com KM_RODADO.
Aceita: COMBUSTIVEL_L · Litros · Combustível (L) · Combustivel · Litros consumidos · Litros abastecidos · Total de litros · Fuel (L)
Opção B — Média km/l
Consumo médio já calculado em km por litro. Usado diretamente no score e convertido para l/100km nos gráficos.
Aceita: MEDIA_KM_L · Consumo de combustível [km/l] · Consumo [km/l] · KM/L · km/l · Rendimento · Eficiência
Opção C — l/100km direto
Consumo médio em litros por 100 km. Usado diretamente no score e convertido para km/l nos gráficos.
Aceita: Consumo médio [l/100 km] · l/100km · L/100km · l/100 km · Consumo médio · Consumo médio (l/100km)
Recomendado — habilita módulos e gráficos adicionais
GESTOR recomendado
Nome do gestor responsável pelo veículo. Habilita o módulo Gestor completo com filtros, cards e 10 gráficos comparativos por responsável
Aceita: GESTOR · Gestor · Manager · Responsável · Responsavel · nm_agencia_gerente
DATA_EMISSAO recomendado
Data de emissão do registro (DD/MM/AAAA). Habilita o filtro de período, contagem real de dias operados e KPIs de km/dia precisos
Aceita: DATA_EMISSAO · Data Emissão · Data · data · dt_emissao · dt_mes_emissao · dt_embarque
VALOR_FRETE recomendado
Receita do frete por registro. Habilita os KPIs de receita total, lucro e margem. Sem esta coluna o sistema estima R$3,50/km como fallback
Aceita: VALOR_FRETE · TOTAL_CTE · Receita · receita · vl_frete · vl_frete_empresa · vl_frete_valor · vl_recebido_empresa
CUSTO_COMBUSTIVEL recomendado
Custo real de combustível em reais. Quando ausente, estimado com base em COMBUSTIVEL_L × preço padrão (R$7,10/l)
Aceita: CUSTO_COMBUSTIVEL · custo_combustivel · vl_vale_combustivel (vale combustível CTe)
Marcha lenta (l/h) recomendado
Consumo em idle — litros por hora com motor ligado e veículo parado. Habilita o KPI Marcha Lenta e o gráfico Marcha Lenta por Gestor
Aceita: Consumo com o veículo parado [l/h] · Marcha lenta [l/h] · Idle [l/h] · Marcha lenta · marcha_lenta
UF_ORIGEM recomendado
Sigla do estado de origem (SP, GO, MS…). Habilita a aba Regional completa com gráficos por estado e região do Brasil
Aceita: UF_ORIGEM · UF · Estado · Estado (UF) · State · uf · ds_uf_origem · ds_sigla_origem
QTD_VOLUMES recomendado
Quantidade de volumes ou entregas por registro. Habilita KPIs de custo/entrega, receita/entrega, entregas/dia e km/entrega
Aceita: QTD_VOLUMES · Entregas · Qtd. Entregas · Nº Entregas · num_entregas · Deliveries · qt_produto
SLA recomendado
Conformidade de prazo de entrega. Alimenta o score de eficiência e os gráficos de conformidade. Valores esperados: Dentro SLA ou Fora SLA. Em planilhas CTe, o sistema calcula automaticamente comparando dt_chegada (prevista) com dt_chegada_destino ou dt_descarga (real)
Aceita: SLA · sla · dt_chegada + dt_chegada_destino (CTe) · dt_chegada + dt_descarga (Viagem/Receita)
MOTORISTA recomendado
Nome do motorista quando diferente do gestor. Habilita o gráfico Entregas por Motorista na aba Regional
Aceita: MOTORISTA · Motorista · Driver · motorista · nm_pessoa_motorista
LUCRO_OPERACIONAL recomendado
Lucro líquido já calculado. Usado diretamente nos cards financeiros; quando ausente, estimado como receita − custos
Aceita: LUCRO_OPERACIONAL · Lucro · lucro · vl_resultado
VALE_PEDAGIO / PEDAGIO recomendado
Valor do pedágio por registro. Somado ao custo total do veículo
Aceita: VALE_PEDAGIO · PEDAGIO · Pedágio · pedagio · vl_pedagio · vl_pedagio_ctrc · vl_pedagio_empresa
OCORRENCIA recomendado
Descrição da ocorrência. Linhas diferentes de Sem ocorrência são contadas como incidentes por veículo nos alertas
Aceita: OCORRENCIA · Ocorrência · ocorrencia
Telemetria do veículo — exportado do sistema de rastreamento
Velocidade média telemetria
Velocidade média do veículo em km/h no período do registro. Habilita o card Velocidade Média e o gráfico Velocidade por Gestor na aba Operação
Aceita: Velocidade média · Ø Velocidade [km/h] · Vel. média · velocidade
Horas motor telemetria
Total de horas com o motor ligado no período. Habilita o card Horas Motor e é usado como denominador do cálculo de Taxa de Utilização
Aceita: Horas motor · Tempo de funcionamento do motor · h_motor
Horas condução telemetria
Horas efetivamente em movimento. Habilita o card Horas Movimento e compõe o numerador da Taxa de Utilização (horas condução ÷ horas motor)
Aceita: Horas condução · Tempo de condução · h_conducao
Horas parado telemetria
Horas com motor ligado e veículo parado (marcha lenta). Habilita o card Horas Parado e a fatia "Parado" no gráfico Uso do Motor
Aceita: Horas parado · Tempo de paragem · h_parado
Dicas importantes
Mínimo absoluto (não recomendado): PLACA_CAVALO + KM_RODADO. O dashboard abre, mas fica inutilizável — sem score de eficiência, sem detecção de anomalias e sem KPIs de consumo. Inclua obrigatoriamente uma coluna de combustível.
Análise essencial (obrigatório): PLACA_CAVALO + KM_RODADO + uma coluna de combustível (COMBUSTIVEL_L, MEDIA_KM_L ou L/100km). Com essas 3 colunas o dashboard exibe score por veículo, detecção de anomalias, rankings de eficiência e KPIs de consumo.
📈
Análise completa (recomendado): adicione GESTOR, DATA_EMISSAO, VALOR_FRETE, UF_ORIGEM e SLA para habilitar comparativos por gestor, evolução temporal, financeiro e análise regional.
💰
Financeiro detalhado: adicione CUSTO_COMBUSTIVEL e LUCRO_OPERACIONAL para exibir custo real e margem nos cards financeiros. Quando ausentes, o sistema estima com base nos litros × R$7,10/l.
📈
Agrupamento automático: pode haver N linhas por veículo — o sistema agrupa pela PLACA_CAVALO e soma KM, combustível, frete etc. de cada registro automaticamente.
📡
Telemetria: para habilitar os cards de Velocidade Média, Horas Motor, Taxa de Utilização e o gráfico Uso do Motor, exporte as colunas Velocidade média, Horas motor, Horas condução e Horas parado do seu sistema de rastreamento e inclua-as na mesma planilha.
🌏
Análise Regional: adicione UF_ORIGEM com a sigla do estado (SP, GO, MS...) para desbloquear a aba Regional com gráficos por estado e região do Brasil.
🔢
Coluna não reconhecida? O sistema exibe um mapeador manual para você indicar qual coluna corresponde a cada campo esperado — sem necessidade de renomear o arquivo.
📄
Primeira aba: o sistema lê sempre a primeira aba do Excel. Certifique-se de que os dados estão nela com o cabeçalho na primeira linha e sem linhas em branco iniciais.
🚫
Sem envio de dados brutos: todo o processamento acontece localmente no seu browser. Apenas KPIs e identificadores de frota por veículo são salvos no histórico — o conteúdo da planilha nunca é transmitido para servidores externos.
🛡
Verificação de segurança: todo arquivo enviado passa por uma análise automática antes do processamento — o sistema detecta extensões disfarçadas, fórmulas maliciosas (CSV Injection) e consulta uma base de antivírus para proteger o ambiente contra malwares.

Baixe a planilha de exemplo e veja o dashboard em ação.

Arquivo Excel com 150 registros fictícios em 10 veículos (15 viagens cada) — todas as colunas necessárias cobrindo as 5 regiões do Brasil, incluindo GESTOR, SLA, DATA_EMISSAO, telemetria e financeiro completo. Cabeçalho colorido por tipo de coluna. Dois veículos têm consumo anômalo proposital para você ver a detecção automática funcionando.

⬇ Baixar planilha de exemplo ↑ Fazer upload agora