# Tela de Pedidos — Visão Geral (GO)

A tela de **Pedidos** no GO concentra a operação diária da transportadora: consulta, filtragem, acompanhamento de status e ações individuais por pedido — com foco nos pedidos recebidos dos seus [embarcadores](https://abbiamo-guide.netlify.app/go/conceitos/embarcador/).
**Diferença para o LOG:** No LOG, a tela de Pedidos é voltada para o embarcador que envia. No GO, é voltada para a transportadora que executa as entregas. Por isso, o GO inclui filtros e colunas de **embarcador** que não existem no LOG, e não exibe o painel lateral de KPIs.

---

## Onde acessar

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

---

## O que você vê ao entrar

### Cabeçalho

| Elemento | Descrição |
|----------|-----------|
| **Menu lateral** | Abre/fecha a sidebar |
| **Título** | "Pedidos" |
| **Criar pedido** | Abre fluxo de criação de pedido |

### Cards de status (topo)

No topo da tela, cards colapsáveis exibem a contagem de pedidos por status (Criado, Pendente, Despachado, Em Trânsito, etc.), permitindo uma visão rápida do estado geral da operação.

### Barra de filtros e controles

- **Busca de pedido** por NF, número do pedido e `external_id`
- **Atualizar lista** manualmente (botão de refresh)
- **Status** (multisseleção)
- **Entregue por** (transportadora/responsável da última entrega)
- **Período** (date range, até 93 dias)
- **Marcadores** (incluindo opção "Sem marcadores")
- **Grupo de embarcadores** — filtra por grupo de embarcadores
- **Embarcador** — filtra por embarcador específico
- **Filtros avançados** (filtro por campo)
- **Visibilidade de colunas** (mostrar/ocultar)
- **Exportar** (CSV da tabela atual)
**Filtros exclusivos do GO:** Os filtros **Grupo de embarcadores** e **Embarcador** são exclusivos do GO e permitem segmentar rapidamente os pedidos por cliente.

### Tabela de pedidos

Colunas principais disponíveis:

| Coluna | O que mostra |
|--------|-------------|
| **Pedido** | Número do pedido |
| **ID Externo** | ID externo do pedido |
| **NF** | Número da nota fiscal |
| **Embarcador** | Nome do embarcador que originou o pedido, com indicação do grupo |
| **Tipo da entrega** | Entrega / Retirada / Reversa |
| **Criado em** | Data/hora de criação |
| **Atualizado em** | Tempo relativo desde última atualização |
| **Envios** | Quantidade de envios |
| **Status / Sub Status** | Situação atual do pedido (veja [Status de pedido](https://abbiamo-guide.netlify.app/go/conceitos/status-de-pedido/)) |
| **Entregue por** | Responsável da última entrega |
| **Cliente** | Nome do cliente |
| **Chegada** | Data/hora de chegada |
| **Prazo prometido** | Data/hora prometida (quando aplicável) |
| **Frete pago** | Valor de frete |
| **Rastreio** | Código de rastreio |
| **Marcadores** | Tags aplicadas |
| **Indicadores** | Avaliação e comprovante |
| **Ações** | Menu de ações por pedido (⋮) |
**Coluna Embarcador:** A coluna **Embarcador** é exclusiva do GO. Ela exibe o nome do embarcador com um indicador colorido e, ao passar o mouse, mostra o identificador e o grupo ao qual pertence.

### Interações de linha

- **Clique simples:** abre detalhes do pedido em side panel
- **Seleção múltipla:** habilita barra de ações em lote

### Paginação

- Tamanhos de página: **50, 100, 150, 200**

### Estado vazio

Quando não há resultados:

> _"Nenhum pedido encontrado. Crie um novo agora mesmo"_

---

## Filtros avançados disponíveis

No menu de filtros avançados, os campos incluem:

- Pedido (`invoice.number`)
- NF (`invoice.invoice_number`)
- Nome do cliente (`customer.name`)
- Documento do cliente (`customer.document_number`)
- Tipo da entrega (`invoice.type`)
- Origem do pedido (`invoice.creation_origin`)
- Filial (`invoice.seller_id`)
- Tipo da operação (`invoice.operation`)

---

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

As opções variam por status e tipo do pedido.

### Ações comuns

- **Ver rastreio**
- **Ver etiqueta**
- **Ver DANFE** (desabilita se o pedido não tiver NF/chave)
- **Duplicar pedido**
- **Anexar comprovantes** (somente quando status = `SUCCESSFUL`)
- **Editar marcadores**
- **Editar embarcador** — associar ou alterar o embarcador do pedido
**Editar embarcador:** A ação **Editar embarcador** é exclusiva do GO. Ela permite associar um embarcador a pedidos que ainda não possuem vínculo. Pedidos já vinculados a um embarcador via integração LOG não podem ter o embarcador alterado.

### Ações condicionais

- **Finalizar retirada** (pedido TAKEOUT em `DISPATCHED` + substatus `READY_FOR_TAKEOUT`)
- **Solicitar coleta/reversa** (tipos DELIVERY/RETURN)
- **Reenviar pedido** (status elegíveis + tipo de entrega elegível)
- **Cancelar agendamento** (somente quando status = `SCHEDULED`)

---

## Status e substatus

Os status são os mesmos da plataforma Abbiamo, compartilhados entre LOG e GO. Consulte a referência completa em [Status de pedido](https://abbiamo-guide.netlify.app/go/conceitos/status-de-pedido/).

---

## Comportamentos automáticos importantes

- **Reset de paginação:** alterações de filtros voltam para a primeira página
- **Preservação de seleção:** seleção é reconciliada quando os dados mudam
- **Side panel por URL:** `order_id` em query string abre detalhes do pedido
- **Exportação local:** exporta CSV da visão atual da tabela (respeitando visibilidade de colunas)