Manuais

O que é o GaxUp, para que serve e como faço para usá-lo?

O GaxUp é um aplicativo criado com o objetivo de "varrer" as pastas e subpastas em máquinas locais, indicadas nos parâmetros, localizando documentos habilitados e enviá-los para armazenamento no GaxWeb. Ele busca NFe, CTe, CTeOS, CFe, SAT-CFe entre outros documentos disponíveis na guia Monitoramento na configuração do terminal. Como faço para usá-lo? Criando o terminal GaxUp no GaxWeb O terminal GaxUp deve ser criado no GaxWeb e instalado na máquina que armazena os XMLs (ou que tenha acesso, pela rede, à pasta que os armazena). A indicação é instalar na própria máquina onde estão os XMLs, pois agiliza o processo e não fica dependente da rede da máquina host. 1. Acesse Aplicações → GaxUp e clique em Cadastrar Terminal. 2. Preencha o campo Nome de forma a identificar qual empresa (ou grupo) será monitorado. 3. Ative a flag Iniciar com o Windows e também iniciar minimizado. 4. Clique em Cadastrar Terminal. Aparecerá a mensagem Terminal incluído com sucesso. Clique em OK — o GaxWeb voltará para a guia Geral. Guia Monitoramento Habilite a flag dos documentos que deseja monitorar e enviar ao GaxWeb e clique em Atualizar Terminal. Observação importante: dentro de cada tipo de documento podem existir duas flags adicionais: - Monitorar documentos apenas que tenham Protocolo de Autorização — verifica se o XML possui protocolo válido; se sim, envia ao GaxWeb. - Monitorar documentos apenas que tenham Assinatura Digital — verifica se o XML possui assinatura digital válida; se sim, envia ao GaxWeb. Atenção: somente XMLs que possuem protocolo e assinatura são válidos — juridicamente — perante uma eventual apresentação à fiscalização. A responsabilidade pela guarda de documentos sem protocolo e/ou assinatura é única e exclusiva do administrador de perfil que ativar (ou não) esta verificação. Guia Diretórios Caso saiba o caminho da pasta (na máquina onde o terminal será instalado) que deseja monitorar por XMLs novos ou alterados, insira-o na caixa Diretórios. Caso não saiba, sem problema — você poderá preencher esta configuração ao instalar o GaxUp no terminal da empresa. Se preencher o caminho, não esqueça de clicar em Atualizar Terminal para salvar. Guia Proxy Caso a rede onde o terminal GaxUp será instalado possua configuração de proxy, ative a flag Utilizar proxy para conexão e preencha os campos versão HTTP, servidor, usuário e senha. Clique em Atualizar Terminal. Caso não haja proxy, não precisa ativar a flag. Terminado de criar e configurar, feche a tela de Edição de Terminal (Cancelar ou no x). Você será levado ao datagrid que mostra o(s) terminal(is) criado(s). Instalando o terminal GaxUp na máquina local Selecione o terminal criado (clique uma vez) e clique no botão BAIXAR INSTALADOR. Será gerado o instalador gaxup_install.exe na sua pasta de downloads. Copie este .exe para a máquina onde o GaxUp será instalado. Observação importante — antes de instalar: 1. O computador possui antivírus ou firewall ativo? Se sim, ao instalar o GaxUp ele pode alertar sobre um arquivo potencialmente perigoso. Isso é normal por se tratar de um .exe desconhecido pelo antivírus. Caso apareça mensagem de bloqueio, clique em ACEITAR e/ou INCLUIR o arquivo gaxup.exe na lista de arquivos autorizados. 2. Em alguns casos o firewall do Windows bloqueia a execução — clique em aceitar a execução do instalador. 3. Verifique com antecedência se há proxy ativo na rede. Anote endereço do servidor, usuário e senha — serão necessários para o GaxUp se comunicar com o GaxWeb. Clique duas vezes no gaxup_install.exe para abrir o instalador. Caso ainda não tenha configurado a pasta a monitorar, clique em Configurações → guia Diretórios. Há duas formas de inserir o diretório: escolhendo a pasta pelo Windows Explorer ou digitando o caminho diretamente. Clique em Salvar. Caso a rede tenha proxy, clique na guia Proxy e selecione Utilizar proxy para conexão. Para usar as mesmas configurações do sistema, selecione Utilizar configurações do sistema; para digitar manualmente, preencha servidor (IP), porta, usuário e senha. Clique em Salvar. Se tudo estiver correto, o GaxUp comunicará com o GaxWeb informando o status TERMINAL ATIVO. Agora basta aguardar a varredura da pasta selecionada. Para acompanhar o andamento: acesse GaxWeb → Aplicações → GaxUp, selecione o terminal com um clique e clique em Atividade e/ou Documentos — ali você acompanha a atividade e os arquivos que o GaxUp localizou e enviou ao GaxWeb. Qualquer dúvida ou problema na instalação ou consulta, estamos à disposição pelo Enviar Ticket ou pelo chat.

Para que serve cada flag da configuração da empresa?

Primeiro, o que é uma flag? Uma flag é a chave de opção onde você seleciona SIM ou NÃO. Agora que você já sabe o que é, veja para que serve cada flag da configuração da empresa cadastrada no GaxWeb. Seção NFe Monitorar NFe (Ambiente Nacional) emitida contra o CNPJ da empresa — necessário certificado digital válido. Quando habilitada, permite ao GaxWeb monitorar e baixar as notas fiscais eletrônicas modelo 55. Observação: logo após habilitar, o GaxWeb coloca a empresa numa fila de download, podendo levar entre 5 e 60 minutos até a nota ficar disponível. Isso se deve à nota técnica da SEFAZ, que solicita consultas apenas de hora em hora — do contrário, pode ocorrer bloqueio das portas de consulta. Observação 2: atualmente o GaxWeb inicia o monitoramento 179 dias antes da data do cadastro da empresa, baixando todas as notas disponíveis no SEFAZ Nacional. Normalmente ocorre o download dos últimos 30 dias, dependendo do volume (entrada + saída). Força uma segunda coleta de NSUs nas últimas 6 horas — Intervalo de reanálise em horas. Quando habilitada, permite ao GaxWeb forçar uma segunda coleta de chaves e download de XMLs das últimas 6 horas. O intervalo ajusta a repetição conforme a demanda da SEFAZ, sem bloqueio dos serviços. Observação: criada devido a falhas nos servidores da SEFAZ que, às vezes, não entregam a lista completa de chaves na primeira coleta, causando falhas no sequenciamento do download. Ciência da Operação — Enviar automaticamente assim que o sistema verificar uma nova nota. Muito importante: dependendo da escolha, pode ou não permitir o download de todas as notas emitidas contra a sua empresa. Em alguns casos a SEFAZ não envia todas as notas na primeira coleta, deixando chaves com status AGUARDANDO; numa segunda coleta o download só é permitido mediante o envio da Ciência da Operação. Atenção: Ciência da Operação é diferente da Confirmação da Operação (Manifestação do Destinatário). A ciência é um evento usado ao consultar a nota nos servidores da SEFAZ e não registra nada além disso nos eventos da nota. Porém, em alguns estados (ex.: Rio de Janeiro), após a ciência da operação, passados 30 dias sem manifestação de desconhecimento/cancelamento, a nota pode ser reconhecida como confirmada — podendo ser cobrada como confirmada no SPED do período. Escolha com calma e em comum acordo com seu contador. Para baixar os XMLs sem a ciência da operação, criamos o RecuperarXML — serviço integrado ao GaxWeb que baixa notas e conhecimentos de transporte diretamente do portal da NF-e, mediante chave e certificado válido. Pode ser habilitado mediante configuração do suporte e compra de créditos. Seção CTe Monitorar CTe (Ambiente Nacional) emitido contra o CNPJ da empresa — necessário certificado digital válido. Quando habilitada, permite ao GaxWeb monitorar e baixar os documentos. Observação: o GaxWeb inicia o monitoramento 179 dias antes da data do cadastro, baixando o que estiver disponível no SEFAZ Nacional. Força uma segunda coleta de NSUs nas últimas 6 horas — Intervalo de reanálise em horas. Mesma lógica da seção NFe. Seção MDFe Monitorar MDFe (Ambiente Nacional) emitido contra o CNPJ da empresa — necessário certificado digital válido. O MDF-e (Manifesto Eletrônico de Documentos Fiscais) substitui o documento em papel, com validade jurídica pela assinatura digital do emitente. Deve ser emitido por transportadoras em prestações com mais de um CT-e, ou pelas demais empresas quando o transporte — em veículo próprio, arrendado ou de autônomo — envolver mais de uma nota fiscal. Ao habilitar a flag, o GaxWeb passa a monitorar e baixar os MDF-e disponíveis no SEFAZ (Ambiente Nacional). Seção SAT-CFe Monitorar SAT/SP (Ambiente Estadual) emitidos pelo CNPJ da empresa — necessário certificado digital. (Exclusiva para contribuintes de São Paulo.) Quando ativada, inicia o monitoramento e download automático dos XMLs de todos os SATs emitidos pela empresa nos últimos 7 dias a partir do cadastro. Possibilita a emissão dos relatórios de Apoio à Escrituração (parecido com o do portal do SAT, porém mais fácil) e do Relatório Sequência SAT/SP, que ajuda a visualizar eventuais falhas de sequenciamento de cupons (comum quando os XMLs de SAT são buscados diretamente na base do cliente via GaxUp). Quer saber mais sobre o GaxUp? Acesse o artigo relacionado.

Gestão de Grupos de Permissões no GaxWeb

O GaxWeb acaba de lançar uma das funcionalidades mais aguardadas por gestores e administradores de sistemas: a Gestão de Grupos de Permissões. Com essa novidade, as organizações que utilizam o plano Corporativo ganham um nível inédito de controle sobre o que cada usuário pode acessar e fazer dentro da plataforma. Uma funcionalidade foi desenvolvida para atender empresas com estruturas complexas, múltiplas filiais ou diferentes níveis hierárquicos, onde a segmentação de acesso é essencial para garantir a segurança das informações e a eficiência operacional. O que são grupos de permissões? Grupos de Permissões são conjuntos configuráveis ​​de regras de acesso que podem ser atribuídos a um ou mais usuários do sistema. Em vez de definir permissões individualmente para cada colaborador — um processo de trabalho e sujeito a erros —, o administrador cria um grupo com as configurações desejadas e simplesmente associa os usuários a ele. Essa abordagem, amplamente utilizada em sistemas corporativos robustos, chega ao GaxWeb com uma implementação moderna e intuitiva, adaptada à realidade das empresas brasileiras. Principais Funcionalidades Uma nova funcionalidade oferece um conjunto completo de recursos para a gestão granular de acessos: • Criação de grupos personalizados: defina grupos com nomes descritivos e associe funcionalidades específicas da plataforma a cada um deles. • Definição granular de funcionalidades: escolha exatamente quais módulos, menus e ações estarão disponíveis para cada grupo, garantindo que cada perfil de usuário acesse apenas o necessário. • Acesso restrito por empresa: configure quais empresas (CNPJs ou filiais) cada grupo pode visualizar e operar, ideal para grupos empresariais, franquias e holdings. • Gerenciamento centralizado: qualquer alteração feita no grupo é aplicada automaticamente a todos os usuários vinculados a ele, sem necessidade de ajustes individuais. • Auditoria e rastreabilidade: todas as configurações e alterações de grupos ficam registradas no histórico do sistema para fins de conformidade e auditorias. Casos de Uso Práticos A Gestão de Grupos de Permissões resolve desafios reais do dia a dia corporativo: Redes de franquias: cada franqueado acessa apenas os dados de sua própria unidade, enquanto uma franqueadora mantém visão global. Grupos empresariais: gestores de cada subsidiária têm acesso somente às informações de sua empresa, sem interferência nas demais. Segregação de funções: as equipes de RH, Financeiro e Operacional possuem perfis distintos, com acesso apenas às funcionalidades relevantes ao seu departamento. Auditores externos: acesso somente leitura a módulos específicos, sem risco de alterações indevidas. Disponível exclusivamente no Plano Corporativo A Gestão de Grupos de Permissões é uma funcionalidade exclusiva do Plano Corporate do GaxWeb. Esse plano foi criado para atender às demandas de empresas de maior porte, com estruturas organizacionais complexas e elevados requisitos de segurança e conformidade. Ao optar pelo plano Corporate, a empresa conta não apenas com a gestão avançada de permissões, mas também com um conjunto completo de recursos premium, suporte prioritário e maior capacidade de personalização da plataforma de acordo com as necessidades do negócio. Se a sua empresa ainda não utiliza o plano Corporate e deseja aproveitar este e outras funcionalidades exclusivas, entre em contato com nosso horário comercial e conheça todas as vantagens disponíveis. Conclusão A chegada da Gestão de Grupos de Permissões ao GaxWeb representa um avanço significativo na atualização da plataforma e no compromisso da empresa com a segurança da informação e a eficiência administrativa de seus clientes. Com essa funcionalidade, os administradores ganham autonomia, liberdade e tranquilidade de saber que cada usuário acessou exatamente o que precisa — nem mais, nem menos. A governança de dados deixa de ser um desafio e passa a ser um diferencial competitivo. GaxWeb — Inovação que simplifica a gestão do seu negócio.

