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.