<!-- GERADO AUTOMATICAMENTE por paginas/montar.py.
     NAO EDITE ESTE ARQUIVO: edite paginas/_fonte/ e rode montar.py.
     O bloco comum vem de _fonte/comum-listas.md -- fonte unica, para que os
     artigos das varias telas nao possam divergir entre si. -->

# 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 &lt;nome&gt; (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**.