A tela de CT-e OS: colunas, filtros e acoes (GaxWeb 5.0)

Tiago Camara

Tiago Camara

Última atualização em Aug 27, 2026

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.