Como instalar uma integração de parceiro no HubCount BI

Você instala a integração com o sistema do cliente (ERP, CRM, plataforma de marketing e outros) e o HubCount cria, para a empresa, as visões prontas daquele parceiro. Os dados do parceiro aparecem no BI ao lado dos dados contábeis. A instalação é feita por empresa, no Data Lake, na aba Explorar.

Antes de começar

• Tenha a permissão Conectores. Sem ela, a aba Explorar não aparece.
• Abra uma empresa. A aba só existe no Data Lake de uma empresa, não no de uma organização empresarial.
• Instale pelo endereço padrão do HubCount. Em um link personalizado (domínio próprio do escritório), a tela mostra: Atenção! Não é possível realizar integrações por meio de links personalizados. Por favor, realize a instalação através do site da HubCount. O botão Clique aqui para acessar abre o site padrão.
• Tenha em mãos a credencial do parceiro. O tipo muda de parceiro para parceiro: veja a tabela abaixo.

Instale um parceiro

RD Station e HubSpot têm um passo a mais

Os dois aceitam campos customizados e usam um assistente de três passos: Autenticação, Mapear Campos Customizados. e Templates. Depois da autenticação, a tela avisa: Autenticação realizada com sucesso. Por favor, selecione os campos customizados, se necessário. No passo de campos, o texto orienta: adicione os campos customizados com base nos valores disponíveis e, depois de selecionar todos, finalize a integração. O botão final é Finalizar integração.. Ao terminar, a tela mostra Integração finalizada. Aguarde alguns segundos, você será redirecionado para as configurações. e leva você ao Data Lake da empresa.

Depois da instalação

Quando termina, o HubCount mostra Integração instalada e templates aplicados com sucesso. O parceiro passa a aparecer em Minhas integrações, na lista Integrações de Parceiros Instaladas, com os botões Configurar e Remover Integração. As visões escolhidas ficam disponíveis no ícone de olho, como qualquer visão da empresa. Veja Visão Padrão e Apenas Contábil: o que cada aba mostra.

Se o parceiro não está na lista

O rodapé da aba tem o convite Não encontrou um conector para você? Nos envie como sugestão!, com um link para o formulário de sugestões.

Como cada tipo de autenticação funciona

Tipo	Como você entra	O que preencher
OAuth	Clique em Autenticar. O HubCount abre uma janela do parceiro, e você autoriza o acesso. Ao concluir, o assistente avança sozinho para o passo de templates.	Nada no HubCount. Use o login do parceiro na janela.
App Key e App Secret	Preencha os dois campos. O App Secret tem um botão de olho para mostrar o texto.	App Key e App Secret. Os dois são obrigatórios.
Access Token	Cole o token gerado no parceiro.	Access Token. Se o parceiro aceita vários tokens, depois da instalação você pode acrescentar tokens adicionais, com nome opcional.
Access Token e domínio	Cole o token e o domínio da loja.	Access Token e Domínio do Shopify.
Usuário, senha e URL	Preencha os três campos.	Usuário, Senha e URL.
Via Integrador	O assistente não pede campos. A conexão é feita pelo Integrador ou com o suporte.	Veja o texto de ajuda do parceiro.
Sem autenticação	Não há o que informar.	Nada.

Para vários parceiros, a tela mostra um texto de ajuda com o link da documentação do parceiro para gerar a credencial. Nos casos em que a conexão depende do suporte, o texto é Contate o suporte para realizar a conexão.

Os parceiros e o que cada um traz

A tabela lista os parceiros do código, na ordem do menu. O Cartão diz como a lista mostra o parceiro: Disponível quando o cartão abre os detalhes e Em breve quando o botão Em Breve está desativado.

