Pular para o conteúdo

Acesso ao QuickBooks para o Data Foundation

O Data Foundation reúne os dados de todos os sistemas de ERP e de contabilidade que você conecta, em quantas instâncias você tiver, em um único Common Finance Model. O QuickBooks Online é um dos sistemas que ele lê diretamente. Esta página é para o administrador do QuickBooks que configura o acesso e para o usuário do PlaidCloud que o solicita a ele.

O PlaidCloud apenas lê dados. Ninguém envia uma senha ou um token por e-mail.

Na guia Foundation do projeto, escolha Criar uma nova conexão e selecione QuickBooks Online. O formulário mostra a solicitação completa. Clique em Copiar solicitação para colá-la na sua própria mensagem ou em Enviar solicitação por e-mail para abri-la no seu programa de e-mail com o assunto “Read-only QuickBooks Online access for PlaidCloud.”

  1. Escolher o usuário do QuickBooks com o qual o PlaidCloud vai atuar. No próprio QuickBooks, esse usuário precisa enxergar:

    • o plano de contas, os clientes, os produtos e serviços e os locais
    • os relatórios de Razão geral, Balancete e Demonstração do resultado (um usuário que possa executá-los em Relatórios)
    • as transações de vendas: faturas, recibos de venda, notas de crédito e recibos de reembolso
    • os orçamentos e o Resumo de avaliação de estoque, se você quiser tê-los no modelo (QuickBooks Plus ou Advanced)

    Um administrador da empresa já tem isso. Um usuário limitado precisa ter essas permissões ativadas.

  2. Autorizar o PlaidCloud uma vez. Esse usuário entra na tela de consentimento da Intuit, a partir da conexão que o usuário do PlaidCloud envia a ele. O escopo é somente Accounting (com.intuit.quickbooks.accounting).

  3. Uma empresa por conexão. Se você mantém várias empresas no QuickBooks, autorize cada uma em sua própria conexão.

O administrador envia Informado no PlaidCloud como
O nome da empresa, como deve aparecer no modelo A Empresa que você escolhe para a conexão
Se os livros estão fechados até uma data (Settings > Account and Settings > Advanced > Accounting) Nada a informar: o PlaidCloud lê do QuickBooks a data de fechamento dos livros

Na guia Foundation, o usuário do PlaidCloud preenche a nova conexão:

  • ID da empresa (ID do realm)
  • Token de atualização, um segredo que o usuário do PlaidCloud cola por conta própria
  • Ambiente, que pode ser production ou sandbox

Em Configurações do sistema, Conta de lucros acumulados indica a conta de Patrimônio líquido para a qual a demonstração do resultado de abertura é transferida, quando os nomes das contas ainda não deixam isso claro. É opcional.

De volta ao PlaidCloud, clique em Testar conexão. Cada conjunto de dados aparece como Legível, Permissão ausente ou Erro:

Conjunto de dados O que ele lê no QuickBooks
Entidades As informações da empresa
Plano de contas O plano de contas
Calendário fiscal As preferências da empresa: o primeiro mês do ano fiscal e a data de fechamento dos livros
Balancete O relatório de Balancete, para os saldos de abertura
Razão geral O relatório de Razão geral
Departamentos Locais (opcional)
Clientes Clientes (opcional)
Produtos Produtos e serviços (opcional)
Linhas de vendas Faturas, recibos de venda, notas de crédito e recibos de reembolso (opcional)
Orçamento Orçamentos (opcional)
Saldos de estoque O Resumo de avaliação de estoque (opcional)
Taxas de câmbio Taxas de câmbio (opcional)

Quando um conjunto de dados mostra Permissão ausente, o teste informa o acesso a adicionar. Peça ao administrador que o ative para o usuário e teste novamente. Uma empresa sem os dados opcionais, como orçamentos, ainda carrega todo o resto.

O QuickBooks não tem parceiro comercial, conta intercompanhia nem razão, então as linhas de uma empresa do QuickBooks não trazem nenhum deles.