Folha de Pagamento — Agregados

Esta ferramenta roda 100% no seu navegador. Nenhum dado é enviado para servidor nenhum — tudo é calculado localmente em JavaScript. A sessão inteira (todas as abas, cadastros e mapeamentos de coluna) é salva automaticamente neste navegador e recarregada sozinha da próxima vez que você abrir o arquivo.

1. Fluxo do mês

• Abra cada aba de Entrada (Pagamentos, Base de Viagens, e as 3 de Desconto) e arraste o arquivo da planilha (.xlsx, .xls ou .csv) para a área pontilhada, ou clique em "Selecionar arquivo". Também dá pra colar dados manualmente como texto.
• Depois de carregar, confira o bloco "Mapeamento de colunas" — a ferramenta tenta adivinhar qual coluna é qual campo, mas os nomes reais mudam de exportação para exportação. Campos destacados em vermelho não foram identificados; escolha manualmente no seletor. Isso vale para todas as abas, não só Viagens. O mapeamento fica salvo entre sessões — se desconfiar que ficou errado (ex.: por uma correção feita numa versão anterior da ferramenta), use o botão "🔄 Redetectar automaticamente" no canto do bloco para refazer o palpite do zero.
• Toda tabela (de entrada ou cadastro) tem uma caixa de busca logo acima — digite qualquer trecho (placa, nome, valor, romaneio...) para filtrar as linhas mostradas, sem afetar o cálculo nem apagar nada.
• Proprietários, Frota, Regras de Pagamento e Empresa por Cliente são cadastro — ficam guardados entre sessões e não são apagados por "Limpar entradas". Você pode subir um arquivo ali uma vez e só usar "+ Adicionar linha" para incluir informação nova depois, sem precisar reimportar tudo.
• A aba Resultado recalcula automaticamente a cada mudança.
• No fim do mês, use "Limpar entradas (novo mês)" — isso limpa só Pagamentos, Base de Viagens e os 3 Descontos. Cadastro fica intacto.

2. Como a ferramenta cruza os dados

• Placas são sempre comparadas normalizadas: maiúsculas, sem espaços, sem hífen.
• Cada placa é ligada ao Dono ANTT através da aba Proprietários.
• Na aba GRAAL, a placa é extraída do campo "Placa / Motorista" (tudo antes da primeira barra "/").
• Uma viagem é excluída do cálculo (mas continua visível, riscada, na tabela) se o Status for "Cancelado" ou se a placa pertencer à aba Frota (veículo próprio da empresa).
• Um pagamento é considerado "já efetuado" quando o campo Nº Movimentação está preenchido; se estiver vazio, é "pendente". Tipo "Crédito" soma o valor, "Débito" subtrai.
• O vínculo entre Pagamentos e Base de Viagens é feito pelo número de romaneio. Pagamentos avulsos, sem número, não entram em nenhum cálculo por Dono ANTT.
• A aba Resultado junta todos os clientes numa tabela só — use o filtro "Cliente" (mostra quantas viagens tem cada um, entre parênteses) para ver um cliente específico ou "Todos" para o consolidado. O filtro "Empresa" (MFA/FMX) vem do Cliente da própria viagem, não do cadastro de veículos: qualquer cliente listado na aba "Empresa por Cliente" é FMX, todo o resto é MFA automaticamente. Descontos (que não têm Cliente) herdam a empresa do Dono ANTT, conforme as viagens que ele fez no mês (se ele atendeu as duas empresas, aparece "MFA + FMX"). A opção "(Sem empresa definida)" no filtro pega o raro caso de um Dono ANTT com desconto lançado mas nenhuma viagem no mês para descobrir a empresa.
• A aba Empresa por Cliente (grupo Cadastro) mantém a lista de clientes da FMX — edite lá se um cliente novo virar FMX, ou se a Besni deixar de ser a única.
• Os KPIs "Viagens carregadas (total)", "Excluídas (cancelada/frota)" e "Contabilizadas no Resultado" no topo não mudam com o filtro de Cliente/Empresa — são a conferência de que nenhuma viagem da planilha ficou de fora: total = excluídas + contabilizadas, sempre. "Viagens no filtro atual" mostra quantas estão sendo somadas na visão de agora.
• Descontos de placas da Frota própria não são contabilizados — se algum lançamento de GRAAL/Vale Card/Outros vier com placa da Frota, ele é ignorado (a empresa não lança desconto para veículo próprio). O contador "Descontos de frota ignorados" no topo do Resultado mostra quantos foram descartados.
• Desconto com placa sem cadastro: se a placa do desconto não é da Frota e também não está cadastrada em Proprietários, o lançamento não vira uma linha "(Sem proprietário cadastrado)" no Resultado — em vez disso, aparece como alerta no aviso amarelo no topo da aba, com a fonte, a placa e o valor, para você corrigir o cadastro ou investigar.
• Alerta de pagamento fora do Dono ANTT: o campo "Contratado" de cada pagamento é comparado com o Dono ANTT da viagem daquele romaneio (via placa → Proprietários). Se não baterem, a viagem entra no contador "Pagamentos fora do Dono ANTT" e aparece marcada na coluna "Alerta" do relatório individual — sinal de que o pagamento pode ter sido lançado para a pessoa errada.

