Heurística de Estoque – Wake Tech

Introdução à Heurística de Estoque

A Heurística de Estoque visa otimizar a decisão sobre a origem dos pedidos, priorizando sempre que possível o envio completo a partir de uma única origem. Com o intuito de melhorar a eficiência logística, a plataforma será configurável para utilizar uma série de critérios, como o custo de frete, o prazo de entrega ou parâmetros mais avançados, como o Tempo Médio de Atendimento (TMA), a margem de lucro, a priorização de Centros de Distribuição (CD), o nível de rupturas, entre outros. Esses critérios podem ser ainda utilizados para resolver empates, caso existam origens com custos ou prazos semelhantes. Além disso, quando não for possível atender a um pedido por completo a partir de uma única origem, a funcionalidade permitirá dividir os itens entre diferentes origens, levando em consideração os mesmos parâmetros para garantir uma decisão otimizada e eficiente.

Priorização da Origem do Estoque

Através da página de Priorização da Origem do Estoque, acessada através do Menu Principal > Fretes, no site da Wake Commerce o usuário da loja poderá criar regras de padronização do modelo de heurística que será aplicado para a definição das cotações de frete, origem dos pedidos e CD(s) elegíveis para cotação.

Parametrizações que Influenciam a Inteligência de Origem de Estoque

São 3 os parâmetros que podem influenciar na inteligência de priorização da origem do estoque.

Cotação de Frete

A Cotação de Frete permite à loja definir quais serão as opções de frete que serão retornadas no Front. Há dois valores possíveis de parametrização:

1 → Agrupamento entre o Frete Rápido e o Frete Econômico: Essa opção exibirá apenas duas alternativas para o cliente. Se a nova inteligência estiver ativada, ela selecionará a loja mais rápida e a mais econômica para o envio completo do pedido.

2 → Agrupamento conforme o Nome das Cotações: Nesta opção, a nova inteligência selecionará a loja mais rápida e econômica para o envio completo do pedido, exibindo todas as opções de frete disponíveis em ambas as lojas, agrupadas pelo nome da forma de envio.

Grupo de Frete

No grupo de frete é possível indicar se a decisão daquele grupo leva em consideração o prazo ou preço.

Exemplo: Foi criado um grupo chamado econômico e foi parametrizado que para as transportadoras desse grupo a decisão deve ser baseada no preço (mais barata), ou seja, a decisão será com base no preço. Nesse caso, para decidir qual será a loja para esse grupo de frete vamos olhar para a tolerância de preço, ver as lojas dentro do range de tolerância e decidir de acordo com o desempate (score ou priorização).
Exemplo 2: Foi criado um grupo chamado Expresso e foi parametrizado que para as transportadoras desse grupo a decisão deve ser baseada na prazo (mais rápida), ou seja, a decisão será com base no prazo. Nesse caso, para decidir qual será a loja para esse grupo de frete vamos olhar para a tolerância de prazo, ver as lojas dentro do range de tolerância e decidir de acordo com o desempate (score ou priorização).

Veja mais sobre a Cotação de Frete no artigo Centros de Distribuição - Tipo de agrupamento nas cotações de frete, disponível na Wakepédia.

Exemplo de como retornará no Front:

Regra 1:

→ Mais Rápida

Caso o usuário escolha essa opção será utilizada a origem com o envio mais rápido, com base na regra de heurística configurada.

→ Mais Econômica

Caso o usuário escolha essa opção, será utilizada a origem com o envio mais barato, com base na regra de heurística configurada.

Regra 2:

→ Opção de envio da Loja 1

- Total Express - 1 Dia x 3,00

- Sedex - 2 Dias x 2,00

- Loggi - 5 Dias x 15,00

→ Opção de envio da Loja 2

- Sedex - 2 Dias x 1,00

= Retornará para o Front:

- Total Express - 1 Dia x 3,00 (Origem Loja 1)

- Sedex - 2 Dias x 1,00 (Origem Loja 2)

- Loggi - 5 Dias x 15,00 (Origem Loja 1)

Atenção: Importante salientar que a funcionalidade de Cotação em Todos os CD(s), disponível na configurações de fretes, deve estar com o campo “Ativar?” desabilitado para o correto funcionamento da Heurística de Estoque. Veja como desabilitar a funcionalidade no artigo Centros de Distribuição - Como configurar a Cotação em Todos os CD(s).

Tolerância de Empate

A Tolerância de Empate é uma funcionalidade que permite configurar margens de tolerância para valor e prazo de frete (via parametrização), aumentando as oportunidades e abrindo mais possibilidades para origens que apresentam valores próximos, participem do desempate por critérios de qualidade como Score e Prioridade de CD.

Tolerância de Valor: Margem percentual para cotações econômicas.
Tolerância de Prazo: Margem em dias ou horas para cotações rápidas, heurística detecta o padrão automaticamente.
Desempate por critérios de qualidade dentro da tolerância configurada

Critérios de Desempate

Score: Pontuação baseada em TMA e nível de rupturas. O usuário também poderá criar novos critérios manualmente ou via API, por exemplo: Giro.
Prioridade de CD: Ordem configurada dos centros de distribuição

