Como instalar e usar o Integrador HubCount no Windows

Ao fim desta página o Integrador está instalado no Windows, entra na sua conta HubCount, usa um perfil do seu ERP contábil e integrou o balancete de uma empresa. Você também aprende a agendar a integração, a deixar o aplicativo rodando em segundo plano e a acompanhar logs e atualizações.

Antes de começar

Requisito	O que conferir
Sistema operacional	Windows com o .NET Framework 4.8. Sem ele, o login mostra o aviso “Erro ao abrir o integrador. Certifique-se de que o .NET Framework 4.8 está instalado.”
Tipo do aplicativo	O Integrador é de 32 bits. O DSN do ERP precisa existir no administrador ODBC de 32 bits.
Permissão no Windows	O instalador não pede administrador e instala só para o usuário que o executou.
Acesso ao ERP	O computador precisa alcançar o banco do ERP pelo DSN. No Uau Globaltec e no Fabric, precisa alcançar o serviço do sistema.
Acesso à HubCount	Libere o endereço api.hubcount.com.br. O Integrador usa esse endereço para entrar, enviar dados e buscar atualizações.
Conta HubCount	Um usuário com acesso às empresas que serão integradas.
Perfil	Um perfil do seu ERP já criado em Configurações do Integrador. Veja Como configurar perfis do Integrador.
Empresas	Cada empresa precisa de plano de contas. Veja Plano de contas da empresa.

Baixar e instalar

O Integrador aparece no menu Iniciar com o nome Integrador HubCount e cria o endereço hubcount://, que a web usa no botão Abrir integrador do perfil.

Criar o DSN do ERP

A maioria dos sistemas se conecta por um DSN ODBC. Faça isso uma vez, no computador do Integrador.

Crie o DSN no mesmo usuário do Windows que vai abrir o Integrador, ou como DSN de sistema. Não é preciso DSN no Focco, no Uau Globaltec, nos dois Winthor nem no Fabric.

Entrar no Integrador

O link Esqueceu a senha? abre a página de recuperação de senha da HubCount. Ao entrar, o aplicativo carrega as empresas que o seu usuário pode ver. Se o usuário tem a visibilidade de empresas limitada, só aparecem as empresas ligadas a ele ou aos grupos dele.

Aplicar um perfil

O Integrador só integra depois que um perfil está aplicado. Os perfis vêm da HubCount e são os mesmos da web.

Clicar em um perfil da lista já o aplica neste computador. Com o botão direito, o perfil tem o menu Duplicar perfil e Apagar perfil. Para apagar, o aplicativo pede confirmação com “Deseja realmente deletar esse perfil de configuração?”. O botão + ao lado do título Perfis cria um perfil novo, com o nome “Novo perfil”.

Enquanto uma execução periódica do Report está em andamento, o aplicativo não deixa trocar nem salvar perfil. Ele mostra “Uma execução periódica de Report está em andamento. Aguarde para trocar de perfil.”.

Integrar o balancete na mão

A lista de empresas tem estas colunas:

Coluna	O que mostra
#	A caixa para marcar a empresa.
Id e TenantId	O número da empresa e o da sua instância na HubCount.
Nome e CNPJ	O cadastro da empresa.
Últ. Dt. Atualização	Quando o último balancete chegou à HubCount.
Últ. Período	O mês do último balancete que chegou.

Os botões da aba são quatro:

Botão	O que envia
Integrar Report	Balancete e razão, para o BI contábil.
Integrar Apuração de Impostos	Apurações de impostos, que alimentam a DCTF Web e o MIT. Só os sistemas com “Sim” na coluna Impostos da tabela de sistemas trazem dados.
Integrar Dados de Parceiros	Dados do conector parceiro escolhido no perfil.
Iniciar Análise (Suporte)	Envia os dados brutos para a equipe de suporte analisar. Use só se o suporte pedir.

Se nenhum perfil estiver aplicado, o aplicativo avisa “Antes de iniciar, selecione um perfil na página de Configurações”. O perfil é escolhido na aba Perfil, não em Configurações.

Opções para integração

Opção	O que faz
Último mês com encerramento?	Indica que o último mês do período tem o encerramento. Só o Linx, o JB Cepil e o SAP Business One usam esta opção. Nos outros sistemas ela não muda nada.
Usar Centro de Custo?	Busca os balancetes por centro de custo. Para criar na HubCount os centros de custo do ERP, ligue Sincronizar centro de custos no Hubcount no perfil, nos sistemas que têm essa opção. Veja Centros de custo e departamentos.
Buscar sem centro de custo em conjunto?	Aparece com a opção anterior. Busca também o balancete sem centro de custo.
Data de e Data até	Primeiro e último mês do período. As duas datas são obrigatórias.

Agendar a integração

Na aba Periodicidade você define quando o Integrador roda sozinho. Há um bloco para o Report, um para os impostos e um para os dados de parceiros.

Opção	O que faz
Fragmentação de Busca	Busca um mês de cada vez, do mais recente ao mais antigo, e registra cada mês na aba Monitoramento. Mostra Período de fragmentação e Período máximo de atualização, com as opções Quinzenal, Mensal, Semestral e Anual.
Período máximo de atualização	Até onde o Integrador volta no tempo: quinzenal volta 15 dias, mensal volta 1 mês, semestral volta 6 meses e anual volta 12 meses.
Utilizar mais de um perfil configurado	Troca o botão de empresas por Perfis para Periodicidade. Ali você liga os perfis e escolhe as empresas de cada um. Uma empresa não pode estar em dois perfis ligados.

