Tabela Dinâmica ( Cadastrar Tarifa ) - devbasetecnologia/devmobility GitHub Wiki

Tabela - Tarifa Dinâmica
Introdução
Configuração
Ativar Tabela Dinâmica no Sistema
Tabela Dinâmica no aplicativo do cliente/passageiro
Tabela Dinâmica no aplicativo do prestador/motorista
Exemplo de uma configuração inicial na Tabela Dinâmica

Tabela - Tarifa Dinâmica

Se preferir, clique aqui para ver o video sobre o assunto.

1. Introdução

O sistema Dev Mobility conta com a funcionalidade de configuração de precificação dinâmica, que permite que os preços sejam alterados de acordo com uma certa quantidade de solicitações em um raio (distância em KM) de verificação definido OU por demanda versus oferta.

Atenção: Para ativar a "Tarifa Dinâmica" na sua plataforma, primeiramente acesse o menu "Configurações > Sistema" e marque a opção "Utiliza Tarifa Dinâmica". Após marcar, clique em "Gravar" mais abaixo.

2. Configuração

A configuração da Dinâmica é feita através da tela: Configurações > Tabela Dinâmica > Cadastrar

Nesta tela deverão ser definidas as regras e fatores de multiplicação que serão aplicadas nas localizações onde a precificação deverá ser alterada dinamicamente:

1 - Região para qual a tabela dinâmica valerá:

Uma tabela dinâmica pertencerá a uma região inteira, que pode conter uma ou mais cidades. Ex: Central São Paulo, Central Jundiaí. Em outras palavras, esta mesma configuração valerá para todos os serviços dentro desta região, como X, Select, Black e etc... E para que as regras de precificação desta tabela sejam aplicadas aos Serviços por Região, uma configuração dentro do serviço por região deverá ser marcada, como na imagem abaixo:

Dúvidas:

Posso configurar uma tabela dinâmica para o Serviço por região X e outra para o Select dentro da mesma região?
R: Não é possível. A tabela dinâmica é cadastrada por "Região" (e NÃO por "Serviço").
Ou seja, é possível habilitar o Serviço por Região em questão para utilizar a Tabela Dinâmica ou não.
Serviços conveniados por exemplo, poderão ter a tabela dinâmica desabilitada, para que os valores contratados não sejam alterados. Assim como Serviços VIP, que já possuem preços mais altos, para que não fiquem ainda mais altos.
A tabela dinâmica funcionará para corridas abertas pelo prestador (Maçaneta)
R: SIM!. Caso tenha um tabela dinâmica ATIVA configurada na região, e consequentemente no endereço de origem que o prestador informar na abertura da solicitação, o sistema irá considerar o valor da dinâmica, desde que os serviço que ele escolher também esteja configurado para usar a dinâmica.

2 - Raio de Verificação em quilômetros:

Raio onde a verificação de demanda ou quantidade deverá pesquisar para aplicar as regras da tabela em questão;

3 - Tempo de Verificação e Tempo de Duração:

Atenção: Os tempos definidos nesses campos são em MINUTOS. Os valores máximos nesses campos são de 30 minutos.

Tempo de verificação: Defina aqui "de quanto em quanto" tempo será feito a verificação do raio de atendimento para novos cálculos.
Tempo de Duração: Trata-se do tempo de duração que a tarifa dinâmica ficará aplicada, após realizar os cálculos de verificação. Esse tempo de duração é considerado para cada fator que tenha sido configurado mais abaixo (caso tenho mais de um).

Resumindo de forma prática:
Considerando que tenha uma tabela dinâmica cadastrada, a cada solicitação que entrar no sistema (dentro da região informada), o sistema irá verificar dentro do raio e durante o tempo de VERIFICAÇÃO cadastrado a quantidade de solicitações que ocorreram, para aplicar (ou não) o fator que estiver configurado.
Caso seja aplicado um fator, ele ficará ativo durante o tempo de DURAÇÃO que estiver configurado. Somente após finalizar esse tempo de duração é que o sistema fará uma nova verificação para aplicar ou não um novo fator nesse mesmo raio.

4 - Raio de visão em quilômetros onde o aplicativo do prestador irá pesquisar se há precificação dinâmica em vigor:

E exibirá um círculo com o fator de multiplicação, para que o prestador possa se deslocar até o local para receber solicitações com os valores multiplicados pelo fator exibido;

5 - Quantidade de solicitações base para a ativação da dinâmica:

Caso preenchido, o cálculo será feito de acordo com o percentual configurado na tabela de configuração de fatores (passo 7). O cálculo é feito da seguinte maneira:

