Glossário e Racional de Cálculo

Esta página explica, em linguagem simples, os termos usados pelo RotaCerta e exatamente como cada custo do DRE simulado é calculado — sem nenhuma etapa oculta. Toda fórmula aqui é a mesma usada de verdade pelo sistema, não uma aproximação.

📖 Glossário de termos e documentos

O transporte de cargas envolve vários documentos e conceitos que às vezes têm nomes diferentes conforme o sistema/empresa. Aqui está o que cada um significa e como o RotaCerta usa esse conceito.

Viagem

No RotaCerta, é um cálculo de rota completo, do primeiro ponto até o último — pode ter vários pontos no meio (coleta, entrega, pernoite). Não é um documento fiscal; é só o nome que damos pro "conjunto de tudo que você está calculando de uma vez". Uma viagem pode ter vários Segmentos dentro dela.

Segmento

Um pedaço da Viagem que representa um frete cobrado a um cliente específico — vai da chegada até a partida de um ponto (ou entre dois pontos). Pode estar vinculado a um CT-e cadastrado, ter só um nome livre (quando ainda não há CT-e), ou ser marcado como trecho vazio (o caminhão roda sem carga entre dois segmentos, por exemplo indo buscar a próxima coleta).

CT-e (Conhecimento de Transporte eletrônico)

Documento fiscal eletrônico que registra uma operação de frete: origem, destino, cliente (tomador) e valor cobrado. É emitido por operação — cada Segmento com carga cobrada corresponde, na prática, a um CT-e. No RotaCerta, é o cadastro da aba CT-e em Cadastros.

CTRC

No RotaCerta, é como chamamos um CT-e que ainda não foi autorizado pela SEFAZ/Receita — assim que a data de autorização é preenchida no cadastro, ele vira "CT-e" automaticamente (o status é sempre calculado a partir dessa data, nunca marcado manualmente). Esse é o mesmo uso do termo em sistemas como o SSW. Historicamente, "CTRC" também foi o nome do documento em papel que o CT-e eletrônico substituiu — hoje esse uso antigo praticamente não aparece mais.

MDF-e (Manifesto Eletrônico de Documentos Fiscais)

Documento fiscal que agrupa vários CT-e's de uma mesma viagem/veículo — obrigatório em operações interestaduais e cargas fracionadas. É o nível "acima" do CT-e: se o CT-e é o Segmento, o MDF-e é o mais próximo de uma "Viagem" no sentido fiscal. Diferença importante: o MDF-e é emitido de verdade pra Receita; a "Viagem" do RotaCerta é só o cálculo de rota em si, não um documento fiscal — o RotaCerta hoje não emite nem substitui o MDF-e.

CTRB

Não é uma sigla fiscal oficial da Receita — é um nome usado internamente por alguns sistemas de gestão de transporte (TMS) pro nível de "viagem que agrupa manifestos". No RotaCerta, esse conceito é só chamado de Viagem (ver acima).

Romaneio

Lista/checklist do que está sendo transportado (peso, quantidade, descrição dos volumes) — usado pra conferência no embarque/desembarque. Não é um documento fiscal e não substitui o CT-e/MDF-e; é um controle operacional que pode acompanhar a carga. O RotaCerta não gera romaneio hoje.

🧮 Racional de cálculo

Cada linha do DRE simulado é calculada por uma fórmula própria. Quando um dado necessário não está disponível (posto de combustível perto da rota, tarifa de pedágio cadastrada, etc.), a linha aparece como "indisponível" em vez de mostrar um número inventado — essa é uma regra fixa do sistema, não uma falha.

⛽ Combustível

litros = (distância_km ÷ km_por_litro) × fator_consumo
custo  = litros × preço_médio_do_litro

km_por_litro vem do cadastro do veículo (ou de um padrão por tipo de veículo, se não cadastrado). fator_consumo é 1,0 em trechos com carga e menor que 1,0 em trechos vazios (consumo reduzido sem peso). O preço do litro é a média dos postos cadastrados dentro de um raio da geometria da rota (padrão 7km); se nenhum posto aparece nesse raio, a busca é repetida com um raio maior (20km, depois 50km) antes de considerar indisponível.

Fonte do preço: ANP (Agência Nacional do Petróleo), por município, atualizado semanalmente.

🧴 Arla 32/DEF

litros = litros_de_diesel_consumidos × 5%   (ou informado manualmente em L/km)
custo  = litros × preço_do_litro_de_arla