API GaxDfe - Baixar documento único ou em lote do GaxWeb.

O que esta API cobre — e o que não cobre A API GaxDfe baixa os documentos que trafegam pela SEFAZ. O parâmetro modelo aceita: | modelo | Documento | |---|---| | 55 | NF-e — Nota Fiscal Eletrônica | | 57 | CT-e — Conhecimento de Transporte Eletrônico | | 59 | CF-e/SAT — Cupom Fiscal Eletrônico | | 65 | NFC-e — Nota Fiscal de Consumidor Eletrônica | | 67 | CT-e OS — CT-e Outros Serviços | ⛔ A API GaxDfe não baixa NFS-e. A nota de serviço é municipal, não trafega na Distribuição de DF-e da SEFAZ e não está nesta API. Atenção especialmente ao modelo=59: ele é CF-e/SAT, não NFS-e. ✅ Para obter as NFS-e em arquivo, use a tela de Documentos → Exportação do GaxWeb, que gera XML e PDF por período. Endpoint: https://app.nssoft.com.br/webservice/gaxdfe/monitor/zip/ Parâmetros: - modelo — 55, 57, 59, 65 ou 67 (ex: modelo=55) — ver a tabela acima - empresa — CPF/CNPJ da empresa, somente números (ex: empresa=12345678000123) - emissao — data de emissão no formato YYYY-mm-dd (Ano-mês-dia) (ex: emissao=2022-12-30) - eventos — true ou false. Exporta os eventos do documento (somente zip). (ex: eventos=true) - pdf — true ou false. Exporta o PDF do documento (somente zip). (ex: pdf=true) periodo (a partir de): - 48h → últimas 48 horas - 7d → últimos 7 dias - 15d → últimos 15 dias - 0m → mês atual - 1m → mês anterior - 2m → últimos 2 meses - 3m → últimos 3 meses - 4m → últimos 4 meses - 5m → últimos 5 meses - 6m → últimos 6 meses - 1y → ano atual - 2y → últimos 2 anos - 3y → últimos 3 anos - 4y → últimos 4 anos - 5y → últimos 5 anos (ex: periodo=48h) Exemplos É necessário enviar o header appkey: {APPKEY} na requisição. ⚠️ A APPKEY vai sempre no header, nunca dentro da URL. Chave única (ex.: 35250192791243002157550020004685301267323702): curl https://app.nssoft.com.br/webservice/gaxdfe/nfe/{CHAVE}/zip -H "appkey: {APPKEY}" Lote NFe mod 55, últimos 2 meses da empresa (sem eventos): curl "https://app.nssoft.com.br/webservice/gaxdfe/monitor/zip?modelo=55&periodo=2m&empresa=12345678000123" -H "appkey: {APPKEY}" Lote NFe mod 55, últimos 2 meses da empresa (com eventos): curl "https://app.nssoft.com.br/webservice/gaxdfe/monitor/zip?modelo=55&periodo=2m&empresa=12345678000123&eventos=true" -H "appkey: {APPKEY}" Retorno: Em caso de sucesso retorna HTTP 200 e o arquivo anexo. Neste caso, continue enviando requisições até que não encontre mais documentos, quando retornará HTTP 204 (não há mais arquivos a baixar para esta requisição). Como cada requisição retorna no máximo 1000 arquivos por solicitação, repita as requisições até obter HTTP 204. Erros: - Erros de permissão retornam HTTP 403 (Forbidden). - Demais erros retornam HTTP 400 e a mensagem de erro. Importante: A APPKEY está disponível em um terminal criado no menu Aplicações → GaxDFe. Os arquivos baixados são automaticamente registrados na lista de download e não serão baixados novamente em uma nova requisição — portanto, atenção ao baixar para não remover ou perder o arquivo. Caso precise baixar novamente, faça contato com o suporte pelo chat e solicite o desbloqueio dos arquivos já baixados. Em caso de dúvida, fale com o suporte pelo chat.

Monitor NFC-e SP – Importante: Uso do Certificado Digital Correto

Com base em análises recentes do funcionamento do Monitor NFC-e SP, identificamos uma limitação importante que impacta diretamente a consulta de cupons fiscais eletrônicos no estado de São Paulo. Como funciona a API do Monitor NFC-e SP A API utilizada pelo Monitor NFC-e SP possui uma estrutura simples, porém com uma restrição fundamental: ela não permite a escolha do CNPJ que será consultado. O CNPJ retornado na consulta é determinado exclusivamente pelo certificado digital utilizado na requisição. Isso significa que: - Não é possível utilizar o certificado de uma matriz para consultar NFC-e de uma filial ; - Não é possível utilizar o certificado de uma filial para consultar NFC-e da matriz ; - A consulta funciona somente quando o certificado digital pertence ao próprio titular do CNPJ consultado. Identificação no GaxWEB versão 5 Na versão 5 do sistema, o datagrid de empresas já sinaliza essa inconsistência de forma visual: empresas configuradas para consulta de NFC-e SP que estão vinculadas a um certificado de titularidade diferente do seu próprio CNPJ serão exibidas em vermelho , alertando o operador sobre a configuração incorreta. Perspectiva de adequação pelo SEFAZ SP Até o momento, não há indicativo de que o SEFAZ SP realizará qualquer adaptação para aceitar certificados com mesmo prefixo de CNPJ (como no caso de matriz e filiais). Portanto, não recomendamos aguardar essa possível mudança. O que fazer Caso o cliente necessite baixar NFC-e SP, orientamos que: 1. O cliente adquira o certificado digital correspondente ao CNPJ específico de cada empresa; 2. O certificado seja atualizado corretamente no GaxWEB antes de realizar novas consultas. Essa medida garante o pleno funcionamento do monitor e evita falhas na captura dos documentos fiscais. Equipe de Suporte NSSoft/GaxWEB Qualquer dúvida, estamos à disposição pelos nossos canais de atendimento.

API GaxDfe - Integração Etiquetas do GaxWeb.

Esta API permite criar, associar e desassociar etiquetas personalizadas nos documentos armazenados no GaxWeb. Criar etiqueta — POST https://api.nssoft.com.br/api/etiqueta curl -X POST 'https://api.nssoft.com.br/api/etiqueta' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {APIKEY}' \ -d '{ "nome": "TT", "descricao": "Teste via API", "cor": "#134f55", "tipo_id": "1", "info": "info" }' Associar etiqueta ao documento — PUT https://api.nssoft.com.br/api/documentos/{CHAVE}/{ETIQUETA} curl -X PUT 'https://api.nssoft.com.br/api/documentos/{CHAVE}/TT' -H 'Authorization: Bearer {APIKEY}' Desassociar etiqueta — DELETE https://api.nssoft.com.br/api/documentos/{CHAVE}/{ETIQUETA} curl -X DELETE 'https://api.nssoft.com.br/api/documentos/{CHAVE}/TT' -H 'Authorization: Bearer {APIKEY}' Observação: a {APIKEY} está disponível através do suporte; a {CHAVE} está no documento eletrônico; a {ETIQUETA} é a legenda criada em Administração → Etiquetas (padrão até 3 caracteres). Att, Equipe NSSoft

Como baixar notas de saída de empresas emitentes (tag autXML — NF-e e CT-e)

Caso deseje baixar automaticamente as notas emitidas (notas de saída) de qualquer empresa através do seu certificado digital no GaxWeb, basta pedir à empresa emitente que inclua o seu CNPJ/CPF na tag autXML dentro do XML do documento fiscal emitido. A tag autXML informa o CNPJ ou o CPF das pessoas autorizadas a obter o XML no portal nacional: string autXML(string CNPJ, string CPF) Exemplo de XML com CNPJ informado: <autXML> <CNPJ>12345678000191</CNPJ> </autXML> Exemplo de XML com CPF informado: <autXML> <CPF>12345678912</CPF> </autXML> Depois desse ajuste, o GaxWeb passa a baixar automaticamente os documentos desse emitente usando o seu certificado digital. Praticamente todos os ERPs do mercado permitem configurar a tag autXML — basta solicitar esse pequeno ajuste ao emitente. Em quais documentos a autorização funciona A tag existe em mais de um documento, mas o efeito prático depende de haver um serviço nacional de distribuição para aquele modelo. | Documento | Vale a autorização por autXML? | |---|---| | NF-e (modelo 55) | Sim. É o caso mais comum. | | CT-e (57) e CT-e OS (67) | Sim. O CT-e tem serviço de distribuição próprio, e a SEFAZ entrega o documento também a quem está no autXML — com uma ressalva importante, logo abaixo. | | NFC-e (modelo 65) | Não. A NFC-e não é distribuída nacionalmente, então informar o autXML não faz o documento chegar. Captura automática direto da SEFAZ hoje é só São Paulo (monitor "NFC-e/SP"); nos demais estados, o caminho é o GaxUp. | | SAT / CF-e (59) e NFS-e | Não. Não existe essa autorização nesses documentos. | E a NFS-e? Não há equivalente. No padrão nacional da NFS-e, o Ambiente de Dados Nacional (ADN) entrega os documentos apenas a quem figura como prestador, tomador ou intermediário do serviço — não existe a figura do terceiro autorizado. Por sigilo fiscal, a chave de acesso só é devolvida quando o certificado que faz a consulta é de um desses atores. O que existe de parecido é outra coisa: a consulta ao ADN pode ser feita com certificado de CNPJ da mesma raiz do contribuinte consultado. Ou seja, a matriz consegue consultar as NFS-e das filiais — mas isso não abre caminho para contabilidade ou sistema de terceiro. ⚠️ No CT-e, as chaves dos documentos relacionados vêm mascaradas Esta é a diferença mais importante entre a NF-e e o CT-e, e costuma gerar dúvida. Quando quem baixa o CT-e é um terceiro autorizado pelo autXML, a SEFAZ altera o XML antes de entregar: as chaves de acesso das NF-e e dos CT-e relacionados são substituídas pelo literal 99999999999999999999999999999999999999999999 (44 noves). É uma decisão do ENCAT para preservar o sigilo fiscal dos documentos citados dentro do CT-e. O CT-e em si chega completo e válido — o que vem mascarado são as chaves dos documentos relacionados (grupos de documentos originários, documentos anteriores e CT-e referenciado). Para os demais atores do CT-e (emitente, remetente, destinatário, expedidor, recebedor e tomador), o XML é entregue original, sem alteração. Se você precisa do vínculo entre o CT-e e as notas transportadas, a autorização por autXML não resolve: nesse caso o documento precisa chegar por quem é ator dele, ou pelo GaxUp. ⛔ Não informe no autXML quem já está autorizado Quem já é ator do documento (destinatário, tomador, remetente, recebedor, expedidor) já pode baixar o XML — não precisa constar no autXML. E informar mesmo assim atrapalha: - Na NF-e: a SEFAZ rejeita a nota. Informar o CNPJ/CPF do próprio destinatário no autXML gera a Rejeição 324, porque a informação é redundante. - No CT-e: a SEFAZ aceita o documento, mas o mesmo CNPJ passa a ser tratado como autorizado — e pode receber o XML com as chaves mascaradas descritas acima, em vez do original a que teria direito. Ou seja: peça a inclusão no autXML apenas de quem não aparece em nenhum outro papel do documento. Limites e prazos - O leiaute permite até 10 autorizados por documento. Para informar mais de um, o emitente repete o grupo autXML. - A autorização não é retroativa. Ela vale apenas para os documentos emitidos depois do ajuste no ERP do emitente — documentos já emitidos não passam a ficar disponíveis. - A SEFAZ mantém cada documento disponível para download por um período limitado. Passado esse prazo, ele não é mais recuperável — veja De quando o GaxWeb começa a baixar as notas (regras da SEFAZ / Distribuição de DF-e). Do lado do GaxWeb Para que o documento autorizado seja capturado, a empresa precisa estar com: - certificado digital válido e vinculado; e - o monitor do tipo correspondente ativo no cadastro da empresa (o monitor de NF-e não liga o de CT-e — cada tipo é independente). Em caso de dúvida, fale com a gente pelo WhatsApp que ajudamos na configuração.

