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.
- Cadastre o novo pelo Assistente, vinculando às mesmas empresas; ou
- 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.