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
- Documento — o CPF/CNPJ. Sendo CNPJ, o GaxWeb consulta a ReceitaWS e preenche razão social e endereço sozinho.
- Dados — confira os dados.
- Certificado — anexe o A1 (.pfx).
- Monitores — escolha o que monitorar e o ciclo.
- 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.