Funcionamento

Tolerância de Valor (Cotação Econômica)

Exemplo: Tolerância de 20%

- Menor frete: R$ 10,00

- Limite aceito: R$ 12,00

- Resultado: Fretes até R$ 12,00 competem por desempate.

Tolerância de Prazo (Cotação Rápida)

Exemplo: Tolerância de 2 dias

- Menor prazo: 3 dias

- Limite aceito: 5 dias

- Resultado: Prazos até 5 dias competem por desempate.

Ativando a Funcionalidade

Para ativar essa funcionalidade, vá até a página de Configurações/Configurações Gerais.

Através do link: https://{{ambienteCliente}}.fbits-admin.net/Configuracao?grupoConfiguracaoId=0&termoBusca=toler%C3%A2ncia

Regras de Desempate

Tolerância de Valor (Frete Econômico)

Parâmetro: ToleranciaValorEmpate
Tipo: Percentual (%)
Aplicação:

menorValor = valor da cotação mais barata
limiteTolerancia = menorValor + (menorValor × ToleranciaValorEmpate / 100)

Exemplo:

Menor valor: R$ 10,00

Tolerância: 10%

Limite: R$ 11,00

Cotações elegíveis: todas com valor ≤ R$ 11,00

Tolerância de Prazo (Frete Rápido)

Parâmetros:
ToleranciaPrazoEmpate (horas) - usado quando cotações possuem prazo em horas
ToleranciaPrazoDiasEmpate (dias) - usado quando cotações possuem prazo em dias
Aplicação:

menorPrazo = prazo da cotação mais rápida
limiteTolerancia = menorPrazo + ToleranciaConfiguracao

Exemplo (dias):

Menor prazo: 3 dias

Tolerância: 2 dias

Limite: 5 dias

Cotações elegíveis: todas com prazo ≤ 5 dias

Fluxo de Desempate

1 - Filtra cotações dentro da tolerância (valor ou prazo)

2 - Aplica ordenação conforme tipo de heurística:

Tipos 2 e 4: Prioriza Score do CD
Tipos 3 e 5: Prioriza Ordem do CD

3 - Critérios secundários: prazo/valor (conforme o caso)

4 - Retorna a primeira cotação ordenada

Tipo de Heurística

1 → Heurística Atual da Plataforma: segue o envio com base na priorização dos Centros de Distribuição (CD) definidos por região de destino. Essa opção mantém a heurística atual da plataforma, ou seja, utiliza a priorização dos CD(s) por região como critério para definir a origem do atendimento, sem priorizar o envio completo do pedido.

