Dicionário de códigos de precificação e variáveis de entregador
8 min
Criado por Leandro Pires Nunes em 27/08/2026 14:00
Atualizado por Leandro Pires Nunes em 30/08/2026 20:57
Para criar regras de cobrança para o cliente solicitante ou definir o repasse da sua frota, o sistema utiliza códigos (termos em texto que representam dados reais da corrida). Abaixo está o dicionário completo com todas as opções disponíveis no seu ambiente administrativo para montar as suas fórmulas.
Estes códigos são usados na tabela de preços para calcular o valor final que o cliente solicitante pagará pela corrida.VariávelO que representa na fórmula[KILOMETRAGEM_TRAJETO]Distância total da corrida.[KILOMETRAGEM_TRECHO_1] a [5]Distância de trechos específicos (do ponto 1 ao 5).[KM_INICIAL]Franquia de quilometragem inicial estipulada.[KM_SEM_RETORNO]Distância total descontando o trajeto de volta.[QTD_LOCAIS]Número total de pontos na rota (incluindo coleta).[QTD_ENTREGAS]Número de pontos de entrega.[TAXA_FIXA]Valor base e fixo da corrida.[VALOR_PONTO]Valor cobrado por cada ponto de parada.[VALOR_RETORNO]Valor cobrado se houver ponto de retorno.[VALOR_KM]Preço padrão por quilômetro rodado.[VALOR_KM_1] a **[10]Preços específicos por faixas de quilometragem.[VALOR_ENTREGA_IFOOD]Valor repassado via integração iFood.[CIDADE]**Identificação da cidade onde a corrida ocorre.**Exemplo de Precificação (O que o cliente solicitante paga)**Neste cenário, vamos criar uma regra que cobra um valor fixo para corridas curtas e adiciona uma taxa por quilômetro extra para viagens mais longas.SE( [KILOMETRAGEM_TRAJETO] <= 5 ){ RESULTADO = 15 }SENAO{ RESULTADO = 15 + (([KILOMETRAGEM_TRAJETO] - 5) * 1.50) }A lógica por trás do código:
Estes códigos são exclusivos para a criação da Variável do Entregador, definindo o quanto ele ganha financeiramente por cada rota concluída.VariávelO que representa na fórmula[VALOR_ENTREGA]Valor base de ganho pela corrida.[KILOMETRAGEM_TRAJETO]Distância total percorrida pelo entregador.[KILOMETRAGEM_TRECHO_1] a [10]Distância exata de cada percurso da rota.[DISTANCIA_BASE_KM]Quilometragem base definida para a operação.[QTD_LOCAIS]Total de paradas que o entregador fará.[QTD_ENTREGAS]Total de pacotes/entregas daquela rota.[QTD_OS_DIA] / [QTD_ENTREGAS_DIA]Número de corridas concluídas no dia pelo entregador.[QTD_ENTREGAS_DIA_ANTIGO]Histórico de corridas finalizadas no dia anterior.[VALOR_ENTREGA_IFOOD]Repasse originário de rotas do iFood.[VALOR_PRODUTOS]Valor total das mercadorias transportadas.[MAX_VALOR_REGIAO_TRAJETO_COLETA]Teto de ganho configurado para a região de coleta.[HORA_ATUAL] / [HORA_PEDIDO]Horário em que o sistema roda o cálculo / Horário de criação.[DIA_SEMANA] / [DIA_SEMANA_PEDIDO]Dia atual / Dia em que a corrida foi solicitada.[DOMINGO] a **[SABADO]**Usados para criar valores diferenciados por dia (ex: taxa de final de semana).**Exemplo de Variável do Entregador (O que a frota recebe)**Neste cenário, vamos usar as variáveis exclusivas de repasse para criar um ganho por quilômetro rodado e incluir um bônus automático para quem trabalhar aos domingos.VAR_A = [KILOMETRAGEM_TRAJETO] * 1.20;SE( [DIA_SEMANA] == [DOMINGO] ){ RESULTADO = VAR_A + 5 }SENAO{ RESULTADO = VAR_A }A lógica por trás do código:
Tanto na precificação quanto no repasse, você pode usar a condição [TIPO_SERVICO] combinada com o código do veículo para cobrar ou pagar valores diferentes de acordo com a categoria de veículo (moto, carro, bicicleta, caminhão etc.).
Neste cenário, o entregador de carro recebe mais por quilômetro que o de moto, e as demais categorias seguem um valor padrão.SE( [TIPO_SERVICO] == [ENTREGA_CARRO] ){
RESULTADO = [KILOMETRAGEM_TRAJETO] * 2.00
}SENAO{
SE( [TIPO_SERVICO] == [MOTOBOY] ){
RESULTADO = [KILOMETRAGEM_TRAJETO] * 1.20
}SENAO{
RESULTADO = [KILOMETRAGEM_TRAJETO] * 1.50
}
}**A lógica por trás do código:**O primeiro teste: o sistema verifica se a corrida foi criada na categoria carro. Se for, o entregador recebe R$ 2,00 por quilômetro rodado.O segundo teste: se não for carro, o sistema testa se é motoboy. Sendo motoboy, o repasse é de R$ 1,20 por quilômetro.O valor padrão: qualquer outra categoria (bicicleta, van, caminhão) cai no último SENAO e recebe R$ 1,50 por quilômetro.Na prática: uma corrida de 10 km paga R$ 20,00 ao entregador de carro, R$ 12,00 ao motoboy e R$ 15,00 às demais categorias.💡 Para adicionar mais categorias, basta encadear novos SE dentro do SENAO, seguindo o mesmo padrão. O mesmo raciocínio vale para a tabela de precificação — trocando os códigos de repasse pelos de cobrança da seção 1.**Ainda precisa de ajuda com a ferramenta?**Se você deseja utilizar alguma dessas variáveis, mas não sabe como estruturar a matemática da fórmula, abra um chamado e nossa equipe te ajudará a validar a lógica de cobrança ou repasse.