# Tela de Rotas — Troubleshooting Problemas mais comuns na tela de Rotas e como resolvê-los. --- ## Botão "Criar Rota" está desabilitado O botão fica bloqueado enquanto algum campo obrigatório não estiver preenchido. A tela exibe a razão no próprio botão ou próximo a ele. ### Frota Própria | Mensagem exibida | Causa | O que fazer | | ---------------- | ----- | ----------- | | *Nenhum pedido foi selecionado* | Nenhum pedido marcado no painel direito | Selecione ao menos 1 pedido na tabela | | *Nenhum inicio de rota foi selecionada* | Campo **Início da Rota** vazio | Escolha um armazém de início | | *Nenhum motorista foi selecionado* | Campo **Motorista** vazio | Selecione um motorista ou deixe para atribuir depois pelo menu ⋮ na listagem | ### Transportadora | Mensagem exibida | Causa | O que fazer | | ---------------- | ----- | ----------- | | *Nenhum pedido foi selecionado* | Nenhum pedido marcado | Selecione ao menos 1 pedido na tabela | | *Nenhuma filial foi selecionada* | Campo **Filial** vazio | Selecione a filial de origem | | *Nenhum método foi selecionado* | Campo **Método** vazio | Escolha o método/modalidade da transportadora | | *Carregando informações da filial...* | Dados do armazém ainda carregando | Aguarde alguns segundos e tente novamente | | *Nenhum warehouse encontrado para esta filial* | A filial selecionada não tem armazém cadastrado | Verifique se a filial possui um armazém configurado em **Configurações > Filiais** | --- ## Erros ao clicar em "Criar Rota" ### Pedidos com problema | Erro exibido | Causa | O que fazer | | ------------ | ----- | ----------- | | *Nenhum desses pedidos é roteirizável: [números]* | Um ou mais pedidos selecionados estão em status que não permite roteamento | Volte ao painel de pedidos e remova os pedidos listados. Verifique o status de cada um — apenas pedidos em status roteável podem ser incluídos | | *Nenhum desses pedidos foi encontrado: [números]* | Os pedidos foram deletados ou alterados entre a seleção e o envio | Atualize a lista de pedidos e selecione novamente | ### Motorista com problema (Frota Própria) | Erro exibido | Causa | O que fazer | | ------------ | ----- | ----------- | | *Motorista (nome) não encontrado* | O motorista foi removido do sistema após ser selecionado | Selecione outro motorista ou cadastre o motorista novamente em **Motoristas** | | *Motorista (nome) não associado a sua organização* | O motorista existe no sistema mas não pertence ao seu seller group | Verifique se o motorista está associado às filiais corretas. Consulte **Configurações > Motoristas** | ### Armazém com problema (Frota Própria) | Erro exibido | Causa | O que fazer | | ------------ | ----- | ----------- | | *Início da rota não encontrado* | O armazém de início foi removido após ser selecionado | Selecione outro armazém de início | | *Fim da rota não encontrado* | O armazém de fim foi removido após ser selecionado | Selecione outro armazém de fim ou deixe em branco | | *Armazém não associado a sua organização* | O armazém existe mas pertence a outro seller group | Verifique se o armazém está configurado corretamente para a sua conta | ### Erro genérico | Erro exibido | Causa provável | O que fazer | | ------------ | -------------- | ----------- | | *Erro ao criar rota, tente novamente mais tarde* | Falha no serviço de roteirização ou erro interno | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o suporte | --- ## "Sugerir rota" retorna erro ou não funciona | Erro / Sintoma | Causa | O que fazer | | -------------- | ----- | ----------- | | *Botão desabilitado* | Nenhum pedido selecionado ou armazém de início não definido | Selecione ao menos 1 pedido e defina o **Início da Rota** antes de sugerir | | Pedidos de filiais diferentes | Todos os pedidos de uma sugestão precisam pertencer à mesma filial | Filtre os pedidos por filial no painel direito antes de sugerir a rota | | *Não foi possível sugerir uma rota com a configuração atual* | O serviço de roteirização não encontrou um trajeto válido com os parâmetros informados | Tente alterar o armazém de início, remover pedidos com endereço inválido ou reduzir a quantidade de pedidos | | *Não foi possível incluir todos os pedidos obrigatórios* | A otimização não conseguiu encaixar todos os pedidos marcados como obrigatórios em nenhuma rota viável | Reduza o número de pedidos ou desmarque alguns como obrigatórios | | Sugestão ignorada / rota criada sem sequência | O serviço de roteirização está indisponível | A rota é criada normalmente, mas sem sequência otimizada. Tente sugerir novamente em alguns minutos | **Endereços incompletos impactam a sugestão:** Pedidos com endereço incompleto ou CEP inválido podem impedir o cálculo da rota otimizada. Verifique os endereços de entrega dos pedidos problemáticos antes de sugerir novamente. --- ## Pedidos não aparecem na lista de seleção | Sintoma | Causa provável | O que fazer | | ------- | -------------- | ----------- | | Pedido existe em **Pedidos** mas não aparece aqui | Pedido não está em status roteável | Verifique o status do pedido na tela de **Pedidos**. Pedidos em status `SUCCESSFUL`, `FAILED`, `CANCELED` ou similares não são roteáveis | | Lista vazia mesmo com pedidos ativos | Período selecionado muito restrito | Amplie o intervalo de datas no filtro de período do painel de pedidos | | Pedido de outra filial não aparece | Filial filtrada no painel direito | Remova o filtro de **Filial** ou selecione a filial correta | --- ## Rota criada não aparece na listagem | Sintoma | Causa | O que fazer | | ------- | ------ | ----------- | | Rota recém-criada não está visível | O período padrão (últimos 7 dias) pode não incluir a rota | Verifique a data de criação e ajuste o período nos filtros | | Filtro de status excluindo a rota | Status **CRIADA** foi desmarcado nos filtros | Marque o status **CRIADA** no filtro de **Status** | | Rota visível para um usuário mas não para outro | Filtro de **Entregue por** aplicado diferente | Verifique se o filtro de **Entregue por** está configurado igual para ambos | --- ## Ação "Atribuir motorista" indisponível no menu ⋮ | Causa | O que fazer | | ----- | ----------- | | Rota não está em status **CRIADA** ou **EM EXECUÇÃO** | Não é possível trocar motorista após a rota ser finalizada ou cancelada | | Uma ou mais entregas já foram finalizadas (sucesso ou falha) | A rota já tem ocorrências registradas — não é possível trocar o motorista neste ponto | | Usuário sem permissão para esta ação | Solicite acesso ao administrador da conta |