Tela de Rotas — Visão Geral

Tudo sobre a tela de Rotas: acesso, filtros, colunas, ações por rota e status

A tela de Rotas concentra a operação diária de entregas com frota própria ou transportadoras: visualização de status, atribuição de motoristas, criação e acompanhamento de todas as rotas ativas.


Onde acessar


O que o cliente vê ao entrar

Cabeçalho

ElementoDescrição
Título"Rotas"
Nova rotaAbre a tela de Criação de Rota (/routes/create)

Barra de filtros

  • Pesquisar — busca por nome da rota ou número do pedido
  • Atualizar lista — botão de refresh manual
  • Status (multisseleção) — ver seção Status de rota para os valores disponíveis
  • Entregue por (multisseleção) — frota própria e transportadoras integradas configuradas na conta
  • Período (date range, padrão: últimos 7 dias, máximo 93 dias)
  • Filtros avançados — ver seção dedicada abaixo
  • Visibilidade de colunas — ícone de ajuste para mostrar/ocultar colunas

Tabela de rotas

ColunaO que mostra
IDIdentificador único da rota (exibido com até 12 caracteres + botão de copiar)
Nome da RotaNome externo da rota (external_name), gerado automaticamente se não informado
StatusBadge colorido com o status atual da rota
EntregasContagem total + blocos visuais por status com os números dos pedidos
ResponsávelAvatar e nome do motorista atribuído, ou "Não atribuído"
Criado emData e hora de criação (formato dd/MM/yy HH:mm)
CustoCusto da rota em BRL (quando informado)
DistânciaDistância esperada em km
Tempo estimadoTempo esperado no formato HH:mm
AçõesMenu suspenso (⋮) com ações individuais por rota

Interações de linha

  • Clique simples: abre o painel lateral da rota (adiciona ?route_id= à URL)

Paginação

  • Tamanhos de página: 50 (padrão)

Estado vazio

Quando não há rotas para os filtros aplicados:

"Nenhuma rota encontrada. Crie uma rota agora mesmo"


Filtros avançados disponíveis

CampoTipo
Nome da rotaTexto
Nome do motoristaTexto
Sobrenome do motoristaTexto
Documento do motoristaTexto
Pedido de entregaTexto
Status da entregaMultisseleção

Ações por rota (menu ⋮)

As opções variam conforme o status da rota.

AçãoDisponibilidade
Ver rotaSempre disponível
Atribuir / Trocar motoristaStatus CRIADA ou EM EXECUÇÃO, sem entregas com status de sucesso ou falha
Solicitar coletaRota sem motorista atribuído e com pedidos de uma única filial
Duplicar rotaIndisponível para EM EXECUÇÃO e PEDIDOS CONCLUÍDOS
Exportar CSVDisponível para contas habilitadas
Cancelar rotaAção destrutiva e irreversível

Cancelamento irreversível

Cancelar uma rota é uma ação permanente. Os pedidos vinculados retornam ao estado pendente, mas a rota não pode ser reativada. Confirme antes de prosseguir.


Status de rota

StatusDescrição
CRIADARota criada e aguardando início pelo motorista
EM EXECUÇÃOMotorista iniciou o deslocamento e está realizando as entregas
CANCELADARota cancelada — pedidos retornam ao estado pendente
PEDIDOS CONCLUÍDOSTodos os waypoints da rota foram finalizados
FINALIZADARota encerrada pelo sistema

Painel lateral da rota

Ao clicar em uma rota (ou usar "Ver rota" no menu ⋮), um painel lateral exibe:

  • Lista de entregas com status individual
  • Motorista responsável e dados do veículo
  • Visualização do trajeto no mapa

A URL é atualizada com ?route_id=, permitindo compartilhar ou favoritar o estado diretamente.


Comportamentos automáticos importantes

  • Reset de paginação: alterações de filtro voltam para a primeira página
  • Side panel por URL: ?route_id= na query string abre automaticamente o painel lateral da rota correspondente
  • Exportação CSV: respeita os filtros ativos no momento da exportação (disponível para contas habilitadas)

Próximos passos

  • Como usar — passo a passo para criar, filtrar, acompanhar e gerenciar rotas.

Nesta página