Parceiro	Categoria	Autenticação	Atualização	Cartão	Visão pronta e abas
Conta Azul	Financeiro	OAuth	Diária	Disponível	Visão Conta Azul. Vendas: Geral, Detalhamento. Operacional: Visão Geral, Eficiência Financeira, Contas a Receber, Contas a pagar.
Omie	Financeiro	App Key e App Secret	Diária	Disponível	Visão Omie. Resultado: Geral, DRE. Caixa: Geral. Vendas: Geral, Produto, Serviços.
Nibo	Financeiro	OAuth	Diária	Disponível	Visão Nibo. Resultado: Resultado, Contas a Receber, Contas a Pagar.
Bling	Financeiro	OAuth	Diária	Disponível	Visão Bling. Caixa: Contas a Receber, Contas a Pagar.
Bom Controle	Financeiro	Access Token	Diária	Disponível	Visão Bom Controle. Receitas, Despesas, Fluxo de Caixa, DRE Bom Controle.
Edamatec	Financeiro	Via Integrador	Diária	Disponível	Visão Edamatec. Padrão.
Senior	Financeiro	Via Integrador	Diária	Disponível	Visão Senior. Padrão.
Alterdata	Financeiro	Via Integrador	Diária	Disponível	Usa a Visão Senior.
Agrotitan	Financeiro	Via Integrador	Diária	Disponível	Sem visão pronta.
Rud	Financeiro	Sem autenticação	Tempo real	Disponível	Visão Rud. Análise de Vendas: Pedidos de Vendas, Documento de Saída (Faturamento), Documento de Entrada (Devolução), Registro Portaria, Valores e percentuais de Metas.
Fortus	Financeiro	Sem autenticação	Tempo real	Disponível	Visão Fortus. NFS, Contas à Pagar, Contas à Receber.
Questor Negócios	Financeiro	Access Token	Diária	Em breve	Sem visão pronta.
RD Station	Marketing	OAuth	Tempo real	Disponível	Visão RD Station. Conversões.
Pipedrive	Comercial	OAuth	Diária	Disponível	Visão Pipedrive. Negócios.
HubSpot	Comercial	OAuth	Diária	Disponível	Visão HubSpot. Negócios.
Piperun	Comercial	Access Token	Diária	Disponível	Visão Piperun. Oportunidades.
RdStation CRM	Comercial	Access Token	Diária	Disponível	Visão RdStation CRM. Negociações, Empresas.
Argo	Comercial	Usuário, senha e URL	Diária	Disponível	Visão Argo. Financeiro: Faturamento, Cheques. Tanques: Estoque, Venda.
Shopify	Comercial	Access Token e domínio	Diária	Em breve	Visão Shopify. Pedidos.
GoHusky	Produtividade e Gestão	Access Token, até 6 tokens	Diária	Disponível	Visão GoHusky. Pedidos.
Github	Produtividade e Gestão	Access Token	Diária	Disponível	Sem visão pronta.
Pipefy	Produtividade e Gestão	Access Token	Diária	Em breve	Visão Pipefy. Cards.
Tareffa	Produtividade e Gestão	Access Token	Diária	Em breve	Sem visão pronta.
Monitoramento HubAlertas	Produtividade e Gestão	Sem autenticação	Diária	Disponível	Sem visão pronta.
Let’s Work	Recursos Humanos	App Key e App Secret	Diária	Em breve	Visão Lets Work. Ausências.
Sponte	ERP	Access Token e domínio	Diária	Disponível	Visão Sponte. Visão Geral. Comercial. Pedagógico: Secretaria, Pedagógico. Financeiro: Recebimentos, Pagamentos, Inadimplência, Fluxo de Caixa, Consolidado.
Sponte Educacional	ERP	Access Token e domínio	Diária	Em breve	Visão Sponte Educacional. Mesmas categorias da Visão Sponte.
Questor Organizacional	ERP	Access Token	Diária	Em breve	Visão Questor Organizacional. Visão Organizacional: Lançamentos, Horas, Custo, Resultado.
Questor Empresarial	ERP	Access Token	Diária	Em breve	Visão Questor Empresarial. Análise de Vendas: Resumo de Faturamento, Detalhes de Vendas, Análise Fiscal.

Algumas observações sobre a tabela:

• Cartão “Em breve” não abre a instalação, mesmo quando o parceiro já tem visão pronta no código.
• Categoria ERP não tem filtro próprio. Os parceiros dessa categoria só aparecem em Todas as integrações, e o cartão mostra a categoria como Outros.
• Atualização mostra Diário ou Tempo Real, conforme o parceiro.
• A lista de visões vem do código do produto. Os modelos publicados pelo time do HubCount também aparecem na galeria de templates do passo Templates.

Exemplo: Omie na Aurora Comércio Ltda

A Aurora usa o Omie como ERP financeiro. A Contabilidade Exemplo quer ver o resultado e o caixa do Omie ao lado do balancete.

1. Na Aurora, abre o Data Lake e a aba Explorar, filtra por Financeiro e abre o cartão do Omie.
2. Clica em Instalar. No passo Autenticação, cola o App Key e o App Secret que o cliente gerou no Omie.
3. No passo Templates, marca a Visão Omie e salva a seleção.
4. Clica em Instalar Integração. Aparece Integração instalada e templates aplicados com sucesso.
5. Troca para a visão do Omie, pelo ícone de olho, e abre as abas Resultado, Caixa e Vendas.

Problemas comuns

Informe o App Key e App Secret para continuar

Você tentou instalar um parceiro de App Key e App Secret com um dos campos vazios. Preencha os dois.

Falha na autenticação

O parceiro recusou a credencial, ou a chamada não chegou ao parceiro. Confira a credencial, gere uma nova no parceiro e tente de novo. No OAuth, a mensagem pode vir também com o título Falha no processo de autenticação e o motivo informado pelo parceiro.

A autenticação não foi concluída porque a janela foi fechada antes da conclusão.

Você fechou a janela do parceiro antes de autorizar. Clique de novo em Autenticar e conclua na janela.

Erro ao aplicar modelos.

A integração foi criada, mas o HubCount não conseguiu aplicar as visões escolhidas. Abra o parceiro em Minhas integrações e escolha os templates de novo, ou confirme o que existe na lista de visões da empresa.

Nenhuma integração instalada, você pode instalar integrações com outros softwares na aba ‘Explorar’.

A empresa ainda não tem parceiros. Siga os passos da seção de instalação.

Atenção! Não é possível realizar integrações por meio de links personalizados.

Você abriu o BI pelo domínio próprio do escritório. Use o endereço padrão do HubCount para instalar. O botão Clique aqui para acessar leva ao site padrão.

Você não tem permissão para remover integrações

Para remover um parceiro, peça ao administrador a permissão de exclusão de conectores. A mensagem aparece na remoção.

Relacionados

• Visão Padrão e Apenas Contábil: o que cada aba mostra
• Data Lake
• Consolidado