<!-- GERADO AUTOMATICAMENTE por paginas/montar.py.
     NAO EDITE ESTE ARQUIVO: edite paginas/_fonte/ e rode montar.py.
     O bloco comum vem de _fonte/comum-listas.md -- fonte unica, para que os
     artigos das varias telas nao possam divergir entre si. -->

# A tela de CT-e OS: tudo o que ela mostra e como usar

> **Aplica-se a:** GaxWeb 5.0.0 (alpha) — update 27.08.2026

**Documentos › CT-e OS** lista os **conhecimentos de transporte eletrônicos para
Outros Serviços (modelo 67)** — usados no transporte de pessoas, no excesso de
bagagem e no transporte de valores.

São **16 colunas**. A diferença para o CT-e comum é reveladora: **não há
Destinatário**, só **Tomador**.

## As colunas

| Coluna | O que mostra |
|---|---|
| **Status** | Situação do documento no GaxWeb. |
| **Eventos** | Eventos registrados. |
| **ID** | Número interno do GaxWeb. |
| **Chave de acesso** | Os 44 dígitos. |
| **Nota** | Número do conhecimento. |
| **Natureza da operação** | O que foi declarado. |
| **Emitente** | A transportadora. |
| **Tomador** | 💰 Quem contratou o serviço. |
| **Valor** | Valor do serviço. |
| **Emissão** | Quando foi emitido. |
| **Criação** | Quando entrou no GaxWeb. |
| **Origem** | Por qual caminho chegou. |
| **Empresa** | A qual empresa pertence. |
| **Perfil** | Perfil dono do registro. |

> 🚌 **Por que não tem Destinatário?** No CT-e OS o serviço é prestado a quem
> contrata — não há uma carga sendo entregue a um terceiro. Quem contrata é o
> tomador, e ponto. Se você procura por destinatário aqui, procure por **Tomador**.

**Filtro no cabeçalho** para: ID, Chave de acesso, Nota, Natureza da operação,
Emitente e Tomador.

## Filtros próprios do CT-e OS

**Situação**: Cancelado · Não cancelado · Contingência · Uso denegado · Sem
protocolo · Sem assinatura.

**Eventos**: Cancelamento · Cancelamento do Comprovante de Entrega do CT-e.

## A tela por partes

Toda lista de documentos do GaxWeb 5.0 tem a mesma anatomia. Vale a pena conhecer
uma vez: o que você aprende aqui serve para NF-e, NFC-e, SAT, NFS-e, CT-e e
CT-e OS.

```
┌─ título da tela ──────────── Reload | Registros | 🅧 🔄 ☷ ☰ ← ícones
│  [ menu Documento ]                      "N item(ns) selecionado(s)"
├─ cabeçalho das colunas ──────────────────── ↔ rola para o lado
│  [ caixa de filtro por coluna ]
│  linhas...
└─ Total de registros | Atualizado em          « ‹ 1 2 3 › »  ← páginas
```

## Os quatro ícones do canto superior direito

São fáceis de não notar, e resolvem quase toda queixa de "a tela está estranha".

| Ícone | O que faz |
|---|---|
| 📗 **Exportar resultado para Excel** | Baixa em Excel **o que está na tela**, com os filtros aplicados. Não é a exportação de XML. |
| 🔄 **Recarregar toda a tabela** | Busca os dados de novo no servidor. Use depois de mudar algo em outra tela. |
| ☷ **Exibir/Ocultar colunas** | Escolhe quais colunas aparecem. É aqui que se resolve "essa coluna sumiu". |
| ☰ **Mais filtros** | Abre e fecha o painel **Outros filtros**, à direita. |

> 🧹 **Tela bagunçada?** Existe ainda um ícone **Reiniciar storage local**. O
> GaxWeb guarda no seu navegador a largura e a ordem das colunas — se a tela ficou
> torta ou uma coluna sumiu e não volta, esse botão devolve o padrão. Ele mexe só
> no seu navegador: não altera dado nenhum.

## Reload e Registros

No topo, dois seletores que mudam o comportamento da lista:

| Seletor | Opções | Para que serve |
|---|---|---|
| **Reload** | Desativado · 15s · 30s · 60s | Atualiza a lista sozinha. Útil para acompanhar notas chegando. |
| **Registros** | 10 · 50 · 100 · 500 · 1000 | Quantas linhas por página. |

> 📄 **"Só aparecem 50 registros".** É este seletor, não um limite da sua conta.
> Aumente para 100, 500 ou 1000 — ou use as páginas no rodapé.
>
> ⚠️ **A seleção por caixinha vale só na página aberta.** Se você marcar itens e
> virar a página, a marcação da página anterior se perde. Para agir sobre muitos
> registros, aumente **Registros** primeiro, depois marque.

## A lista rola para o lado

As colunas somam bem mais que a largura da tela — há uma **barra de rolagem
horizontal** no rodapé da grade. **Colunas importantes ficam escondidas à
direita**, entre elas **Valor**, **Emissão**, **Criação**, **Origem**, **Empresa**
e **Perfil**.

