Manual do FiscalSinc - Agente de Sincronização FiscalVault

📦 1. O que é o FiscalSinc?

O FiscalSinc é o agente em segundo plano que roda no seu computador ou servidor Windows. Ele monitora a pasta onde seu emissor/ERP (TOTVS Protheus, SAP, Linx, Sankhya, etc.) grava os XMLs e realiza o envio automático, seguro e transparente para o FiscalVault.

⚡

Executável 100% Compilado e Autocontido: Você não precisa instalar Python nem nenhum programa adicional. O arquivo FiscalVaultSyncGUI.exe já vem pronto para executar.

Sincronização Contínua: Detecta novos XMLs autorizados e envia em tempo real.
Download em Lote: Baixe todos os seus XMLs da nuvem organizados por pasta de Empresa/Filial.
Entrega Protheus GFE: Integração com a pasta MV_XMLDIR do ERP TOTVS.
Sem Duplicidade: Sistema inteligente que nunca envia a mesma nota duas vezes.
Bandeja do Sistema: Fica minimizado junto ao relógio do Windows com baixíssimo consumo de memória.

⚡ 2. Instalação com 1 Clique (Menos de 1 minuto)

1

Executar o Instalador

Dê um duplo clique no arquivo Instalar_FiscalSinc.bat. Ele copiará o aplicativo para C:\FiscalSinc e criará o atalho na Área de Trabalho.

2

Configurar Parâmetros

A URL da API já vem preenchida (https://fiscalvault.com.br/api/upload-xml). Basta selecionar sua pasta de XMLs e preencher seu usuário e senha.

3

Iniciar Monitoramento

Clique em "Salvar Configurações" e depois em "Iniciar Monitoramento". O agente já estará sincronizando!

ℹ️

Inicialização Automática: O FiscalSinc já fica configurado para abrir automaticamente com o Windows, garantindo que suas notas sejam guardadas sem que você precise lembrar de abrir o programa.

⚙️ 3. Tabela de Configuração dos Campos

Campo na Interface	O que preencher	Valor Padrão / Recomendado
URL do FiscalVault (API)	Endereço oficial do servidor FiscalVault.	`https://fiscalvault.com.br/api/upload-xml`
Pasta Local de XMLs (Saída)	Diretório onde seu ERP salva os arquivos XML emitidos.	`D:\ERP\XML_Saida` ou `C:\FiscalVault\XML_Saida`
Pasta de Download	Diretório onde serão salvos os arquivos baixados da nuvem.	`C:\FiscalVault\Downloads`
Intervalo de Varredura	Tempo (em segundos) entre cada checagem de novas notas.	`60` segundos
Usuário e Senha	Seu login e senha cadastrados no FiscalVault.	Suas credenciais do portal
Integração GFE (TOTVS)	Pasta de destino para entrega automática de fretes (CT-e).	`D:\protheus\xml-cte-gfe`

🎯 4. Principais Botões da Interface

🟢 Sincronizar Agora

Faz uma leitura imediata da pasta de saída e envia todas as notas novas na mesma hora.

🟣 Baixar Notas Agora

Baixa todos os XMLs guardados no portal diretamente para o seu computador em pastas organizadas.

🔵 Buscar CT-e (GFE)

Gatilho manual para entregar fretes (CT-e) diretamente na pasta do TOTVS Protheus.

🔄 Verificar Atualização

Verifica se há uma versão mais nova e atualiza o agente de forma automática.

🖥️ 5. Instalação em Servidores (Modo Silencioso 24/7)

Se você for instalar em um servidor onde não há usuário logado na tela o tempo todo, execute o arquivo Configurar_Tarefa_Agendada_SegundoPlano.bat com o botão direito ("Executar como Administrador"). Ele registrará o agente para rodar diretamente na inicialização do Windows.

🛠️ 6. Perguntas Frequentes e Dúvidas

⚠️

"O que acontece se a internet cair?"
O FiscalSinc continua monitorando seus arquivos locais. Assim que a conexão for restabelecida, todos os XMLs acumulados são enviados automaticamente para a nuvem.

⚠️

"Existe risco de reenviar notas duplicadas?"
Não! O agente possui um banco de dados local que registra cada nota enviada com sua chave de acesso e assinatura, impedindo reenvios duplicados.