# GaxUP e GaxDown: enviar e receber XML pelo computador > **Aplica-se a:** GaxWeb 5.0.0 (alpha) — update 27.08.2026 **GaxUP** e **GaxDown** são programas instalados no seu computador que ligam uma **pasta local** ao GaxWeb: | Programa | O que faz | |---|---| | **GaxUP** | ⬆️ **Envia** para o GaxWeb os XML que estão numa pasta sua. | | **GaxDown** | ⬇️ **Baixa** para uma pasta sua os XML que o GaxWeb capturou. | > 🎯 **Qual usar?** *"Tenho XML no meu computador e quero que entrem no GaxWeb"* → > **GaxUP**. *"Quero que as notas capturadas caiam numa pasta para o meu sistema > ler"* → **GaxDown**. As duas telas são **iguais** — mesmas colunas, mesmos filtros, mesmo botão. O que muda é o sentido do transporte. > 📦 **O GaxUP lê ZIP — não precisa descompactar.** Pode jogar na pasta o pacote > do jeito que ele veio: exportação de outro sistema, backup do contador, o ZIP > que o fornecedor mandou. Ele abre e envia os XML de dentro. > > Isso muda o esforço de uma carga grande: **milhares de notas viram arrastar > alguns arquivos**, em vez de descompactar tudo antes. E, como **arquivo > repetido não duplica** (volta com o status *Já processado*), dá para soltar de > novo um pacote que você já mandou, sem medo — é o jeito seguro de garantir que > nada ficou para trás. ## As colunas | Coluna | O que mostra | |---|---| | **Status** | Estado do terminal. | | **Nome/Hwid** | Como você o chamou e a identificação da máquina. | | **Versão** | A versão instalada. | | **Atividade** | 🕐 Quando falou com o GaxWeb pela última vez. | | **Processamento** | Quando processou pela última vez. | | **Computer** | 💻 O nome do computador. | | **Path** | 📁 **A pasta** ligada ao GaxWeb. | | **IPs** | De onde acessou. | **Filtro no cabeçalho** para ID, Nome/Hwid e Computer. **Botão:** *Novo terminal*, no topo. **Botão direito** sobre o terminal: | Ação | O que faz | |---|---| | **Atividade** | O histórico de atividade daquele terminal. | | **Informações do computador** | Dados da máquina. | | **Download do instalador** | 📦 Baixa o instalador. | | **Recarregar item** | Atualiza a linha. | > ⚠️ **Aqui não existe "Destravar HWID".** Essa ação é do **gaxweb-agent › > Terminais**, que é outro programa. Se você trocou de computador e usa GaxUP ou > GaxDown, fale com o suporte — não há botão de destravar nesta tela. > 📁 **A coluna Path é a primeira a conferir** quando algo não funciona: se a pasta > mudou de lugar, foi renomeada, ou está num drive de rede que desconectou, o > programa não acha nada — e o status vira **Sem Diretório**. ## Os status que aparecem aqui | Status | O que aconteceu | O que fazer | |---|---|---| | **Sem Diretório** | A pasta configurada não existe (ou mudou). | Confira a coluna **Path** e o caminho na configuração. | | **Sem Comunicação** | Não está falando com o GaxWeb. | Computador ligado? Internet? Serviço rodando? | | **Sem Importação** | Comunicou, mas não havia arquivo novo. | Normal se nada foi emitido. | | **Já processado** | O arquivo já tinha sido enviado. | Não é erro — evita duplicidade. | ## 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. ## GaxUP, GaxDown ou gaxweb-agent? As três coisas enviam arquivos, e a diferença confunde: | | Para que serve | |---|---| | **GaxUP / GaxDown** | Uma **pasta** do computador, num sentido só (subir ou baixar). | | **gaxweb-agent** | Mais completo: **tarefas agendadas**, lotes, logs e controle por HWID. Típico de PDV. | ### Várias empresas no mesmo servidor? Um GaxUP basta Não é preciso um por empresa. **Um único GaxUP atende todas as empresas do perfil** — ele se baseia no **cadastro de empresas** do seu perfil no GaxWeb para saber a quem cada arquivo pertence. > 🏢 Isso resolve o caso comum de **contabilidade ou grupo com várias lojas** que > guarda os XML de todos os CNPJ no mesmo servidor: instala um, aponta a pasta, e > o GaxWeb distribui cada arquivo para a empresa certa. ## Perguntas frequentes **"Quero trazer os XML que estão no meu computador."** É o **GaxUP**. Instale, aponte a pasta e ele envia sozinho. **"Tenho o histórico em vários ZIP. Preciso descompactar antes?"** **Não.** O GaxUP lê o ZIP e envia os XML de dentro. Jogue os pacotes na pasta do jeito que estão. **"Estou saindo de outro sistema e quero trazer todo o meu histórico."** Exporte os XML no sistema de origem — de preferência **ano a ano**, que fica mais leve — e solte os arquivos (ou os ZIP) na pasta do GaxUP. **Um único GaxUP dá conta de todos os seus CNPJ**, distribuindo cada nota para a empresa certa. Se algum pacote foi enviado duas vezes, o repetido é ignorado. **"As notas baixam no GaxWeb mas não caem na minha pasta."** É o **GaxDown** que faz isso. Confira a coluna **Path** e o status do terminal. **"O terminal aparece mas a Atividade é antiga."** O programa não está rodando ou o computador está fora do ar.