Percentual = (({Quantidade de Solicitações} * 100) / {Quantidade de solicitações base}) - 100; EX: ((15 * 100) / 3) - 100 = 400 (no exemplo a quantidade de solicitações está 400% maior que a definida (nos últimos minutos (passo 3), dentro do raio de verificação (passo 2), houveram 15 solicitações e a quantidade base definida era 3, logo o fator aplicado será 1,40 (passo 7), considerando a tabela de configuração de fatores abaixo:

Caso NÃO preenchido, o cálculo será feito de acordo com o quantidade configurada na tabela de configuração de fatores (passo 7).

Em caso de quantidade, nenhum cálculo é efetuado, o sistema apenas busca o primeiro registro de quantidade da tabela de configuração de fatores menor ou igual a quantidade de solicitações.

Exemplo de tabela por quantidade:

Utilizando a mesma quantidade do exemplo anterior, de 15 solicitações, e com a tabela de configuração de fatores da imagem acima, o fator aplicado seria 1,70.

6 - Demanda versus Oferta:

Faz o cálculo de acordo com a {Quantidade de Solicitações "Média"} versus {Quantidade de Prestadores Disponíveis} no raio de verificação (passo 2). Caso preenchido, o cálculo utilizará a "Contagem de solicitações" (no tempo e raio configurado) dividido pela "Quantidade de prestadores disponíveis" para chegar ao número de {Quantidade de Solicitações Média}, que deverá ser utilizado no cálculo.

Ex:
({Contagem de Solicitações} / {Quantidade de Prestadores Disponíveis}) = {Quantidade de Solicitações MÉDIA}

Seguindo esse exemplo:
Contagem de Solicitações (no tempo de verificação e com endereço de origem no raio configurado) = 15; Quantidade de Prestadores Disponíveis (Com endereço de origem no raio configurado) = 3;

(15 / 3) = 5;

Portando Chegamos no resultado "5"

Agora, com esse cenário, e levando em consideração que o campo Quantidade de Solicitações BASE esteja preenchido com o valor "3", o cálculo seria o seguinte:
(({Quantidade de Solicitações MÉDIA} * 100) / {Quantidade de Prestadores Disponíveis}) - 100

Sendo assim, usamos os seguintes valores no exemplo:
((5 * 100) / 3) - 100 = 66.666...

Considerando o resultado desse exemplo, o fator aplicado seria 1.65 conforme foi configurado na tabela de fatores (veja abaixo)

7 - Tabela de configuração de fatores:

Tabela utilizada no cálculo para definição de qual fator deverá ser aplicado.

3. Ativar Tabela Dinâmica no Sistema

Para ativar ou desativar a funcionalidade de tabela dinâmica no sistema de forma geral, existe um parâmetro na tela Menu > Configurações > Sistema:

4. Tabela Dinâmica no aplicativo do cliente/passageiro

Quando um cliente (passageiro) solicitar uma corrida, e ele estiver no raio de verificação configurado, o sistema irá cálcular a tabela dinâmica para aquele raio, no tempo de verificação também configurado. Se houver um fator em vigor o aplicativo do passageiro apresentará as seguintes informações:

1- Ao selecionar o tipo de serviço, será apresentado um simbolo (uma pequena chama), ao lado desse serviço, representando que a tarifa dinâmica está aplicada naquele momento. (veja imagem abaixo)

2- Ao clicar em "Confirmar" para fazer a solicitação, o aplicativo apresentará uma mensagem na tela (veja imagem abaixo), informando sobre o preço dinâmico que será aplicado com uma explicação. O cliente terá a opção de "Cancelar" ou "Aceitar" (clicando em "Ok, Continuar"). Atenção: essa opção pode ser ligada ou desligada pelo administrador da plataforma, na tela de "Configurações > Sistema", opção "Janela Tarifa Dinâmica".

Com a opção marcada, a tela será apresentada para o cliente conforme abaixo:

5. Tabela Dinâmica no aplicativo do prestador/motorista

Quando um prestador (motorista) receber uma solicitação, de uma área em que a Tabela Dinâmica estiver ativa no momento, o aplicativo avisará ele através da tela de aceite de corrida, conforme imagem abaixo.

É apresentado o simbolo de uma pequena chama (representando a tarifa Dinâmica), com o valor aplicado por essa tarifa ao lado. Atenção: essa opção pode ser ligada ou desligada pelo administrador da plataforma, na tela de "Configurações > Sistema", opção "Tarifa Dinâmica na tela de Aceitar".

Com a opção marcada, a tela será exibida conforme a imagem abaixo:

Caso o prestador queira saber se alguma região está com a Tarifa Dinâmica aplicada naquele momento, ele pode clicar no botão que aparece na tela do mapa (parte inferior, botão redondo com uma pequena chama).

Após clicar no botão, o aplicativo dele apresentará uma marcação vermelha com um valor dentro (o circulo vermelho representa a área afetada pela tarifa), mostrando que naquela região a Tarifa Dinamica está aplicada naquele momento. Caso não haja regiões disponíveis naquele momento (com a tarifa aplicada) o sistema não apresentará.
Se por acaso houver mais de uma região com a Tarifa Dinâmica aplicada, será possivel verificar através do mapa. É possível "arrastar" e "diminuir" o mapa para auxiliar na visualização.

As Tarifas podem ser diferentes nas regiões, conforme foi configurado na plataforma. O Aplicativo mostra essa informação dentro do circulo vermelho (trata-se da taxa adicional aplicada naquela região).

6. Exemplo de uma configuração inicial na Tabela Dinâmica

A imagem abaixo, representa um modelo de exemplo simples, para servir de ponto inicial para configurar uma Tabela Dinâmica numa determinada região. Esse modelo, não utiliza o Cálculo por Demanda e Oferta, justamente para facilitar a compreensão.

As explicações de cada campo encontram-se mais acima, nesta mesma página.

A quantidade de Solicitações Base está definida como "zero", pois assim o sistema tomará como base os valores informados na tabela abaixo, ou seja, nesse caso a partir de 5 solicitações, o sistema aplicará o fator "1,10" em cima dos valores das próximas corridas que ocorrerem nessa região informada (conforme definido no Raio de Verificação).

A partir de 7 solicitações, o fator será "1,30". E assim por diante conforme informado na tabela.

É possível adicionar uma dinâmica em toda a cidade?

Sim! Você pode cadastrar uma Tarifa Dinâmica na região da cidade deseja, e NÃO definir (cadastrar) fatores, apenas deixar cadastrada uma tabela na região (sem fatores), e após isso ir para a outra tela de CÁLCULOS da dinâmica. Escolha um endereço "no centro da cidade" (por exemplo) e um "raio" que abranja praticamente toda a cidade. Veja mais orientações sobre essa tela na wiki de Tabela Dinâmica CÁLCULOS, ou clique aqui para ser redirecionado.