API GaxDfe - Enviar arquivos para o GaxWeb.

O envio de arquivos via API para o GaxWeb é simples. Acesse o GaxWeb, menu Aplicações → GaxDFE, clique em + e crie um terminal, onde terá acesso à APIKEY. Envie o arquivo via POST para: https://app.nssoft.com.br/webservice/gaxdata/{APIKEY}/dfe/upload Qualquer dúvida sobre este procedimento, entre em contato pelo chat ou envie um bilhete. Att, Suporte NSSoft

Grupos de Empresas: como criar e usar (GaxWeb 5.0)

Grupos de Empresas Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Não disponível em: GaxWeb 4.6 Onde fica: menu Segurança › Grupos de Empresas O que é Um Grupo de Empresas reúne várias empresas sob um mesmo nome, para que o acesso possa ser concedido ao grupo inteiro de uma vez em vez de empresa por empresa. O uso típico é o escritório de contabilidade que atende dezenas de clientes e precisa que cada colaborador enxergue apenas a carteira dele. Em vez de vincular o colaborador a cada empresa, você cria um grupo com a carteira e vincula o usuário ao grupo. Quando uma empresa entra ou sai da carteira, você altera o grupo — e o acesso de todos os usuários daquele grupo acompanha. Antes de começar As empresas que farão parte do grupo já precisam estar cadastradas em Administração › Empresas. A tela de grupo apenas seleciona empresas existentes; ela não cadastra empresa nova. A lista de grupos | Coluna | O que mostra | |---|---| | Situação | Se o grupo está ativo. | | ID | Número interno. | | Nome / Descrição | Identificação do grupo. | | Empresas | 🏢 Quantas empresas o grupo tem. | | Usuários | 👥 Quantos usuários usam este grupo. | | Criação | Quando foi criado. | | Perfil | A qual perfil pertence. | Filtro no cabeçalho para ID, Nome e Descrição. 📊 As duas colunas de contagem contam a história: um grupo com Empresas em zero não libera nada; um grupo com Usuários em zero não está sendo usado por ninguém — e talvez possa ser desativado. Como criar um grupo 1. Abra Segurança › Grupos de Empresas. 2. Clique em Cadastrar. Abre a janela Novo grupo de empresas, com duas abas: Geral e Empresas. 3. Na aba Geral, preencha os campos (detalhe na tabela abaixo). 4. Vá até a aba Empresas e clique em Selecionar. Abre a janela Selecione as empresas: busque por CPF/CNPJ, Razão Social ou município, marque as empresas desejadas e clique em Selecionar para confirmar. 5. De volta ao formulário, confira o contador no rodapé da aba Empresas — ele deve mostrar quantas empresas você trouxe. 6. Clique em Salvar. Atenção — o erro mais comum: um grupo não pode ser salvo sem nenhuma empresa. Se você preencher só a aba Geral e clicar em Salvar, o sistema recusa. A mensagem que reclama da falta de empresas aparece no canto superior direito da tela, enquanto seus olhos estão na aba Geral — por isso muita gente não vê o aviso e acha que o botão Salvar travou. Antes de salvar, confira se a aba Empresas mostra pelo menos 1 item. O que acontece depois de salvar Aparece a mensagem "Atualizado com sucesso" no canto superior direito e a janela continua aberta — só que agora com o título "Editando <nome do grupo> (ID nn)", já com o número do grupo criado. Como a janela não fecha sozinha, é comum achar que não salvou e clicar em Salvar de novo. Não é preciso. Se o título mudou para "Editando..." e apareceu o ID, o grupo já foi criado. Feche a janela e confira na lista. O campo Perfil fica esmaecido depois de salvo — ele não pode ser alterado depois que o grupo existe. Campos da aba Geral | Campo | Obrigatório | O que informar | |---|---|---| | Perfil | Sim (já vem preenchido) | O perfil dono do grupo. Vem preenchido com o seu. Não é editável depois de salvar. | | Nome | Sim | Nome curto do grupo, como ele aparecerá nas listas. Ex.: Carteira Zona Sul. | | Descrição | Não | Texto livre para explicar o critério do grupo. Ex.: Clientes atendidos pela equipe da filial. | | Situação | Sim | Estado do grupo. Veja a tabela de situações abaixo. | | Limite de empresas | Sim | Número inteiro. Teto de empresas que o grupo aceita. Aceita apenas números — não use ponto, vírgula ou texto. | Valores de Situação | Situação | O que significa | |---|---| | 1: Ativo | Grupo em uso normal. É o único que aparece na lista por padrão. | | 2: Inativo | Grupo desativado, guardado para consulta. | | 3: Bloqueado | Grupo impedido de ser usado. | | 4: Suspenso | Uso interrompido temporariamente. | | 5: Excluído | Grupo removido do uso. O registro continua na base — a exclusão é lógica, não apagamento. | | 6: Limitado | Grupo em uso com restrição. | Se um grupo "sumiu", provavelmente é isto. O painel Outros filtros, à direita, já vem com Situação = 1:Ativo preenchido. Qualquer grupo que não esteja Ativo simplesmente não aparece na lista — e a tela não avisa que há um filtro aplicado. Para ver todos, limpe o campo Situação nesse painel, clicando no X ao lado dele. Na prática, o que muda o dia a dia é Ativo × qualquer outra coisa: só os Ativos aparecem e valem. A diferença fina entre Inativo, Bloqueado, Suspenso e Limitado não altera o que você precisa fazer — se quer o grupo funcionando, deixe-o Ativo. Aba Empresas | Elemento | Para que serve | |---|---| | Selecionar | Abre a janela de busca e traz empresas para o grupo. | | Remover | Tira do grupo a empresa marcada. Fica esmaecido enquanto nada está marcado. | | Campo de busca | Localiza por CPF/CNPJ, Razão Social ou município. | | Contador de itens | No rodapé da aba, mostra quantas empresas o grupo tem. Se marcar 0 item(ns), o Salvar vai recusar. | Na janela Selecione as empresas também há filtros por Perfil, Situação, Status e Etiqueta, úteis quando a lista de empresas é grande. Mensagens de erro e o que fazer Estas são as mensagens exatas do sistema: | Mensagem | O que fazer | |---|---| | nome: O campo nome é obrigatório. | Preencha Nome, na aba Geral. | | situacao_id: O campo situacao id selecionado é inválido. | Escolha uma opção em Situação. Deixar em branco não é aceito. | | max_empresas: O campo max empresas deve ser um número inteiro. | Refere-se a Limite de empresas. Informe só números. | | empresas: O campo empresas é obrigatório. | Vá à aba Empresas e adicione ao menos uma. | As mensagens usam o nome interno do campo, e não o rótulo que aparece na tela. A tabela acima faz a tradução: max_empresas é o Limite de empresas e situacao_id é a Situação. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Perguntas frequentes Uma empresa pode estar em mais de um grupo? Sim. Uma empresa já vinculada a um grupo continua aparecendo na busca e pode ser adicionada a outros. (Confirmado em teste: a mesma empresa foi vinculada a dois grupos distintos, e os dois passaram a contá-la.) Salvei e a janela não fechou. Salvei ou não? Salvou. Veja se o título mudou para "Editando <nome> (ID nn)" — o ID só existe depois de gravado. Feche a janela e confirme na lista. O que acontece com os usuários quando removo uma empresa do grupo? A confirmar — não testado. Qual a diferença entre Grupo de Empresas e Grupo de Permissões? O Grupo de Empresas define quais empresas o usuário enxerga. O Grupo de Permissões define o que ele pode fazer. Os dois se combinam no cadastro do usuário, em Administração › Usuários, nos campos Grupo de empresas e Grupo de permissões.

Grupos de Permissoes: os tres estados e o que da para controlar (GaxWeb 5.0)

