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