📘 Manual

Roteirização — v1.7.7k3_full_FINAL_OK3_FIX (RB4 OUTBTN)

Bases

Obrigatório: latitude e longitude. Opcionais: colaborador/name/nome.
Obrigatório: latitude e longitude + Código Operação.
Aguardando base de operações…
Padrão: Não. Se Sim, colaborador pode ser roteirizado para o depósito mais próximo dentre os selecionados.
Use Ctrl/Cmd ou Shift para seleção múltipla.
Se vazio, detecto automaticamente.

Parâmetros e Custos

Lista lida da coluna D (colaborador) da base de pessoas.
  • Configure encaixe de modais - entrada ciclo posterior 30 min antes da saída do ciclo anterior (habilite multi ciclo)
  • Colaboradores PART TIME com horários diferentes de FIXO, serão configuradas rotas exclusivas para PART TIME
  • Suba a base com todas pessoas roteirizáveis
  • Pessoas sem horários não serão roteirizadas
AM1 — FIXO
AM2/PM — FIXO
SD — FIXO
AM1 — PART TIME
AM2/PM — PART TIME
SD — PART TIME
O acréscimo é aplicado sobre o custo fixo mensal dos modais quando um mesmo modal é utilizado em mais de um ciclo.
Quando Sim, pessoas podem migrar entre AM1, AM2/PM e SD buscando menor custo/tempo, mantendo a mesma quantidade de pessoas por ciclo do cenário original.

Catálogo de veículos (modais pré-definidos)

CUSTO MENSAL (BASE)

CUSTO MENSAL (FINAL)

MENSAL POR PESSOA (FINAL)

PESSOAS ATENDIDAS

KM IDA / DIA

KM VOLTA / DIA

KM TOTAL / DIA

TEMPO TOTAL (IDA+VOLTA)

ROTAS

Top 5 Maiores tempos por pessoa

    Top 5 Menores tempos por pessoa

      Gráfico (visual) — Top 10 tempos por pessoa

      Unidade: minutos — clique para destacar no mapa

      Comparativo: COM × SEM ponto de encontro

      Rotas criadas — modal, ocupação e custo

      Calcule para ver o detalhamento por rota (clique para destacar).

      Mapas — Rotas de Ida (acima) e Volta (abaixo)

      Mapa de IdaPonto de partida a partir do primeiro colaborador da rota
      Mapa de Volta

      📘 Manual de Instruções — Roteirizador Multiciclos

      1) Objetivo

      O roteirizador cria rotas otimizadas para ida e volta entre residências dos colaboradores e o depósito (operação), respeitando capacidade do modal, janelas de horário e regras de multi ciclo com encaixe de modais.

      2) Bases necessárias

      • Pessoas (CSV/Excel): deve conter latitude, longitude e preferencialmente nome. Colunas típicas (não obrigatório usar os mesmos nomes): Nome, Latitude, Longitude, Tipo (FIXO | PART TIME), Ciclo (AM1 | AM2/PM | SD).
      • Operações (CSV/Excel): deve conter latitude, longitude e Código Operação. A coluna do código é detectada automaticamente ou selecionável.

      3) Parâmetros principais

      • Tipo de operação: somente ida (coleta → depósito) ou ida e volta (depósito ↔ casas).
      • Velocidade média: usada para transformar km em minutos de rota.
      • Máx. horas por roteiro: o sistema divide rotas se exceder este limite.
      • Catálogo de veículos: capacidade (lugares), custo fixo mensal (base) e custo por km (R$).

      4) Multi ciclo & encaixe

      • Habilite multi ciclo para combinar AM1, AM2/PM e SD quando houver encaixe.
      • Regra do encaixe: a entrada do ciclo posterior deve ser 30 min antes da saída do ciclo anterior (AM1→PM, PM→SD, AM1→SD).
      • Quando o encaixe existir, os campos de saída do ciclo anterior e entrada do ciclo posterior ficam com fundo verde.
      • Sem horário (entrada/saída = 00:00) ⇒ colaborador não é roteirizado.
      • PART TIME com horário diferente do FIXO em qualquer ciclo ⇒ cria rotas exclusivas para PART TIME nesse ciclo.

      5) Cálculo de custo (resumo)

      Por rota, escolhe-se o modal com menor custo final respeitando a capacidade.

      • Variável: custo_por_km × km_dia × dias_úteis
      • Fixo (padrão): multiplicador depende do filtro/combinação e se há encaixe.
      • AM1 + SD:
        • Com encaixe: (variável + (fixo_modal × 1 × (1 + acréscimo%))) / total_pessoas
        • Sem encaixe: (variável + (fixo_modal × 2)) / total_pessoas
      • Para demais combinações, aplica-se o multiplicador de fixo conforme o encaixe e acréscimos definidos.
      • Preço final: aplica margem (%) e impostos (%).

      6) Lógica de tempo por pessoa

      • Ida: tempo do ponto de coleta do colaborador até o depósito seguindo a ordem da rota (primeiros têm maior tempo).
      • Volta: tempo do depósito até a residência do colaborador seguindo a ordem da volta.
      • Relato: no gráfico Top 10, ao clicar em uma barra, a pessoa é destacada nos mapas, e o tooltip mostra “Tempo em rota: hh:mm”.

      7) Pontos de encontro (opcional)

      • Informe raios (m) para ida e/ou volta. O sistema busca um ponto que cubra o maior número de pessoas e reencaminha as coordenadas dos cobertos para este ponto.
      • Comparativo COM × SEM ponto de encontro é mostrado com km, tempo e custo.

      8) Exportação

      Clique em Exportar Excel para salvar os indicadores principais do cenário atual.

      🛈 Caso deseje consultar as Lat e Lon no Google Maps, basta copiá-las da planilha e colá-las no campo de busca.

      9) Boas práticas

      • Garanta coordenadas válidas nas bases (latitude/longitude).
      • Use a seleção múltipla de operações quando fizer sentido (e o recurso de reatribuição para depósito mais próximo, se habilitado).
      • Revise a velocidade média para refletir a malha viária local.
      Dúvidas ou sugestões, contato via Workspace felipe.dapper@mercadolivre.com.