Fretamento - Ficha do Veículo

O que é

A ficha do veículo reúne tudo que envolve a manutenção e a documentação de um ônibus ou van da sua frota própria: os documentos obrigatórios com a data de validade de cada um, o histórico de manutenções preventivas e corretivas, e o registro de abastecimentos com o cálculo automático de consumo e custo por km. É a página que decide se aquele veículo pode ou não ser usado num fretamento novo.

Você chega aqui clicando em qualquer card da tela Fretamento > Frota. Costuma ser depois de um aviso do Dashboard ou da tela de Alertas de que algum documento está vencendo, mas também serve como rotina: lançar o abastecimento do dia, registrar que uma revisão foi feita ou anexar o seguro assim que ele é renovado.

Como usar

1. Vá em Fretamento > Frota na barra lateral e clique no card do veículo que você quer abrir (ou volte para a lista pela seta no canto superior esquerdo do título).
2. No topo, o modelo do veículo aparece como título; embaixo vêm a placa, a quantidade de lugares e a quilometragem atual, que o próprio sistema mantém a partir dos lançamentos de manutenção e abastecimento.
3. Na seção Documentos, clique em Adicionar (canto superior direito do bloco) para abrir a janela de cadastro. Preencha:
   • Tipo - CRLV, seguro, SRC, RCO-V, IPVA, tacógrafo, cronotacógrafo, TAF, licença SISAUT, autorização ANTT ou outros.
   • Número, Emissão e Validade - todos opcionais, mas sem validade o documento não entra nos alertas de vencimento.
   • Arquivo - PDF ou imagem do documento.
   • Bloquear operação quando vencido - veja em "O que você precisa saber antes".
4. Na seção Manutenção, clique em Adicionar e informe o Tipo, o Valor, uma Descrição, a Data prevista e, quando o serviço acontecer, a Data realizada. Km atual atualiza a quilometragem do veículo; Km próxima é só para você planejar a próxima parada. Dá para escolher um Fornecedor já cadastrado e anexar a Nota fiscal.
5. Na seção Abastecimentos, clique em Adicionar. A janela já abre com a data de hoje e a quilometragem atual do veículo preenchidas. Informe Litros e Valor por litro - o Valor total se calcula sozinho - e escolha o Combustível. Deixe Tanque completo marcado sempre que encher o tanque: é isso que permite calcular o consumo em km/L.
6. Para corrigir ou completar um lançamento já feito, clique no ícone de lápis ao lado dele; para removê-lo, no ícone de lixeira (pede confirmação antes de excluir).

O que você precisa saber antes

• Documento bloqueante vencido trava a operação do veículo inteiro. Quando isso acontece, aparece a etiqueta vermelha "Operação bloqueada" ao lado do título e um aviso detalhando quais documentos estão vencidos. Enquanto não renovar, não é possível confirmar novos fretamentos com esse veículo.
• Os tipos que já vêm marcados como bloqueantes ao cadastrar são seguro, SRC, RCO-V, TAF e autorização ANTT - mas o checkbox "Bloquear operação quando vencido" pode ser ligado ou desligado em qualquer documento, inclusive num CRLV ou IPVA que por padrão não bloqueia nada.
• O status da manutenção é calculado sozinho, sem você escolher: Planejada quando a data prevista ainda não chegou, Realizada assim que você preenche a data em que o serviço foi feito, e Atrasada quando a data prevista já passou e a data realizada continua em branco. Manutenções atrasadas aparecem na tela de Alertas da frota, mas não bloqueiam o veículo.
• A quilometragem do veículo é atualizada automaticamente. Toda vez que você lança um abastecimento com odômetro ou uma manutenção com Km atual, o sistema compara com o valor mais alto já registrado (de qualquer uma das duas origens) e mantém esse como a quilometragem atual mostrada no topo da ficha - você nunca precisa editar isso manualmente.
• O consumo em km/L só é calculado com o tanque completo. A conta usa a diferença de odômetro entre dois abastecimentos marcados como "Tanque completo", dividida pelos litros do intervalo. Se você deixar o tanque como parcial ou não informar o odômetro, o abastecimento é registrado normalmente, mas não entra no cálculo de consumo.
• Os seis indicadores acima da lista de Abastecimentos (Consumo médio, Custo por km, Km rodados, Total gasto, Litros, Abastecimentos) somam todo o histórico cadastrado para aquele veículo, não só os itens visíveis na tela.
• Arquivos de documento, nota fiscal de manutenção e de abastecimento aceitam PDF ou imagem (JPG, PNG, WEBP), com até 10 MB. Ao editar um item que já tem arquivo, marque a caixa "remover" se quiser tirá-lo sem enviar outro.

Casos especiais

Veículo sem nenhum lançamento

Quando o veículo acabou de ser cadastrado, as três seções mostram apenas "Nenhum documento cadastrado.", "Nenhuma manutenção registrada." e "Nenhum abastecimento registrado.", e os seis indicadores de consumo aparecem zerados ou com traço. Basta clicar em Adicionar em qualquer seção para começar a preencher.

Só quem tem permissão de edição vê os botões de gerenciar

Os botões Adicionar de cada seção e os ícones de editar e excluir de cada item só aparecem para quem tem permissão para editar dados do Fretamento. Sem ela, a ficha continua visível, mas só para consulta.

Erros comuns e como resolver

• Não consegue salvar um documento, manutenção ou abastecimento sem escolher o Tipo - o campo Tipo é obrigatório nos três cadastros; sem ele o formulário não é enviado.
• "Valor total" e "Litros" não salvam o abastecimento vazios - esses dois campos são obrigatórios no abastecimento, junto com a Data e o Combustível.
• Arquivo recusado ao anexar documento ou nota fiscal - só são aceitos PDF, JPG, JPEG, PNG e WEBP, com até 10 MB; um formato diferente ou um arquivo maior é rejeitado.

Onde encontrar

• URL: /admin/fretamento/frota/{veiculo}
• Caminho no menu: Fretamento > Frota, clicando no card do veículo
• Permissão necessária: ver fretamentos (para consultar) e editar fretamentos (para cadastrar, editar ou excluir)
• Módulo necessário: Fretamento

Veja também

• Fretamento - Frota
• Fretamento - Alertas da Frota