Passo a passo
Como configurar perfis do Integrador e escolher o sistema
Crie e edite os perfis do Integrador em Administração, escolha o sistema do ERP e veja o que cada sistema suportado pede para conectar.
Você cria, edita e exclui os perfis do Integrador na tela Configurações do Integrador, no HubCount BI Web. Um perfil guarda como o Integrador chega ao ERP contábil do escritório: o sistema, o DSN, o login e a senha. Depois de salvo, o perfil aparece na aba Perfil do Integrador instalado, para todos os usuários do escritório. Abaixo estão os passos, os campos e a lista de sistemas suportados.
Antes de começar
- Tenha a permissão da tela. O acesso à tela Configurações do Integrador vem da permissão de mesmo nome. Para criar, você precisa de Criar novo perfil de configuração. Para editar, de Editar perfil de configuração. Para excluir, de Deletar perfil de configuração. Veja Usuários e autorizações.
- Saiba o sistema contábil do escritório e escolha, na lista, o nome igual ao que o escritório usa.
- Tenha um login e uma senha de leitura do ERP. Peça ao responsável pelo ERP um usuário só para o Integrador.
- Tenha o nome do DSN, quando o sistema usa ODBC. O DSN é criado no computador onde o Integrador roda. Veja Como instalar e usar o Integrador.
Abrir a tela
- Abra o HubCount BI Web e entre com um usuário com a permissão da tela.
- No menu lateral, abra Administração.
- Clique em Configurações do Integrador.
O cabeçalho mostra o texto Gerencie os perfis de configuração do sistema e dois botões: Baixar o Integrador, que baixa o instalador, e Criar novo Perfil. A lista abaixo tem estas colunas:
| Coluna | O que mostra |
|---|---|
| Id Interno | O número do perfil. |
| Nome do perfil | O nome que você deu ao perfil. |
| Sistema | O sistema escolhido, com o mesmo nome da lista de sistemas. |
O campo Pesquisar... procura pelo nome do perfil ou pelo número dele. A lista mostra 10 perfis por página. Cada linha tem um menu com Editar e Deletar.
Criar um perfil
- Clique em Criar novo Perfil.
- Em Nome do perfil, digite um nome que diga o sistema e o uso. Por exemplo, “Domínio Contabilidade Exemplo”.
- Em Selecione o sistema, escolha o sistema. Digite parte do nome para filtrar a lista.
- Preencha os campos que aparecem para esse sistema. Todo sistema pede Login e Senha. A tabela de campos mais abaixo mostra o resto.
- Marque as opções de contas que valem para o seu ERP, se precisar.
- Clique em Salvar.
Ao salvar, a tela mostra Salvo com sucesso!, fecha a janela e atualiza a lista. A tela não avisa se você salvar sem escolher o sistema. Escolha o sistema antes de salvar.
Campos do perfil
Campos de todo perfil
| Campo | O que fazer |
|---|---|
| Nome do perfil | Nome livre. Aparece na lista da web e na aba Perfil do Integrador. |
| Selecione o sistema | Escolha o sistema contábil. Os campos abaixo mudam conforme a escolha. |
| Nome do DSN | Nome do DSN ODBC criado no computador do Integrador. A web esconde este campo no Focco e no Uau Globaltec. |
| Login | Usuário de leitura do ERP. |
| Senha | Senha desse usuário. O ícone de olho mostra ou esconde o texto. |
Campos que dependem do sistema
| Sistema | Campo | O que preencher |
|---|---|---|
| Focco | TSN do Servidor | Nome do servidor ou do banco de dados do cliente. |
| Focco | User Schema | O schema do usuário no banco Oracle. |
| Uau Globaltec | Link | O endereço do serviço. Peça à GlobalTec. |
| Uau Globaltec | Usuário | O usuário do serviço. Peça à GlobalTec. |
| Uau Globaltec | Token | O token do serviço. Peça à GlobalTec. |
| Questor | Buscar dados apenas da matriz ou filial | Caixa. Marque para buscar só os dados da matriz ou da filial da empresa. |
| Alterdata/AlterdataWeb SQL Server | Tabelas possuem prefixo 'Alterdata' | Caixa. Marque se o erro de tabela não encontrada aparecer ao integrar. |
Opções de contas
Estas cinco caixas aparecem para qualquer sistema.
| Opção | O que faz |
|---|---|
| Igualar quantidade de Dígitos das Contas | Completa o código da conta com zeros até o número de dígitos das contas analíticas do plano da empresa. Os zeros entram à esquerda. Veja Plano de contas da empresa. |
| Colocar zeros à direita | Faz os zeros entrarem à direita do código, no lugar da esquerda. Só tem efeito com a opção anterior marcada. A web deixa esta caixa desativada até você marcar a anterior. |
| Usar Código de conta reduzido como Identificador | Usa o código reduzido da conta como identificador. A classificação passa para o começo da descrição, no formato classificação, hífen, descrição. |
| Remover pontos da classificação/código da conta | Tira os pontos e os hífens da classificação ou do código da conta. |
| Usar tratamento para grande volume de dados | Esta caixa grava o perfil, mas o Integrador não usa o valor dela. Para ligar o tratamento de grande volume de dados no Protheus, use a opção de mesmo nome na aba Perfil do Integrador. |
Sistemas suportados
A coluna Onde aparece diz se o sistema está na lista da web e no Integrador ou só no Integrador. A coluna Campos no Integrador mostra o que a aba Perfil pede, além de Login e Senha. A coluna Impostos diz se o Integrador busca a apuração de impostos (DCTF Web e MIT) nesse sistema. Nos que dizem Não, a opção Integrar Apuração de Impostos não traz dados ou termina com erro.
| Sistema | Onde aparece | Campos no Integrador | Impostos |
|---|---|---|---|
| Alterdata/AlterdataWeb Postgres | Web e Integrador | Nome do DSN. Driver ODBC do PostgreSQL (32 bits). | Sim |
| Alterdata/AlterdataWeb SQL Server | Web e Integrador | Nome do DSN. | Sim |
| Apolo | Web e Integrador | Nome do DSN. | Não |
| Athenas | Web e Integrador | Nome do DSN. | Não |
| Consigo ERP | Web e Integrador | Nome do DSN. | Não |
| Consistem | Web e Integrador | Nome do DSN. | Não |
| CRM | Web e Integrador | Nome do DSN. | Não |
| CVSoft | Web e Integrador | Nome do DSN. | Não |
| Domínio | Web e Integrador | Nome do DSN. Data em Filtrar departamentos criados a partir de. | Sim |
| ERP Solution | Web e Integrador | Nome do DSN. | Não |
| Evolution | Web e Integrador | Nome do DSN. | Não |
| Focco - Oracle | Web e Integrador | TSN do Servidor e User Schema, sem DSN. | Não |
| Fortes | Web e Integrador | Nome do DSN. | Não |
| Linx | Web e Integrador | Nome do DSN. | Não |
| Mastermaq | Web e Integrador | Nome do DSN. | Não |
| NBS | Web e Integrador | Nome do DSN, Identificação do Banco e Utilizar ID de um Plano de Contas Contábil específico. | Não |
| NetCorp | Web e Integrador | Nome do DSN. | Não |
| Protheus | Web e Integrador | Nome do DSN, Nome do banco e Identificação do Banco. | Não |
| ProtheusWeb | Web e Integrador | Nome do DSN e URL servidor TOTVS. | Não |
| Questor | Web e Integrador | Nome do DSN. Driver Firebird ODBC (32 bits). | Sim |
| Questor Postgres | Web e Integrador | Nome do DSN. | Sim |
| Questor Saldos | Web e Integrador | Nome do DSN. | Sim |
| Sage MySql | Web e Integrador | Nome do DSN. Driver MySQL Connector/ODBC (32 bits). | Não |
| Sage Sql Server | Web e Integrador | Nome do DSN. | Não |
| Sapiens - Oracle | Web e Integrador | Nome do DSN. | Não |
| Sapiens/Senior | Web e Integrador | Nome do DSN. | Não |
| SCI Único - Firebird | Web e Integrador | Nome do DSN. Driver Firebird ODBC. | Sim |
| System | Web e Integrador | Nome do DSN. | Não |
| Teste Integracao | Web e Integrador | Nome do DSN. Envia dados fictícios, com a conta “Teste”. Use só para testar o Integrador. | Não |
| Uau Globaltec | Web e Integrador | Link, Usuário e Token, sem DSN. | Não |
| Winthor | Web e Integrador | TSN do Servidor, Identificação do Banco e Utilizar ID de um Plano de Contas Contábil específico, sem DSN no Integrador. | Não |
| Winthor - Query Padrao | Web e Integrador | TSN do Servidor e Identificação do Banco, sem DSN no Integrador. | Não |
| Agro | Só Integrador | Nome do DSN. Driver Firebird ODBC. | Não |
| Agrotitan Fazendas | Só Integrador | Nome do DSN. | Não |
| Fabric | Só Integrador | Client ID e Client Secret, sem DSN, login e senha. | Não |
| JB Cepil | Só Integrador | Nome do DSN. Driver Firebird ODBC. | Não |
| SAP Business One | Só Integrador | Nome do DSN, de um banco de empresa do SAP Business One. | Não |
Os conectores de parceiros aparecem na mesma lista da web e, no Integrador, em um campo separado, chamado Conectores Parceiros. Eles alimentam a opção Integrar Dados de Parceiros e não enviam balancete. Veja Parceiros.
| Conector parceiro | Campos no Integrador |
|---|---|
| Agrotitan Fazendas - Conector Parceiro | Nome do DSN. |
| Alterdata - Conector Parceiro | Nome do DSN. |
| Edamatec - Conector Parceiro | Nome do DSN. Driver MySQL Connector/ODBC (32 bits). |
| Senior - Conector Parceiro | Nome do DSN, mais as opções de matriz e filial, tesouraria e Oracle da tabela abaixo. |
Opções que só existem no Integrador
Estas opções aparecem na aba Perfil do Integrador, de acordo com o sistema escolhido. A web não mostra nenhuma delas.
| Opção | Sistemas |
|---|---|
| Considerar encerramento das contas? | Domínio |
| Buscar dados apenas da matriz ou filial | Domínio, NetCorp, Protheus, Questor, Questor Postgres, Senior (parceiro) |
| Buscar dados apenas da matriz | SCI Único |
| Buscar dados utilizando código da empresa | Domínio |
| Filtrar dados somente pelo codigo da filial. | Domínio |
| Filtrar contas de ativo e passivo para busca por centro de custo | Domínio, Protheus |
| Sincronizar centro de custos no Hubcount | Domínio, Linx, NBS, Protheus, Questor, Questor Postgres, Sapiens/Senior, Sapiens - Oracle |
| Opção sobre lançamento feito em conta sintética | Domínio, Questor |
| Ignorar lançamentos tipo fiscal? | Questor, Questor Postgres |
| Considerar código reduzido como chave primária? | Questor, Questor Postgres |
| Buscar lançamentos com centro de custo por conta | Questor, Questor Postgres |
| Buscar lançamentos de centro de custo apenas para contas de resultado | Questor, Questor Postgres |
| Erro de conexão com banco de dados ou tabela não foi identificada? | Alterdata Postgres, Alterdata SQL Server |
| Valores zerados ou possui diferença entre Hubcount e Alterdata? | Alterdata Postgres, Alterdata SQL Server |
| Buscar lançamentos por periodicidade? | Athenas |
| Considerar filiais? | Athenas |
| Usar lançamentos contabilizados e ignorar rateio. | Sapiens/Senior |
| Considerar saldos apenas de lançamentos sem centro de custo | Sapiens/Senior |
| Ignorar processamento de filiais | Linx, Sapiens - Oracle, Sapiens/Senior |
| Considerar contas padrão na busca da tesouraria | Sapiens/Senior, Senior (parceiro) |
| Aplicar ‘owner’ para banco Oracle | Sapiens - Oracle, Sapiens/Senior, Senior (parceiro) |
| Considerar encerramento trimestral | Linx, Winthor |
| Utilizar funções/views na busca de dados | Winthor, Winthor - Query Padrao |
| Usar tratamento para grande volume de dados | Protheus |
| Considera plano de contas padrão para todas as empresas | Protheus |
| Desconsiderar opção ‘Flag Saldo Lucros Perdas’ (Z) | Protheus |
| Utilizar tabelas de cadastro específicas. | Protheus |
| Utilizar cloud com autenticação | ProtheusWeb |
| Aplicar saldo de contas de resultado (3, 4 e 5) na conta 244010 | Fabric |
| Possui mais de uma empresa cadastrada? Utilize o “Meu Id” | Alterdata Postgres, Alterdata SQL Server, Fabric, Fortes, Protheus, Questor, Questor Postgres, SCI Único, Sapiens - Oracle, Sapiens/Senior |
A tela explica algumas delas ao passar o mouse:
- Buscar dados utilizando código da empresa: use quando o plano de contas do ERP está ligado a mais de uma empresa. O Integrador busca só os lançamentos da empresa selecionada.
- Filtrar dados somente pelo codigo da filial.: só funciona com a opção de matriz ou filial ligada. No Domínio, um lançamento da matriz pode estar ligado à filial. Esta opção filtra só o que é da filial.
- Filtrar departamentos criados a partir de: mostra só os centros de custo criados na data informada ou depois. Deixe em branco para mostrar todos.
- Buscar lançamentos por periodicidade?: busca o saldo anterior pelos lançamentos anteriores à data, no lugar da tabela de saldos. Use quando o saldo anterior das contas diverge entre a HubCount e o Athenas.
- Considerar filiais?: soma o balancete da matriz e das filiais na empresa selecionada.
- Possui mais de uma empresa cadastrada? Utilize o “Meu Id”: o “Meu Id” é o identificador que você cadastra na empresa. Veja Como cadastrar empresas.
Além dessas opções, a aba Perfil tem duas que valem para qualquer sistema: Iniciar servidor A3, para quem usa certificado A3 na DCTF Web, e Pasta para salvar logs.
Editar um perfil
- Na lista, abra o menu da linha do perfil e clique em Editar.
- Altere o que for preciso. O título da janela passa a ser Editar perfil e o nome do perfil.
- Clique em Salvar.
- No Integrador, abra a aba Perfil e clique no perfil na lista. Isso aplica as mudanças no computador.
A janela tem ainda o botão Abrir integrador. Ele chama o aplicativo instalado e abre a aba Perfil. Se o aplicativo não abrir, a tela avisa que ele não está instalado.
Excluir um perfil
- Na lista, abra o menu da linha do perfil e clique em Deletar.
- Na confirmação, leia a pergunta e clique em Confirmar. Para desistir, clique em Cancelar.
A pergunta da confirmação é Deseja realmente deletar esse perfil de configuração?. Depois de excluir, a tela mostra a mensagem “Integração deletada com sucesso.” e atualiza a lista. Não exclua um perfil que ainda está no agendamento do Integrador. O agendamento com vários perfis pula o perfil que não existe mais.
Exemplo: a Contabilidade Exemplo usa o Domínio
A Contabilidade Exemplo quer integrar o balancete da Aurora Comércio Ltda, que usa o Domínio.
| Campo | O que ela preenche |
|---|---|
| Nome do perfil | Domínio Contabilidade Exemplo |
| Selecione o sistema | Domínio |
| Nome do DSN | DominioContabilidade, o DSN que o TI criou no servidor do escritório |
| Login | O usuário de leitura que o TI criou no Domínio |
| Senha | A senha desse usuário |
| Opções de contas | Todas desmarcadas |
Depois de salvar, ela abre o Integrador no servidor, clica no perfil na aba Perfil e liga, só no Integrador, as opções do Domínio que o escritório precisa, como Buscar dados apenas da matriz ou filial. O próximo passo é integrar o balancete. Veja Como instalar e usar o Integrador.
Problemas comuns
- O botão Criar novo Perfil está desativado. Falta a permissão Criar novo perfil de configuração. Peça ao administrador do escritório.
- O sistema do meu ERP não está na lista. O Integrador só conecta os sistemas da tabela acima. Para outro ERP, envie o balancete por arquivo. Veja Como enviar balancete no HubCount BI.
- Mudei o perfil na web e o Integrador continua igual. Clique no perfil na aba Perfil do Integrador para aplicar.
- A integração falha com o perfil salvo. Veja Problemas de sincronização.