> Se uma informação parece não existir, role para a direita antes de concluir que
> falta. E se você nunca usa certas colunas, esconda-as em **Exibir/Ocultar
> colunas** — as que sobram ficam mais largas.

## Três formas de filtrar (e elas se somam)

**1. Filtro por coluna** — a caixinha logo abaixo do título da coluna. Digite ali
para filtrar por aquele campo. Nem toda coluna tem: as de texto e código têm; as
de data e valor, não.

**2. Painel "Outros filtros"** — à direita, aberto pelo ícone ☰. É onde ficam os
filtros de período, empresa, situação e origem.

**3. Ordenação** — clique no título da coluna. As setas ⇅ indicam quais ordenam.

> Os três se combinam. Uma busca que "não traz nada" quase sempre tem um filtro
> esquecido em outro lugar — o painel da direita costuma ser o culpado.

### Filtros que toda lista de documentos tem

| Campo | O que faz |
|---|---|
| **Perfil** | Restringe ao perfil escolhido. |
| **Empresa (CPF/CNPJ)** | Busca por CNPJ, razão social ou município. |
| **Etiqueta** | Filtra pelos marcadores aplicados. |
| **Origem** | **De onde veio o documento** — veja abaixo. |
| **Emissão entre** | Período pela data de **emissão** do documento. |
| **Criação entre** | Período pela data em que o documento **entrou no GaxWeb**. |

> 📅 **Emissão x Criação — a confusão mais comum.** *Emissão* é quando o emitente
> emitiu a nota. *Criação* é quando ela chegou ao GaxWeb. Uma nota emitida em
> janeiro pode ter criação em março, se a empresa só foi cadastrada depois. Quem
> procura por "notas que chegaram esta semana" deve filtrar por **Criação**.

### Origem: de onde veio cada documento

Este filtro responde a pergunta "por que essa nota está aqui?" — ou "por que
aquela não está". Os valores mais úteis no dia a dia:

| Origem | Significa |
|---|---|
| `nfe_an`, `cte_an`, `nfse_an`, `mdfe_an` | Veio do **monitor** no Ambiente Nacional. É o caminho normal. |
| `gaxup` | Subiu pelo **GaxUp**, do computador do cliente. |
| `agent` | Veio pelo **gaxweb-agent** instalado num terminal. |
| `email` | Chegou por **e-mail**. |
| `manual` | Alguém **subiu o arquivo** na mão. |
| `recuperar_xml` | Veio de uma **recuperação por chave**. |
| `nfean_autorecover` | O GaxWeb **recuperou sozinho** um XML que faltava. |
| `serpro`, `mastertax`, `saesp` | Veio de **integração** com esses serviços. |
| `migracao` | Veio da **migração** da versão anterior. |
| `Não informado` | Registro antigo, sem origem gravada. |

Há ainda origens técnicas (`console`, `sat_sp`, `ws_sat_sp`, `cfe_go`, `nfe_rs`,
`mdfe_svrs`, `gaxdata_dfe`, `exportacao_formulario`, `datagrid_*`), usadas por
processos internos.

## O que dá para fazer com um documento

**Botão direito sobre a linha** — é o caminho mais curto, e tem ações que **não
existem** no menu de cima:

| Ação | O que faz |
|---|---|
| **Visualizar** | Abre o documento em aba própria, com **DANFE**, **Detalhes** e **XML**. |
| **Exportar PDF** | Baixa o PDF (DANFE) **avulso**, na hora. |
| **Exportar XML** | Baixa o XML **avulso**, sem zip. |
| **Recarregar item** | Atualiza só aquela linha. |

**Menu Documento**, no topo, com linhas marcadas: **apenas Exportação**.

> 📦 **"Veio um zip e eu queria só o XML".** O zip vem da exportação em lote. Para
> **uma nota**, use o **botão direito → Exportar XML**: sai o arquivo avulso.
>
> 🏷️ **Não existe aplicar etiqueta em várias notas de uma vez.** O menu Documento
> só exporta. Etiqueta em lote existe para *empresas*, em Administração.

## Quando a lista volta vazia

Confira nesta ordem — a causa quase sempre está na primeira ou na segunda:

1. **O painel "Outros filtros" está com algo marcado?** É a causa nº 1. Limpe pelo
   **X** de cada campo.
2. **O período está certo?** Veja se filtrou por *Emissão* quando queria *Criação*.
3. **Há filtro digitado no cabeçalho de alguma coluna?** Role para o lado: pode
   haver um filtro numa coluna que você não está vendo.
4. **A empresa está sendo monitorada?** Se nunca chegou nota daquela empresa, o
   problema não é o filtro — veja *Monitores*.

## CT-e ou CT-e OS?

| | CT-e (57) | CT-e OS (67) |
|---|---|---|
| Transporta | Carga | Pessoas, bagagem, valores |
| Tem destinatário | Sim | Não |
| Tela | Documentos › CT-e | Documentos › CT-e OS |

São **listas separadas**: um documento nunca aparece nas duas. Se o conhecimento
não está numa, procure na outra antes de abrir chamado.