Sem a fragmentação, o Report e os impostos buscam os últimos três meses: do primeiro dia de dois meses atrás até o mês de ontem. Antes de cada execução, o Integrador entra de novo com o login salvo e espera até 30 segundos pela lista de empresas.

Monitoramento

A aba Monitoramento só funciona com a Fragmentação de Busca ligada. Sem ela, a aba pede para configurar a fragmentação. Escolha uma empresa e filtre por Período (ano), Período (mês) e Status. Cada linha é um período de uma empresa.

Status	Significa
Atualizado	O período chegou à HubCount.
Reagendado	O período falhou e o Integrador vai tentar de novo.
Erro	O período falhou depois das tentativas.
Sem status	Ainda não houve execução.

Quando um período falha, o Integrador tenta de novo 15 minutos depois, depois 1 hora e depois 3 horas. Se falhar de novo, o período fica em Erro. O botão de Forçar sincronização, na linha, tenta na hora. Para as tentativas automáticas funcionarem, o Integrador precisa estar aberto, por isso ligue o início com o Windows.

Deixar o Integrador rodando

O Integrador não é um serviço do Windows. Ele é um aplicativo que fica na bandeja, perto do relógio. O agendamento só roda enquanto o aplicativo está aberto.

Situação	O que acontece
Você fecha a janela	O aplicativo some da tela e continua na bandeja.
Você abre o atalho de novo	O aplicativo mostra a janela que já estava aberta. Só roda uma cópia por vez.
Menu da bandeja	Abrir Integrador mostra a janela. Sair encerra o aplicativo.
O Windows reinicia	O aplicativo só abre sozinho se Iniciar com o Windows estiver ligado.
O computador está desligado na hora agendada	A execução daquele horário não acontece. O Integrador não repete horários perdidos.
O Windows está sem sessão aberta	O aplicativo não roda. Em servidor, não faça logoff do usuário. Desconectar a sessão remota mantém o aplicativo rodando.

Para ligar o início com o Windows:

Acompanhar o que o Integrador fez

Onde	O que mostra
Janela final	Depois de uma integração manual, a janela Integrador HubCount mostra “Integração realizada com sucesso!” ou o erro de cada empresa.
Barra de baixo	Mostra a última mensagem de uma execução agendada e um indicador de que o Integrador está trabalhando.
Sino	Mostra avisos das tentativas de novo, como “Empresa … reagendada”.
Pasta de logs	Se você definiu Pasta para salvar logs, cada execução agendada do Report grava, para cada empresa, um arquivo com o nome log_integracao, o CNPJ, a data e a hora.
Aba Monitoramento	O status de cada período, com a fragmentação ligada.
Aba Integração	As colunas Últ. Dt. Atualização e Últ. Período de cada empresa.

Os arquivos temporários do envio ficam em %LocalAppData%\HubCount\Temp e são apagados depois do envio. Quando uma integração dá erro, o Integrador também avisa a HubCount, que guarda o erro no registro de auditoria com o nome “Integrador”.

Atualizar o Integrador

A atualização automática vem desligada. O que acontece depende dessa opção.

Situação	O que acontece
Atualizar automaticamente o Integrador desligado (padrão)	Ao abrir, e na hora da verificação periódica, aparece “Atualização disponível” com Sim e Não. Se a versão for obrigatória, aparece só Ok.
Atualizar automaticamente o Integrador ligado	Na hora da verificação periódica, o aplicativo baixa e reinicia sozinho. Se houver uma integração em andamento, ele espera o Integrador ficar parado. Ao abrir, ele só marca que existe versão nova.
Depois de reiniciar	Aparece na bandeja “Atualizado com sucesso para v…”.
A baixa falha	Aparece “Falha ao baixar atualização. Será tentado novamente no próximo ciclo.”

Em Configurações, o campo “Selecione a periodicidade de atualização automática do Integrador” define quando o Integrador procura atualização: todo dia em uma hora ou toda semana em um dia. O padrão é todo dia às 08:00. Para procurar na hora, use o ícone de atualização no rodapé do menu lateral, com a dica “Verificar se há atualizações do Integrador HubCount”. Um ponto nele indica que existe versão nova. As respostas possíveis são “Atualização em andamento”, “Atualização pendente” e “Não há atualizações no momento”.

Exemplo: a Contabilidade Exemplo integra a Aurora

A Contabilidade Exemplo usa o Domínio e já criou o perfil “Domínio Contabilidade Exemplo” na web.

No dia seguinte, o balancete da Aurora Comércio Ltda aparece no HubCount BI sem ninguém exportar planilha. Para conferir, abra o Data Lake.

Problemas comuns

• A aba Integração está vazia. O seu usuário não vê nenhuma empresa, ou ainda não carregou. Confira o cadastro em Como cadastrar empresas.
• “Empresa não tem plano de contas configurado”. Cadastre o plano de contas da empresa antes de integrar.
• “Sem movimento no período selecionado”. O ERP não tem lançamentos nos meses escolhidos.
• O agendamento não rodou. O Integrador estava fechado, a sessão do Windows estava encerrada ou o computador estava desligado.
• A janela do Integrador diz “Erro ao integrar”. Veja Problemas de sincronização, que lista as mensagens do aplicativo.

Onde continuar

• Como configurar perfis do Integrador
• Problemas de sincronização
• Como enviar balancete no HubCount BI
• Integrador ou Sync Agent: qual usar