Grupos de Permissões Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Não disponível em: GaxWeb 4.6 Onde fica: menu Segurança › Grupos de Permissões O que é Um Grupo de Permissões define o que um usuário pode fazer dentro do GaxWeb: se pode apenas consultar documentos, se pode exportar XML, se pode manifestar uma NF-e, se pode cadastrar empresas. Ele é o par do Grupo de Empresas: um diz quais empresas o usuário enxerga, o outro diz o que ele pode fazer nelas. Os dois se combinam no cadastro do usuário, em Administração › Usuários. A lógica é montar o grupo uma vez e reaproveitar. Em vez de configurar permissão a permissão para cada colaborador novo, você cria grupos como "Consulta apenas" ou "Operação fiscal" e vincula a pessoa ao grupo certo. A lista de grupos | Coluna | O que mostra | |---|---| | Situação | Se o grupo está ativo. | | ID | Número interno. | | Nome / Descrição | Identificação do grupo. | | Visibilidade | 👁️ Pública (todo o perfil pode usar) ou Local. | | Usuários | 👥 Quantos usuários usam este grupo. | | Criação | Quando foi criado. | | Perfil | A qual perfil pertence. | Filtro no cabeçalho para ID, Nome e Descrição. No painel da direita há ainda o filtro Visibilidade (Pública · Local). 👥 A coluna Usuários mostra o alcance da mudança. Antes de alterar um grupo, veja quantas pessoas dependem dele: a alteração vale para todas de uma vez. Como criar um grupo de permissões 1. Abra Segurança › Grupos de Permissões. 2. Clique em Cadastrar. Abre a janela Novo grupo de permissões, com as abas Geral e Permissões. 3. Na aba Geral, preencha Nome, Descrição, Visibilidade e Situação. 4. Vá à aba Permissões e defina cada item (explicado abaixo). 5. Clique em Salvar. Assim como nos Grupos de Empresas, a janela não fecha ao salvar — ela passa a mostrar "Editando <nome> (ID nn)". Isso significa que salvou. Não clique em Salvar de novo. Campos da aba Geral | Campo | Obrigatório | O que informar | |---|---|---| | Perfil | Sim (já vem preenchido) | O perfil dono do grupo. | | Nome | Sim | Nome do conjunto de permissões. Ex.: Consulta apenas. | | Descrição | Não | Para que serve o grupo. Ex.: Vê documentos, não exporta e não manifesta. | | Visibilidade | Sim | Local ou Pública (veja abaixo). | | Situação | Sim | Mesma lista de situações dos demais cadastros. Só os Ativos aparecem na lista por padrão. | Visibilidade: Local ou Pública São as duas únicas opções. Na dúvida, use Local — é o mais restrito e o que atende ao caso normal, em que o grupo serve apenas ao seu próprio perfil. A aba Permissões: os três estados Cada permissão tem três botões, e é isso que confunde à primeira vista: | Estado | O que faz | |---|---| | Sim | Libera explicitamente. | | Sistema | Não decide nada aqui — vale o padrão do sistema. É como o item já vem. | | Não | Bloqueia explicitamente. | Deixar em Sistema não é o mesmo que deixar em Não. "Sistema" significa "não tenho opinião, siga o padrão"; "Não" significa "proíba". Quando você quer garantir que alguém não faça algo, marque Não — não basta deixar como veio. As permissões são organizadas em árvore: o item de cima é o módulo, e abaixo dele ficam as ações. Há um campo Filtrar permissões... no topo, útil porque a árvore é longa. O que um usuário comum já pode, sem nenhum grupo O estado Sistema usa um padrão que o GaxWeb já traz. Vale conhecer, porque explica o que a pessoa consegue fazer antes de você criar qualquer grupo: | Área | Padrão do sistema | |---|---| | Administração (usuários, empresas, certificados, etiquetas) | 🔴 Bloqueado | | Aplicativos (GaxUP, GaxDown, Relatórios) | 🔴 Bloqueado | | Documentos fiscais | 🟢 Liberado, com ressalvas abaixo | Dentro de Documentos, o padrão é mais fino do que parece: | Permissão | Padrão | Na prática | |---|---|---| | Visualizar o documento | 🟢 Sim | Vê a nota e os Detalhes. | | Ver o XML na tela | 🔴 Não | Não abre a aba XML. | | Exportar PDF (botão direito) | 🟢 Sim | Baixa a DANFE avulsa. | | Exportar XML (botão direito) | 🟢 Sim | Baixa o XML avulso. | | Exportação em lote (zip) | 🔴 Não | Não exporta vários de uma vez. | | Excel | 🔴 Não | Não exporta a lista. | | Etiquetas | 🔴 Não | Não aplica marcadores. | | Manifestação | 🔴 Não | Não manifesta. | | Consultar webservice | 🔴 Não | Não força consulta à Sefaz. | 🤔 Um detalhe que confunde: o usuário comum baixa o XML pelo botão direito, mas não consegue vê-lo na tela. São duas permissões diferentes — XML (visualizar) e Exportar XML (baixar). Se alguém diz "consigo baixar mas não consigo abrir", é isso, e não um defeito. 💡 Por isso o Grupo de Permissões existe: para liberar o que o padrão bloqueia — exportação em lote, Excel, etiquetas e manifestação são as liberações mais pedidas. O que dá para controlar Administração | Módulo | Ações disponíveis | |---|---| | Usuários | Edição (cadastrar ou editar), Excel | | Empresas | Edição, Etiquetas, Excel | | Certificados | Edição, Etiquetas, Excel | | Etiquetas | Edição, Excel | Documentos fiscais Todos os tipos de documento têm o mesmo conjunto básico: | Ação | O que libera | |---|---| | Visualizar | Ver o documento | | Detalhes | Ver os detalhes do documento | | XML | Ver o XML do documento | | Exportação | Exportar os documentos selecionados em zip | | Etiquetas | Modificar etiquetas do registro | | Excel | Exportar o resultado para Excel | | Ações → Exportar PDF | Exportar o documento em PDF | | Ações → Exportar XML | Exportar o documento em XML | Tipos cobertos: NF-e (55), NFC-e (65), NFS-e (nacional), CT-e (57), CT-e OS (67) e Exportação. A NF-e tem duas permissões que nenhum outro documento tem — e são as mais sensíveis do sistema: - Manifestação — Manifestação do destinatário, subdividida em Ciência da operação, Confirmação da operação, Desconhecimento da operação e Cancelamento da realizada. - Consultar webservice — Forçar consulta na Sefaz. Manifestação é declaração enviada à Sefaz em nome da empresa. Vale conceder essas quatro só a quem de fato responde por isso, e deixar as demais pessoas em Não — e não apenas em "Sistema". Aplicativos | Módulo | Ações | |---|---| | GaxUP (Gaxweb Uploader) | Edição (cadastrar ou editar terminais), Excel | | GaxDown (Gaxweb Downloader) | Edição, Excel | | Relatórios customizados | Excel | O que não é controlado aqui A árvore de permissões não cobre os menus Segurança nem Monitores. O acesso a essas áreas não se configura por Grupo de Permissões. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Perguntas frequentes Qual a diferença entre "Não" e "Sistema"? "Sistema" segue o padrão e pode mudar conforme a configuração do ambiente; "Não" proíbe de forma explícita. Para bloquear com segurança, use Não. Preciso liberar item por item? Não. Marque no nível do módulo (por exemplo, "NFe") para valer no conjunto, e use os itens de baixo só quando quiser abrir uma exceção. Criei o grupo mas o usuário continua sem acesso. Verifique se o grupo está vinculado ao usuário em Administração › Usuários, no campo Grupo de permissões — criar o grupo não o aplica a ninguém automaticamente. Confira também se o grupo está com Situação Ativo. Meu grupo sumiu da lista. O painel Outros filtros já vem com Situação = 1:Ativo. Se você mudou a situação do grupo, ele deixa de aparecer. Limpe o filtro no X ao lado do campo.

gaxweb-agent: Terminais, Tarefas e Uploads (GaxWeb 5.0)

gaxweb-agent: Terminais, Tarefas e Uploads Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 O gaxweb-agent é o programa instalado num computador seu que envia arquivos ao GaxWeb sozinho — típico de quem tem PDV ou uma pasta onde os XMLs se acumulam. Em Aplicativos › gaxweb-agent há três telas, e elas contam a mesma história em três níveis: quem envia (Terminais), o que roda (Tarefas) e o que chegou (Uploads). Terminais: os computadores Cada linha é um computador com o agent instalado. | Coluna | O que mostra | |---|---| | Nome / App Key | Como você chamou o terminal e a chave dele. | | HWID | 🔑 A identificação da máquina. É o que amarra a licença àquele computador. | | Versão | A versão do agent instalada. | | Atividade | Quando o terminal falou com o GaxWeb pela última vez. | | Último IP | De onde ele acessou. | Botões: Novo terminal e o menu Terminal. O botão direito traz ações que não existem na barra: | Ação | O que faz | |---|---| | Instalador pré-configurado | 📦 Baixa o instalador já com as credenciais daquele terminal — não precisa configurar na mão. | | Destravar HWID | 🔓 Solta a amarração com a máquina. | | Logs | Mostra o que o agent registrou. É o primeiro lugar quando algo não funciona. | | Hardware | Dados da máquina. | 💻 Trocou o computador? O HWID muda, e o terminal para. Use Destravar HWID para soltar a amarração e instalar na máquina nova. 📦 Instalando pela primeira vez? Use o Instalador pré-configurado: ele já vem com as credenciais e evita erro de digitação. Tarefas: o que roda, e quando Cada linha é uma rotina agendada num terminal. | Coluna | O que mostra | |---|---| | Terminal | Em qual computador roda. | | Tipo / Nome | O que a tarefa faz. | | Cron | ⏰ A programação — de quanto em quanto tempo roda. | | Última exec. | Quando rodou pela última vez. | | Resultado | Como terminou. | | Execs / Falhas | 📊 Quantas vezes rodou e quantas falharam. | Botões: Nova tarefa e o menu Tarefa. 📊 A coluna Falhas é o alarme. Execuções subindo e falhas subindo junto significa tarefa quebrada — veja os Logs do terminal. Uploads: o que chegou Cada linha é um lote de arquivos enviado. | Coluna | O que mostra | |---|---| | Terminal | Quem enviou. | | Lote | Identificação do lote. | | Docs | Quantos documentos vieram. | | Tamanho | O tamanho do lote. | | Tent. | Quantas tentativas de envio. | | Recebido em / Processado em | Quando chegou e quando foi processado. | | Info | 💬 A mensagem sobre o lote — onde aparece o motivo de uma falha. | Botão direito: Baixar zip e Reprocessar. 🔁 Lote com erro? Leia a coluna Info, e use Reprocessar — não é preciso reenviar do computador. ⏱️ Recebido mas sem "Processado em"? Ainda está na fila. Ligue o Reload de 30s para acompanhar. 🔎 Nas telas de Tarefas e Uploads há um ícone a mais no topo: Filtrar pelo ID do terminal. É o atalho para ver tudo de um computador só. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Roteiro: "o terminal parou de enviar" 1. Terminais → a coluna Atividade é recente? Se não, o computador pode estar desligado, sem internet, ou o serviço parado. 2. Status "Sem Diretório"? A pasta configurada não existe mais no computador. 3. Tarefas → a coluna Falhas está subindo? 4. Botão direito no terminal → Logs — a resposta costuma estar aí. 5. Uploads → chegou algum lote hoje? Leia a coluna Info.

Public Links: enviar arquivos para fora com seguranca (GaxWeb 5.0)

Public Links: enviar arquivos para fora com segurança Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Aplicativos › Public Links cria links para entregar arquivos a quem não tem acesso ao GaxWeb — o contador, o fiscal, um cliente. É a alternativa ao anexo de e-mail: o link tem prazo, pode ter senha, tem limite de downloads e pode ser revogado a qualquer momento. 📎 Por que não mandar por e-mail? Anexo enviado não volta: circula, é reencaminhado e não há como cancelar. Um link controlado você desliga quando quiser — e ainda vê quantas vezes foi baixado. As colunas | Coluna | O que mostra | |---|---| | Situação | Se o link está ativo. | | Arquivo | Qual arquivo está sendo compartilhado. | | Disk | Onde o arquivo está guardado. | | has_password | 🔒 Se o link exige senha. | | download_count | 📥 Quantas vezes já foi baixado. | | max_downloads | O limite de downloads permitido. | | log_count | Quantos acessos foram registrados. | | Expiração | 📅 Até quando o link vale. | | Criação / Atualização | Quando foi criado e alterado. | Filtro no cabeçalho para ID e Arquivo. 📥 A coluna download_count confirma a entrega. Mandou o link ao contador e ele diz que não recebeu? Se o contador está em 1 ou mais, o arquivo foi baixado. Criar e gerenciar Novo link, no topo, cria um compartilhamento. Botão direito sobre a linha: | Ação | O que faz | |---|---| | Copiar URL | Copia o endereço para enviar. | | Revogar link | 🚫 Desliga o link na hora. Quem tiver o endereço deixa de conseguir baixar. | 🚫 Mandou para a pessoa errada? Revogue. É imediato, e é a principal razão para usar link em vez de anexo. Link vencido Links vencidos aparecem com a linha inteira em vermelho. É a forma mais rápida de descobrir por que alguém diz que "o link não abre": se a linha está vermelha, expirou. Confira, nesta ordem: (1) a linha está vermelha? Então expirou. (2) O download_count já bateu o max_downloads? Então o limite acabou. (3) A Situação está ativa? Onde mais se gera link público Não é só aqui. Na tela Documentos › Exportação, o botão direito sobre um pedido oferece Gerar link público — é o caminho natural para mandar ao contador o zip de um período inteiro, sem baixar e reenviar. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Boas práticas Prefira prazo curto. Um link de 7 dias cobre a necessidade real na maioria dos casos, e reduz o tempo em que o arquivo fica acessível. Use senha para conteúdo fiscal sensível, e mande a senha por outro canal — não no mesmo e-mail do link. Confira o download_count antes de reenviar. Muita gente reenvia porque o destinatário não achou o e-mail, quando o arquivo já tinha sido baixado.

