Tela de Rotas — Como Usar

Guia prático para criar e gerenciar rotas de entrega via transportadora no dia a dia do contexto LOG.

Fluxo típico

Acesse Operação > Rotas (/routes).
Defina período, status e transportadora nos filtros principais para trazer a visão correta.
Use filtros avançados para localizar rotas por pedido ou status de entrega.
Clique em uma rota para abrir o painel lateral com detalhes, lista de entregas e mapa.
Use o menu ⋮ para executar ações individuais na rota.
Para criar uma nova rota, clique em Nova rota no cabeçalho.

Filtrar e localizar rotas

Filtros principais

Status — filtre por CRIADA, EM EXECUÇÃO, CANCELADA, PEDIDOS CONCLUÍDOS ou FINALIZADA
Entregue por — filtre pela transportadora responsável
Período — janela de datas (padrão: últimos 7 dias)
Filtros avançados — nome da rota, motorista (quando disponível), número do pedido e status de entrega

Acompanhar uma rota

Clique em qualquer linha da tabela para abrir o painel lateral com:

Lista de entregas e status individual de cada uma
Transportadora responsável
Visualização do trajeto no mapa

A URL é atualizada com ?route_id= — você pode copiar o link para compartilhar diretamente a rota em questão.

Ações por rota

Solicitar coleta

Encaminha a rota para uma transportadora integrada. Disponível quando a rota ainda não tem responsável atribuído e todos os pedidos pertencem a uma única filial.

Duplicar rota

Cria uma nova rota com os mesmos pedidos e configurações. Disponível para a maioria dos status, exceto EM EXECUÇÃO e PEDIDOS CONCLUÍDOS.

Cancelar rota

Criar uma rota via transportadora

Como acessar

Clique em Nova rota no canto superior direito da tela de Rotas. A URL muda para /routes/create.

Layout da tela

A tela de criação é dividida em dois painéis simultâneos:

Painel	O que contém
Esquerdo	Modo de criação, campos de configuração e mapa com prévia do trajeto
Direito	Tabela de pedidos disponíveis para seleção, com filtros

Campos — aba Transportadora

Campo	Obrigatório	Descrição
Filial	Sim	Filial de origem dos pedidos. Define a transportadora e as opções de método disponíveis
Método	Sim	Modalidade ou serviço da transportadora (ex.: Expresso, Econômico)
Retorno obrigatório	Não	Toggle — quando ativado, exige que o veículo retorne ao depósito de origem após as entregas

Selecionar pedidos

No painel direito, use os filtros para localizar e selecionar os pedidos a incluir na rota:

Busca por número do pedido, nome do cliente ou filial
Marcadores — filtre por tags aplicadas aos pedidos
Filial — filtre por filial de origem
Período — ajuste o intervalo de datas
Filtros avançados — opções adicionais de filtragem

Sugerir rota e prévia

Ação	O que faz
Sugerir rota	Calcula a sequência otimizada de entregas. Requer ao menos um pedido selecionado.
Prévia de rota	Exibe o trajeto no mapa à esquerda antes de confirmar a criação.

Confirmar criação

Após configurar a rota e selecionar os pedidos, clique em Criar Rota (botão no canto inferior direito). O sistema valida os dados e cria a rota. Você é redirecionado de volta para a tela de listagem.

Validações e restrições

Erros durante a criação

Código	O que significa
`ORDERS_NOT_ROUTEABLE`	Um ou mais pedidos selecionados não estão em status roteável
`DIFFERENT_SELLER_IDS`	Pedidos de seller groups diferentes foram incluídos na seleção
`COULD_NOT_SUGGEST_ROUTE_WITH_MUST_HAVE_ORDERS`	O otimizador não conseguiu incluir todos os pedidos obrigatórios na sugestão
`COULD_NOT_SUGGEST_ROUTE_WITH_CURRENT_CONFIG`	A configuração atual não permite gerar uma sugestão de rota

Boas práticas operacionais

Verifique o status dos pedidos antes de selecioná-los — apenas pedidos em status roteável podem ser incluídos.
Confirme que a filial selecionada possui integração ativa com a transportadora desejada.
Use Sugerir rota para otimizar automaticamente a sequência de entregas quando a transportadora permite.
Use Prévia de rota para validar visualmente o trajeto antes de confirmar.

Próximos passos

Troubleshooting — botão desabilitado, erros de criação e outros problemas comuns.