Fretamento - Editar Contrato Mensal

O que é

Esta é a tela de edição de um contrato de fretamento contínuo (recorrente): aquele serviço de transporte de funcionários, escolar, corporativo ou de eventos que se repete toda semana, com rota, dias e horários fixos, e é cobrado por mensalidade ou por viagem realizada — diferente do fretamento avulso, que é uma viagem única. Aqui você reúne, num só formulário, o contratante, o trajeto e a recorrência, o veículo e o motorista alocados, e as regras de faturamento mensal.

Você chega aqui clicando em Editar na ficha de um contrato já existente, na lista Contratos mensais do menu Fretamento. O código do contrato (no padrão FCT-ANO-SEQUENCIAL) e a situação atual — Ativo, Suspenso ou Encerrado — aparecem no cabeçalho, ao lado da seta que volta para a ficha do contrato; nenhum dos dois é alterado por este formulário.

Como usar

1. Na seção Contratante, busque um cliente já cadastrado em Cliente cadastrado (opcional) ou preencha manualmente Nome / empresa (único campo obrigatório desta seção), CNPJ / CPF, E-mail e Telefone. Em Tipo de serviço, classifique o contrato como Transporte de funcionários, Fretado escolar, Corporativo, Eventos recorrentes ou Outros.
2. Em Rota e recorrência, informe Origem e Destino do trajeto fixo, marque os dias em Dias da semana (o dia marcado fica destacado em laranja) e defina Horário de ida e Horário de volta. Preencha Início da vigência (obrigatório) e, se o contrato tiver data para acabar, Fim da vigência; deixando em branco, o contrato fica sem prazo de término.
3. Em Alocação, escolha o Veículo preferencial e o Motorista entre os cadastros ativos da sua frota, e informe a quantidade em Passageiros.
4. Em Faturamento, escolha o Tipo de faturamento: Mensal (valor fixo) mostra o campo Valor mensal; Por viagem (informo as viagens) mostra Valor por viagem no lugar. Defina o Dia de vencimento (de 1 a 28) e, se aplicável, a Forma de pagamento. Use Lembrete de reajuste para guardar uma data de revisão do valor e Observações internas para anotações que só a sua equipe vê.
5. Em Contrato assinado (PDF), anexe ou substitua o arquivo do contrato assinado (até 10 MB, apenas PDF).
6. Clique em Salvar alterações, no final da página. Enquanto você mexe nos campos, a tela avisa "Alterações não salvas"; Cancelar volta para a ficha do contrato sem gravar nada.

O que você precisa saber antes

• Esta tela não muda o status do contrato. Suspender, reativar ou encerrar o contrato são ações da ficha do contrato (a tela anterior a esta), não deste formulário de edição.
• Mudar o valor aqui não altera faturas já geradas. Só as faturas futuras, geradas depois da alteração, usam o novo valor mensal ou por viagem — as que já existem continuam com o valor antigo.
• Selecionar um cliente cadastrado só preenche Nome/empresa e CNPJ/CPF automaticamente se esses campos estiverem vazios no momento de salvar. Se o contrato já tem um nome digitado manualmente (diferente do cliente escolhido), ele não é sobrescrito.
• O veículo só fica bloqueado no calendário dentro das janelas configuradas (dias da semana e horários de ida/volta). Fora desses horários, ele continua disponível para fretamento avulso normalmente.
• O dia de vencimento aceita só de 1 a 28, justamente para existir em todos os meses do ano (evita cair num dia 29, 30 ou 31 que não existe em fevereiro, por exemplo).
• O código do contrato não pode ser alterado aqui nem em nenhuma outra tela: ele é gerado automaticamente na criação.

Casos especiais

Contratante sem cadastro na sua base

Deixe Cliente cadastrado (opcional) vazio e preencha Nome / empresa diretamente — é o único campo obrigatório da seção Contratante. CNPJ/CPF, e-mail e telefone continuam opcionais.

Trocar o tipo de faturamento

Ao alternar entre Mensal (valor fixo) e Por viagem (informo as viagens), o campo de valor ao lado troca automaticamente: Valor mensal some e dá lugar a Valor por viagem, ou vice-versa. Preencha o campo que ficou visível; o outro não é exigido.

Já existe um PDF de contrato anexado

Quando o contrato já tem um arquivo salvo, a tela mostra o link ver PDF para abri-lo e o checkbox remover para apagar o arquivo atual. Escolher um novo arquivo em Contrato assinado (PDF) substitui o anterior ao salvar.

Forma de pagamento antiga fora da lista atual

Se o contrato foi cadastrado com uma forma de pagamento que não existe mais na lista padrão, ela continua aparecendo selecionada no campo Forma de pagamento, com o aviso "(texto antigo, escolha uma da lista)" — vale a pena trocar para uma das opções atuais na próxima edição.

Erros comuns e como resolver

• "O campo valor mensal é obrigatório quando faturamento tipo for mensal_unico." (ou a versão equivalente para valor por viagem) - Causa: você escolheu o tipo de faturamento mas deixou o campo de valor correspondente em branco. Solução: preencha Valor mensal (se o tipo for Mensal) ou Valor por viagem (se o tipo for Por viagem).
• Mensagem pedindo que o fim da vigência seja igual ou posterior ao início - Causa: a data em Fim da vigência ficou anterior à de Início da vigência. Solução: ajuste as datas ou deixe o fim em branco para contrato sem prazo.
• "O campo dia vencimento deve ser um número inteiro." ou fora do intervalo permitido - Causa: valor digitado fora de 1 a 28. Solução: informe um dia entre 1 e 28.
• "O campo contrato pdf deve ser um arquivo do tipo: pdf." - Causa: o arquivo selecionado não é um PDF. Solução: anexe o contrato em formato PDF.
• Erro de tamanho no upload do contrato - Causa: o arquivo passa de 10 MB. Solução: comprima o PDF ou anexe uma versão menor.

Onde encontrar

• URL: /admin/fretamento/contratos/{contrato}/edit
• Caminho no menu: Fretamento > Contratos mensais, abra o contrato e clique em Editar
• Permissão necessária: fretamento.edit
• Módulo necessário: Fretamento

Veja também

• Fretamento - Dashboard - indicadores do mês, incluindo a receita recorrente (MRR) dos contratos mensais
• Fretamento - Agenda da Frota - onde os dias e horários do contrato aparecem bloqueando o veículo
• Fretamento - Editar Fretamento - edição do fretamento avulso (viagem única), diferente deste contrato recorrente