Intuit QuickBooks Online
Este artigo descreve como conectar o Tableau aos dados do Intuit QuickBooks Online e como configurar a fonte de dados.
Observação: o Tableau está funcionando em um conector substituto. Depois de concluído, ele será adicionado a esta página.
Aviso: o conector Intuit QuickBooks está obsoleto desde a versão 2023.1. Você pode usar o conector até que ele seja descontinuado. Depois que o conector for descontinuado, ele será removido da interface de usuário do Tableau e todas as fontes de dados que usam o conector não funcionarão mais conforme o esperado. O conector obsoleto será descontinuado 1-2 versões após o conector de substituição ser disponibilizado.
Observação: para obter informações mais atualizadas sobre este conector, consulte o tópico de ajuda Intuit QuickBooks Online da versão atual do Tableau.
Antes de começar, colete estas informações de conexão:
- Seu endereço de e-mail ou ID de usuário e senha da conta do Quickbooks Online.
Observação: para conectar o Tableau aos dados do QuickBooks Online, você deve ser um Administrador de Empresa na empresa QuickBooks Online. Somente um administrador em sua empresa pode conectar o Tableau ao QuickBooks Online.
O QuickBooks Online não oferece suporte à recuperação das Transações de ajuste de inventário. Para obter informações sobre quando as transações de Ajuste de inventário estarão disponíveis na API do QuickBooks Online, consulte as resposta a esta pergunta(O link abre em nova janela) no site do desenvolvedor do Intuit.
- Inicie o Tableau e, em Conectar, selecione Intuit QuickBooks Online. Para obter uma lista completa de conexões de dados, selecione Mais em A um servidor. Na guia aberta pelo Tableau no navegador padrão, faça o seguinte:
- Insira seu endereço de e-mail ou ID de usuário e senha para a conta do QuickBooks Online.
- Selecione Fazer logon.
O QuickBooks Online periodicamente alerta sobre a verificação de duas etapas. Se isso acontecer, siga os prompts para obter um código e confirmar a sua conta Intuit.
- Se mais de uma empresa estiver associada à sua conta, selecione a empresa à qual gostaria de se conectar.
- Selecione Autorizar para autorizar o Intuit a compartilhar com segurança os seus dados com o Tableau Desktop.
Se o Tableau não conseguir fazer a conexão, verifique se as suas credenciais estão corretas. Se ainda assim não conseguir se conectar, seu computador está enfrentando problemas para localizar o servidor. Entre em contato com o administrador de rede ou de banco de dados para obter assistência.
Na página da fonte de dados, faça o seguinte:
(Opcional) Selecione o nome da fonte de dados padrão na parte superior da página e, em seguida, insira um nome de fonte de dados exclusivo para uso no Tableau. Por exemplo, use uma convenção de nomeação de fonte de dados que ajude os outros usuários da fonte de dados a deduzir a qual fonte de dados devem se conectar.
- Em Tabela, selecione uma tabela e arraste-a até a parte superior do canvas.
Selecione a guia Planilha 1 para iniciar a sua análise.
Depois de selecionar a guia de planilha, o Tableau importa os dados criando uma extração. Observe que o Tableau Desktop só é compatível com extrações do QuickBooks Online. Você pode atualizar os dados atualizando a extração. Para obter mais informações, consulte Extrair seus dados.
A criação das extrações pode demorar algum tempo, dependendo da quantidade de dados incluída.
Usar a tabela Itens de linha de vendas e despesas para criar relatórios contábeis
O QuickBooks Online agrega as informações necessárias para criar uma variedade de relatórios, como as declarações de lucro e perda (P&L) e as planilhas de saldo. Como os dados são agregados pelo QuickBooks Online, você não pode criar esses tipos de relatórios no Tableau. Para solucionar isso, adicionamos uma tabela no Tableau, Itens de linha de vendas e despesas, que inclui detalhes do item de linha com todos os campos necessários para criar esses relatórios.
A tabela Itens de linha de vendas e despesas contém informações das seguintes transações (ou documentos) do QuickBooks Online:
Fatura Pagamento da fatura Nota fiscal Depósito | Estimativa Fatura Entrada do diário Pagamento Compra | Pedido de compra Recibo do reembolso Recibo de vendas Crédito do fornecedor |
A maioria das transações tem filhos (ou itens secundários), por exemplo, uma fatura tem itens de detalhes. Como este exemplo:
Algumas transações têm itens de grupo, que consistem em um grupo de outros itens de linha. Como este exemplo:
A tabela Itens de linha de vendas e despesas desnormaliza a relação de "transação para itens" incluindo uma linha por item e duplicando os campos de transação em cada linha. No caso de um item de linha de grupo com filhos, a tabela inclui os itens filho do grupo em vez do grupo.
A imagem a seguir mostra como essas duas faturas aparecem no Tableau com os dados desnormalizados:
Além das tabelas de transações, a tabela Itens de linha de vendas e despesas contém informações da tabela Conta.
Unir tabelas com a tabela Itens de linha de Vendas e despesas
Usando a tabela Itens de linha de venda e despesas, você pode unir colunas das tabelas de Conta e de transações a ela para obter as informações detalhadas necessárias para o relatório que deseja criar.
Para unir colunas da tabela Conta a cada linha em uma transação, una [Line Detail Account Ref value (Valor de ref. da conta de detalhe da Linha] na tabela Itens de linha de vendas e despesas a [ID Account (Conta de ID)] na tabela Conta.
Para as tabelas de transações do QuickBooks Online (por exemplo, Fatura, Estimativa, Pedido de compra e assim por diante), una [Transation Type (Tipo de transação)] + [ID] + [Line ID (ID da linha)] na tabela Itens da linha de vendas e despesas aos campos equivalentes na tabela de transações. Por exemplo, se você criar uma associação com a tabela de transações Fatura, o campo [ID] para união de Fatura será [(ID) Bill ((ID) Fatura]; o campo [Line ID (ID da linha)] para a união em Fatura será [Line ID (Bill) (ID da linha (Bill))], e assim por diante.
A imagem a seguir mostra várias uniões com a tabela Itens de linha de vendas e despesas à esquerda, bem como exemplos das cláusulas de união da tabela Conta e da tabela Fatura à direita.
Criar a fonte de dados do QuickBooks Online
Estas são as etapas gerais para começar a criar uma fonte de dados que você pode usar para criar vários relatórios, como relatórios P&L:
- Conecte-se ao QuickBooks Online.
- Na página Fonte de dados, em Tabela, selecione a tabela Itens de linha de vendas e despesas.
- Una uma ou mais das tabelas listadas na Estrutura de tabela dos Itens de linha de vendas e despesas à tabela Itens de linha de vendas e despesas para incluir os dados necessários para o relatório que você deseja criar.
- Depois de criar a fonte de dados, você pode criar suas declarações e analisar seus dados.
Um dos erros a seguir podem ser exibidos ao tentar conectar o Tableau aos dados do QuickBooks Online.
Pastas de trabalho salvas em versões anteriores do Tableau
As pastas de trabalho e fontes de dados criadas antes da versão 2018.2 do Tableau não poderão acessar tabelas ou campos adicionados em versões posteriores do conector. Para solucionar esse problema, abra uma nova pasta de trabalho e crie uma nova conexão à fonte de dados do QuickBooks Online. Copie e cole as planilhas que deseja manter da conexão anterior ou crie-as novamente no Tableau.
Somente administradores podem comprar aplicativos…
O QuickBooks Online requer que cada usuário que conecta um aplicativo ao QuickBooks Online seja um Administrador da Empresa. O seguinte erro do Intuit aparece se não for um administrador na conta da empresa:
Somente os administradores de <endereço de e-mail> da Empresa podem comprar aplicativos na empresa. Entre em contato com o administrador na empresa ou escolha outra empresa.
Para resolver este problema, peça ao proprietário da conta da empresa para tornar você um Administrador da Empresa na conta.
Código de erro: app_already_purchased
Somente um Administrador da Empresa pode se conectar por aplicativo, por exemplo ao Tableau Desktop. Se alguém na sua empresa já está conectou o Tableau à sua conta QuickBooks Online, o erro do Intuit a seguir é exibido:
Opa! Ocorreu um erro. Feche esta janela e tente novamente.
Código de erro: app_already_purchased
Mensagem: Outro usuário desta empresa já se inscreveu neste aplicativo. Entre em contato com <endereço de e-mail> para alterar esta inscrição.
Para resolver este problema, é necessário pedir ao Administrador da Empresa que abra mão dos privilégios do aplicativo para o Tableau Desktop e os forneça a você. Se isto não for possível, por exemplo, porque o administrador usa ativamente o Tableau, outra opção é o administrador publicar a fonte de dados no Tableau Server ou Tableau Cloud, para que qualquer pessoa que tenha permissão possa acessar os dados.
Alteração da conexão abre a página Meus aplicativos
Se você precisa acessar outra empresa do QuickBooks Online, após o logon (e possivelmente passar pelo processo de autenticação de duas etapas), o Intuit pode mostrar a página Meus aplicativos, em vez da página “selecione a empresa para se conectar”. Para resolver este problema, siga essas etapas:
Feche a página Meus aplicativos.
No painel Conectar do Tableau, selecione Intuit QuickBooks Online.
Se mais de uma empresa estiver associada à sua conta, selecione a empresa à qual gostaria de se conectar.
Selecione Autorizar para abrir a página de fonte de dados do Tableau.
Consulte também
- Configurar fontes de dados – Adicione mais dados a esta fonte de dados ou prepare os dados antes de analisá-los.
- Criar gráficos e analisar dados – Inicie a análise de dados.