Documentos Fiscais
Guia sobre NF-e, NFC-e, CT-e, SAT e NFS-e: manifestação, eventos e a guarda obrigatória de 11 anos.
Por que guardar o XML por 11 anos (e o risco de nao guardar)
A legislação fiscal exige a guarda do XML das notas fiscais por até 11 anos (Ajuste SINIEF 2/2025). A responsabilidade é do contribuinte — tanto de quem emite quanto de quem recebe. A SEFAZ não é backup. O risco de não guardar: multa, perda de crédito tributário e problema em fiscalização. Em SP, por exemplo, a multa pode chegar a 10% do valor da operação. O GaxWeb resolve isso automaticamente: baixa e guarda o XML por 11 anos, organizado e disponível para exportar quando você precisar. Quer testar o GaxWeb? É grátis e sem cartão: gaxweb.com.br · Falar com a gente: WhatsApp
O que é um pfx?
O pfx é a extensão do arquivo exportado do certificado A1. Sempre que você emite o certificado A1, a certificadora gera um arquivo .pfx que pode ser guardado no repositório do computador ou em qualquer pasta que desejar. Importante: faça sempre backup do arquivo .pfx e da senha — se perdê-lo, não será possível recuperá-lo, sendo necessário emitir um novo certificado digital (gerando custos). Precisa de um certificado digital agora? Emita no iCertificado
Como funciona o evento Ciência da Emissão?
O evento "Ciência da Emissão" registra na NF-e a solicitação do destinatário para obter o arquivo XML. Após o registro, o destinatário pode efetuar o download do XML. Este evento NÃO representa a manifestação do destinatário sobre a operação — apenas dá condições para obter o XML e registra que o destinatário sabe que o documento foi emitido, mas ainda não expressou uma manifestação conclusiva. Toda operação com Ciência da Emissão deve, na sequência, ter o registro da manifestação conclusiva (Confirmação da Operação, Operação não Realizada ou Desconhecimento da Operação).
Uma vez que o destinatário tomou Ciência da Emissão é obrigatória a sua manifestação?
Sim. Toda nota informada ao contribuinte deve ter registrada a respectiva manifestação no prazo máximo de 180 dias, contados da data da ciência. Esse prazo máximo será reduzido gradativamente, conforme o interesse das Administrações Tributárias.
O que é a Manifestação do Destinatário?
Conjunto de eventos que permite ao destinatário da NF-e se manifestar sobre a sua participação comercial descrita na nota, confirmando as informações prestadas pelo fornecedor/emissor. No GaxWeb esses eventos podem ser registrados diretamente, sem necessidade de escolher o certificado nem digitar senhas. São quatro eventos: 1) Ciência da Emissão; 2) Confirmação da Operação; 3) Registro de Operação não Realizada; 4) Desconhecimento da Operação.
O processo de Manifestação do Destinatário é obrigatório?
Mantendo a mesma filosofia de implementação da NF-e, o processo de Manifestação do Destinatário foi inicialmente voluntário, com obrigatoriedade prevista para iniciar ao longo do tempo para alguns tipos selecionados de movimentação de mercadorias.
O que é um evento da Nota Fiscal Eletrônica - NF-e?
É qualquer fato relacionado com uma NF-e, normalmente ocorrido após a sua autorização de uso. A Carta de Correção Eletrônica e o Cancelamento são exemplos de eventos da NF-e. Os eventos aparecem na consulta da NF-e na internet e funcionam como um extrato dos fatos vinculados ao documento; conforme sua natureza, podem ser visualizados por todos os envolvidos na operação ou somente pelas Administrações Tributárias.
Consigo baixar as notas com certificado e-CPF ou só e-CNPJ?
Sim. O GaxWeb baixa as notas tanto com e-CNPJ quanto com e-CPF — e isso é uma regra da própria SEFAZ, não uma limitação do sistema. Como a SEFAZ trata isso O download automático de notas usa o serviço nacional de Distribuição de DF-e (NFeDistribuicaoDFe, criado pela Nota Técnica 2014.002). Esse serviço atende qualquer participante da NF-e — pessoa física ou jurídica — desde que use um certificado digital válido (e-CPF ou e-CNPJ) e informe o CPF ou o CNPJ do interessado. O certificado define DE QUEM são as notas - e-CNPJ → baixa as notas daquele CNPJ. Um mesmo e-CNPJ também alcança as filiais da mesma raiz (os 8 primeiros dígitos do CNPJ). - e-CPF → baixa as notas emitidas para aquele CPF (pessoa física), ou aquelas em que o CPF foi autorizado pelo emitente (grupo de autorizados do XML). Importante: cada certificado enxerga apenas o próprio documento. Um e-CPF não baixa as notas de um CNPJ, e um e-CNPJ não baixa as de um CPF. No GaxWeb, na prática No Assistente de cadastro (Administração › Empresas › Assistente): 1. Documento — informe o CPF ou o CNPJ; 2. Certificado — anexe o A1 (.pfx) correspondente; 3. Monitores — escolha os documentos e o ciclo. Com um e-CPF A1 você monitora normalmente as notas daquele CPF. Dois pontos que valem saber - A NF-e completa só é liberada depois da manifestação (Ciência da Operação). Antes disso, a distribuição entrega apenas o resumo da nota. - Os documentos ficam disponíveis para download por cerca de 90 dias após chegarem ao Ambiente Nacional.
É possível reconsiderar o registro de um destes eventos?
O destinatário pode enviar uma única mensagem de Confirmação da Operação, Desconhecimento da Operação ou Operação não Realizada, valendo apenas a última mensagem registrada. Exemplo: pode desconhecer uma operação que havia confirmado, ou confirmar uma que havia desconhecido. O evento de Ciência da Emissão não configura a manifestação final do destinatário, portanto não cabe registrá-lo após a manifestação final.
Se a Manifestação do Destinatário ainda não é obrigatória, por que as empresas devem adotar este processo?
Pelas razões abaixo, que beneficiam o próprio destinatário das mercadorias: - Saber quais NF-e foram emitidas, em todo o país, tendo a empresa como destinatária - Evitar o uso indevido da sua Inscrição Estadual por emitentes que usam inscrições para acobertar operações fraudulentas - Obter o XML das NF-e que não tenham sido transmitidas pelo emitente - Obter segurança jurídica no uso do crédito fiscal correspondente, pois uma nota confirmada não pode ser cancelada pelo emitente - Registrar junto aos fornecedores que a mercadoria foi recebida, constituindo formalmente o vínculo comercial, sem necessidade de assinatura no canhoto do DANFE
Por que a manifestação feita em outro sistema não aparece no GaxWeb
Se você (ou seu cliente) manifesta as notas de entrada em outro sistema — por exemplo no seu ERP (Varejo Fácil, etc.) ou o próprio fornecedor faz a manifestação — e essas manifestações não aparecem no GaxWeb (nem ao filtrar por "manifestadas"), isso é esperado. Abaixo explicamos o porquê e o que dá para fazer. Por que isso acontece O GaxWeb baixa documentos e eventos consultando o Ambiente Nacional do SEFAZ (serviço NFeDistribuiçãoDFe). E existe uma regra da própria SEFAZ (Nota Técnica 2014.002): A distribuição entrega a cada empresa apenas os documentos e eventos que NÃO foram gerados por ela. A manifestação do destinatário — Ciência da Emissão, Confirmação da Operação, Operação não Realizada e Desconhecimento da Operação — é um evento gerado pela própria empresa destinatária. Por isso, quando essa manifestação é feita fora do GaxWeb, a SEFAZ não a devolve para a empresa na distribuição — e o GaxWeb não tem como exibi-la nem filtrá-la. Não é uma limitação do GaxWeb, e sim uma regra do SEFAZ. O que aparece no GaxWeb - Manifestações feitas dentro do GaxWeb: aparecem normalmente e podem ser filtradas. - Manifestações feitas em outro sistema (ERP, fornecedor): não retornam do SEFAZ, então não aparecem no GaxWeb. Como unificar tudo no GaxWeb Se você precisa ver no GaxWeb também as manifestações feitas em outro sistema, o caminho é integração. Há duas formas, a definir conforme onde e como o seu sistema guarda esses dados: 1. Base a base, via GaxUp — o aplicativo GaxUp varre uma pasta/base local e envia automaticamente os XMLs (documentos e eventos) para o GaxWeb. 2. Via API (GaxDFE) — o seu sistema envia os documentos/eventos ao GaxWeb por API. Para avaliarmos a melhor opção para o seu caso, agende uma reunião com a gente ou fale pelo nosso WhatsApp. Atenção: "Desconhecimento da Operação" não é nota denegada Um ponto importante: o evento Desconhecimento da Operação significa que o destinatário recusou aquela nota — não que a nota foi denegada ou cancelada. A nota continua ativa; se for o caso, é o emitente quem faz a devolução/ajuste. Detalhe técnico (para quem quiser se aprofundar) - Antes de o destinatário se manifestar, a SEFAZ disponibiliza apenas o Resumo da NF-e; o XML completo só é liberado após a manifestação (Ciência, Confirmação ou Operação não Realizada). - Os documentos ficam disponíveis para download por cerca de 90 dias após a recepção no Ambiente Nacional. Ficou com dúvida? Fale com a gente pela Central de Ajuda ou pelo WhatsApp — estamos à disposição.
Monitores: por onde comecar (GaxWeb 5.0)
Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Os monitores são o coração do GaxWeb: eles consultam a Sefaz de tempos em tempos e trazem os documentos emitidos contra o seu CNPJ, sem você fazer nada. O menu Monitores é onde se acompanha essa busca. Cada tipo de documento tem o seu, com telas próprias. | Monitor | Manual completo | |---|---| | NFe/AN — o mais completo, com Tentativas e Ciência | O monitor de NF-e | | CTe/AN, NFSe/AN e NFCe/SP | Os monitores de CT-e, NFS-e e NFC-e/SP | O monitor não se liga aqui Esta é a confusão mais comum: o menu Monitores só mostra. Quem liga é o cadastro da empresa: Administração › Empresas → botão direito na empresa → Editar → aba Monitor → ponha em Ativo o tipo de documento desejado, e escolha o Ciclo. ⚠️ São dois campos, e a diferença derruba muita gente: Ativo/Inativo é o que liga; o Ciclo é só a janela de horário. Definir apenas o Ciclo não liga nada, e nenhuma mensagem avisa. 🔀 Cada tipo é independente. Ligar o de NF-e não liga o de CT-e nem o de NFS-e. Depois de ligar: o que esperar - A empresa entra numa fila: de 5 a 60 minutos até a primeira nota. - A busca é retroativa, a partir de cerca de 179 dias antes do cadastro. - A Sefaz aceita uma consulta por hora. Não existe "buscar agora". 🛑 Não deixe o monitor parado. A Fazenda desativa a distribuição para quem fica 60 dias sem monitorar — e é a causa mais comum de "parou de chegar nota do nada". Diagnóstico rápido: "não está chegando nota" Nesta ordem — quase sempre para nos dois primeiros: 1. A empresa aparece na tela Empresas daquele monitor? Se não, ele não está Ativo. 2. Tem certificado válido e vinculado? Confira a Validade e a coluna Vínculos em Administração › Certificados. 3. A "Última consulta" é recente? A coluna Informações diz o motivo em texto — é o diagnóstico mais direto que existe. 4. NSU atual muito atrás do Último NSU? Está atrasado, mas rodando. 5. Na tela Tentativas (só NF-e), qual código de retorno se repete? Para entender a mensagem que apareceu, veja O que significa cada status e mensagem do GaxWeb. Para ir além - Ligar o monitor de uma empresa → A tela de Empresas: cadastro, monitores e eCac - Certificado vencido ou sem vínculo → A tela de Certificados - As notas capturadas → Documentos fiscais: por onde começar
A tela de CT-e: colunas, filtros e acoes (GaxWeb 5.0)
A tela de CT-e: tudo o que ela mostra e como usar Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Documentos › CT-e lista os conhecimentos de transporte eletrônicos (modelo 57) — o documento do frete. São 17 colunas. É a única tela que traz Destinatário e Tomador ao mesmo tempo, e a razão é a natureza do transporte: quem recebe a carga nem sempre é quem paga o frete. As colunas | Coluna | O que mostra | |---|---| | Status | Situação do documento no GaxWeb. | | Eventos | Eventos registrados para o CT-e. | | 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. | | Destinatário | 📦 Quem recebe a carga. | | Tomador | 💰 Quem contratou e paga o frete. | | Valor | Valor do frete. | | 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. | 🎯 Destinatário ≠ Tomador, e isso importa na busca. Numa venda com frete pago pelo vendedor (CIF), o tomador é o vendedor e o destinatário é o comprador. Filtrar pelo campo errado é a causa mais comum de "meu CT-e não aparece". Se não achar por um, tente pelo outro. Filtro no cabeçalho para: ID, Chave de acesso, Nota, Natureza da operação, Emitente, Destinatário e Tomador. Filtros próprios do CT-e Situação: Cancelado · Não cancelado · Contingência · Uso denegado · Sem protocolo · Sem assinatura. Eventos: | Evento | Significa | |---|---| | Cancelamento | O conhecimento foi cancelado. | | Cancelamento do Comprovante de Entrega do CT-e | Foi cancelado o comprovante de entrega. | 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. O monitor de CT-e O CT-e tem monitor próprio, ligado empresa a empresa em Administração › Empresas → aba Monitor, no par Ativo/Inativo + Ciclo do CT-e/AN. Ligar o monitor de NF-e não liga o de CT-e. São independentes — é comum a empresa receber notas normalmente e estranhar que os fretes não aparecem.
A tela de CT-e OS: colunas, filtros e acoes (GaxWeb 5.0)
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.
A tela de Exportacao: pedidos, status e download (GaxWeb 5.0)
A tela de Exportação: pedidos, status e download Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Documentos › Exportação é diferente das outras telas deste menu: ela não lista notas, e sim os pedidos de exportação que você fez — cada linha é um pedido, com o que ele trouxe e onde está o arquivo. É aqui que se exporta um período inteiro e se baixa o resultado depois. Como funciona: exportação entra em fila Exportar por período não é instantâneo. O pedido entra numa fila, é processado, e só então o arquivo fica disponível. É por isso que esta tela existe: para você acompanhar e voltar depois. Fazer um pedido: botão Exportar, no topo. Escolha o modelo de documento, o período e as opções. ⚠️ As opções de Situação vêm desmarcadas. Se você não marcar ao menos uma (Autorizados, Cancelados, Denegados), o pedido costuma voltar vazio — status Finalizado Alerta, 0 registros, arquivo de 0 byte. É a causa nº 1 de "exportei e não veio nada". As colunas | Coluna | O que mostra | |---|---| | Status | Como terminou o pedido. | | ID | Número do pedido. Cite-o no suporte. | | Modelo | Que tipo de documento foi exportado. | | Descrição | O que você pediu. | | Empresa | De qual empresa. | | Registros | Quantos documentos o filtro encontrou. | | Processados | Quantos foram efetivamente processados. | | Arquivo | O arquivo gerado e seu tamanho. | | Etapa | Em que ponto do processamento está. | | Data inicial / Data final | O período que você pediu. | | Criação | Quando o pedido foi feito. | | Finalização | Quando terminou. | | Usuário | Quem pediu. | | Info | 🔎 A mensagem do sistema sobre o pedido — é aqui que aparece o motivo de um resultado vazio ou de um erro. | | Perfil | Perfil dono do pedido. | 📊 Registros x Processados. Se Registros veio 0, o filtro não achou nada — reveja período e situação. Se Registros tem número mas Processados está bem abaixo, o pedido ainda está rodando ou parou no meio: leia a coluna Info. Filtro no cabeçalho para: ID, Descrição, Usuário e Info. ⚠️ Esta tela não tem caixinhas de seleção. Não há ação em lote: cada pedido é tratado individualmente, pelo botão direito. O botão direito é essencial aqui Todas as ações úteis desta tela estão só no botão direito sobre o pedido: | Ação | O que faz | |---|---| | Efetuar download | Baixa o arquivo gerado. | | Gerar link público | Cria um link para enviar o arquivo a alguém de fora — o contador, por exemplo. | | Replicar exportação | Refaz o mesmo pedido, com os mesmos filtros. | 🔁 "O arquivo antigo não baixa mais". O histórico do pedido fica, mas o arquivo tem prazo e é removido. Use Replicar exportação para gerar de novo, sem redigitar os filtros. 🔗 Precisa mandar para o contador? Use Gerar link público em vez de anexar em e-mail. O link é controlado e pode ser revogado — veja Public Links. Os filtros desta tela | Campo | Opções | |---|---| | Modelo | NFe 55 · CTe 57 · Sat 59 · CFe 65 · CTeOS 67 · NFSe nacional · Chave/ID | | Status | Situação · Informação · Alerta · Erro · Throwable | | Versão | v2 · v1 (legado) | | Perfil, Empresa | Restringem o resultado. | | Criação entre | Período em que o pedido foi feito. | 🔑 Modelo "Chave/ID" é como se exporta uma nota específica de que você tem a chave de acesso — útil quando o contador pede um XML avulso. ⚠️ Status "Erro" ou "Throwable" significa que o pedido falhou de fato. Leia a coluna Info e, se não estiver claro, abra chamado citando o ID do pedido. Os ícones do topo | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa a lista de pedidos em Excel — não os documentos. | | 🔄 Recarregar toda a tabela | Atualiza a lista. Útil para ver um pedido sair da fila. | | ☷ Exibir/Ocultar colunas | Escolhe as colunas visíveis. | | ☰ Mais filtros | Abre o painel da direita. | O seletor Reload (15s, 30s, 60s) é especialmente útil aqui: deixe a tela atualizando sozinha enquanto o pedido é processado. Qual caminho usar para baixar XML | Você quer | Caminho | Resultado | |---|---|---| | Uma nota | Na lista do documento: botão direito → Exportar XML | Arquivo avulso, na hora | | Uma nota, tendo só a chave | Aqui: Exportar → modelo Chave/ID | Entra na fila | | Várias notas escolhidas | Na lista: marcar → menu Documento → Exportação | Compactado | | Um período inteiro | Aqui: Exportar | Entra na fila, compactado |
A tela de NFC-e: colunas, filtros e acoes (GaxWeb 5.0)
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.
A tela de NF-e: colunas, filtros e acoes (GaxWeb 5.0)
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. |
A tela de NFS-e: colunas, filtros e acoes (GaxWeb 5.0)
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 | Coluna | O que mostra | |---|---| | Status | Situação do documento no GaxWeb. | | Eventos | Eventos registrados para a nota. | | ID | Número interno do GaxWeb. | | cStat | Código de status. Só NF-e e NFS-e têm. | | Chave de acesso | A chave da nota. | | Número | Número da nota de serviço. | | Emitente | O prestador do serviço. | | Tomador | 👤 Quem contratou o serviço — o equivalente ao destinatário. | | Valor | Valor do serviço. | | 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, 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: | Evento | Significa | |---|---| | Cancelamento | A nota foi cancelada. | | Solicitação de Cancelamento | Foi pedido o cancelamento, ainda não efetivado. | | Substituição | A nota foi substituída por outra. | | Confirmação do Tomador | O tomador confirmou o serviço. | 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". | Í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. 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.
A tela de SAT (CF-e): colunas, filtros e acoes (GaxWeb 5.0)
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 | Coluna | O que mostra | |---|---| | Status | Situação do documento no GaxWeb. | | ID | Número interno do GaxWeb. | | Chave de acesso | Os 44 dígitos do cupom. | | Chave vinculada | 🔑 Exclusivo do SAT — a chave do documento relacionado. É o que liga um cupom de cancelamento ao cupom original. | | Nota | Número do documento. | | Emitente | Quem emitiu. | | Destinatário | Para quem foi emitido. | | Valor | Valor total. | | 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. | ⚠️ 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". | Í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. 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: | Origem | Significa | |---|---| | sat_sp / ws_sat_sp | Veio do ambiente estadual de São Paulo. | | gaxup | Subiu pelo GaxUp, a partir do computador onde ficam os arquivos. | | agent | Veio pelo gaxweb-agent instalado no terminal. | | manual | Alguém subiu o arquivo. | 🏪 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.
Documentos fiscais: por onde comecar (GaxWeb 5.0)
Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 O menu Documentos é onde ficam as notas que o GaxWeb capturou para as suas empresas. Cada tipo de documento tem a sua própria tela — e cada uma tem um manual completo, com todas as colunas, filtros e ações. Esta página é o mapa: use-a para saber em qual tela procurar e ir direto ao manual dela. Qual tela usar | Se você procura | Modelo | Vá em | Manual completo | |---|---|---|---| | Nota fiscal de mercadoria | 55 | Documentos › NF-e | A tela de NF-e | | Nota do varejo, ao consumidor | 65 | Documentos › NFC-e | A tela de NFC-e | | Cupom fiscal do equipamento SAT (SP) | 59 | Documentos › Sat | A tela de SAT | | Nota de serviço | — | Documentos › NFS-e | A tela de NFS-e | | Conhecimento de transporte (frete de carga) | 57 | Documentos › CT-e | A tela de CT-e | | Transporte de pessoas, bagagem ou valores | 67 | Documentos › CT-e OS | A tela de CT-e OS | | Seus pedidos de exportação e os arquivos gerados | — | Documentos › Exportação | A tela de Exportação | As listas são separadas. Um documento aparece em uma tela só. Se não achou onde esperava, confira na tabela acima se é mesmo aquele modelo — CT-e e CT-e OS são a confusão mais comum. O que muda de uma tela para outra As telas são parecidas de propósito: quem aprende uma sabe usar todas. As diferenças que realmente importam no dia a dia: - NF-e é a mais completa e a única com Manifestação do destinatário e com Etiquetas nas notas. Também é a única com o filtro "Sem XML", que mostra as notas em que falta o arquivo. - NFS-e e CT-e OS falam em Tomador — quem contratou — no lugar de destinatário. O CT-e tem os dois, porque quem recebe a carga nem sempre é quem paga o frete. - SAT é a única sem coluna de eventos: um cancelamento aparece como outro cupom, ligado ao original pela Chave vinculada. - Exportação não lista notas, e sim pedidos — e não tem seleção múltipla. Cada uma dessas diferenças está detalhada no manual da tela. As três perguntas mais frequentes "Sumiu da lista." O painel Outros filtros, à direita, costuma estar com algo marcado. Limpe pelo X de cada campo. Detalhe em qualquer um dos manuais de tela, na seção Quando a lista volta vazia. "Não tem botão de download do XML." Tem: botão direito sobre a nota → Exportar XML, e sai o arquivo avulso, sem zip. O zip vem da exportação em lote. "Falta informação na tela." As colunas passam da largura da tela — role para o lado. Valor, Emissão, Criação, Origem, Empresa e Perfil ficam à direita. Para ir além - Exportar em lote ou por período → A tela de Exportação - As notas não estão chegando → Monitores: busca automática de documentos na Sefaz - Quem pode ver e fazer o quê → Grupos de Permissões: os três estados - Está vindo da versão 4.6? → O que mudou da versão 4.6 para a 5.0
O monitor de NF-e: acompanhar e diagnosticar (GaxWeb 5.0)
O monitor de NF-e: acompanhar e diagnosticar Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Monitores › NFe/AN é onde se acompanha a busca automática de notas fiscais no Ambiente Nacional — e onde se descobre por que uma empresa parou de receber. É o monitor mais completo: tem quatro telas, duas a mais que os outros. As quatro telas | Tela | Para que serve | |---|---| | Empresas | Quais empresas estão sendo monitoradas e o estado de cada uma. | | DFe | Cada documento que o monitor trouxe, com seu NSU. | | Tentativas | 🔧 O histórico das consultas à Sefaz, com o código de retorno de cada uma. | | Ciência | A ciência automática da operação. | Como ler a tela de Empresas do monitor É a tela de diagnóstico do "não está chegando nota". Cada linha é uma empresa monitorada, e quatro colunas contam a história toda: | Coluna | O que olhar | |---|---| | Certificado digital | Sem certificado válido não há consulta. | | Última consulta | 🕐 Se está vazia ou antiga, as consultas pararam. | | Informações | 💬 A mensagem do sistema sobre a última consulta. É o diagnóstico mais direto que existe. | | Status | O estado atual do monitoramento. | 🎯 Comece pela coluna Informações. Ela diz, em texto, por que a última consulta não trouxe nada — certificado vencido, consumo indevido, sem movimento. Veja O que significa cada status e mensagem do GaxWeb. ⚠️ A empresa não aparece nesta lista? Então ela não está sendo monitorada. Vá em Administração › Empresas → aba Monitor e ponha o monitor daquele tipo em Ativo — lembrando que definir só o Ciclo não liga nada. As telas de cada monitor | Tela | Para que serve | |---|---| | Empresas | Quais empresas estão sendo monitoradas e o estado de cada uma. | | DFe | Os documentos que o monitor trouxe, um a um, com o NSU de cada. | Filtrar e navegar Vale aqui tudo o que vale nas outras listas: filtro no cabeçalho de algumas colunas, painel "Outros filtros" pelo ícone ☰, rolagem horizontal (as colunas passam da largura da tela) e paginação no rodapé, com o seletor Registros no topo. Os ícones do canto superior direito são os mesmos: Exportar resultado para Excel, Recarregar toda a tabela, Exibir/Ocultar colunas, Vacuum e Mais filtros — além do Reiniciar storage local, que devolve o padrão se a tela ficar torta. 🔍 O filtro Informações, no cabeçalho da coluna, é o mais útil: dá para procurar todas as empresas com a mesma mensagem de erro de uma vez. O NSU: o marcador da Sefaz A Sefaz numera sequencialmente tudo o que disponibiliza para o seu CNPJ. Esse número é o NSU, e é assim que o GaxWeb sabe de onde continuar. | Coluna | O que significa | |---|---| | NSU atual | Até onde o GaxWeb já leu. | | Último NSU | O último que a Sefaz tem disponível. | 📊 NSU atual muito abaixo do Último NSU significa que a busca está em curso, porém atrasada — não é erro. Costuma se resolver sozinha, já que a Sefaz aceita uma consulta por hora. Se a diferença não diminui ao longo do dia, aí vale investigar. A tela Tentativas É o diagnóstico fino, e só a NF-e tem. Cada linha é uma consulta à Sefaz: | Coluna | O que mostra | |---|---| | cStat | 🔑 O código de retorno da Sefaz naquela consulta. | | NSU / Ult. NSU / Max NSU | Onde a consulta começou, terminou e o teto disponível. | | Qtd | Quantos documentos vieram. | | Informações | A mensagem daquela tentativa. | 🎯 Quando o cliente diz "não chega nota e ninguém sabe por quê", esta tela responde. O erro repetido no cStat e na coluna Informações aponta a causa real — e é o que o suporte precisa para agir. A tela Ciência Mostra as notas em que a ciência da operação foi registrada automaticamente. A ciência é ligada empresa a empresa, em Administração › Empresas → aba Monitor, no campo NF-e ciência (Ativo/Inativo). ⚖️ Ciência é declaração enviada à Sefaz, com efeito fiscal — não é um marcador interno. O acesso a ela é controlado em Segurança › Grupos de Permissões. Roteiro: "esta empresa parou de receber" 1. A empresa aparece em Empresas? Se não, o monitor não está Ativo. 2. Tem certificado, válido e vinculado? 3. A Última consulta é recente? A coluna Informações diz o motivo. 4. NSU atual muito atrás do Último NSU? Atrasado, mas rodando. 5. Em Tentativas, qual o cStat que se repete? 6. Parou do nada, sem erro? A Fazenda desativa a distribuição após 60 dias sem monitorar.
Os monitores de CT-e, NFS-e e NFC-e/SP (GaxWeb 5.0)
Os monitores de CT-e, NFS-e e NFC-e/SP Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Além da NF-e, o GaxWeb monitora CT-e, NFS-e e NFC-e de São Paulo. Cada um tem seu próprio par de telas em Monitores, e cada um se liga separadamente. ⚠️ Ligar o monitor de NF-e não liga os outros. São independentes — é comum a empresa receber notas normalmente e estranhar que os fretes ou as notas de serviço não aparecem. Cada tipo tem seu par Ativo/Inativo + Ciclo em Administração › Empresas → aba Monitor. O que cada um tem | Monitor | Telas | Usa NSU? | |---|---|---| | CTe/AN | Empresas · DFe | Sim | | NFSe/AN | Empresas · DFe | Sim | | NFCe/SP | Empresas · DFe | ❌ Não | Como ler a tela de Empresas do monitor É a tela de diagnóstico do "não está chegando nota". Cada linha é uma empresa monitorada, e quatro colunas contam a história toda: | Coluna | O que olhar | |---|---| | Certificado digital | Sem certificado válido não há consulta. | | Última consulta | 🕐 Se está vazia ou antiga, as consultas pararam. | | Informações | 💬 A mensagem do sistema sobre a última consulta. É o diagnóstico mais direto que existe. | | Status | O estado atual do monitoramento. | 🎯 Comece pela coluna Informações. Ela diz, em texto, por que a última consulta não trouxe nada — certificado vencido, consumo indevido, sem movimento. Veja O que significa cada status e mensagem do GaxWeb. ⚠️ A empresa não aparece nesta lista? Então ela não está sendo monitorada. Vá em Administração › Empresas → aba Monitor e ponha o monitor daquele tipo em Ativo — lembrando que definir só o Ciclo não liga nada. As telas de cada monitor | Tela | Para que serve | |---|---| | Empresas | Quais empresas estão sendo monitoradas e o estado de cada uma. | | DFe | Os documentos que o monitor trouxe, um a um, com o NSU de cada. | Filtrar e navegar Vale aqui tudo o que vale nas outras listas: filtro no cabeçalho de algumas colunas, painel "Outros filtros" pelo ícone ☰, rolagem horizontal (as colunas passam da largura da tela) e paginação no rodapé, com o seletor Registros no topo. Os ícones do canto superior direito são os mesmos: Exportar resultado para Excel, Recarregar toda a tabela, Exibir/Ocultar colunas, Vacuum e Mais filtros — além do Reiniciar storage local, que devolve o padrão se a tela ficar torta. 🔍 O filtro Informações, no cabeçalho da coluna, é o mais útil: dá para procurar todas as empresas com a mesma mensagem de erro de uma vez. Por que a NFC-e/SP é diferente Repare que a tela de Empresas do NFC-e/SP não tem as colunas NSU atual e Último NSU. Não é falta: o NSU é o marcador do Ambiente Nacional, e a NFC-e de São Paulo vem do ambiente estadual paulista, que funciona de outro jeito. Por isso o NFC-e/SP tem duas regras próprias: - Certificado do próprio CNPJ. Matriz não consulta filial e filial não consulta matriz — cada uma precisa do seu. - Além do Ciclo, o cadastro tem um campo Período só para este monitor. 🏪 Se você tem PDV em São Paulo e as vendas não estão aparecendo, comece conferindo de quem é o certificado vinculado àquela empresa. O monitor de NFS-e e a questão do município A NFS-e é a captura mais irregular, e a razão está fora do GaxWeb: cada prefeitura decide como disponibiliza. Municípios no padrão nacional sincronizam no repositório (ADN) e são capturados normalmente; os que operam só com emissor próprio dependem do que a prefeitura libera. ❓ Antes de concluir que "o GaxWeb não pega a minha NFS-e", confirme com o suporte se o seu município está homologado. Não dá para deduzir isso da tela. Roteiro quando um tipo não chega 1. O monitor daquele tipo está Ativo no cadastro da empresa? (Não basta o de NF-e.) 2. A empresa aparece na tela Empresas daquele monitor? 3. O que diz a coluna Informações? 4. É NFC-e/SP? Confira se o certificado é do próprio CNPJ. 5. É NFS-e? Confirme a cobertura do município.
De quando o GaxWeb começa a baixar as notas (regras da SEFAZ / Distribuição de DF-e)
Uma dúvida muito comum: "cadastrei minha empresa hoje — o GaxWeb baixa as notas do mês inteiro, inclusive as de antes do cadastro?". A resposta honesta é: depende de a empresa já vir sendo monitorada na SEFAZ ou não — e, em qualquer caso, o retroativo não é garantido. O que se garante é a captura da data de ativação para frente. Este artigo explica o porquê. Resumo rápido - O que sempre é garantido: a captura da data de ativação (início do monitoramento no GaxWeb) para frente. - O retroativo (notas anteriores) depende da situação do CNPJ na SEFAZ — e mesmo quando as regras permitiriam, a SEFAZ nem sempre libera (mais sobre isso abaixo). - Notas que não vierem pela captura automática entram pelo GaxUp (importando os XMLs) ou por chave de acesso (dentro dos 90 dias). Como o GaxWeb captura as notas (Distribuição de DF-e) O GaxWeb usa o serviço oficial da SEFAZ, a Distribuição de DF-e (NFeDistribuiçãoDFe). Ele funciona como uma esteira sequencial por CNPJ: cada documento recebe um número (o NSU) e o GaxWeb avança a partir do último NSU lido. Ponto importante: o NSU é do CNPJ, não do sistema — ou seja, o histórico de numeração pertence à empresa, independentemente de qual software fez as consultas. As duas situações (é aqui que muda tudo) Situação 1 — a empresa JÁ vinha sendo monitorada na SEFAZ (por outro sistema) nos últimos 90 dias. Nesse caso o CNPJ já tem numeração (NSU) ativa e um histórico recente na SEFAZ. Ao cadastrar no GaxWeb, ele varre os últimos 90 dias e traz as notas que ainda estiverem disponíveis na SEFAZ — ou seja, é possível recuperar o período recente (retroativo até 90 dias). Situação 2 — empresa nova / CNPJ que NUNCA fez consulta à SEFAZ. Aqui a numeração (NSU) só começa a ser gerada na primeira sincronização. A SEFAZ passa a "numerar" os documentos daquele CNPJ a partir daquele momento — então o GaxWeb captura da ativação para frente, e as notas emitidas antes disso não entram pela captura automática (não receberam NSU retroativo). Exemplo: CNPJ que nunca consultou, ativado no GaxWeb em 16/06 → as notas de 01–15/06 não vêm automático. Importante: o retroativo NÃO é garantido As regras acima estão nas Notas Técnicas da SEFAZ, mas na prática já vimos a SEFAZ se comportar fora do previsto (liberar menos do que deveria, ou variar de um CNPJ para outro). Portanto: - Não prometemos que todas as notas retroativas serão baixadas — nem na Situação 1. - Garantimos a captura da data de ativação (início do monitoramento) para frente. - O retroativo, quando vem, é um ganho; quando não vem, o caminho é o GaxUp. A janela de 90 dias da SEFAZ Independentemente da situação, a SEFAZ mantém cada documento disponível por no máximo 90 dias após a recepção no Ambiente Nacional. Passado esse prazo, a nota não é mais recuperável pela SEFAZ — nem pela Distribuição de DF-e, nem por chave de acesso. Como trazer as notas que não vieram (antigas ou retroativas) 1. GaxUp — se você (ou o cliente) tem os arquivos XML, o GaxUp lê os XMLs guardados localmente (uma pasta da máquina/servidor) ou por integração banco-a-banco com o seu sistema e envia tudo ao GaxWeb. Depois você lista, exporta e gera o PDF (DANFE) normalmente. É a forma mais confiável de garantir o retroativo. 2. Consulta por chave de acesso — se você tem a chave e a nota está dentro dos 90 dias. Notas sem XML e já fora dos 90 dias não são recuperáveis em nenhum sistema, porque a própria SEFAZ não as disponibiliza mais. Ciência da operação (para NF-e recebidas / de entrada) Nas notas em que a empresa é destinatária, a SEFAZ entrega primeiro o resumo da NF-e. Para liberar o XML completo, o comportamento varia: em alguns casos a SEFAZ já libera direto (sem precisar manifestar); em outros, exige apenas a Ciência da Operação — o evento mais simples de manifestação (um "estou ciente", sem efeito fiscal de aceite). O GaxWeb registra essa Ciência quando ela é necessária para o download. ⛔ Nunca é preciso a Confirmação da Operação (o que popularmente se chama de "manifestação do destinatário") para baixar a nota — quando exigida, a Ciência já basta. O que é capturado em âmbito nacional e o que não é - NF-e (modelo 55) e CT-e: capturados em âmbito nacional pela Distribuição de DF-e (qualquer estado), respeitando as regras acima. - NFC-e (modelo 65): não vem pela Distribuição de DF-e nacional. Captura automática direto da SEFAZ hoje é só São Paulo (monitor "NFC-e/SP"). Nos demais estados, via GaxUp. - NFS-e (serviços): é municipal — depende de cada prefeitura. Confirme na prática, no teste. Perguntas frequentes Cadastrei hoje. O GaxWeb pega o mês inteiro? Depende: se sua empresa já vinha sendo monitorada na SEFAZ (por outro sistema) nos últimos 90 dias, o GaxWeb varre e traz o que a SEFAZ ainda tiver. Se o CNPJ nunca tinha sido consultado, ele pega da ativação para frente. Em nenhum dos casos o retroativo é garantido — o garantido é da ativação para frente. Por que "faltaram" notas do começo do mês? Ou o CNPJ nunca tinha sido consultado (então só pega da ativação para frente), ou a SEFAZ não liberou aquele período. O caminho para trazê-las é o GaxUp, com os XMLs. Como garanto o retroativo? Com o GaxUp, importando os XMLs. É o único jeito de não depender do que a SEFAZ resolve liberar. Vale igual para NF-e e NFC-e? Não. NF-e e CT-e são nacionais. NFC-e direto da SEFAZ é só SP; nos demais estados, via GaxUp.