Só calculado quando o combustível do veículo é diesel. O percentual de 5% é uma regra prática usada por motores com sistema SCR (redução catalítica seletiva).

🛣️ Pedágio

Soma o valor de cada praça de pedágio dentro de um raio de 300m da rota, usando a tarifa cadastrada pra aquela praça/categoria de veículo. Caminhão paga a tarifa-base de carro multiplicada pelo número de eixos informado (regra oficial das concessionárias). Quando uma praça no caminho não tem tarifa cadastrada, o sistema tenta completar o valor via Google Routes API.

🔧 Depreciação do veículo

depreciação_por_km = valor_do_veículo ÷ vida_útil_em_km
custo               = depreciação_por_km × distância_km

O valor do veículo vem, em ordem de prioridade: valor informado na requisição → valor FIPE cadastrado manualmente no veículo → valor FIPE sincronizado automaticamente (por marca/modelo/ano) → valor de compra cadastrado → uma sugestão de mercado por tipo de veículo (ajustável em Administração > Depreciação por tipo de veículo). A vida útil em km também vem dessa mesma tabela por tipo de veículo.

🛞 Pneu (cavalo e carreta)

custo_por_km = (número_de_pneus × valor_do_pneu) ÷ vida_útil_do_pneu_em_km
custo        = custo_por_km × distância_km

Só calculado quando esses 3 dados estão cadastrados no veículo/carreta (não há valor padrão global — desgaste de pneu varia demais por veículo).

🌙 Diária do motorista

custo = valor_da_diária × número_de_pernoites

O número de pernoites vem da simulação da jornada do motorista (Lei 13.103/2015): direção contínua máxima de 5h30 exige 30min de pausa; jornada diária de 8h exige 11h de descanso contínuo entre um dia e outro. O valor da diária pode ser informado na requisição, configurado como padrão da empresa em Preferências, ou cai num valor global (Administração > Diária do motorista).

⬜ Deslocamento vazio

Quando um trecho é marcado como "vazio" (caminhão rodando sem carga), o combustível e o arla desse trecho são calculados com um desconto de consumo (configurável em Administração), e o pneu é prorateado pela distância vazia sobre a distância total. No DRE compilado (resumo da viagem inteira), esse custo aparece como uma linha própria — não é somado escondido dentro da linha "Combustível".

⚖️ Piso mínimo de frete (ANTT)

piso = CCD × distância_km + CC
     (+ 0,92 × distância_km × CCD, se marcado "retorno vazio")

CCD (custo por km) e CC (custo fixo) são coeficientes oficiais da ANTT (Resolução 5.867/2020 e atualizações), por tabela/tipo de carga/número de eixos — não são estimativas do RotaCerta, vêm direto da calculadora oficial da ANTT. É o mínimo permitido por lei; não inclui lucro nem os demais custos operacionais listados acima.

💰 Receita do frete (sugestão)

Em ordem de prioridade:

receita_sugerida = custo_total ÷ (1 − alíquota_ICMS% − alíquota_PIS/COFINS% − margem_padrão%)

Essa fórmula (markup) já é calibrada pra que, depois de descontar os impostos (que incidem sobre a receita, não sobre o custo), a margem de contribuição realizada bata exatamente com a margem padrão configurada — sem essa calibragem, a margem real ficaria sistematicamente menor que a configurada.

📊 Margem de contribuição

margem_reais     = receita − (custo_total + comissão_do_motorista + ICMS + PIS/COFINS)
margem_percentual = margem_reais ÷ receita × 100

🧾 ICMS / PIS-COFINS / Comissão do motorista

valor = receita × alíquota%

As 3 são sempre uma alíquota percentual sobre a receita (não sobre o custo). As alíquotas vêm de Administração > Impostos (ICMS/PIS-COFINS) e de Preferências ou padrão global (comissão).

🧮 IBS + CBS (informativo)

valor = receita × 1,0%   (0,9% IBS + 0,1% CBS)

Alíquotas-teste da fase de transição da reforma tributária (2026) — aparecem no documento a título informativo, mas não entram no total de custos nem na margem de contribuição calculada hoje.

📋 CIOT (informativo)

Valor fixo por viagem, configurado em Administração > Impostos — também informativo, não entra no total de custos nem na margem.

✈️ Encargos de aduana / Despachante aduaneiro

Só aparecem quando a viagem é marcada como tendo desembaraço aduaneiro. Os valores são configuráveis (informado na requisição, padrão da empresa em Preferências, ou padrão global).