Administracao: por onde comecar (GaxWeb 5.0)

Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 O menu Administração guarda os cadastros que fazem o GaxWeb funcionar: quem entra, quais empresas são monitoradas, com qual certificado, e como tudo isso é organizado. Cada tela tem um manual completo. Esta página é o mapa. As telas | Tela | Para que serve | Manual completo | |---|---|---| | Usuários | Quem entra no sistema, com qual nível, e quais empresas cada um enxerga. | A tela de Usuários | | Empresas | O cadastro dos CNPJ — e onde se liga o monitoramento e o eCac. | A tela de Empresas | | Certificados | Os certificados A1, sua validade e seus vínculos. | A tela de Certificados | | Etiquetas | Os marcadores para organizar documentos, empresas e usuários. | A tela de Etiquetas | | Perfis | O perfil da sua conta, plano e consumo. | — | As três coisas que mais geram dúvida 1. Cadastrar a empresa não liga o monitoramento. Na aba Monitor do cadastro, cada tipo de documento tem dois campos: Ativo/Inativo — que é o que liga — e Ciclo, que é só a janela de horário. Definir o Ciclo sozinho não liga nada, e nenhuma mensagem avisa. 2. No 5.0 o usuário só vê as empresas vinculadas a ele. Para o Usuário padrão, o acesso é concedido, não presumido: a aba Empresas do cadastro mostra um contador Grupo | Local, e se os dois estão em zero, ele não vê empresa nenhuma. Níveis administrativos veem tudo do perfil. 3. Certificado com Vínculos = 0 não serve para nada. Ele aparece na lista, parece certo, mas não está ligado a empresa alguma — e nenhum monitor o usa. É a causa mais comum e a menos óbvia de "renovei e continua sem baixar". Um roteiro para "não está chegando nota" Nesta ordem, e quase sempre para na primeira ou na segunda: 1. Empresas → a coluna do monitor daquele tipo está Ativo? (Role para a direita: as colunas de monitor ficam depois de Certificado digital.) 2. Certificados → a Validade está no futuro e os Vínculos são maiores que zero? 3. Ligou agora? Espere: a primeira carga leva de 5 a 60 minutos. 4. Parou do nada? A Fazenda desativa a distribuição após 60 dias sem monitorar. 5. Só então veja Monitores, para a leitura fina de NSU e tentativas. Duas rotinas que evitam chamado Uma vez por mês, em Certificados: filtre Status = Vencendo para saber o que renovar, e Vínculo = Sem vínculo para achar o que foi cadastrado e esquecido. Ao criar um usuário: confira a aba Empresas antes de entregar o acesso. Usuário novo nasce sem empresa nenhuma. Para ir além - Quem pode fazer o quê → Grupos de Permissões: os três estados - Carteiras de empresas → Grupos de Empresas: como criar e usar - A leitura fina dos monitores → Monitores: busca automática de documentos na Sefaz - Está vindo da 4.6? → O que mudou da versão 4.6 para a 5.0

O que mudou da versao 4.6 para a 5.0 (GaxWeb 5.0)

Aplica-se a: GaxWeb 5.0.0 (alpha) — update 26.08.2026 Desde 14/08/2026 todo usuário entra direto na versão 5.0. O botão no canto superior direito permite voltar à 4.6 quando necessário. ⚠️ Esse botão mostra o DESTINO, não onde você está. Quem está na 5.0 lê "Gaxweb 4.6" escrito nele. Para saber sua versão, olhe o canto superior esquerdo — ou use a pista mais simples: se o menu lateral tem "Segurança", você está na 5.0. O menu mudou de nome e de lugar | 4.6 | 5.0 | |---|---| | Documentos | Documentos | | Aplicações | Aplicativos | | Monitor | Monitores | | Administração | Administração | | Sistema | — | | — | Segurança ← novo | Segurança é o grupo novo: Grupos de Empresas (quais empresas cada pessoa enxerga) e Grupos de Permissões (o que ela pode fazer). Na 4.6 esse controle era mais simples e ficava espalhado. O botão direito virou o caminho principal É a mudança que mais gera a sensação de "sumiu essa função". Na 5.0, o menu do botão direito sobre a linha é diferente do menu da barra de cima, e várias ações existem só nele: | Onde | Só no botão direito | |---|---| | Listas de documentos | Exportar PDF, Exportar XML | | Documentos › Exportação | Efetuar download, Gerar link público, Replicar exportação | | Public Links | Copiar URL, Revogar link | | gaxweb-agent › Terminais | Instalador pré-configurado, Destravar HWID, Logs | | Toda a Administração | Alterações (quem mudou o quê) | Regra prática: não achou uma ação? Clique com o botão direito sobre o registro antes de concluir que ela não existe. Baixar XML: por que "veio um zip" Na 4.6 o download saía mais direto. Na 5.0 há dois caminhos, e escolher o errado é o que gera a reclamação: | Você quer | Caminho | Resultado | |---|---|---| | Uma nota | Botão direito sobre a linha → Exportar XML | Arquivo avulso, na hora | | Várias | Marcar as caixinhas → menu Documento → Exportação | Compactado | | Um período | Documentos › Exportação → Exportar | Entra em fila, sai compactado | Se você quer só o XML de uma nota, como era antes, use o botão direito. O zip só aparece na exportação em lote. Na exportação por período, as opções de Situação (Autorizados, Cancelados, Denegados) vêm desmarcadas. Sem marcar ao menos uma, o pedido costuma voltar vazio — status "Finalizado Alerta", 0 registros. "Sumiu da lista" Em todas as listas da 5.0, o painel Outros filtros já vem com Situação = 1:Ativo. Registros inativos ficam ocultos por padrão. Para ver tudo, clique no X ao lado do campo Situação. Duplo clique não abre nada Na 5.0, dar duplo clique numa linha não faz nada. Para abrir um registro: botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar sem medo. Ligar o monitor: dois campos, não um Em Administração › Empresas → aba Monitor, cada tipo de documento tem: | Campo | O que faz | |---|---| | Ativo / Inativo | É o que liga o monitor. | | Ciclo | Só a janela de horário da consulta. | Definir apenas o Ciclo não liga o monitor — e nada avisa. Quais empresas cada usuário enxerga É a mudança de comportamento que mais gera chamado depois da virada. Em Administração › Usuários, ao abrir um usuário existe a aba Empresas — uma lista de inclusão. Ela mostra um contador com as duas origens possíveis: Grupo: 0 | Local: 0 | Origem | O que é | |---|---| | Grupo | Empresas que chegam pelo Grupo de empresas vinculado ao usuário. | | Local | Empresas vinculadas uma a uma, direto naquele usuário. | Um usuário padrão enxerga apenas as empresas que somam nessas duas origens. Se as duas estão em zero, ele não vê empresa nenhuma — e é por isso que aparece o chamado "meu usuário entrou e não vê nada". Isso depende do Nível do usuário: níveis administrativos enxergam as empresas do perfil independentemente do vínculo. A regra da lista de inclusão vale para o Usuário padrão. Não existe nenhuma opção de "ver todas as empresas" — conferido nas quatro abas do cadastro (Geral, Permissões, Empresas, Administrador). Na 4.6 o comportamento era mais aberto; na 5.0 o acesso é concedido, não presumido. Manifestação: mudou de lugar Quem procura na lista não acha, e conclui que a versão não manifesta. Ela existe — está dentro da nota: Documentos › NF-e → botão direito sobre a nota → Visualizar → botão "Manifestação", no canto superior direito. O visualizador abre numa aba própria, com DANFE, Detalhes e XML. Os quatro eventos: Confirmação da Operação, Ciência da Operação, Desconhecimento da Operação e Operação não Realizada. O campo Motivo é pedido junto. Só a NF-e tem manifestação. O botão direito da lista oferece apenas Visualizar, Exportar PDF, Exportar XML e Recarregar item — a manifestação não está ali. Etiqueta em várias notas de uma vez: não dá Com várias notas marcadas, o menu Documento oferece apenas Exportação — e o botão direito não tem etiqueta. Não existe aplicar etiqueta em lote nas notas na 5.0. Etiqueta em lote existe para empresas (Administração), não para documentos. Exportação para Excel vem limitada Se a exportação trouxe menos registros do que a lista mostra, veja Administração › Usuários → aba Administrador → "Limite de registros no Excel". É um teto por usuário.

A tela de Certificados: validade, vinculos e renovacao (GaxWeb 5.0)