3. Regra de Pagamento, filtros e ordenação

Cada Dono ANTT tem uma modalidade de pagamento (15+10 por padrão, salvo exceções cadastradas na aba "Regras de Pagamento"). No Resultado, use os filtros (Cliente, Empresa, Regra, Desconto, Divergência, Pagto. fora do Dono ANTT, Buscar) para restringir a visualização — os botões de ação e o contador de KPIs consideram só as linhas visíveis pelo filtro atual. Clique no cabeçalho de qualquer coluna para ordenar por ela (do menor para o maior na primeira vez, clique de novo para inverter).

4. Ver detalhe, copiar romaneios e exportar

• Clique no nome do Dono ANTT (sublinhado, na tabela) para abrir uma janela com o detalhe completo — viagens, descontos e valor final — igual ao relatório em Excel, mas na hora, sem precisar baixar nada.
• Todo card de KPI é clicável (como um painel de BI): "Divergências", "Total Desconto" e "Pagamentos fora do Dono ANTT" filtram a tabela na hora; "Descontos de frota ignorados" e "Excluídas" abrem a lista exata por trás do número; os demais cards abrem "Ver tudo" — todas as viagens e descontos que compõem aquele número, com a coluna Dono ANTT, sem precisar abrir um por um.
• Buscar viagem por romaneio (acima da tabela) ignora todos os filtros — sempre responde a quem aquele romaneio pertence, mesmo que um filtro de Cliente/Empresa esquecido ligado estivesse escondendo aquele Dono ANTT da tabela principal. Use "Limpar filtros" ao lado se desconfiar que algo está escondido.
• Copiar romaneios e Baixar selecionados agem sobre os Donos ANTT marcados na caixinha da tabela; se nada estiver marcado, agem sobre todas as linhas visíveis pelo filtro atual.
• Copiar romaneios junta os romaneios numa lista separada por vírgula, sem espaço, pronta para colar no sistema.
• Exportar Excel (tabela) baixa a tabela de resultado inteira (linhas visíveis) num .xlsx, com divergências destacadas.
• Baixar selecionados gera um relatório individual (Excel ou PDF, à sua escolha) por Dono ANTT — com resumo (incluindo o período das viagens, pela data "Agendado Em"), lista completa das viagens (agendamento, cliente, nº pedido, identificação, placa, motorista, rota, valores e alerta de contratado) e lista de descontos. O nome do arquivo é sempre o nome do Dono ANTT. Se mais de um for selecionado, tudo vem numa pasta .zip.

5. Desconto - Outros: lançar direto na ferramenta

Além de importar planilha, dá pra adicionar um lançamento de desconto avulso direto na aba "Desc. Outros": escolha uma Placa (o Dono ANTT é preenchido sozinho) OU um Proprietário direto (sem vincular placa nenhuma). Em ambos os casos, só é possível escolher algo já cadastrado na aba Proprietários, clicando numa opção da lista — não é possível digitar um nome/placa livre e confirmar sem clicar, para não cadastrar algo inexistente.

6. Divergências

Linhas em vermelho indicam que pelo menos uma viagem daquele Dono ANTT tem o Total Nativo diferente do Total Calculado (mesmo que a soma geral do Dono ANTT pareça bater — divergências que se compensam entre viagens diferentes também contam). O contador no topo do Resultado mostra quantos Donos ANTT (dentro do filtro atual) têm divergência.