<!-- 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 NF-e: tudo o que ela mostra e como usar

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

**Documentos › NF-e** lista as **notas fiscais eletrônicas modelo 55** capturadas
para as suas empresas — as que fornecedores emitiram contra o seu CNPJ e as que
você emitiu.

É a tela mais completa do GaxWeb: **19 colunas** e a única com **Etiquetas**,
**cStat**, **CFOP** e **Manifestação do destinatário**.

## As colunas

| Coluna | O que mostra |
|---|---|
| **Status** | Situação do documento no GaxWeb. |
| **Etiquetas** | Marcadores aplicados à nota. *Só a NF-e tem.* |
| **Eventos** | Manifestações registradas para a nota. |
| **ID** | Número interno do GaxWeb. Serve para citar a nota no suporte. |
| **cStat** | Código de status da Sefaz (ex.: `100` = autorizado). *Só NF-e e NFS-e.* |
| **CFOP** | Códigos fiscais da operação. *Só a NF-e.* |
| **Chave de acesso** | Os 44 dígitos da nota. |
| **Documento** | Número e série. |
| **Natureza da operação** | O que o emitente declarou (venda, remessa, devolução…). |
| **Emitente** | Quem emitiu — nome e CNPJ, com a UF ao lado. |
| **Destinatário** | Para quem foi emitida. |
| **Valor** | Valor total da nota. |
| **Emissão** | Data e hora em que o emitente emitiu. |
| **Criação** | Data e hora em que a nota entrou no GaxWeb. |
| **Origem** | Por qual caminho a nota chegou. |
| **Empresa** | A qual das suas empresas a nota pertence. |
| **Perfil** | Perfil dono do registro. |

> As colunas de **Valor** em diante ficam à direita da rolagem — role para o lado
> ou esconda o que não usa.

**Filtro no cabeçalho** para: ID, cStat, CFOP, Chave de acesso, Documento,
Natureza da operação, Emitente e Destinatário.

## Filtros próprios da NF-e

**Situação** (pode marcar mais de uma):

| Opção | Encontra |
|---|---|
| Cancelado | Notas canceladas pelo emitente. |
| Não cancelado | Apenas as válidas. |
| **Sem XML** | **Notas de que o GaxWeb tem os dados mas ainda não o XML.** |
| Contingência | Emitidas em contingência. |
| Uso denegado | Denegadas pela Sefaz. |
| Sem protocolo | Sem protocolo de autorização. |
| Sem assinatura | Sem assinatura digital válida. |

> 🔎 **"Sem XML" é o filtro mais útil desta tela.** Ele mostra exatamente as notas
> em que falta o arquivo — o que você precisa guardar. Se aparecerem itens aí,
> veja *Como recuperar notas antigas*.

**Eventos** — as manifestações: Ciência, Confirmação, Desconhecimento e Não
realizada.

## 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*.

## Manifestação do destinatário

Só a NF-e tem. É a declaração enviada à Sefaz sobre uma nota emitida contra o seu
CNPJ — **tem efeito fiscal**, não é um marcador interno.

📍 **Onde fica — e por que muita gente não acha:** a manifestação **não está no
menu do botão direito**. Ela fica **dentro da nota**:

**botão direito sobre a nota → Visualizar → botão "Manifestação"**, no canto
superior direito do visualizador.

| Tipo de evento | Significado |
|---|---|
| Ciência da Operação | Você tomou conhecimento da nota. |
| Confirmação da Operação | Você confirma que a operação ocorreu. |
| Desconhecimento da Operação | Você declara que não reconhece a operação. |
| Operação não Realizada | A operação não se concretizou. |

A janela pede a **chave de acesso** (já preenchida), o **tipo de evento** e o
**motivo**.

> 🔒 O acesso à manifestação é controlado em **Segurança › Grupos de Permissões**.
> Se o botão não aparece para alguém da equipe, é permissão — não é a versão.

## O visualizador da nota

**Botão direito → Visualizar** abre a nota em **aba própria**, com três abas:

| Aba | Conteúdo |
|---|---|
| **DANFE** | A representação gráfica, com zoom, girar, imprimir e baixar. |
| **Detalhes** | Os campos da nota em tela, sem precisar ler o XML. |
| **XML** | O arquivo em si. |