A tela de Certificados: validade, vínculos e renovação Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Administração › Certificados lista os certificados digitais A1 guardados no GaxWeb. É o certificado que autoriza o sistema a consultar a Sefaz em nome da empresa — sem ele, nenhum monitor funciona. Certificado é a causa nº 1 de "parou de funcionar". Esta tela responde por quê em duas colunas. Duas colunas resolvem quase tudo | Coluna | O que olhar | |---|---| | Validade | 📅 Data no passado = vencido, sem contorno possível. | | Vínculos | 🔗 Se estiver em 0, o certificado está cadastrado mas não está ligado a nenhuma empresa — e não serve para nada. | 🎯 Vínculos = 0 é a causa mais comum e a menos óbvia. O certificado foi enviado, aparece na lista, tudo parece certo — mas nenhuma empresa o está usando. Costuma acontecer quando o Assistente é abandonado antes da etapa do vínculo. As colunas | Coluna | O que mostra | |---|---| | Status | Situação do certificado. | | Etiquetas | Marcadores aplicados. | | ID | Número interno. | | CPF/CNPJ | O titular do certificado. | | Tipo | Tipo do certificado. | | UF | Estado. | | Descrição | Identificação dada no cadastro. | | Informações | Dados do certificado (emitido por, emitido para). | | Vínculos | 🔗 Quantas empresas o usam. | | Validade | 📅 Até quando vale. | | Criação | Quando entrou no GaxWeb. | | Perfil | A qual perfil pertence. | Filtro no cabeçalho para ID, CPF/CNPJ, UF, Descrição e Informações. Como cadastrar: só pelo Assistente Repare que esta tela não tem botão "Cadastrar" — os botões são Assistente e Certificado. O certificado entra pelo Assistente, em 4 etapas, e a etapa 3 é o vínculo com as empresas. ⚠️ Sair antes do fim deixa o certificado sem vínculo — a própria tela avisa que só grava ao finalizar. É exatamente assim que se produz um certificado com Vínculos = 0. Renovar um certificado O certificado novo é outro arquivo: cadastrar não substitui o antigo automaticamente. 1. Cadastre o novo pelo Assistente, vinculando às mesmas empresas; ou 2. Vá em Administração › Empresas → menu Empresa → Atualizar certificado, empresa por empresa. Depois, confira a coluna Vínculos do certificado novo: se estiver em 0, o vínculo não foi feito e os monitores continuam usando o antigo — que vai vencer. Antecipar vencimentos O painel de filtros tem os campos que evitam a surpresa: | Filtro | Opções | Serve para | |---|---|---| | Status | Válido · Inválido · Vencendo · Vencido · Revogado | 📅 Ver o que vence em breve. | | Vínculo | Com vínculo · Sem vínculo | 🔗 Achar certificado que não está sendo usado. | | Validade entre | Período | Planejar as renovações do mês. | | Criação entre | Período | Quando entraram. | 💡 Rotina que evita chamado: uma vez por mês, filtre Status = Vencendo e Vínculo = Sem vínculo. A primeira lista o que renovar; a segunda, o que foi cadastrado e esquecido. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Regras que não se deduzem da tela A1, não A3. O GaxWeb trabalha com certificado A1 — o arquivo .pfx. O A3 (cartão ou token) exige a mídia conectada e não serve para consulta automática. Certificado do próprio CNPJ, para NFC-e SP e NFS-e. Matriz não consulta filial e filial não consulta matriz: cada uma precisa do seu. O certificado fica no servidor, e é isso que permite a consulta 24 horas por dia sem depender do seu computador. O acesso é controlado por perfis e pode ser revogado a qualquer momento. Perguntas frequentes "Renovei o certificado e continua sem baixar nota." Coluna Vínculos do certificado novo. Se estiver em 0, faltou vincular. "Erro processando certificado / senha inválida." A senha é a que foi criada na emissão do certificado, não a do GaxWeb. Confira também se o arquivo é .pfx e se não está corrompido. "Não consigo cadastrar de novo o certificado." Veja se ele já não está na lista — o filtro Situação = 1:Ativo pode estar escondendo a versão inativa. Limpe o filtro pelo X.

A tela de Empresas: cadastro, monitores e eCac (GaxWeb 5.0)

A tela de Empresas: cadastro, monitores e eCac Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Administração › Empresas é o cadastro dos CNPJ/CPF que você administra — e é também onde se liga o monitoramento na Sefaz e o eCac de cada empresa. Não existe outro lugar para isso. Se as notas de uma empresa não estão chegando, a resposta quase sempre está nesta tela. Três botões, três caminhos | Botão | Quando usar | |---|---| | Assistente | 🚀 Para a primeira empresa, ou para quem está começando. Conduz as 5 etapas numa sequência só. | | Cadastrar | Formulário completo em abas, para quem já conhece. | | Empresa | Menu de ações sobre a empresa selecionada. | O Assistente, em 5 etapas 1. Documento — o CPF/CNPJ. Sendo CNPJ, o GaxWeb consulta a ReceitaWS e preenche razão social e endereço sozinho. 2. Dados — confira os dados. 3. Certificado — anexe o A1 (.pfx). 4. Monitores — escolha o que monitorar e o ciclo. 5. Revisão — confira e conclua. ⚠️ Vá até a etapa 5. O cadastro só grava ao finalizar — sair no meio deixa a empresa incompleta ou sem certificado vinculado. O menu Empresa | Ação | O que faz | |---|---| | Editar empresa | Abre o cadastro. | | Atualizar certificado | Troca o certificado vinculado. É o caminho da renovação. | | Desvincular certificado | Solta o certificado da empresa. | | Consultar ReceitaWS | 🔎 Busca os dados cadastrais pelo CNPJ — evita digitar à mão. | As colunas | Coluna | O que mostra | |---|---| | Status | Situação da empresa. | | Etiquetas | Marcadores aplicados. | | ID | Número interno. | | Tipo | Física ou Jurídica. | | CPF/CNPJ | O documento. | | Município / UF | Localização. | | Razão Social/Nome Fantasia | Identificação. | | Certificado digital | O certificado vinculado. | | NFe AN | 🟢 Estado do monitor de NF-e. | | NFe ciência | Se a ciência automática da operação está ligada. | | CTe AN | Estado do monitor de CT-e. | | NFSe AN | Estado do monitor de NFS-e. | | NFCe SP | Estado do monitor de NFC-e São Paulo. | | ECac AN | Estado do eCac. | | Criação | Quando foi cadastrada. | | Perfil | A qual perfil pertence. | 👀 As colunas de monitor são a visão mais rápida de "esta empresa está sendo monitorada?" — empresa por empresa, sem abrir cadastro nenhum. Ficam à direita da rolagem. Filtro no cabeçalho para ID, CPF/CNPJ, Município, UF e Razão Social/Nome Fantasia. Ligar o monitor: são dois campos, não um Na aba Monitor do cadastro, cada tipo de documento tem dois ajustes: | Campo | O que faz | |---|---| | Ativo / Inativo | ✅ É ISTO que liga o monitor. | | Ciclo | Apenas a janela de horário da consulta. | Definir só o Ciclo não liga o monitor — a empresa continua sem ser monitorada e nenhuma mensagem avisa. Se as notas não chegam, este é o primeiro campo a conferir. Os ciclos: Integral (24h) · Diurno (6h-18h) · Noturno (18h-6h) · e as faixas de seis horas (3-9h, 9-15h, 15-21h, 21-3h). Não há horário livre. Há ainda NF-e ciência (Ativo/Inativo), a ciência automática da operação, só para NF-e. E o NFC-e SP tem um campo Período a mais. ⏰ Ciclo restrito evita a mensagem 656. Se a empresa já usa outro sistema consultando a Sefaz com o mesmo certificado, os dois se atropelam e aparece consumo indevido. Um ciclo mais estreito no GaxWeb resolve a convivência. 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". 🛑 A Fazenda desativa a distribuição para quem fica 60 dias sem monitorar. É a causa mais comum de "parou de chegar nota do nada". A aba eCAC Liga a busca das mensagens da Receita, com a mesma lógica de Ciclo. Tem também Configuração alternativa, que aponta para outra empresa — usada quando a procuração é de um terceiro, como o escritório contábil. Filtros próprios desta tela Além dos comuns, o painel traz filtros que respondem perguntas inteiras: | Filtro | Opções | Serve para | |---|---|---| | Tipo | Física · Jurídica | Separar CPF de CNPJ. | | Status (empresa) | Alerta · Erro | Achar empresas com problema. | | Status (certificado) | Válido · Inválido · Vencendo · Vencido · Revogado | 📅 Antecipar renovações. | | Vínculo | Com vínculo · Sem vínculo | 🔗 Achar certificado que não está ligado a empresa nenhuma. | | Monitor de cada tipo | Ativo · Inativo | Listar quem está sem monitor. | | Ciclo de cada tipo | Os 7 ciclos | Ver quem está em que janela. | 🎯 Dois filtros que resolvem chamado sozinhos: Status = Vencendo mostra os certificados a renovar antes que parem; Monitor NFe = Inativo lista as empresas que estão cadastradas mas não estão sendo monitoradas. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Perguntas frequentes "Cadastrei a empresa e não chegou nota nenhuma." Cadastrar não liga monitor. Aba Monitor → ponha em Ativo. "Ativei e continua sem vir nada." Confira se passaram 60 minutos, se há certificado válido e vinculado, e a coluna do monitor na lista. "Parou de chegar do nada." Certificado vencido ou desvinculado, ou os 60 dias sem monitorar.

A tela de Etiquetas: marcadores para organizar (GaxWeb 5.0)

A tela de Etiquetas: marcadores para organizar Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Administração › Etiquetas cria os marcadores que você aplica a documentos, empresas e usuários para organizar e filtrar depois. É a tela mais simples do menu — e tem uma pegadinha que gera chamado. Use o tipo "Geral" — é a recomendação Ao criar a etiqueta você escolhe um Tipo: Geral, Documentos, Empresas ou Usuários. A ideia é que ele limite onde a etiqueta pode ser aplicada. ✅ A recomendação hoje é criar tudo como "Geral". Assim a etiqueta fica disponível em qualquer tela, sem surpresa. ⚠️ "Criei a etiqueta e ela não aparece na hora de vincular." Se a etiqueta foi criada com um tipo específico, mude para Geral (botão direito → Editar → campo Tipo) e tente de novo. É o caminho que funciona. As colunas | Coluna | O que mostra | |---|---| | Status | Situação da etiqueta. | | ID | Número interno. | | Legenda | O texto que aparece na etiqueta. | | Descrição | Para que ela serve. | | Tipo | Geral · Documentos · Empresas · Usuários. | | Criação | Quando foi criada. | | Perfil | A qual perfil pertence. | Filtro no cabeçalho para ID, Legenda e Descrição. Onde a etiqueta aparece depois - Nas listas, na coluna Etiquetas. - No painel de filtros de quase toda tela, no campo Etiqueta. - No cadastro de empresas e usuários. 🏷️ Não existe aplicar etiqueta em várias notas de uma vez. Com várias notas marcadas, o menu Documento só oferece Exportação. Etiqueta em lote existe para empresas, não para documentos. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Como usar bem Etiqueta organiza, não controla acesso. Quem tem acesso ao menu vê todos os registros permitidos, etiquetados ou não. Para restringir de fato, use Grupos de Empresas e Grupos de Permissões, em Segurança. Boas etiquetas são poucas e estáveis. Marcadores como Carteira A, Filial Sul ou Revisar rendem mais do que dezenas de etiquetas específicas que ninguém lembra de aplicar. Etiqueta em empresa combina com Grupo de Empresas. Etiquete as empresas de uma carteira e use a etiqueta para achá-las rápido na hora de montar o grupo. Perguntas frequentes "A etiqueta não aparece para vincular." Mude o Tipo dela para Geral (botão direito → Editar). É o tipo que funciona em qualquer tela. "A etiqueta sumiu da lista." Filtro Situação = 1:Ativo. Limpe pelo X. "Posso apagar uma etiqueta em uso?" Prefira deixá-la Inativa: apagar faz perder a marcação nos registros que a usavam.

A tela de Usuarios: acesso, niveis e quais empresas cada um ve (GaxWeb 5.0)

