<!-- 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. -->

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