Manuais
Por Tiago Camara
Por Tiago Camara
Passo a passo das funções: monitores, exportação, etiquetas, relatórios, GaxUp/GaxDown e a API GaxDfe.
O que é o GaxUp, para que serve e como faço para usá-lo?
O GaxUp é um aplicativo criado com o objetivo de "varrer" as pastas e subpastas em máquinas locais, indicadas nos parâmetros, localizando documentos habilitados e enviá-los para armazenamento no GaxWeb. Ele busca NFe, CTe, CTeOS, CFe, SAT-CFe entre outros documentos disponíveis na guia Monitoramento na configuração do terminal. Como faço para usá-lo? Criando o terminal GaxUp no GaxWeb. O terminal GaxUp deve ser criado no GaxWeb e instalado na máquina que armazena os XMLs (ou que tenha acesso pela rede à pasta que os armazena). A indicação é instalar na máquina onde os XMLs estão armazenados, pois agiliza o processo e não fica dependente da rede. Para criar um terminal, acesse Aplicações >> GaxUp, clique em Cadastrar Terminal. Preencha o campo Nome (identificando a empresa/grupo), ative a flag "Iniciar com o Windows" e "iniciar minimizado" e clique em Cadastrar Terminal. Aparecerá "Terminal incluído com sucesso". Guia Monitoramento: habilite a flag dos documentos que deseja monitorar e enviar, e clique em Atualizar Terminal. Observação importante: dentro de cada tipo de documento podem existir duas flags adicionais: "Monitorar apenas documentos que tenham Protocolo de Autorização" e "Monitorar apenas documentos que tenham Assinatura Digital". Atenção: somente XMLs com protocolo e assinatura são válidos juridicamente perante a fiscalização; a responsabilidade da guarda de documentos sem protocolo/assinatura é exclusiva do administrador de perfil que ativar ou não esta verificação. Guia Diretórios: informe o caminho da pasta a ser monitorada (XMLs novos ou alterados). Sempre clique em Atualizar Terminal para salvar. É possível preencher também na hora de instalar o GaxUp no terminal. Guia Proxy: se a rede tiver proxy, ative "Utilizar proxy para conexão" e preencha versão HTTP, servidor, usuário e senha. Clique em Atualizar Terminal. Instalando o terminal GaxUp na máquina local. Selecione o terminal criado e clique em BAIXAR INSTALADOR. Será gerado um instalador gaxup_install.exe na pasta de download. Copie o .exe para a máquina que será monitorada. Observação importante (antes de instalar): 1) Se houver antivírus/firewall, pode haver alerta por ser um .exe desconhecido — aceite/inclua o gaxup.exe na lista de autorizados. 2) Em alguns casos o firewall do Windows bloqueia a execução — aceite. 3) Verifique se há proxy na rede e anote servidor, usuário e senha. Dê duplo clique no gaxup_install.exe para abrir o instalador. Caso ainda não tenha configurado a pasta, clique em Configurações >> guia Diretórios (escolha a pasta pelo explorador ou informe o caminho) e Salvar. Se houver proxy, use a guia Proxy (pode usar as configurações do sistema ou informar servidor/porta/usuário/senha) e Salvar. Se estiver tudo correto, o GaxUp comunicará com o GaxWeb informando o status TERMINAL ATIVO. Basta aguardar a varredura da pasta. Para acompanhar, acesse GaxWeb >> Aplicações >> GaxUp, selecione o terminal e clique em Atividade e/ou Documentos. Qualquer dúvida, estamos à disposição pelo Enviar Ticket ou pelo Chat.
Para que serve cada flag da configuração da empresa?
Primeiro, o que é uma flag? Uma flag é uma chave de opção onde você seleciona SIM ou NÃO. Veja para que serve cada flag da configuração da empresa cadastrada no GaxWeb. Seção NFe Monitorar NFe (Ambiente Nacional) emitida contra o CNPJ da empresa (necessário certificado digital válido): habilita o GaxWeb a monitorar e baixar as NF-e modelo 55. Obs.: após habilitar, a empresa entra numa fila de download (de 5 a 60 min) — a nota técnica da SEFAZ pede consultas de hora em hora, senão pode bloquear as portas de consulta. Obs. 2: o GaxWeb inicia o monitoramento 179 dias antes da data de cadastro da empresa, baixando o que estiver disponível no SEFAZ Nacional (normalmente os últimos ~30 dias, conforme o volume de entrada e saída). Força uma segunda coleta de NSUs nas últimas 6 horas (intervalo de reanálise em horas): força nova coleta de chaves e download de XMLs das últimas 6h; o intervalo ajusta a repetição conforme a demanda da SEFAZ sem bloqueio. Criada por causa de falhas nos servidores da SEFAZ que às vezes não entregam a lista completa na primeira coleta. Ciência da Operação — enviar automaticamente ao verificar nova nota: flag muito importante. Em alguns casos a SEFAZ não envia todas as notas na 1ª coleta (ficam com status AGUARDANDO) e só libera o download numa 2ª coleta mediante o envio da CIÊNCIA DA OPERAÇÃO. ATENÇÃO: Ciência da Operação é DIFERENTE de Confirmação da Operação (Manifestação do Destinatário). A ciência é usada só para a consulta da nota e não registra mais nada nos eventos. PORÉM em alguns estados (ex.: Rio de Janeiro), após 30 dias sem manifestação de desconhecimento/cancelamento por qualquer parte, a SEFAZ reconhece a nota como CONFIRMADA — podendo cobrar o registro dela como confirmada no SPED do período. Escolha com calma e em acordo com seu contador. Seção CTe: mesma lógica do NFe — monitorar CT-e do Ambiente Nacional (179 dias retroativos) e a segunda coleta de NSUs das últimas 6h. Seção MDFe: o MDF-e (Manifesto Eletrônico de Documentos Fiscais) substitui o documento em papel, com validade jurídica pela assinatura digital do emitente, e permite ao Fisco acompanhar as operações em tempo real. É emitido por transportadoras (prestações com mais de um CT-e) ou por empresas em operações com transporte próprio/arrendado/autônomo e mais de uma nota fiscal. Ao habilitar a flag, o GaxWeb passa a monitorar e baixar todos os MDF-e disponíveis no Ambiente Nacional. Seção SAT-CFe: Monitorar SAT/SP (Ambiente Estadual) emitidos pelo CNPJ da empresa (necessário certificado; exclusiva para contribuintes de SP). Inicia o monitoramento e download automático dos XMLs dos SATs emitidos nos últimos 7 dias a partir do cadastro. Possibilita os relatórios de Apoio à Escrituração e o Relatório Sequência SAT/SP (mostra falhas no sequenciamento de cupons, comuns quando os XMLs de SAT são buscados direto na base do cliente via GaxUP).
Gestão de Grupos de Permissões no GaxWeb
O GaxWeb acaba de lançar uma das funcionalidades mais aguardadas por gestores e administradores de sistemas: a Gestão de Grupos de Permissões. Com essa novidade, as organizações que utilizam o plano Corporativo ganham um nível inédito de controle sobre o que cada usuário pode acessar e fazer dentro da plataforma. Uma funcionalidade foi desenvolvida para atender empresas com estruturas complexas, múltiplas filiais ou diferentes níveis hierárquicos, onde a segmentação de acesso é essencial para garantir a segurança das informações e a eficiência operacional. O que são grupos de permissões? Grupos de Permissões são conjuntos configuráveis de regras de acesso que podem ser atribuídos a um ou mais usuários do sistema. Em vez de definir permissões individualmente para cada colaborador — um processo de trabalho e sujeito a erros —, o administrador cria um grupo com as configurações desejadas e simplesmente associa os usuários a ele. Essa abordagem, amplamente utilizada em sistemas corporativos robustos, chega ao GaxWeb com uma implementação moderna e intuitiva, adaptada à realidade das empresas brasileiras. Principais Funcionalidades Uma nova funcionalidade oferece um conjunto completo de recursos para a gestão granular de acessos: • Criação de grupos personalizados: defina grupos com nomes descritivos e associe funcionalidades específicas da plataforma a cada um deles. • Definição granular de funcionalidades: escolha exatamente quais módulos, menus e ações estarão disponíveis para cada grupo, garantindo que cada perfil de usuário acesse apenas o necessário. • Acesso restrito por empresa: configure quais empresas (CNPJs ou filiais) cada grupo pode visualizar e operar, ideal para grupos empresariais, franquias e holdings. • Gerenciamento centralizado: qualquer alteração feita no grupo é aplicada automaticamente a todos os usuários vinculados a ele, sem necessidade de ajustes individuais. • Auditoria e rastreabilidade: todas as configurações e alterações de grupos ficam registradas no histórico do sistema para fins de conformidade e auditorias. Casos de Uso Práticos A Gestão de Grupos de Permissões resolve desafios reais do dia a dia corporativo: Redes de franquias: cada franqueado acessa apenas os dados de sua própria unidade, enquanto uma franqueadora mantém visão global. Grupos empresariais: gestores de cada subsidiária têm acesso somente às informações de sua empresa, sem interferência nas demais. Segregação de funções: as equipes de RH, Financeiro e Operacional possuem perfis distintos, com acesso apenas às funcionalidades relevantes ao seu departamento. Auditores externos: acesso somente leitura a módulos específicos, sem risco de alterações indevidas. Disponível exclusivamente no Plano Corporativo A Gestão de Grupos de Permissões é uma funcionalidade exclusiva do Plano Corporate do GaxWeb. Esse plano foi criado para atender às demandas de empresas de maior porte, com estruturas organizacionais complexas e elevados requisitos de segurança e conformidade. Ao optar pelo plano Corporate, a empresa conta não apenas com a gestão avançada de permissões, mas também com um conjunto completo de recursos premium, suporte prioritário e maior capacidade de personalização da plataforma de acordo com as necessidades do negócio. Se a sua empresa ainda não utiliza o plano Corporate e deseja aproveitar este e outras funcionalidades exclusivas, entre em contato com nosso horário comercial e conheça todas as vantagens disponíveis. Conclusão A chegada da Gestão de Grupos de Permissões ao GaxWeb representa um avanço significativo na atualização da plataforma e no compromisso da empresa com a segurança da informação e a eficiência administrativa de seus clientes. Com essa funcionalidade, os administradores ganham autonomia, liberdade e tranquilidade de saber que cada usuário acessou exatamente o que precisa — nem mais, nem menos. A governança de dados deixa de ser um desafio e passa a ser um diferencial competitivo. GaxWeb — Inovação que simplifica a gestão do seu negócio.
API GaxDfe - Baixar documento único ou em lote do GaxWeb.
Endpoint: https://app.nssoft.com.br/webservice/gaxdfe/monitor/zip/ Parâmetros: - modelo: 55, 57, 59, 65 ou 67 (ex: modelo=55) - empresa: CPF/CNPJ, somente números (ex: empresa=12345678000123) - emissao: data no formato YYYY-mm-dd (ex: emissao=2022-12-30) - periodo (a partir de): 48h, 7d, 15d, 0m (mês atual), 1m..6m, 1y (ano atual), 2y..5y (ex: periodo=48h) - eventos: true/false — exporta eventos do documento (somente zip) - pdf: true/false — exporta PDF do documento (somente zip) Chave única: curl https://app.nssoft.com.br/webservice/gaxdfe/nfe/{CHAVE}/zip -H "appkey: {APPKEY}" Exemplo lote NFe (mod 55, últimos 2 meses): curl "https://app.nssoft.com.br/webservice/gaxdfe/monitor/zip?modelo=55&periodo=2m&empresa=12345678000123" -H "appkey: {APPKEY}" (adicione &eventos=true para incluir eventos) Retorno: HTTP 200 + arquivo anexo (máx 1000 por requisição). Repita as requisições até receber HTTP 204 (sem mais arquivos). Erros: 403 (permissão) e 400 (demais, com mensagem). Importante: a APPKEY fica em um terminal criado no menu Aplicações >> GaxDFe. Arquivos baixados são registrados e não voltam em nova requisição; para rebaixar, solicite desbloqueio ao suporte. Att, Equipe NSSoft
Monitor NFC-e SP – Importante: Uso do Certificado Digital Correto
Com base em análises recentes do funcionamento do Monitor NFC-e SP, identificamos uma limitação importante que impacta diretamente a consulta de cupons fiscais eletrônicos no estado de São Paulo. Como funciona a API do Monitor NFC-e SP A API utilizada pelo Monitor NFC-e SP possui uma estrutura simples, porém com uma restrição fundamental: ela não permite a escolha do CNPJ que será consultado. O CNPJ retornado na consulta é determinado exclusivamente pelo certificado digital utilizado na requisição. Isso significa que: - Não é possível utilizar o certificado de uma matriz para consultar NFC-e de uma filial ; - Não é possível utilizar o certificado de uma filial para consultar NFC-e da matriz ; - A consulta funciona somente quando o certificado digital pertence ao próprio titular do CNPJ consultado. Identificação no GaxWEB versão 5 Na versão 5 do sistema, o datagrid de empresas já sinaliza essa inconsistência de forma visual: empresas configuradas para consulta de NFC-e SP que estão vinculadas a um certificado de titularidade diferente do seu próprio CNPJ serão exibidas em vermelho , alertando o operador sobre a configuração incorreta. Perspectiva de adequação pelo SEFAZ SP Até o momento, não há indicativo de que o SEFAZ SP realizará qualquer adaptação para aceitar certificados com mesmo prefixo de CNPJ (como no caso de matriz e filiais). Portanto, não recomendamos aguardar essa possível mudança. O que fazer Caso o cliente necessite baixar NFC-e SP, orientamos que: 1. O cliente adquira o certificado digital correspondente ao CNPJ específico de cada empresa; 2. O certificado seja atualizado corretamente no GaxWEB antes de realizar novas consultas. Essa medida garante o pleno funcionamento do monitor e evita falhas na captura dos documentos fiscais. Equipe de Suporte NSSoft/GaxWEB Qualquer dúvida, estamos à disposição pelos nossos canais de atendimento.
API GaxDfe - Integração Etiquetas do GaxWeb.
Esta API permite criar, associar e desassociar etiquetas personalizadas nos documentos armazenados no GaxWeb. Criar etiqueta — POST https://api.nssoft.com.br/api/etiqueta curl -X POST 'https://api.nssoft.com.br/api/etiqueta' -H 'Content-Type: application/json' -H 'Authorization: Bearer {APIKEY}' -d '{ "nome": "TT", "descricao": "Teste via API", "cor": "#134f55", "tipo_id": "1", "info": "info" }' Associar etiqueta ao documento — PUT https://api.nssoft.com.br/api/documentos/{CHAVE}/{ETIQUETA} curl -X PUT 'https://api.nssoft.com.br/api/documentos/{CHAVE}/TT' -H 'Authorization: Bearer {APIKEY}' Desassociar etiqueta — DELETE https://api.nssoft.com.br/api/documentos/{CHAVE}/{ETIQUETA} curl -X DELETE 'https://api.nssoft.com.br/api/documentos/{CHAVE}/TT' -H 'Authorization: Bearer {APIKEY}' Observação: a {APIKEY} está disponível através do suporte; a {CHAVE} está no documento eletrônico; a {ETIQUETA} é a legenda criada em Administração >> Etiquetas (padrão até 3 caracteres). Att, Equipe NSSoft
Como baixar notas de saída de empresas emitentes.
Caso deseje baixar automaticamente as notas emitidas (notas de saída) de qualquer empresa através do seu certificado digital no GaxWeb, basta pedir à empresa emitente que inclua seu CNPJ/CPF na tag autXML no XML do documento fiscal emitido. A funcionalidade gera o XML com a informação do CNPJ ou CPF das pessoas autorizadas a obter o XML da NF-e no portal nacional: autXML(string CNPJ, string CPF). IMPORTANTE: a SEFAZ não permite informar o CNPJ/CPF do próprio destinatário na tag autXML (é redundante) — não é necessário. Exemplo com CNPJ: 12345678000191 Exemplo com CPF: 12345678912
API GaxDfe - Enviar arquivos para o GaxWeb.
O envio de arquivos via API para o GaxWeb é simples. Acesse o GaxWeb, menu Aplicações >> GaxDFE, clique em + e crie um terminal, onde terá acesso ao APIKEY. Envie o arquivo via POST para: https://app.nssoft.com.br/webservice/gaxdata/{APIKEY}/dfe/upload Qualquer dúvida sobre este procedimento, entre em contato pelo chat ou envie um bilhete. Att, Suporte NSSoft