O cálculo roda no seu navegador, mas todos os dados (Viagens, Pagamentos, Frota MFA, Cadastro de Veículos e Cliente × Supervisor) são salvos automaticamente no servidor a cada mudança — não precisa clicar em "salvar", e os dados ficam disponíveis igual em qualquer computador que abra este link. O indicador no topo da página ("Dados salvos no servidor às...") confirma quando a última alteração foi gravada. Isso exige conexão com a internet: se o indicador ficar vermelho, a alteração ainda não foi salva no servidor — confira a conexão antes de fechar a página. "Limpar entradas (novo ciclo)" apaga Viagens, Pagamentos, Frota MFA e Cadastro de Veículos (no servidor também); o Cadastro Cliente × Supervisor não é afetado por esse botão.
1. O que é esta ferramenta
É o passo de validação diária, feito junto com cada supervisor, para conferir se as viagens de agregados dos clientes dele já têm pagamento lançado no sistema — antes do fechamento oficial do mês. Ela não trata descontos (GRAAL, Vale Card, Outros); isso é feito depois, na Folha de Agregados.html, que é o fechamento mensal oficial.
2. Fluxo de uso
- Nas abas Viagens, Pagamentos, Frota MFA e Cadastro de Veículos, arraste o arquivo .xlsx/.xls/.csv exportado do sistema (ou cole os dados manualmente em "Ou cole os dados manualmente").
- Se o arquivo tiver mais de uma aba interna, escolha qual usar no seletor que aparece.
- Depois de carregar, confira o bloco "Mapeamento de colunas" que aparece acima da tabela — a ferramenta tenta adivinhar qual coluna do seu arquivo é qual campo (ex.: qual coluna é o romaneio, qual é a placa, qual é o Dono ANTT), mas os nomes reais das colunas variam de exportação para exportação. Sempre confira se o mapeamento veio certo; campos destacados em vermelho não foram identificados automaticamente e precisam ser escolhidos manualmente no seletor.
- A tabela abaixo fica editável — clique numa célula para corrigir, ou use o ícone de lixeira para remover uma linha errada.
- Na aba Cliente × Supervisor, mantenha atualizado quem é responsável por cada cliente (isso persiste entre sessões — só precisa atualizar quando algo mudar).
- A aba Validação recalcula automaticamente. Use os filtros "Ver" (por supervisor) e "Ponto de atenção" (por tipo de erro) para conferir a tela antes de exportar.
- Escolha o formato (Excel ou PDF) e clique em "Gerar arquivos" — é criado um arquivo por supervisor (mais um "Sem Supervisor" quando aplicável), nomeado como
Validação Viagens - <Supervisor> - <data>.
3. Como a ferramenta cruza os dados
- Placas são sempre comparadas normalizadas: maiúsculas, sem espaços, sem hífen.
- Viagens com Status = Cancelado são excluídas do cálculo.
- Viagens cuja Placa está cadastrada na aba Frota MFA (frota própria) são excluídas do cálculo.
- O vínculo entre Pagamentos e Viagens é feito pela coluna mapeada como "Romaneio / Prog. Viagem" em cada aba — que pode se chamar "Prog. Viagem", "Romaneio" ou outro nome dependendo da exportação (por isso o mapeamento de colunas é conferível/editável). Quando o mesmo romaneio aparece mais de uma vez em Pagamentos, cada linha é tratada como uma parcela daquela viagem.
- O Dono ANTT de cada viagem vem do Cadastro de Veículos, pela Placa (também conferível no mapeamento de colunas daquela aba). Se a placa não constar no cadastro, a viagem é marcada como "Dono ANTT não encontrado".
- O Cliente de cada viagem é usado para buscar o Supervisor no cadastro Cliente × Supervisor. Sem supervisor cadastrado, a viagem vai para o arquivo "Sem Supervisor".
4. Pontos de atenção
- Dono ANTT não encontrado — a placa da viagem não está no Cadastro de Veículos (ou a coluna de Placa/Dono ANTT não está mapeada corretamente naquela aba).
- Pagamento não lançado para o Dono ANTT — nenhum pagamento com o mesmo romaneio foi encontrado (confira se a coluna de romaneio está mapeada igual nas duas abas, Viagens e Pagamentos).
- Cliente sem supervisor definido — o cliente da viagem não está no Cadastro Cliente × Supervisor.
- Mais de um pagamento lançado — informativo, não é erro; apenas indica que a viagem foi paga em parcelas.
Use o filtro "Ponto de atenção" na aba Validação para ver só as viagens de um tipo específico de erro — útil para resolver um problema de cada vez.
As colunas "Nome" (e "Categorias") do relatório do sistema podem se repetir com significados diferentes (cliente, motorista/dono, descrição da rota) — a ferramenta numera as repetidas como "Nome (2)", "Nome (3)" etc. no seletor de mapeamento. Se um campo vier errado, abra o mapeamento de colunas daquela aba e escolha a coluna certa manualmente — os nomes de coluna variam entre exportações do sistema, então o mapeamento automático é só um palpite inicial.
Diferente da Folha de Agregados.html: aqui não entram descontos (GRAAL, Vale Card, Outros) nem regras de modalidade de pagamento (15+10, 15+20 etc.) — este é o passo de conferência com o supervisor, anterior ao fechamento oficial do mês.