A tela de Usuários: acesso, níveis e quais empresas cada um vê Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Administração › Usuários é onde se cria quem entra no GaxWeb e se define o que cada pessoa enxerga e pode fazer. É a tela que mais gera chamado depois da virada para a 5.0 — porque o acesso às empresas mudou de lógica. Comece pela seção Quais empresas o usuário enxerga. As colunas | Coluna | O que mostra | |---|---| | Status | Situação do usuário. | | Online | 🟢 Se a pessoa está no sistema agora. | | Etiquetas | Marcadores aplicados ao usuário. | | ID | Número interno. | | Nível | Administrador geral · Administrador perfil · Usuário padrão. | | Nome/Usuário | Nome e e-mail de acesso. | | Atividade | Data e hora da última atividade. | | GeoIP | 🌎 De onde a pessoa acessou — IP e cidade. | | Criação | Quando o usuário foi criado. | | Perfil | A qual perfil pertence. | | Grupo de empresas | O grupo vinculado, se houver. | | Grupo de permissões | O grupo de permissões vinculado. | Filtro no cabeçalho para ID e Nome/Usuário. 🌎 A coluna GeoIP é de segurança. Acesso de cidade inesperada merece atenção. Combine com o filtro Online: Online (< 5 min) · Ausente (5-30 min) · Offline (> 30 min). Os três níveis | Nível | Enxerga | |---|---| | Administrador geral | Tudo. | | Administrador perfil | As empresas do perfil dele. | | Usuário padrão | Só as empresas vinculadas a ele. | Quais empresas o usuário enxerga No 5.0 o acesso é concedido, não presumido. Na 4.6 as empresas apareciam de forma mais aberta; agora, para o Usuário padrão, vale a regra da lista. Abra o usuário (botão direito → Editar) e vá à aba Empresas. Ela mostra um contador com duas origens: Grupo: 0 | Local: 0 | Origem | O que é | |---|---| | Grupo | Empresas que chegam pelo Grupo de empresas vinculado. | | Local | Empresas vinculadas uma a uma, ali no usuário. | O usuário padrão vê a soma das duas. Se ambas estão em zero, ele não vê nenhuma empresa — e é essa a causa de "meu usuário entrou e não aparece nada". Para liberar: use Selecionar naquela aba (uma a uma) ou vincule um Grupo de empresas em Segurança › Grupos de Empresas. ⛔ Não existe opção de "ver todas as empresas" no cadastro do usuário. Para carteiras grandes, o caminho é o Grupo de empresas — muda em um lugar só e vale para todos os usuários daquele grupo. As quatro abas do cadastro | Aba | O que tem | |---|---| | Geral | Perfil, e-mail, nome, senha, Situação, Nível, Grupo de empresas e Grupo de permissões. | | Permissões | O que a pessoa pode fazer, item a item. | | Empresas | A lista de inclusão descrita acima. | | Administrador | Ajustes de sessão e segurança — veja abaixo. | A aba Administrador Guarda ajustes pouco conhecidos que explicam vários chamados: | Ajuste | Para que serve | |---|---| | Limite de registros no Excel | 📊 Teto de linhas na exportação para Excel desse usuário. Se a exportação vem cortada, é aqui. | | Permitir alternar entre versões | 🔀 É o que controla o botão 4.6 / 5.0. Sem isso, a pessoa não consegue voltar à versão anterior. | | Permitir acesso à versão beta | Libera versões em teste. | | Não permite o uso de diferentes sessões por um mesmo usuário | Impede a mesma conta em dois lugares ao mesmo tempo. | | Não permite diferentes IPs numa mesma sessão | Derruba a sessão se o IP mudar. | | Finalizar sessão após 15 minutos de inatividade | Logout automático. | | Validar 2FA no próximo login | Exige o segundo fator no próximo acesso. | | Alterar senha no próximo login | Obriga a troca de senha. | | Derrubar sessão do usuário | Encerra a sessão ativa na hora. | | E-mail de boas-vindas | Dispara o e-mail de boas-vindas. | 🔀 "Sumiu o botão para voltar ao 4.6". É o Permitir alternar entre versões, aqui. Não é a versão que removeu o botão — é permissão do usuário. 👥 Conta compartilhada entre várias pessoas costuma esbarrar em Não permite o uso de diferentes sessões. A solução certa é criar um usuário por pessoa: sai mais barato que perder o histórico de quem fez o quê. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Perguntas frequentes "Criei o usuário e ele não vê nenhuma empresa." Aba Empresas do usuário: Grupo e Local em zero. Vincule as empresas ou um grupo. "A exportação para Excel veio cortada." Aba Administrador → Limite de registros no Excel. Diferente do seletor Registros, que muda só o que aparece na tela. "O usuário sumiu da lista." O filtro Situação = 1:Ativo esconde os inativos. Limpe pelo X. "Preciso saber quem alterou este usuário." Botão direito → Alterações.

O que significa cada status e mensagem do GaxWeb (5.0)

Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 O GaxWeb usa um código de status para dizer o que aconteceu com uma empresa, um certificado, uma consulta à Sefaz ou um pedido de exportação. Ele aparece na coluna Status das listas e na coluna Info da tela de Exportação. Esta página explica os que você vai encontrar no dia a dia, agrupados pelo que fazer — não pelo número. Antes de tudo: os cinco tipos Todo status tem um tipo, que já indica a gravidade: | Tipo | O que significa | |---|---| | Situação | Estado normal do registro. Não é problema. | | Informação | Aviso sem gravidade. | | Alerta | ⚠️ Algo merece atenção, mas o processo seguiu. | | Erro | ❌ O processo falhou. | | Throwable | 🔥 Falha técnica inesperada. Abra chamado. | Na tela de Exportação, o filtro Status usa exatamente esses cinco tipos. Filtrar por Alerta e Erro mostra só o que deu problema. Certificado | Status | O que aconteceu | O que fazer | |---|---|---| | Certificado a vencer | Está perto do vencimento. | Providencie a renovação antes que pare. Em Certificados, o filtro Status = Vencendo lista todos. | | Certificado vencido | Passou da validade. | Nenhuma consulta funciona. Cadastre o novo e vincule às empresas. | | Certificado revogado | Foi revogado pela autoridade certificadora. | Não há conserto: é preciso emitir outro. | | Sem certificado digital | A empresa não tem certificado vinculado. | Vincule em Empresas → menu Empresa → Atualizar certificado. | 🔗 Cuidado com o mais silencioso: certificado cadastrado mas com Vínculos = 0 não dá erro — simplesmente nada acontece. Confira essa coluna em Administração › Certificados. CNPJ e cadastro | Status | O que aconteceu | O que fazer | |---|---|---| | CNPJ não confere | O CNPJ do certificado não é o da empresa. | Para NFC-e SP e NFS-e, cada CNPJ precisa do seu próprio certificado: matriz não consulta filial. | | CPF não confere | Mesma coisa, para pessoa física. | Verifique o titular do certificado. | | CNPJ inválido | O número não é válido. | Corrija o cadastro da empresa. | | CNPJ não cadastrado | O documento não está na base consultada. | Confirme se a empresa existe e está ativa na Receita. | | Não ativo na UF informada | A empresa não tem inscrição ativa naquele estado. | Confira a UF do cadastro. | Consumo e plano | Status | O que aconteceu | O que fazer | |---|---|---| | Pouco crédito | O plano está chegando ao limite. | Acompanhe o consumo; avalie subir de plano. | | Sem créditos | O limite do plano acabou. | A captura para até a renovação do ciclo ou a troca de plano. | | Créditos expirados | Os créditos venceram. | Fale com o comercial. | | Consumo indevido | ⚠️ É a famosa mensagem 656. Mais de um sistema consultando a Sefaz com o mesmo certificado. | Não é preciso desligar o GaxWeb: ajuste o Ciclo para uma janela mais estreita e os dois convivem. | 🔁 Sobre a 656: a Sefaz aceita uma consulta por hora por certificado. Quando o GaxWeb e outro sistema consultam juntos, os dois se atropelam. O ciclo restrito resolve sem perder a captura. A nota não veio, ou veio incompleta | Status | O que aconteceu | O que fazer | |---|---|---| | Sem XML | Chegaram os dados da nota, mas não o arquivo. | Em NF-e, o filtro Situação → Sem XML lista todas. Veja Como recuperar notas antigas. | | Sem protocolo | Falta o protocolo de autorização. | Costuma se resolver sozinho na próxima consulta. | | Sem assinatura | Falta a assinatura digital válida. | Se persistir, abra chamado com a chave da nota. | | Nenhum documento localizado | A consulta rodou e não achou nada. | Normal quando não houve emissão no período. | | NSU solicitado muito antigo | O ponto de leitura pedido está fora da janela da Sefaz. | A Sefaz não devolve documentos muito antigos por esse caminho: use a recuperação por chave. | | Sem atividade / 48h sem atividade | A empresa não teve movimento. | ⚠️ Atenção: a Fazenda desativa a distribuição após 60 dias sem monitorar. | Situação do documento Estes não são erro — descrevem o estado da nota: | Status | Significa | |---|---| | Cancelado | A nota foi cancelada pelo emitente. | | Contingência | Emitida em contingência (sistema da Sefaz fora do ar na emissão). | | Denegado | A Sefaz negou a autorização. | | Confirmado | Operação confirmada na manifestação. | | Não realizado | Operação declarada como não realizada. | | Duplicidade | O documento já existia na base. | Exportação | Status | O que aconteceu | O que fazer | |---|---|---| | Processando / Executando | O pedido está na fila ou rodando. | Aguarde. Ligue o Reload de 30s para acompanhar. | | Finalizado | Terminou com sucesso. | Botão direito → Efetuar download. | | Finalizado Alerta | ⚠️ Terminou, mas sem trazer nada. | Quase sempre é filtro: as opções de Situação vêm desmarcadas. Marque ao menos uma e refaça com Replicar exportação. | | Finalizado Erro / Exception | Falhou. | Leia a coluna Info. Se não estiver claro, abra chamado citando o ID do pedido. | | Timeout | Demorou além do limite. | Refaça com um período menor. | | Aguardando / Ocioso | Na fila, sem processar ainda. | Aguarde. | GaxUp e gaxweb-agent | Status | O que aconteceu | O que fazer | |---|---|---| | Sem Diretório | A pasta configurada não existe no computador. | Confira o caminho na configuração do GaxUp. | | Sem Comunicação | O terminal não está falando com o GaxWeb. | Veja se o computador está ligado, com internet, e o serviço rodando. | | Sem Importação | Comunicou, mas não havia arquivo novo. | Normal se nada foi emitido. | | Já processado | O arquivo já tinha sido enviado antes. | Não é erro — evita duplicidade. | Específicos do SAT e da NFC-e Quebra de sequência — há um vão na numeração dos documentos: entre o número inicial e o final da série, faltam documentos. 📊 Existe relatório pronto para isso. Em Aplicativos › Relatórios há "Quebra de Sequência - SAT" (lista as séries com quebra) e "Sequenciamento - SAT" (verifica a sequência no período, apontando as lacunas). Para NFC-e, os equivalentes são "Quebra NFCe" e "Sequência NFCe". Vale rodar antes de fechar o mês: documento faltando na numeração é o que o fisco cobra. Data maior que último cupom — a data consultada é posterior ao último cupom que o equipamento registrou. Se não for esperado, fale com o suporte informando a empresa e o período. Falhas técnicas Estes indicam problema do lado do serviço consultado, não do seu cadastro: Indisponível · Não disponível · Nenhum serviço compatível · Bad Response · Server Error · Client Error · Falha no schema XML · Erro interno do servidor · Runtime error · Captcha inválido Costumam ser passageiros e se resolvem na consulta seguinte. Se um deles se repetir por mais de um dia na mesma empresa, abra chamado informando a empresa, o tipo de documento e o horário. Como usar isto no dia a dia 1. Leia o tipo antes do texto. Situação e Informação não pedem ação. 2. Na Exportação, a coluna Info explica o pedido. É onde está o motivo real de um resultado vazio. 3. Na tela de Monitores, a coluna Informações traz o retorno da última consulta — é o diagnóstico mais direto de "não está chegando nota". 4. Ao abrir chamado, informe o status exato, a empresa e o horário. Com isso o suporte começa do meio do caminho.

GaxUP e GaxDown: enviar e receber XML pelo computador (GaxWeb 5.0)

