Cadastrando um contrato
Olá seja bem vindo(a) a mais esse artigo, hoje você vai aprender como cadastrar um contrato de maneira bem simples.
O primeiro passo é acessar o menu onde o contrato será cadastrado e clicar no botão "Novo"
Para isto use o menu: Transportadoras > Contratos > Novo
Esse caminho é para contratos de Compra (vinculados a uma tabela de transportadora). Para cadastrar um contrato de Venda (vinculado a um cliente ou a um grupo de clientes), use em vez disso o menu: Clientes > CONTRATOS > Novo. As duas telas funcionam da mesma forma — a diferença está no vínculo (transportadora de um lado, cliente do outro) e nos campos explicados a seguir.
O menu Clientes > CONTRATOS aparece apenas para usuários internos com a permissão correspondente. Clientes e transportadoras que acessam pelo portal não veem esta tela.
Após o acesso, o sistema vai abrir os dados para cadastro do contrato de frete, onde eles deve ser preenchidos de acordo com a necessidade do contrato.
Explicando os principais itens do contrato:
Classe: Neste ponto há dois tipo de classe, "Valor recorrente" e "Tabela de Frete". O mais utilizado é o tipo "Tabela de Frete" que será vinculada uma tabela ao contrato. O tipo "Valor Recorrente" como o nome já indica será um valor fixo e recorrente, sem vinculo a qualquer tabela.
Compra/Venda: Compra deve ser utilizado para contratos vinculados a tabelas das transportadoras, e Venda deve ser utilizado para contratos vinculados a tabela de clientes.
Grupo tomador do serviço: selecione o grupo de clientes ao qual o contrato se aplica — qualquer cliente pertencente a este grupo pode ter o frete calculado por este contrato.
Cliente: selecione um cliente específico, quando o contrato valer só para ele (em vez de um grupo inteiro).
Estes dois campos só aparecem quando o contrato é do tipo Venda. Preencha pelo menos um dos dois — um contrato de Venda sem Cliente nem Grupo tomador do serviço vinculado nunca é usado no cálculo do frete, mesmo estando vigente e aprovado — o sistema simplesmente o ignora e segue calculando pela proposta comercial do cliente, como se o contrato não existisse. Se tentar salvar sem preencher nenhum dos dois, o sistema impede e mostra o aviso: "Vincule um cliente ou o grupo tomador do serviço: sem isso, o contrato de venda é ignorado pelo cálculo de frete."
Transportadora: Selecionar o grupo da transportadora que o contrato vai ser utilizado.
Transportadora (Filial): Selecionar a transportadora (unidade) que o contrato vai ser utilizado.
Descrição: Campo livre para colocar a descrição de identificação do contrato, porém, é um campo obrigatório de preenchimento.
Vigência do contrato: Há dois campos para indicar a vigência de inicio e fim, se não preenchida a data de inicio o sistema atribui a data da aprovação do contrato. A data de termino se não preenchida deixa o contrato valido até que seja revogado.
Modal: Selecionar o modal de transporte vinculado a este contrato.
Operação: Selecionar a operação de transporte vinculada a este contrato.
Tipo de DT a ser gerado: Utilizar sempre "PréDT", outras opções devem ser selecionadas caso seja indicado pela equipe da Tecnovia.
Após o preenchimento dos dados básicos do contrato, será necessário indicar a tabela que será vinculada ao contrato.
Neste caso a dois campos a serem preenchidos:
Tabela de frete: Seleciona a tabela da transportadora a ser vinculada ao contato.
Versão da tabela de frete: Se selecionado a versão, este contrato sempre irá calcular na versão indicada, mesmo que a tabela sofra atualizações, o sistema irá sempre calcular pela versão indicada.
Obs.: Geralmente a versão da tabela de frete é utilizada em branco, desta forma qualquer alteração na tabela associada ao contrato já estará vigente.
Após o preenchimento de todos os dados é só gravar/salvar o contrato na parte superior, clicando no link "SALVAR".
Para que o contrato fique vigente é necessário fazer a aprovação, clicando no link "APROVAR".
O que muda no cálculo do frete quando o contrato é de Venda: a partir do momento em que um contrato de Venda vigente e aprovado tem o Cliente (ou Grupo tomador do serviço) preenchido casando com o Tomador de uma carga, o sistema passa a calcular o frete dessa carga pela tabela do contrato — mesmo que esse cliente já tenha uma proposta comercial cadastrada e em vigor. A proposta deixa de ser consultada para esse cliente enquanto o contrato estiver vigente. Se quiser que um cliente continue sendo calculado pela proposta comercial, não cadastre (ou revogue) o contrato de Venda vinculado a ele.
Identificando contratos de Venda sem vínculo na lista: na tela de contratos de clientes (Clientes > CONTRATOS), um contrato de Venda sem Cliente nem Grupo tomador do serviço vinculado aparece com um ícone de aviso ao lado do nome. Passe o mouse sobre o ícone para ver a explicação: "Sem cliente nem grupo tomador do serviço vinculado, o cálculo de frete ignora este contrato de venda." Use este indicador para encontrar rapidamente contratos que precisam ser corrigidos — normalmente contratos antigos, cadastrados antes de o vínculo ser obrigatório.
Filtrando a lista: na tela de contratos de clientes, os filtros de busca são por Cliente e Grupo tomador do serviço — na tela de contratos de compra (Transportadoras), os filtros equivalentes são por Transportadora e Grupo de transportadora.
Quando a tabela do contrato foi excluída
Uma tabela de frete excluída deixa de valer a partir da data em que foi excluída. Se o cálculo de um frete chega a uma condição dessa tabela, o sistema não calcula e avisa, em vez de seguir usando a tabela excluída sem que ninguém perceba. Isso vale para qualquer cálculo com data igual ou posterior à exclusão: a simulação de frete, a geração de um DT e o recálculo de um DT.
Como reconhecer
Na memória de cálculo da simulação (ou do DT) aparece uma mensagem como esta:
"Não foi possível calcular o frete: a tabela de frete "TAB-EXEMPLO" foi excluída em 27/10/2026 15:52 e ainda é usada pelo contrato nr. 274 (Descrição do contrato). Corrija o cadastro (troque a tabela ou encerre a referência) antes de calcular."
Ela diz três coisas: qual tabela foi excluída, quando foi excluída e quem ainda aponta para ela. Quem aponta pode ser:
- Um contrato: "…ainda é usada pelo contrato nr. N (descrição)".
- Uma condição de outra tabela que remete a ela (a "cascata"): "…ainda é usada pela condição "C" da tabela "T"". Nesse caso a tabela principal está viva, mas uma de suas condições manda calcular por uma tabela que foi excluída.
- A tabela padrão da unidade: "…ainda é usada como tabela padrão da unidade".
- A proposta comercial do cliente ou o cadastro da transportadora: "…ainda é usada pela proposta comercial do cliente ou pelo cadastro da transportadora".
Quando o cálculo não sai, a memória termina com uma linha "Não foi possível efetuar o cálculo…", e a simulação não mostra valor de frete.
O que o sistema faz e o que não faz
- Só recusa se o frete realmente passaria pela tabela excluída. Se a tabela excluída não tem nenhuma condição que atenda àquele frete (por exemplo, é de um contrato que só cobre outra região), ela simplesmente fica fora do cálculo, sem erro, e o frete é calculado pelos demais contratos. Por isso a mensagem pode aparecer para uma rota e não para outra da mesma transportadora.
- Não escolhe outro caminho por conta própria. O sistema não troca para outro contrato, outra condição ou a tabela padrão para "dar um jeito": quem decide qual tabela vale é o cadastro, e é ele que precisa ser corrigido.
- A data do cálculo importa. Uma tabela excluída em 27/10 continua calculando normalmente para datas anteriores a 27/10. Por isso um DT gerado antes da exclusão pode ser recalculado pela tabela da época, e o valor se mantém. Já um DT gerado depois da exclusão, ao ser recalculado, fica com valor zero e sem componentes, e a memória do DT traz a mensagem acima.
Atenção: antes de recalcular DTs de uma transportadora cuja tabela foi excluída, corrija o cadastro. Recalcular antes de corrigir zera o valor do DT gerado depois da exclusão.
Como corrigir
Identifique na mensagem quem ainda aponta para a tabela excluída e escolha uma das saídas:
- Contrato que ainda vale: abra o contrato e, nos campos Tabela de frete e Versão da tabela de frete, escolha uma tabela vigente no lugar da excluída.
- Contrato que não vale mais: encerre a vigência do contrato (preenchendo a data de término em Vigência do contrato) ou revogue-o, para que ele deixe de ser considerado nos próximos cálculos.
- Cascata: abra a tabela citada na mensagem ("da tabela "T""), localize a condição indicada e troque a tabela para a qual ela remete por uma vigente, ou retire a referência, se aquela condição não deve mais calcular por outra tabela.
- Tabela padrão da unidade, proposta comercial ou cadastro da transportadora: troque a tabela no cadastro indicado na mensagem. Se não encontrar onde, abra um chamado de suporte informando o texto da mensagem.
Depois da correção, refaça a simulação para confirmar que o frete volta a ser calculado.
Contrato ignorado por falta de versão em vigor
Há um caso parecido, mas que não trava o cálculo. Se um contrato de Compra com reajuste automático aponta para uma tabela que ainda não tinha nenhuma versão criada na data do cálculo, o sistema ignora esse contrato, registra na memória uma linha como "Contrato nr. N (descrição) foi selecionado, mas sua tabela não tem versão em vigor em [data] — contrato ignorado." e segue calculando pelos demais contratos. Se o contrato deveria ter sido usado, confira a vigência do contrato e a data de criação da versão da tabela: o início do contrato precisa ser igual ou posterior à criação da primeira versão.
