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.

1.Códigos de Precificação (Cobrança do Cliente)

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:

  • A franquia inicial: O primeiro comando avisa o sistema que qualquer corrida de até 5 km terá o custo fixo de R$ 15,00.

  • O cálculo do excedente: Se a corrida passar de 5 km, ela cai na regra do SENAO. O sistema pega a distância total, subtrai os 5 km que já estão inclusos no preço base, e multiplica apenas a distância extra por R$ 1,50.

  • Na prática: Uma corrida de 8 km custaria os R$ 15,00 da base + R$ 4,50 pelos 3 km excedentes (Total: R$ 19,50).


2. Códigos para a Variável do Entregador (Cálculo de Repasse)

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:

  • O valor base: Primeiro, o sistema calcula a distância total da corrida vezes R$ 1,20 e guarda esse valor na "VAR_A" (Variável A).

  • O teste do dia: O sistema verifica em que dia a corrida foi criada usando o comando [DIA_SEMANA].

  • O bônus de domingo: Se o dia for igual a [DOMINGO], o entregador recebe o valor do trajeto (VAR_A) + um bônus fixo de R$ 5,00. Se for qualquer outro dia da semana (SENAO), ele recebe apenas o valor padrão do trajeto.

3. Tipos de Serviço e Veículos

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.).

  • Motos e Bikes: [MOTOBOY], [MOTOTAXI], [ENTREGA_BICICLETA], [ENTREGA_MOTO_PONTO_PONTO], [ENTREGA_MOTO_PART_TIME], [ENTREGA_MOTO_FULL_TIME].

  • Carros e Utilitários: [ENTREGA_CARRO], [ENTREGA_PICAPE], [ENTREGA_VAN], [ENTREGA_UTILITARIO], [ENTREGA_TRANSPORTE_CARRO], [ENTREGA_PASSEIO_PART_TIME], [ENTREGA_PASSEIO_FULL_TIME], [ENTREGA_FIORINO_500_KG], [ENTREGA_VAN_1200_KG].

  • Caminhões e Pesados: [ENTREGA_VUC], [ENTREGA_CAMINHAO], [ENTREGA_TRUCK], [ENTREGA_CARRETA], [ENTREGA_VUC_PLATAFORMA], [ENTREGA_CAMINHAO_BAU], [ENTREGA_CAMINHAO_TOCO_BAU_M_FULL_TIME].

  • Equipamentos e Especiais: [ENTREGA_ENTREGADOR_BAG], [ENTREGA_ENTREGADOR_BAU], [ENTREGA_ENTREGADOR_MOCHILA], [ENTREGA_REBOQUE], [ENTREGA_GUINCHO], [ENTREGA_OUTRO_UM].

  • Categorias Premium/Urgentes: [ENTREGA_TRANSPORTE_CARRO_ECONOMICO], [ENTREGA_TRANSPORTE_CARRO_PREMIUM], [ENTREGA_MOTOBOY_ENTREGADOR_PREMIUM], [ENTREGA_MOTOBOY_ENTREGADOR_URGENTE].

Exemplo: variável diferente para cada categoria de veículo

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.