# Tela de Rotas — Visão Geral

A tela de **Rotas** permite visualizar, acompanhar e criar rotas de entrega. No contexto **LOG**, ela é usada para criar e gerenciar **rotas via transportadora (TRP)** — quando um lote de pedidos é enviado a uma transportadora integrada para execução das entregas.
**Frota Própria:** A criação de rotas com motoristas próprios (Frota Própria) faz parte do produto **GO**. Se você gerencia uma frota de motoristas, consulte a [documentação de Rotas do GO](https://abbiamo-guide.netlify.app/go/products/rotas/).

---

## Onde acessar

- **URL principal:** [https://dashboard.abbiamolog.com/routes](https://dashboard.abbiamolog.com/routes)
- **Menu:** seção **Operação** > **Rotas**

---

## O que o cliente vê ao entrar

### Cabeçalho

| Elemento | Descrição |
| -------- | --------- |
| **Título** | "Rotas" |
| **Nova rota** | Abre 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](#status-de-rota)
- **Entregue por** (multisseleção) — filtre pelas 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

| Coluna | O que mostra |
| ------ | ------------ |
| **ID** | Identificador único da rota (exibido com até 12 caracteres + botão de copiar) |
| **Nome da Rota** | Nome externo da rota, gerado automaticamente se não informado |
| **Status** | Badge colorido com o status atual da rota |
| **Entregas** | Contagem total + blocos visuais por status com os números dos pedidos |
| **Responsável** | Transportadora responsável pelas entregas |
| **Criado em** | Data e hora de criação (formato dd/MM/yy HH:mm) |
| **Custo** | Custo da rota em BRL (quando informado) |
| **Distância** | Distância esperada em km |
| **Tempo estimado** | Tempo esperado no formato HH:mm |
| **Ações** | Menu suspenso (⋮) com ações individuais por rota |

### Interações de linha

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

### Estado vazio

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

> *"Nenhuma rota encontrada. Crie uma rota agora mesmo"*

---

## Filtros avançados disponíveis

| Campo | Tipo |
| ----- | ---- |
| **Nome da rota** | Texto |
| **Nome do motorista** | Texto |
| **Sobrenome do motorista** | Texto |
| **Documento do motorista** | Texto |
| **Pedido de entrega** | Texto |
| **Status da entrega** | Multisseleção |

---

## Ações por rota (menu ⋮)

| Ação | Disponibilidade |
| ---- | --------------- |
| **Ver rota** | Sempre disponível |
| **Solicitar coleta** | Rota sem responsável atribuído, pedidos de uma única filial |
| **Duplicar rota** | Indisponível para **EM EXECUÇÃO** e **PEDIDOS CONCLUÍDOS** |
| **Exportar CSV** | Disponível para contas habilitadas |
| **Cancelar rota** | Açã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

| Status | Descrição |
| ------ | --------- |
| **CRIADA** | Rota criada e aguardando aceite ou início pela transportadora |
| **EM EXECUÇÃO** | A transportadora iniciou as entregas |
| **CANCELADA** | Rota cancelada — pedidos retornam ao estado pendente |
| **PEDIDOS CONCLUÍDOS** | Todos os waypoints da rota foram finalizados |
| **FINALIZADA** | Rota 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
- Transportadora responsável
- 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**](https://abbiamo-guide.netlify.app/log/products/rotas/como-usar/) — passo a passo para criar rotas via transportadora, filtrar e acompanhar o status das entregas.