GaxUP e GaxDown: enviar e receber XML pelo computador Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 GaxUP e GaxDown são programas instalados no seu computador que ligam uma pasta local ao GaxWeb: | Programa | O que faz | |---|---| | GaxUP | ⬆️ Envia para o GaxWeb os XML que estão numa pasta sua. | | GaxDown | ⬇️ Baixa para uma pasta sua os XML que o GaxWeb capturou. | 🎯 Qual usar? "Tenho XML no meu computador e quero que entrem no GaxWeb" → GaxUP. "Quero que as notas capturadas caiam numa pasta para o meu sistema ler" → GaxDown. As duas telas são iguais — mesmas colunas, mesmos filtros, mesmo botão. O que muda é o sentido do transporte. 📦 O GaxUP lê ZIP — não precisa descompactar. Pode jogar na pasta o pacote do jeito que ele veio: exportação de outro sistema, backup do contador, o ZIP que o fornecedor mandou. Ele abre e envia os XML de dentro. Isso muda o esforço de uma carga grande: milhares de notas viram arrastar alguns arquivos, em vez de descompactar tudo antes. E, como arquivo repetido não duplica (volta com o status Já processado), dá para soltar de novo um pacote que você já mandou, sem medo — é o jeito seguro de garantir que nada ficou para trás. As colunas | Coluna | O que mostra | |---|---| | Status | Estado do terminal. | | Nome/Hwid | Como você o chamou e a identificação da máquina. | | Versão | A versão instalada. | | Atividade | 🕐 Quando falou com o GaxWeb pela última vez. | | Processamento | Quando processou pela última vez. | | Computer | 💻 O nome do computador. | | Path | 📁 A pasta ligada ao GaxWeb. | | IPs | De onde acessou. | Filtro no cabeçalho para ID, Nome/Hwid e Computer. Botão: Novo terminal, no topo. Botão direito sobre o terminal: | Ação | O que faz | |---|---| | Atividade | O histórico de atividade daquele terminal. | | Informações do computador | Dados da máquina. | | Download do instalador | 📦 Baixa o instalador. | | Recarregar item | Atualiza a linha. | ⚠️ Aqui não existe "Destravar HWID". Essa ação é do gaxweb-agent › Terminais, que é outro programa. Se você trocou de computador e usa GaxUP ou GaxDown, fale com o suporte — não há botão de destravar nesta tela. 📁 A coluna Path é a primeira a conferir quando algo não funciona: se a pasta mudou de lugar, foi renomeada, ou está num drive de rede que desconectou, o programa não acha nada — e o status vira Sem Diretório. Os status que aparecem aqui | Status | O que aconteceu | O que fazer | |---|---|---| | Sem Diretório | A pasta configurada não existe (ou mudou). | Confira a coluna Path e o caminho na configuração. | | Sem Comunicação | Não está falando com o GaxWeb. | Computador ligado? Internet? Serviço rodando? | | Sem Importação | Comunicou, mas não havia arquivo novo. | Normal se nada foi emitido. | | Já processado | O arquivo já tinha sido enviado. | Não é erro — evita duplicidade. | A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. GaxUP, GaxDown ou gaxweb-agent? As três coisas enviam arquivos, e a diferença confunde: | | Para que serve | |---|---| | GaxUP / GaxDown | Uma pasta do computador, num sentido só (subir ou baixar). | | gaxweb-agent | Mais completo: tarefas agendadas, lotes, logs e controle por HWID. Típico de PDV. | Várias empresas no mesmo servidor? Um GaxUP basta Não é preciso um por empresa. Um único GaxUP atende todas as empresas do perfil — ele se baseia no cadastro de empresas do seu perfil no GaxWeb para saber a quem cada arquivo pertence. 🏢 Isso resolve o caso comum de contabilidade ou grupo com várias lojas que guarda os XML de todos os CNPJ no mesmo servidor: instala um, aponta a pasta, e o GaxWeb distribui cada arquivo para a empresa certa. Perguntas frequentes "Quero trazer os XML que estão no meu computador." É o GaxUP. Instale, aponte a pasta e ele envia sozinho. "Tenho o histórico em vários ZIP. Preciso descompactar antes?" Não. O GaxUP lê o ZIP e envia os XML de dentro. Jogue os pacotes na pasta do jeito que estão. "Estou saindo de outro sistema e quero trazer todo o meu histórico." Exporte os XML no sistema de origem — de preferência ano a ano, que fica mais leve — e solte os arquivos (ou os ZIP) na pasta do GaxUP. Um único GaxUP dá conta de todos os seus CNPJ, distribuindo cada nota para a empresa certa. Se algum pacote foi enviado duas vezes, o repetido é ignorado. "As notas baixam no GaxWeb mas não caem na minha pasta." É o GaxDown que faz isso. Confira a coluna Path e o status do terminal. "O terminal aparece mas a Atividade é antiga." O programa não está rodando ou o computador está fora do ar.

A tela de Relatorios: os prontos e o Report Builder (GaxWeb 5.0)

A tela de Relatórios: os prontos e o Report Builder Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Aplicativos › Relatórios guarda relatórios que cruzam os seus documentos e respondem perguntas que a lista não responde — principalmente documento faltando na numeração. Pode trazer relatórios prontos, e você pode criar os seus. Relatórios prontos que podem estar disponíveis ⚠️ Confira o que aparece na sua tela. A lista abaixo é o que existe no sistema; o que você enxerga depende do seu perfil e da Visibilidade de cada relatório. Se algum não aparecer para você, fale com o suporte. | Relatório | O que mostra | |---|---| | Quebra de Sequência - SAT | 🔎 As séries SAT do perfil onde há quebra entre o número inicial e o final — ou seja, documentos faltando. | | Sequenciamento - SAT | Verifica a sequência dos documentos SAT no período, identificando as lacunas. | | Apoio Escrituração - SAT | Resumo mensal de documentos SAT emitidos, processados e cancelados. | | Apoio Escrituração - CFe | O mesmo, para CF-e. | | Movimento Diário - CFe | Resumo diário de CF-e emitidos, processados e cancelados. | | Sequência NFCe | Sequenciamento das NFC-e. | | Quebra NFCe | As quebras de sequência nas NFC-e. | | Apoio CFe | Apoio à escrituração de CF-e. | 📅 Rotina que vale ouro no fechamento do mês: rode Quebra de Sequência e Sequenciamento antes de entregar ao contador. Documento faltando na numeração é exatamente o que o fisco cobra depois — e é o tipo de coisa que ninguém percebe olhando a lista de notas. As colunas | Coluna | O que mostra | |---|---| | ID | Número do relatório. | | Nome | Como ele se chama. | | Descrição | O que ele faz. | | Visibilidade | 👁️ público (todos do perfil veem) ou privado (só quem criou). | | Usuário | Quem criou. | | Criação / Atualização | Quando foi criado e alterado. | Filtro no cabeçalho para ID, Nome e Descrição. O que fazer com um relatório Botão direito sobre a linha: | Ação | O que faz | |---|---| | Visualizar relatório | Roda e mostra o resultado. | | Editar relatório | Abre para alterar. | | Exportar Excel | 📗 Baixa o resultado em Excel. | | Excluir | Remove o relatório. | | Recarregar item | Atualiza a linha. | E o botão Novo relatório, no topo, abre o construtor. 💡 Precisa de um relatório recorrente? Crie uma vez e deixe público — a equipe inteira passa a usar o mesmo, e ninguém refaz filtro toda semana. A tela por partes As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais. Os ícones do canto superior direito | Ícone | O que faz | |---|---| | 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. | | 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. | | ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". | | 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. | | ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. | 🧹 Tela bagunçada? Há também 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. Mexe só no seu navegador, não altera dado nenhum. Reload, Registros e páginas No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé. ⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar. A lista rola para o lado As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa. Como filtrar 1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna. Os três se somam. 🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu". O painel tem duas seções Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro. Abrir, editar e o histórico Botão direito sobre a linha: | Ação | O que faz | |---|---| | Editar | Abre o cadastro. | | Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. | | Recarregar item | Atualiza só aquela linha. | ⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado. 🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar. Ao salvar, a janela não fecha Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar. Se um relatório que você usava não está aqui Se você usava algo na versão 4.6 que não aparece: 1. Confira a Visibilidade — se foi criado como privado por outra pessoa, ele não aparece para você. 2. Veja se o filtro Situação do painel não está escondendo registros. 3. Se mesmo assim não achar, fale com o suporte informando o nome do relatório como era usado antes. Nem tudo que existia na 4.6 tem equivalente pronto aqui — alguns precisam ser recriados no construtor.

Onde ficava na 4.6, onde fica na 5.0 (mapa de migracao)

Aplica-se a: GaxWeb 4.6 e 5.0 — apurado em 27/08/2026 Está migrando e não acha alguma coisa? Esta página é o mapa de tradução: onde ficava antes → onde fica agora. O menu inteiro, lado a lado | 4.6 | 5.0 | |---|---| | Documentos | Documentos | | Aplicações | Aplicativos | | Monitor | Monitores | | Administração | Administração | | Sistema | — (virou área interna) | | — | Segurança ← novo | O que mudou de lugar | O que você procura | Na 4.6 | Na 5.0 | |---|---|---| | Relatórios | Documentos › Relatórios | Aplicativos › Relatórios | | GaxUp | Aplicações › GaxUp | Aplicativos › GaxUP | | GaxDown | Aplicações › GaxDown | Aplicativos › GaxDown | | Exportação | Documentos › Exportação | Documentos › Exportação (mesmo lugar) | | Perfil | Administração › Perfil | Administração › Perfis | 📊 O caso mais comum: os Relatórios saíram de Documentos e foram para Aplicativos. Quem procura onde estava conclui que sumiram — e eles estão lá. O que a 5.0 tem e a 4.6 não tinha | Novidade | Onde | |---|---| | Grupos de Empresas e Grupos de Permissões | Segurança — menu novo | | NFS-e | Documentos › NFS-e | | Monitor de NFS-e e de NFC-e/SP | Monitores | | eCac | Aplicativos | | Public Links | Aplicativos | | gaxweb-agent | Aplicativos | 🔐 Segurança é a maior novidade — e a que mais muda o dia a dia de quem tem vários usuários. Na 4.6 não havia grupos: agora dá para definir quais empresas cada pessoa enxerga e o que ela pode fazer. Os tipos de documento | Documento | 4.6 | 5.0 | |---|---|---| | NF-e | ✅ NFe | ✅ NF-e | | CT-e | ✅ CTe | ✅ CT-e | | CT-e OS | ✅ CTeOS | ✅ CT-e OS | | SAT | ✅ Sat | ✅ Sat | | NFC-e | ✅ CFe | ✅ NFC-e | | NFS-e | ❌ | ✅ novo | Diferenças de comportamento que geram dúvida Além de mudar de lugar, algumas coisas funcionam diferente. As principais: Quais empresas o usuário enxerga. Na 5.0, para o Usuário padrão, o acesso é concedido: ele vê apenas as empresas vinculadas a ele (uma a uma ou por Grupo de Empresas). Confira em Administração › Usuários → aba Empresas. Ligar o monitor são dois campos. Na aba Monitor da empresa, cada documento tem Ativo/Inativo (é o que liga) e Ciclo (a janela de horário). Definir só o Ciclo não liga nada. O botão direito virou o caminho principal. Várias ações existem só nele: Exportar XML/PDF nas listas, Efetuar download e Gerar link público na Exportação, Alterações em toda a Administração. Duplo clique não abre nada. Para abrir um registro: botão direito → Editar. Para a lista completa do que mudou de comportamento, veja O que mudou da versão 4.6 para a 5.0. Como saber em qual versão você está Olhe o menu lateral: - Tem Segurança e Aplicativos → você está na 5.0 - Tem Aplicações, Monitor e Sistema → você está na 4.6 ⚠️ Não use o botão azul do canto superior direito para isso. Ele mostra o destino da troca, não onde você está: quem está na 5.0 lê "Gaxweb 4.6" escrito nele.