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

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

Documentos › Sat lista os CF-e/SAT (modelo 59) — o cupom fiscal eletrônico emitido pelo equipamento SAT, usado no varejo de São Paulo.

São 15 colunas, e esta tela tem duas particularidades que nenhuma outra tem.

As colunas

⚠️ Esta tela não tem coluna "Eventos" — é a única lista de documentos sem ela. O SAT não trabalha com eventos como a NF-e: o cancelamento aparece como um outro cupom, ligado ao original pela Chave vinculada.

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

Filtros próprios do SAT

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

Não há filtro de Eventos nesta tela.

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.

Como o SAT chega ao GaxWeb

O CF-e/SAT não vem do Ambiente Nacional como a NF-e. Ele chega por caminhos próprios, que você reconhece na coluna Origem:

🏪 Para quem tem PDV, o caminho usual é o GaxUp ou o gaxweb-agent instalado no terminal: eles recolhem os cupons e enviam sozinhos. Veja gaxweb-agent: Terminais, Tarefas e Uploads.