O Sincroniza Notas® é o módulo oficial da Qive desenvolvido para automatizar a gestão de documentos fiscais eletrônicos (DFes). Ele atua como uma ponte inteligente entre o seu servidor local e a nossa conta na nuvem, garantindo segurança, integridade e conformidade fiscal sem esforço manual.
Neste artigo, você vai entender as vantagens de utilizar a versão executada como serviço em segundo plano (background) e o passo a passo para realizar a instalação no Windows ou Linux.
💡 Rodar o Sincroniza Notas® como serviço garante que a sincronização continue acontecendo de forma contínua, mesmo que a máquina seja reiniciada e nenhum usuário esteja logado nela.
Por que utilizar o Sincroniza Notas® como Serviço?
Uma gestão de XMLs dependente de processos manuais abre margem para esquecimentos, atrasos e erros de digitação. Ao ativar o Sincroniza Notas®, você ganha:
Disponibilidade Contínua: O sistema inicia automaticamente junto com o sistema operacional. Se o seu servidor reiniciar de madrugada após uma atualização, a sincronização volta a rodar sozinha, sem precisar que alguém faça login na máquina.
Automação de Entrada e Saída: O módulo monitora pastas locais continuamente para enviar documentos emitidos pelo seu ERP direto para a Qive, enquanto baixa as notas recebidas direto para o seu ambiente local.
Conformidade com a Lei da Guarda: Garante o armazenamento seguro em nuvem de todo o seu histórico fiscal dos últimos 5 anos, eliminando o risco de multas pesadas por perda de XMLs.
Gestão Multicompanias Centralizada: Baixe e organize XMLs de múltiplos CNPJs de uma só vez, com regras de subpastas personalizáveis para o seu servidor.
Requisitos Prévios para Instalação
Antes de iniciar, certifique-se de cumprir os seguintes critérios:
Desinstalação: Remova a versão padrão (interface visual) do Sincroniza Notas caso ela já esteja instalada na máquina.
Acesso: Privilégios de Administrador (Windows) ou Root/Sudo (Linux).
Arquitetura: Compatível com Windows de 32 bits (x86) e 64 bits (x64) ou Linux (x64).
Sistema Operacional: Windows 10/11, Windows Server 2016 (ou superior), Ubuntu 18.04, Debian 9 ou CentOS 7+.
Espaço em Disco: Mínimo de 100 MB para a instalação e 1 GB recomendado para o armazenamento local de notas.
Download e Preparação
Baixe o pacote correspondente ao seu sistema operacional e extraia os arquivos na pasta de sua preferência (Ex: C:\Instalador_Sincronizador).
Linux: Baixar arquivo
Windows 386: : Baixar arquivo
Windows x64 (64 bits): Baixar arquivo
Verifique se os seguintes arquivos estão presentes na pasta:
backend-service.exe: O "coração" do serviço.
daemon-server-setup.exe: Utilitário para configurações.
install-service.ps1: Script automatizado de instalação.
uninstall-service.ps1: Script de remoção.
Passo a Passo de Instalação
🔸No Windows
Abrir o PowerShell como Administrador: Pressione a tecla Windows, digite PowerShell, clique com o botão direito sobre ele e selecione Executar como Administrador.
Acessar a pasta dos arquivos: Digite o comando abaixo (ajuste o caminho conforme a pasta onde você extraiu os arquivos):
cd "C:\\Caminho\\Para\\Sua\\Pasta"
Executar o Instalador: Inicie o processo com o comando:
.\install-service.ps1
🔸No Linux
Abrir o Terminal: Acesse o terminal da sua distribuição (Ubuntu, Debian, CentOS, etc).
Acessar a pasta e dar permissão: Navegue até a pasta e garanta que o script seja executável:
cd /caminho/para/sua/pasta
chmod +x install-service.shExecutar o Instalador: Inicie o processo com privilégios de superusuário:
sudo ./install-service.sh
Após a instalação (para ambos os sistemas)
Após rodar o comando de instalação, o sistema iniciará uma janela interativa ou prompt:
Autenticação: Insira seu e-mail e senha de acesso à conta Qive.
Pastas: O sistema perguntará onde as notas devem ser salvas (Upload/Download). Se estiver na dúvida, aceite os caminhos padrões sugeridos pressionando Enter.
Serviço: Ao final, o instalador registrará o serviço (QiveDaemonServer) para iniciar automaticamente com o sistema.
Estrutura de Pastas e Gerenciamento
Finalidade | Windows (Padrão) | Linux (Padrão) |
Binários | C:\Program Files\DaemonServer (Em sistemas 64 bits emulando 32 bits, a pasta será Program Files (x86)) | /usr/local/bin |
Dados/Logs | C:\ProgramData\DaemonServer | /var/lib/daemon-server |
Status do Serviço | Get-Service QiveDaemonServer | systemctl status QiveDaemonServer |
Reiniciar | Restart-Service QiveDaemonServer | sudo systemctl restart QiveDaemonServer |
Windows 32 bits: Se o seu sistema for 32 bits, o caminho dos arquivos será o mesmo, a menos que esteja em um sistema 64 bits emulando 32 bits, onde a pasta será C:\Program Files (x86)\DaemonServer.
Formas de Gerenciamento do Serviço (QiveDaemonServer)
Via PowerShell (Comandos rápidos para Windows)
Verificar se está rodando: Get-Service -Name QiveDaemonServer
Iniciar: Start-Service -Name QiveDaemonServer
Parar: Stop-Service -Name QiveDaemonServer
Reiniciar: Restart-Service -Name QiveDaemonServer
Via Interface Visual do Windows (Services.msc)
Pressione Win + R, digite services.msc e dê Enter.
Localize o serviço QiveDaemonServer na lista.
Clique com o botão direito para realizar as ações de Iniciar, Parar ou Reiniciar.
Resolução de Problemas
Erro: "A execução de scripts foi desabilitada" (Windows)
Causa: Política de segurança do Windows bloqueando scripts .ps1 locais.
Resolução: Execute o comando abaixo no PowerShell como Administrador e tente instalar novamente.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
O serviço não inicia ou parou de funcionar sozinho
Ação: analisar as últimas 20 linhas do arquivo de log para identificar o erro raiz
No Windows: Get-Content "C:\ProgramData\DaemonServer\logs\*.log" -Tail 20
No Linux: sudo journalctl -u QiveDaemonServer -n 20
Causas mais comuns:
Erro de digitação nas credenciais (e-mail ou senha).
Falta de permissão de escrita/leitura na pasta selecionada para o download das notas.
Servidor local sem acesso à internet ou retido no Firewall corporativo.
O cliente precisa alterar o e-mail ou a pasta de sincronização mapeada
Cenário: Mudança de e-mail de integração ou novo diretório de rede.
Resolução: Não é necessário desinstalar e reinstalar o serviço. Basta rodar o utilitário de configuração em produção:
No Windows (PowerShell): & "C:\Program Files\DaemonServer\daemon-server-setup.exe"
No Linux (Terminal): sudo /usr/local/bin/daemon-server-setup
Falha de Permissão no Ambiente Linux
Causa: O instalador cria um usuário próprio chamado daemon-server, e este usuário perdeu ou não tem direito de acesso às pastas de upload/download.
Resolução: Garanta a propriedade das pastas rodando o comando:
sudo chown -R daemon-server:daemon-server /caminho/da/sua/pasta
❌ Desinstalação
Caso precise remover o serviço do servidor:
Acesse a pasta onde estão os scripts originais via terminal (como Administrador no Windows ou Sudo no Linux).
Execute o script de remoção:
Windows: .\uninstall-service.ps1
Linux: sudo ./uninstall-service.sh
⚠️ Atenção: Os arquivos de log e configurações podem permanecer na pasta de dados (ProgramData ou /var/lib). Remova-os manualmente se desejar uma limpeza completa.
📢 Dúvidas? Caso encontre problemas ou precise de apoio na configuração, nosso time de suporte está totalmente à disposição para te ajudar!