Este artigo lista os códigos que você pode usar nas fórmulas personalizadas para definir o valor cobrado do cliente solicitante e o repasse ao entregador.
Caminho no ambiente administrativo: Menu Personalização > Precificação > Variáveis Entregador > Fórmulas Personalizadas
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.
| Código | O que representa na fórmula |
|---|---|
| [KILOMETRAGEM_TRAJETO] | Distância total da corrida. |
| [KILOMETRAGEM_TRECHO_1] a [KILOMETRAGEM_TRECHO_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 [VALOR_KM_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, a regra 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)
}
Como funciona:
- Franquia inicial: qualquer corrida de até 5 km custa R$ 15,00.
- Excedente: acima de 5 km, o sistema subtrai os 5 km inclusos e cobra R$ 1,50 por km extra.
- Na prática: uma corrida de 8 km custa R$ 15,00 + R$ 4,50 (3 km excedentes) = R$ 19,50.
2. Códigos para a variável do entregador (cálculo de repasse)
Estes códigos são exclusivos da variável do entregador, que define quanto ele recebe por cada rota concluída.
| Código | O 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 [KILOMETRAGEM_TRECHO_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] ou [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] ou [HORA_PEDIDO] | Horário em que o sistema roda o cálculo / horário de criação da corrida. |
| [DIA_SEMANA] ou [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 fim de semana). |
e [QTD_ENTREGAS_DIA] são equivalentes, ou cada um tem um cálculo próprio?]
Exemplo de variável do entregador (o que a frota recebe)
Neste cenário, o repasse é calculado por quilômetro rodado, com bônus automático de R$ 5,00 para corridas criadas aos domingos.
VAR_A = [KILOMETRAGEM_TRAJETO] * 1.20;
SE( [DIA_SEMANA] == [DOMINGO] ){
RESULTADO = VAR_A + 5
}SENAO{
RESULTADO = VAR_A
}
Como funciona:
- Valor base: a distância total vezes R$ 1,20 é guardada em VAR_A.
- Teste do dia: o sistema verifica o dia em que a corrida foi criada.
- Bônus de domingo: em domingo, o entregador recebe VAR_A + R$ 5,00. Nos demais dias, recebe apenas VAR_A.
3. Tipos de serviço e veículos
Tanto na precificação quanto no repasse, é possível usar a condição [TIPO_SERVICO] combinada com o código do veículo para cobrar ou pagar valores diferentes por categoria (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
}
}
Como funciona:
- Primeiro teste: se a corrida é da categoria carro, o entregador recebe R$ 2,00 por km.
- Segundo teste: se não for carro, verifica se é motoboy, com R$ 1,20 por km.
- Padrão: as demais categorias (bicicleta, van, caminhão) recebem R$ 1,50 por km.
- 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 incluir mais categorias, encadeie novos SE dentro do SENÃO, seguindo o mesmo padrão. A mesma lógica vale para a tabela de precificação, trocando os códigos de repasse pelos de cobrança da seção 1.
Precisa de ajuda com a fórmula?
Se você quer usar alguma dessas variáveis, mas não sabe montar a lógica da fórmula, abra um chamado de suporte. A equipe ajuda a validar a lógica de cobrança ou repasse.