A tela de NFS-e: tudo o que ela mostra e como usar

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

Documentos › NFS-e lista as notas fiscais de serviço eletrônicas — as notas de serviço, emitidas pelas prefeituras.

São 16 colunas. Esta tela tem vocabulário próprio: onde as outras dizem Destinatário, aqui se diz Tomador (quem contratou o serviço).

As colunas

Filtro no cabeçalho para: ID, cStat, Chave de acesso, Número, Emitente e Tomador.

Filtros próprios da NFS-e

Situação — só duas opções, bem menos que nas outras telas: Cancelado · Contingência.

Eventos — e aqui a lista é a mais rica de todas:

Note que não existe manifestação do destinatário aqui — os eventos da NFS-e são outros, próprios do modelo nacional de nota de serviço.

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".

🧹 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:

📄 "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

📅 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:

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:

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.

Por que faltam notas de serviço: a questão do município

A NFS-e é a captura mais irregular do GaxWeb, e a razão não está no sistema:

• Municípios no padrão nacional — sincronizam as notas no repositório nacional (ADN), e o GaxWeb captura normalmente.
• Municípios com emissor próprio — cada prefeitura tem seu portal e seu webservice. A captura depende de o município disponibilizar o acesso.

A Lei Complementar 214/2025 estabeleceu que, desde 1º de janeiro de 2026, todos os municípios devem sincronizar os dados no repositório nacional — mas podem continuar com seu próprio portal emissor. Na prática, a adesão é desigual.

❓ Antes de concluir que "o GaxWeb não pega minha NFS-e", confirme com o suporte se o seu município já está homologado. Não dá para deduzir isso da tela.