Guia de conexão do QuickBooks Desktop para Jitterbit App Builder

Visão geral

Este guia descreve os requisitos do sistema e as instruções para conectar o App Builder a um QuickBooks Desktop. Este guia utiliza um arquivo de exemplo do QuickBooks com uma tabela de Clientes contendo registros de clientes para ilustrar os conceitos principais.

Neste cenário de exemplo, o QuickBooks e o App Builder residem no mesmo servidor. Se você estiver conectando o App Builder a um ambiente QuickBooks externo, certifique-se de seguir o protocolo de segurança adequado para sua infraestrutura.

Requisitos do sistema

Aplicativo e conector remoto

• QuickBooks Desktop

• Conector Remoto do QuickBooks

Navegador da web do cliente

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

Instruções de conexão

Instalar o conector remoto do QuickBooks

O Conector Remoto é utilizado para poder ler e escrever dados do QuickBooks em situações onde o acesso direto ao QuickBooks não está disponível.

1. Baixe o arquivo QuickBooks Remote Connector Setup.exe de remoteconnector.com<

2. Instale o arquivo do Conector Remoto no mesmo servidor onde o QuickBooks Desktop está instalado

   1. Execute o arquivo .exe como Administrador em Modo de Usuário Único

   2. Clique em Avançar nas instruções do assistente de instalação e Eu concordo para aceitar o Contrato de Licença

   3. Clique em Instalar para instalar o Conector Remoto para o QuickBooks

   4. Clique em Concluir para finalizar a instalação e iniciar o Conector Remoto

   

3. Confirme que o aplicativo QuickBooks Desktop foi iniciado e está em Modo de Usuário Único

4. Clique na aba Usuários no Conector Remoto

5. Clique no botão Adicionar…

   

6. Crie um registro para registrar o usuário conectando-se no App Builder:

   1. Insira o Usuário. Por exemplo: App BuilderDemo

   2. Insira a Senha. Por exemplo: vinyldemo123

   3. Confirme o tipo de Autenticação. Por exemplo: Autenticação Básica

   4. Confirme o Software ao qual está se conectando. Por exemplo: QB Desktop

   5. Deixe o valor padrão <empresa atualmente aberta> como o Arquivo da Empresa

   6. Revise e modifique o Nome do Aplicativo se desejar. Por exemplo: App BuilderDemo

   7. Revise o valor de Acesso aos Dados e modifique conforme necessário. Por exemplo: Completo

7. Clique no botão OK para salvar

8. Um prompt de Autorização do Aplicativo aparecerá

1. Clique no botão OK para abrir o QuickBooks Desktop como Administrador

2. Revise o Certificado do Aplicativo QuickBooks e selecione a opção apropriada

   1. Para esta configuração, selecione Sim, sempre; permitir acesso mesmo que o QuickBooks não esteja em execução

3. Revise o prompt de Autorização e clique em Sim

4. Revise e determine se deseja conceder ao aplicativo acesso a dados pessoais

5. Clique no botão Continuar…

6. Revise a tela de Confirmação de Acesso

   

7. Clique no botão Concluído

8. Um prompt de Autorização Bem-Sucedida aparecerá agora, perguntando se você deseja salvar as informações do Arquivo da Empresa.

9. Clique no botão Sim

10. Clique na aba Status no Conector Remoto

11. Revise e confirme se o Conector Remoto se conectou ao QuickBooks

Crie um aplicativo App Builder para se conectar ao QuickBooks

Nesta seção, criaremos um aplicativo App Builder e estabeleceremos uma conexão com o QuickBooks. Uma vez configurado corretamente, os registros do QuickBooks podem ser visualizados e modificados a partir do aplicativo App Builder.

1. Navegue até o Menu do Site do App Builder

2. Clique no botão + App

3. Atribua um Nome da Aplicação. Por exemplo: Demonstração do QuickBooks

4. Para a Fonte de Dados, selecione Fonte Existente

5. Para a Página Inicial, selecione Menu à Esquerda

6. Clique no botão Prosseguir

7. Na tela Adicionar uma Fonte à sua aplicação, selecione Nova Conexão

8. Clique no botão Próximo

9. Para a Categoria de Conexão, selecione Outro

10. No campo de pesquisa Tipos de Conexões, digite "quick"

11. Clique no botão de rádio Selecionado para Quick Books Desktop

    

12. Clique no botão Próximo

13. Insira os valores apropriados para as Configurações do Servidor e Configurações de Segurança da Nova Conexão:

    1. Nome do Servidor: o nome do servidor. Por exemplo: QuickBooksDemo

    2. Tipo: o tipo de conexão. Por exemplo: Quick Books Desktop

    3. URI: o URI do servidor. Por exemplo: 10.0.0.44:8166

    4. Nome de Usuário: use o mesmo Usuário configurado para o Conector Remoto. Por exemplo: App BuilderDemo

    5. Senha: use a mesma Senha configurada para o Conector Remoto. Por exemplo: vinyldemo123

14. Clique no botão Próximo. O App Builder agora executa processos em segundo plano e importa o esquema do Quick Books. Esta etapa pode levar alguns minutos para ser concluída.

15. Navegue até o Menu do Site e inicie o novo aplicativo criado. Por exemplo: Demonstração do QuickBooks

16. Vá para o Banco de Trabalho do App e confirme que há 1 Fonte de Dados registrada e que as Tabelas existem a partir do arquivo de origem conectado

17. Clique no bloco Fontes de Dados

18. Confirme que a Fonte de Dados Quick Books Desktop está registrada

19. Clique no botão correspondente Detalhes do Servidor

20. Expanda a seção Teste

21. Clique no botão Testar Conexão

    

22. Confirme que você vê uma mensagem verde de Sucesso, indicando que a conexão está configurada corretamente

23. A aba Status do Conector Remoto também mostrará o tráfego de conexão bem-sucedido na Atividade Recente

24. Navegue de volta para o App Workbench

25. Clique no bloco Tables

26. Localize a tabela de Clientes e clique no ícone de Resultados correspondente

    1. Enquanto o App Builder carrega os dados da tabela Quick Books, você pode ver o processamento do handshake de conexão através da aba de Status do Conector Remoto

27. O App Builder irá recuperar e exibir todos os registros da tabela selecionada no QuickBooks. Com base na configuração fornecida, as alterações feitas nos dados a partir do aplicativo App Builder serão gravadas e salvas no QuickBooks.

Solução de Problemas

Se você encontrar problemas com o QuickBooks Desktop, estas etapas de solução de problemas são recomendadas:

1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

2. Consulte a documentação do CData ADO.NET Provider para QuickBooks para informações detalhadas.

Recursos

Os seguintes sites oferecem mais informações, incluindo a versão mais recente do arquivo QuickBooks Remote Connector Setup.exe:

• http://remoteconnector.com/

• https://cdn.cdata.com/help/RQG/ado/pg_startedintro.htm

• https://cdn.cdata.com/help/RQG/ado/pg_rcintroduction.htm

• https://cdn.cdata.com/help/RQG/ado/pg_rctroubleshooting.htm