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

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

**Documentos › NFC-e** lista as **notas fiscais de consumidor eletrônicas
(modelo 65)** — a nota do varejo, emitida direto ao consumidor final.

A tela é mais enxuta que a de NF-e: **15 colunas**. Não tem Etiquetas, cStat nem
CFOP, porque a NFC-e não trabalha com manifestação do destinatário.

## As colunas

| Coluna | O que mostra |
|---|---|
| **Status** | Situação do documento no GaxWeb. |
| **Eventos** | Eventos registrados (na NFC-e, cancelamento). |
| **ID** | Número interno do GaxWeb. |
| **Chave de acesso** | Os 44 dígitos. |
| **Documento** | Número e série. |
| **Emitente** | Quem emitiu. |
| **Destinatário** | Para quem foi emitida (nem sempre identificado, no varejo). |
| **Valor** | Valor total. |
| **Emissão** | Quando foi emitida. |
| **Criação** | Quando entrou no GaxWeb. |
| **Origem** | Por qual caminho chegou. |
| **Empresa** | A qual empresa pertence. |
| **Perfil** | Perfil dono do registro. |

**Filtro no cabeçalho** para: ID, Chave de acesso, Documento, Emitente e
Destinatário.

## Filtros próprios da NFC-e

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

> Note que **não há "Sem XML"** aqui — ao contrário da NF-e.

**Eventos**: apenas **Cancelamento**. A NFC-e não tem manifestação do
destinatário.

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

## Um caso à parte: NFC-e de São Paulo

O monitor de **NFC-e/SP** é separado dos demais e tem uma regra própria: exige o
**certificado do próprio CNPJ**. Matriz não consulta filial e filial não consulta
matriz — cada uma precisa do seu.

Ele se liga em **Administração › Empresas → aba Monitor**, no par
**Ativo/Inativo + Ciclo** do NFC-e/SP, e tem ainda um campo **Período**.