2 → Prioriza Pacote Completo e Desempate por Score: prioriza a origem que consiga enviar o pedido por completo, levando em consideração o envio mais rápido ou mais econômico (cotando o frete em até 5 CD(s). A seleção dos CD(s) e o critério de desempate são definidos com base no score. Caso nenhuma loja consiga enviar o pedido integralmente, o score será utilizado para determinar a ordem de split do pedido, considerando, neste caso, todos os CDs que atendem à região do cliente.

3 → Prioriza Pacote Completo e Desempate por Prioridade de CD: Prioriza a origem que consiga enviar o pedido por completo, levando em consideração o envio mais rápido e mais barato (cotando o frete em até 5 CDs), utilizando a priorização do CD como critério de desempate. Caso nenhuma loja consiga enviar o pedido integralmente, a priorização do CD será utilizada para definir a ordem de split do pedido, considerando todos os CD(s) que atendem à região do cliente.

A principal diferença entre este item e o item 2 é o critério de desempate e a ordenação do split: no item 2, o desempate é feito pelo score da origem, enquanto no item 3, o critério de desempate é a priorização do CD de origem.

Cenário 1

Cenário 2

4 → Prioriza Pacote Completo por Score: prioriza a origem que consiga enviar o pedido completo e apresente o melhor score. Caso nenhuma loja consiga atender o pedido integralmente, a divisão será feita com base no score, determinando a priorização das origens.

5 → Prioriza Pacote Completo por Prioridade de CD: Prioriza a origem que consiga enviar o pedido completo, seguindo a ordem estabelecida na priorização do CD. Caso nenhuma loja consiga atender o pedido integralmente, a divisão será feita com base na priorização do CD.

Nota: Todas as opções respeitam o cluster de CDs definido para cada região, ou seja, as regras de origem do CD sempre seguirão o cluster de CDs determinado pelo varejista para cada faixa de CEP. A nova inteligência de origem será aplicada apenas quando o parâmetro "Cotar em todos os CDs" estiver inativo e o parâmetro "Tipo de heurística" for configurado como 2, 3, 4 ou 5. Caso o parâmetro esteja definido como 1, será utilizada a inteligência atual da plataforma.

Cotar em Todos os CD(s)

O parâmetro "Cotar em Todos os CD(s)" define se o frete será cotado em todos os CDs. Quando ativado, o pedido será atendido apenas se um CD conseguir atender o pedido por completo. Caso não exista um CD capaz de atender integralmente, o pedido não será dividido.

Atenção: A nova inteligência de origem será aplicada somente quando o parâmetro 'Cotar em todos os CDs' estiver desativado e o parâmetro 'Tipo de heurística' configurado com os valores 2, 3, 4 ou 5.

Parametrização da Inteligência para Geração do Score

Adicionar Critério

Os critérios que define o score devem ser criados pelo próprio usuário lojista ao clicar no botão ADICIONAR CRITÉRIO, localizado no canto superior direito da tela.

Observe que ao clicar no botão para adicionar critério, haverá uma lista com 2 critérios fixos que poderão ser utilizados.

Esses critérios são fixos, não podem ser editados, e serão preenchidos automaticamente pela inteligência de dados do Wake OMS.

→ TMA - OMS (quanto menor, melhor): tempo médio do atendimento.

→ Nível Ruptura (quanto menor, melhor): nível de ruptura do estoque da loja.

O usuário também poderá criar novos critérios, mantendo a lista de critérios em branco e preenchendo o formulário, conforme imagem abaixo:

Para a regra de cálculo, existem dois parâmetros possíveis:

→ Valor ser maior, melhor

→ Valor ser menor, melhor

Após adicionar e salvar os critérios, o usuário poderá editar o peso que terá cada critério na avaliação do score.

Dados dos Critérios - Implementando os Pesos

Na seção, “Dados dos critérios”, o usuário encontrará a lista de critérios adicionados e seu respectivo peso, para alterar do percentual dos pesos dos critérios, basta ao usuário clicar na coluna “Ações” no ícone e selecionar a opção “Editar”.

O usuário poderá editar as informações do score por loja utilizando a API, planilha ou editando manualmente o score do critério por loja diretamente em tela, conforme demonstrado a seguir.

Endpoint de atualização do Score: Método POST → /fretes/criteriosscore/valor

Lista de Centro de Distribuição - Pontuando os Critérios Manualmente

Na seção Lista de Centro de Distribuição, o usuário pode alterar ou adicionar critérios por CD, localizando o CD desejado. Veja abaixo como os itens da seção funcionam e se organizam.

Exemplo de estrutura do do Score:

→ Campo de Busca do Centro de Distribuição: o usuário poderá utilizar o campo para localizar um CD específico na lista.

→ Coluna Centro de Distribuição: na primeira coluna da lista está o nome dos Centros de Distribuição.

→ Coluna do Critério: a coluna de critério seguirá logo após a coluna Centro de Distribuição, cada critério terá sua própria coluna com seu respectivo score.

→ Score do Critério: a coluna de score do critério estará sempre à direita da coluna do seu respectivo critério.

→ Score Total: a coluna de score total será sempre a última coluna antes da coluna de ações. Nela estará o total do score do Centro de Distribuição.

→ Coluna de Ações: através do ícone o usuário habilitará a edição do score do Centro de Distribuição, conseguindo então adicionar ou alterar dados para cada critério que o permita.

→ Paginação: a lista de Centros de Distribuição podem mostrar entre 5 e 25 registros, caso a lista seja maior, o usuário pode utilizar as setas de navegação de páginas, onde conseguirá ver os demais registros.

→ Importar dados via Planilha: botão que permite a importação dos dados via planilha. Ao clicar no botão, o usuário terá opção de baixar o modelo da planilha.

Métrica do Score

O score exemplificado na imagem, segue a seguinte fórmula de cálculo:

→ Se o indicador tiver como base o Menor valor como Melhor, o cálculo do score será:

(Menor valor entre os CD(s) / Valor do indicador para o CD) x 100.

No exemplo da imagem acima, o menor TMA (Tempo Médio de Atendimento) é 1, para calcular o score do TMA dos CD(s) seriam:

**Iguatemi: (1 /1) * 100 = 100**

**Curitiba: (1 / 3) * 100 = 33,33**

**Pátio: (1 / 1) * 100 = 100**

Nota: o TMA (Tempo Médio de Atendimento) é um exemplo de que quanto menor, mais eficiente a loja é no atendimento dos pedidos.

→ Se o indicador tiver como base o maior valor como melhor, o cálculo do score será:

(Valor do indicador para o CD / Maior valor entre os CD(s) * 100.

No exemplo da imagem acima, a maior Margem é 16, para calcular o score da Margem seria:

**Iguatemi seria (10 / 16) * 100 = 62,50**

**Curitiba: (12 / 16) * 100 = 75,00**

**Pátio: (15/16) * 100 = 93,75**

O score total do CD será calculado da seguinte forma: (Score Indicador * Peso).

No exemplo acima seria:

CD: (Score TMA x Peso TMA) + (Score Margem / Peso Margem) + (Score Giro / Peso Giro)

Iguatemi: (100,00 x 70%) + (62,50 x 20%) + (33,33 x 10%) = 85,83

Curitiba: (33,33 x 70%) + (75,00 x 20%) + (100,00 x 10%) = 48,33

Pátio: (100,00 x 70%) + (93,75 x 20%) + (33,33 x 10%) = 92,08

Nesta imagem de exemplo acima, o Pátio obteria o melhor score (92,08), o que lhe garantiria prioridade caso a plataforma esteja configurada para utilizar o score como critério de prioridade de origem.

Pesquisa