Fretamento - Lista de Fretamentos

O que é

A tela Fretamentos é a porta de entrada do módulo: reúne todos os orçamentos e locações de veículo cadastrados, do primeiro contato com o cliente até o fim da viagem. Aqui entra a locação avulsa (viagem única); o transporte contratado todo mês tem tela própria, em Contratos mensais.

Você chega aqui pelo menu Fretamento > Fretamentos na barra lateral, ou clicando em Ver fretamentos no Dashboard do módulo. É o ponto de partida do dia a dia operacional: de um lado mostra quantos fretamentos você tem em cada situação e quanto faturou no mês, do outro permite agir direto em cada um — confirmar, editar, duplicar, cancelar ou excluir — sem abrir a ficha completa.

Como usar

1. Vá em Fretamento > Fretamentos na barra lateral.
2. No topo, ao lado do título Fretamentos, você vê quantos fretamentos a lista está mostrando. À direita, troque o modo de visualização da mesma frota entre Lista (esta tela), Agenda (linha do tempo dos veículos) e Mês (visão mensal consolidada). O botão Novo fretamento abre o formulário para montar um orçamento do zero.
3. Logo abaixo, quatro indicadores resumem o módulo: Total (todos os fretamentos, de orçamento a cancelado), Orçamentos (aguardando confirmação do cliente), Confirmados (soma de confirmados e em andamento) e Faturamento do mês (valor dos fretamentos confirmados, em andamento ou concluídos com saída neste mês).
4. Na barra de filtros, digite no campo Buscar por código, cliente, rota... para procurar por essas três informações. Em Status, escolha ver só um status específico (Orçamento, Confirmado, Em andamento, Concluído ou Cancelado). Em Veículo, filtre pelos ônibus ativos da sua frota própria. Clique em Filtrar para recarregar a lista.
5. Cada card da lista mostra o código (que começa com FRT-), o nome do cliente, a etiqueta de status, a rota de origem e destino, as datas de saída e retorno, o valor total e o veículo alocado. A barra colorida à esquerda do card também indica o status.
6. No rodapé de cada card ficam dois atalhos: Editar (quando o fretamento ainda pode ser alterado) e Visualizar. O restante das ações fica no dropdown Ações, que muda conforme a situação do fretamento: Confirmar (só em orçamento), Duplicar, Cancelar e Excluir.
7. Use a paginação no rodapé da tela para navegar entre as páginas, quando houver mais de 15 fretamentos.

O que você precisa saber antes

• O indicador Total conta tudo, inclusive os cancelados. Já Confirmados soma dois status ao mesmo tempo — confirmado e em andamento —, então não corresponde a nenhum filtro de status sozinho na barra de filtros.
• O Faturamento do mês usa a data de saída, não a data em que o fretamento foi criado ou confirmado. Um fretamento fechado hoje mas com saída marcada para o mês seguinte só entra no faturamento quando aquele mês chegar.
• Confirmar bloqueia se o veículo tiver documento vencido que impeça a operação (seguro, ANTT etc.). Nesse caso a confirmação não acontece e a tela avisa qual documento está pendente, com um atalho para a Frota.
• Duplicar cria um fretamento novo, sempre como Orçamento, copiando os dados do original (cliente, roteiro, veículo, valores) e zerando o que é específico daquele contrato: código, valor pago, PDF do contrato e dados da licença de viagem. Depois de duplicar, você é levado direto para a edição do novo fretamento.
• Cancelar é o que acerta o financeiro, a exclusão só esconde o registro. Por isso um fretamento Confirmado, Em andamento ou Concluído não pode ser excluído direto: os dois primeiros status precisam ser cancelados antes (é o cancelamento que estorna a receita); um fretamento Concluído nunca pode ser excluído.
• Excluir pede a palavra EXCLUIR digitada na confirmação, mesmo depois de já ter clicado no botão — é uma segunda trava contra exclusão acidental.
• Editar só aparece para Orçamento e Confirmado. Em andamento, Concluído e Cancelado não podem mais ser alterados por essa tela.
• O filtro de Veículo só lista os ativos da sua frota própria. Fretamentos feitos com veículo de terceiro ou ainda sem veículo definido não aparecem nesse filtro, embora continuem na lista geral.

Casos especiais

Nenhum fretamento cadastrado

Quando não há fretamentos (ou o filtro aplicado não encontra nenhum), a lista mostra a mensagem "Nenhum fretamento cadastrado" com um atalho direto para Novo fretamento.

Tentando excluir um fretamento que precisa ser cancelado antes

Para um fretamento Confirmado ou Em andamento, o item Excluir do dropdown Ações aparece desabilitado, com o rótulo "Excluir (cancele antes)". Clicar nele mostra um aviso explicando que é preciso cancelar primeiro.

Erros comuns e como resolver

• "Apenas orçamentos podem ser confirmados." - Causa: o fretamento já não está mais em Orçamento quando a confirmação é processada. Solução: atualize a página; o botão Confirmar só deveria aparecer para fretamentos ainda em orçamento.
• "Não é possível confirmar: o veículo [modelo] tem documento(s) vencido(s)..." - Causa: o veículo escolhido tem um documento bloqueante vencido (seguro, licença etc.). Solução: regularize o documento em Fretamento → Frota antes de confirmar.
• "Este fretamento não pode ser cancelado." - Causa: o fretamento já está Concluído ou já está Cancelado. Solução: nenhuma ação é necessária, o status já é definitivo.
• "Só é possível excluir um fretamento em orçamento ou cancelado. Cancele-o primeiro." - Causa: tentativa de excluir um fretamento Confirmado, Em andamento ou Concluído. Solução: cancele o fretamento primeiro (exceto Concluído, que não pode ser excluído de forma alguma).
• "Para excluir, digite EXCLUIR na confirmação." - Causa: a palavra de confirmação não foi digitada corretamente na modal de exclusão. Solução: digite exatamente EXCLUIR, em maiúsculas, no campo da modal.

Onde encontrar

• URL: /admin/fretamento
• Caminho no menu: Fretamento > Fretamentos
• Permissão necessária: ver fretamentos
• Módulo necessário: Fretamento

Veja também

• Fretamento - Novo Orçamento
• Fretamento - Editar Fretamento
• Fretamento - Dashboard
• Fretamento - Fechados
• Fretamento - Agenda da Frota