Configurar a sincronização contábil (Gerasoft)

A integração Gerasoft traz a contabilidade para dentro do Hap: um serviço Windows (HapGerasoftSync) lê o banco Firebird do Gerasoft e sincroniza, a cada 4 horas, empresas, plano de contas, históricos, centros de custo, lançamentos, movimentos fiscais e apurações de impostos. Com isso, o ERP monta o DRE Contábil, o Dashboard, o Fluxo Contábil e a previsão de folha/encargos e impostos nos relatórios de Fluxo de Caixa e Análise Financeira.

ContábilAtualizado em 17/09/2026

Quando usar

Use quando sua contabilidade roda no Gerasoft e você quer ver no Hap o DRE, o fluxo contábil, os impostos apurados e a previsão de saídas (folha, 13º, INSS, FGTS e impostos) sem digitar nada — os dados vêm direto da contabilidade.

Antes de começar

Módulo Contábil habilitado no seu plano.
Serviço HapGerasoftSync instalado no servidor onde fica o banco do Gerasoft (Firebird) — instalação feita pela equipe Hap/TI.
Acesso de administrador às Configurações do ERP.

O que é

A integração Gerasoft conecta a sua contabilidade (que roda no Gerasoft, banco Firebird) ao Hap. Um serviço Windows chamado HapGerasoftSync lê o Gerasoft no servidor e envia os dados para o Hap a cada 4 horas (intervalo configurável). São sincronizados empresas, filiais, plano de contas, históricos, centros de custo, lançamentos contábeis, movimentos fiscais e apurações de impostos (federais e ICMS).

Com esses dados, o Hap monta o DRE Contábil, o Dashboard Contábil e o Fluxo Contábil e ainda projeta a folha/encargos e os impostos como a camada Previsto (Contábil) nos relatórios de Fluxo de Caixa e Análise Financeira.

Como acessar

Vá em Configurações > Integrações > Contábil Gerasoft. No topo, o selo Serviço ativo mostra se a sincronização está ligada.

Tela Contábil Gerasoft: Conexão com o serviço, Gerar nova chave e Dados para o serviço (appsettings.json).

Passo a passo da configuração

1
Em Conexão com o serviço, clique em Gerar nova chave (rotacionar). A chave (API Key) só é exibida no momento em que é gerada — copie e guarde; se perder, gere outra.
2
Em Dados para o serviço (appsettings.json), copie a URL da API (Hap.BaseUrl) e o Token da empresa (Hap.Token) usando os botões Mostrar/Copiar.
3
No servidor onde está o Gerasoft, cole a chave, a URL e o token na seção Hap do appsettings.json do serviço HapGerasoftSync e reinicie o serviço.
4
Confira que o serviço Hap Gerasoft Sync está Em execução no Gerenciador de Serviços do Windows (services.msc).
Serviços do Windows: Hap Gerasoft Sync em execução (início automático).
5
De volta à tela, ajuste a Frequência (horas entre ciclos) e mantenha o Serviço ativo em Sim. A URL de callback é opcional.

Como acompanhar e sincronizar manualmente

Mais abaixo na tela você dispara uma sincronização na hora e acompanha o que entrou. Em Recurso, escolha Tudo (ciclo completo) ou um recurso específico e clique em Disparar sincronização. As abas Histórico de sincronização e Logs detalhados mostram cada execução com status (SUCESSO/ERRO) e a quantidade de registros recebidos, inseridos e atualizados.

Disparar sincronização por recurso, Resetar e re-sincronizar e o Histórico de sincronização.

O que você passa a ver

Com a sincronização rodando, o menu Contábil mostra os relatórios montados a partir do Gerasoft:

DRE Contábil: receitas, custos, despesas e resultado por período.

Dashboard Contábil: KPIs, evolução mensal, provisões e impostos previstos.

Fluxo Contábil (regime de competência) com previsão de saídas.

Além disso, os relatórios operacionais do Financeiro ganham a camada Previsto (Contábil) — folha/encargos (salários, INSS, FGTS e férias), 13º e impostos — exibida à parte, sem somar ao realizado:

Fluxo de Caixa com a camada Previsto (Contábil).

Análise Financeira com o painel Previsto (Contábil).

Problemas comuns

Serviço inativo ou Última execução antiga: confira no servidor se o serviço Hap Gerasoft Sync está Em execução (services.msc) e se o Firebird do Gerasoft está no ar.
Último heartbeat parado: o serviço caiu ou a chave está errada — gere uma nova chave, atualize o appsettings.json e reinicie o serviço.
Autenticação falhou (401): a chave foi gerada para outra URL/ambiente. Gere a chave nesta tela (mesma URL que o serviço usa) e cole no appsettings.json.
Faltam lançamentos: use Resetar e re-sincronizar (completo) — o serviço zera o ponto de leitura e relê tudo, sem duplicar.
Impostos previstos zerados no Fluxo de Caixa: o imposto só aparece quando a apuração tem vencimento dentro do período do relatório; competências antigas ou já pagas não entram. ICMS com saldo credor não gera valor a recolher.
DRE ou telas contábeis vazias: confira o período e a empresa selecionada; os dados aparecem após o primeiro ciclo de sincronização concluído.