Fretamento - Dashboard

O que é

O Dashboard é a tela inicial do módulo de Fretamento: um resumo visual do mês atual, sempre comparado com o mês anterior. Em vez de abrir a listagem e contar linha por linha, você enxerga de uma vez quantos fretamentos fechou, quanto faturou, qual foi a margem depois das despesas e quanto da sua frota própria ficou ocupada — além de alertas de documentação e manutenção, o que está para sair nos próximos dias, e rankings dos melhores clientes, rotas e veículos.

Você chega aqui ao entrar em Fretamento pela barra lateral (é a primeira tela do módulo) ou clicando em Dashboard dentro do grupo Fretamento. É o ponto de partida do dia: de um lado mostra a saúde financeira e operacional do mês, do outro aponta o que precisa de atenção imediata (documento vencido, manutenção atrasada) e o que sai na semana.

Como usar

1. Vá em Fretamento > Dashboard na barra lateral.
2. No topo, o título mostra o mês sendo resumido e avisa que a comparação é sempre com o mês anterior. Clique em Ver fretamentos (botão laranja no canto superior direito) para ir para a listagem completa.
3. Os quatro cartões de indicadores mostram, nesta ordem: Fretamentos no mês (quantidade, sem os cancelados), Faturamento bruto, Margem (− despesas) e Ocupação da frota. Os três primeiros trazem uma seta verde (▲) ou vermelha (▼) comparando com o mês anterior.
4. Logo abaixo, dois cartões dividem o faturamento: Receita recorrente (MRR), que soma os contratos mensais ativos e é clicável, e Faturamento eventual no mês, com o valor dos fretamentos avulsos.
5. Se houver algo pendente na frota, uma faixa amarela de Alertas operacionais aparece logo abaixo, com a contagem de documentos vencidos, vencendo ou bloqueantes e manutenções atrasadas. Clique nela para ir para a tela de alertas da frota.
6. Em Próximos 7 dias, veja a lista de fretamentos e excursões que usam veículos da sua frota, ordenados por data. Clique em qualquer linha para abrir a ficha completa daquele serviço.
7. Ao lado, Por status mostra quantos fretamentos do mês estão em cada etapa: Orçamento, Confirmado, Em andamento, Concluído e Cancelado.
8. Em Últimos recebimentos, veja os oito pagamentos confirmados mais recentes. Clique no nome do cliente para abrir o fretamento, ou use Baixar PDF para salvar o recibo e Enviar recibo para compartilhar o link por WhatsApp, e-mail ou link curto.
9. Na parte de baixo, três rankings do mês: Top clientes, Top rotas e Top veículos, cada um com os oito primeiros colocados por valor faturado.

O que você precisa saber antes

• Margem é faturamento menos despesas, não é lucro contábil. O cálculo soma o valor dos fretamentos confirmados, em andamento e concluídos do mês e subtrai as despesas lançadas nesses mesmos fretamentos. Orçamentos e fretamentos cancelados nunca entram nessa conta.
• Ocupação da frota soma fretamentos e excursões próprias juntos. Se um veículo da sua frota está alocado a uma excursão (não só a fretamentos de terceiros), esses dias também contam como ocupados. O percentual é limitado a 100%, mesmo que dois serviços se sobreponham no mesmo veículo e no mesmo dia.
• A seta de variação usa 100% quando o mês anterior foi zero. Se você não faturou nada no mês passado e faturou algo este mês, o indicador mostra "▲ 100,0%" em vez de um número mais preciso — não é bug, é a forma escolhida para representar "saiu do zero".
• A comparação com o mês anterior é sempre com o mês civil completo, não com "os últimos 30 dias".
• O cartão de receita recorrente (MRR) só soma contratos com faturamento mensal único e status ativo. Contratos suspensos ou encerrados não entram na soma, mesmo que ainda apareçam na listagem de contratos recorrentes.
• Os alertas operacionais só aparecem quando há pendência. Se não houver documento vencido, vencendo em 30 dias, bloqueante ou manutenção atrasada, a faixa amarela simplesmente não é exibida — não é preciso ir a outra tela para confirmar que está tudo certo.
• "Enviar recibo" gera um link público de verdade para o recibo daquele pagamento, que pode ser compartilhado por WhatsApp, e-mail ou link curto. Qualquer pessoa com o link consegue ver o recibo.
• Os rankings e o funil por status usam a data de saída do fretamento, não a data em que ele foi cadastrado ou pago. Um fretamento fechado em um mês mas com saída marcada para o mês seguinte só aparece nos indicadores do mês da viagem.
• Fretamentos sem origem, destino ou veículo definido aparecem com "?" na lista de próximos dias e no ranking de rotas, em vez de dar erro — esses campos são opcionais no cadastro.

Casos especiais

Mês sem nenhum fretamento

Quando não há fretamentos no mês, os cartões de indicadores mostram zero e o funil por status também. As listas de Top clientes, Top rotas e Top veículos mostram a mensagem "Sem dados no mês." em vez de ficarem vazias sem explicação.

Nenhum recebimento registrado ainda

Se você nunca registrou um recebimento na ficha de um fretamento, a seção Últimos recebimentos mostra o aviso "Nenhum recebimento registrado ainda. Registre pelo botão 'Registrar recebimento' na ficha do fretamento e o recibo sai daqui."

Nada agendado para a semana

Se não houver fretamento nem excursão com saída nos próximos sete dias, a lista mostra "Nenhuma viagem nos próximos 7 dias." no lugar dos itens.

Erros comuns e como resolver

Esta tela é só de leitura: não há formulário para preencher nem envio que possa falhar diretamente aqui. As mensagens que aparecem são avisos de estado vazio (listados em Casos especiais), não erros de validação.

Onde encontrar

• URL: /admin/fretamento/dashboard
• Caminho no menu: Fretamento > Dashboard (primeira tela do grupo Fretamento na barra lateral)
• Permissão necessária: ver fretamentos
• Módulo necessário: Fretamento

Veja também

• Fretamento - Agenda da Frota
• Fretamento - Configurações