# Tela de Rotas — Troubleshooting

Problemas mais comuns na criação e gestão de rotas via transportadora 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 indica a razão diretamente.

| Mensagem exibida | Causa | O que fazer |
| ---------------- | ----- | ----------- |
| *Nenhum pedido foi selecionado* | Nenhum pedido marcado no painel direito | Selecione ao menos 1 pedido na tabela |
| *Nenhuma filial foi selecionada* | Campo **Filial** vazio | Selecione a filial de origem dos pedidos |
| *Nenhum método foi selecionado* | Campo **Método** vazio | Escolha a modalidade/serviço da transportadora |
| *Carregando informações da filial...* | Dados do armazém ainda sendo carregados | Aguarde alguns segundos e tente novamente |
| *Nenhum warehouse encontrado para esta filial* | A filial 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 estão em status que não permite roteamento | Volte ao painel de pedidos, remova os pedidos listados e verifique o status de cada um em **Operação > Pedidos** |
| *Nenhum desses pedidos foi encontrado: [números]* | Os pedidos foram alterados ou removidos entre a seleção e o envio | Atualize a lista e selecione os pedidos novamente |

### Transportadora / integração com problema

| Erro exibido | Causa | O que fazer |
| ------------ | ----- | ----------- |
| *Integração de transportadora não encontrada* | A integração de transportadora selecionada foi desativada ou removida | Verifique se a integração está ativa em **Configurações > Integrações de transportadora** |
| *Armazém não associado a sua organização* | O armazém da filial pertence a outro seller group | Verifique a configuração da filial com o time de suporte |

### 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 instabilidade | Aguarde alguns minutos e tente novamente. Se o problema persistir, contate o suporte |

---

## "Sugerir rota" retorna erro ou não funciona

| Erro / Sintoma | Causa | O que fazer |
| -------------- | ----- | ----------- |
| *Botão desabilitado* | Nenhum pedido selecionado | Selecione ao menos 1 pedido antes de sugerir a rota |
| Pedidos de filiais diferentes | A sugestão exige pedidos da mesma filial | Use o filtro de **Filial** no painel de pedidos para garantir que todos são da mesma origem |
| *Não foi possível sugerir uma rota com a configuração atual* | O serviço de roteirização não encontrou trajeto válido | Tente remover pedidos com endereço inválido ou reduzir a quantidade selecionada |
| *Não foi possível incluir todos os pedidos obrigatórios* | A otimização não conseguiu encaixar todos os pedidos obrigatórios | Reduza o número de pedidos ou desmarque alguns como obrigatórios |
**Endereços incompletos impactam a sugestão:** Pedidos com CEP inválido ou endereço incompleto podem impedir o cálculo do trajeto. Verifique os endereços 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 na tela de **Pedidos**. Pedidos já finalizados, cancelados ou com falha não são roteáveis |
| Lista vazia mesmo com pedidos ativos | Período muito restrito no filtro de datas | Amplie o intervalo de datas no painel de pedidos |
| Pedido de outra filial não aparece | Filtro de **Filial** ativo no painel direito | Remova ou ajuste o filtro de **Filial** |

---

## 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) não inclui a rota | Ajuste o período nos filtros da tela de Rotas |
| Filtro de status excluindo a rota | Status **CRIADA** desmarcado | Marque o status **CRIADA** no filtro de **Status** |
| Rota visível para um usuário mas não para outro | Filtro de **Entregue por** diferente entre usuários | Verifique se o filtro de transportadora está configurado da mesma forma |

---

## Ação "Solicitar coleta" indisponível no menu ⋮

| Causa | O que fazer |
| ----- | ----------- |
| Rota já tem transportadora atribuída | Solicitar coleta só está disponível para rotas sem responsável definido |
| Pedidos pertencem a mais de uma filial | A solicitação de coleta exige pedidos de uma única filial na rota |
| Usuário sem permissão para esta ação | Solicite acesso ao administrador da conta |