# gaxweb-agent: Terminais, Tarefas e Uploads > **Aplica-se a:** GaxWeb 5.0.0 (alpha) — update 27.08.2026 O **gaxweb-agent** é o programa instalado num computador seu que envia arquivos ao GaxWeb sozinho — típico de quem tem **PDV** ou uma pasta onde os XMLs se acumulam. Em **Aplicativos › gaxweb-agent** há três telas, e elas contam a mesma história em três níveis: **quem envia** (Terminais), **o que roda** (Tarefas) e **o que chegou** (Uploads). ## Terminais: os computadores Cada linha é um computador com o agent instalado. | Coluna | O que mostra | |---|---| | **Nome / App Key** | Como você chamou o terminal e a chave dele. | | **HWID** | 🔑 A **identificação da máquina**. É o que amarra a licença àquele computador. | | **Versão** | A versão do agent instalada. | | **Atividade** | Quando o terminal falou com o GaxWeb pela última vez. | | **Último IP** | De onde ele acessou. | **Botões:** *Novo terminal* e o menu *Terminal*. O **botão direito** traz ações que não existem na barra: | Ação | O que faz | |---|---| | **Instalador pré-configurado** | 📦 Baixa o instalador **já com as credenciais** daquele terminal — não precisa configurar na mão. | | **Destravar HWID** | 🔓 Solta a amarração com a máquina. | | **Logs** | Mostra o que o agent registrou. É o primeiro lugar quando algo não funciona. | | **Hardware** | Dados da máquina. | > 💻 **Trocou o computador?** O HWID muda, e o terminal para. Use **Destravar > HWID** para soltar a amarração e instalar na máquina nova. > > 📦 **Instalando pela primeira vez?** Use o **Instalador pré-configurado**: ele já > vem com as credenciais e evita erro de digitação. ## Tarefas: o que roda, e quando Cada linha é uma rotina agendada num terminal. | Coluna | O que mostra | |---|---| | **Terminal** | Em qual computador roda. | | **Tipo** / **Nome** | O que a tarefa faz. | | **Cron** | ⏰ **A programação** — de quanto em quanto tempo roda. | | **Última exec.** | Quando rodou pela última vez. | | **Resultado** | Como terminou. | | **Execs** / **Falhas** | 📊 Quantas vezes rodou e **quantas falharam**. | **Botões:** *Nova tarefa* e o menu *Tarefa*. > 📊 **A coluna Falhas é o alarme.** Execuções subindo e falhas subindo junto > significa tarefa quebrada — veja os **Logs** do terminal. ## Uploads: o que chegou Cada linha é um **lote** de arquivos enviado. | Coluna | O que mostra | |---|---| | **Terminal** | Quem enviou. | | **Lote** | Identificação do lote. | | **Docs** | Quantos documentos vieram. | | **Tamanho** | O tamanho do lote. | | **Tent.** | Quantas tentativas de envio. | | **Recebido em** / **Processado em** | Quando chegou e quando foi processado. | | **Info** | 💬 **A mensagem sobre o lote** — onde aparece o motivo de uma falha. | **Botão direito:** *Baixar zip* e *Reprocessar*. > 🔁 **Lote com erro?** Leia a coluna **Info**, e use **Reprocessar** — não é > preciso reenviar do computador. > > ⏱️ **Recebido mas sem "Processado em"?** Ainda está na fila. Ligue o **Reload** > de 30s para acompanhar. > 🔎 Nas telas de **Tarefas** e **Uploads** há um ícone a mais no topo: **Filtrar > pelo ID do terminal**. É o atalho para ver tudo de um computador só. ## 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. ## Roteiro: "o terminal parou de enviar" 1. **Terminais** → a coluna **Atividade** é recente? Se não, o computador pode estar desligado, sem internet, ou o serviço parado. 2. **Status "Sem Diretório"?** A pasta configurada não existe mais no computador. 3. **Tarefas** → a coluna **Falhas** está subindo? 4. **Botão direito no terminal → Logs** — a resposta costuma estar aí. 5. **Uploads** → chegou algum lote hoje? Leia a coluna **Info**.