Guia de Conexão do QuickBooks Desktop¶

Visão Geral¶

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

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

Para conectar seus servidores, você deve ter o Vinyl 3.3+ instalado.

Requisitos de Sistema¶

Aplicativo e Conector Remoto¶

• Área de Trabalho QuickBooks

• Conector remoto QuickBooks

Navegador da Web do Cliente¶

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

Instruções de Conexão¶

Instale o Conector Remoto do Quickbooks¶

O Conector Remoto é usado para gravar e ler dados QuickBooks em situações onde o acesso direto a QuickBooks não está disponível.

1. Baixe o arquivo QuickBooks Remote Connector Setup.exe em 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 no modo de usuário único

   2. Clique em Avançar nos prompts do assistente de instalação e Concordo em aceitar o Contrato de Licença

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

   4. Clique em Concluir para concluir a instalação e iniciar o Remote Connector

   

3. Confirme se o aplicativo QuickBooks Desktop está iniciado e em execução no 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 cadastrar o usuário conectado no Vinyl:

   1. Insira o Usuário. Por exemplo: VinylDemo

   2. Digite a Senha. Por exemplo: vinyldemo123

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

   4. Confirme o Software conectado. Por exemplo: QB Desktop

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

   6. Revise e modifique o Nome do aplicativo se desejar. Por exemplo: VinylDemo

   7. Revise o valor Acesso a dados e modifique-o conforme necessário. Por exemplo: Completo

7. Clique no botão OK para salvar

8. Um prompt Autorização do aplicativo aparecerá

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

2. Revise o Certificado de aplicativo QuickBooks e selecione a opção apropriada

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

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

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

5. Clique no botão Continuar…

6. Revise a tela Confirmação de acesso

   

7. Clique no botão Concluído

8. Um prompt 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 está conectado ao QuickBooks

Crie um Aplicativo Vinyl para Conectar-se a QuickBooks¶

Nesta seção, criaremos um aplicativo Vinyl e estabeleceremos uma conexão com QuickBooks. Depois de configurados corretamente, os registros QuickBooks podem ser visualizados e modificados no aplicativo Vinyl.

1. Navegue até o Vinyl Menu do Site

2. Clique no botão + Aplicativo

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

4. Para a fonte de dados, selecione Fonte existente

5. Para a página inicial, selecione Menu esquerdo

6. Clique no botão Continuar

7. Na tela Adicionar uma fonte ao seu aplicativo, selecione Nova conexão

8. Clique no botão Avançar

9. Para a categoria de conexão, selecione Outro

10. No campo de pesquisa Tipos de conexões, digite "rápido"

11. Clique no botão de opção Selecionado para Quick Books Desktop

    

12. Clique no botão Avançar

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

    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: VinylDemo

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

14. Clique no botão Avançar. O Vinyl agora executa processos em segundo plano e importa o esquema 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 App Workbench e confirme se há 1 fonte de dados registrada e se existem tabelas do arquivo de origem conectado ao

17. Clique no ficha Fontes de dados

18. Confirme se a fonte de dados do 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 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 em Atividade Recente

24. Navegue de volta para o App Workbench

25. Clique no ficha Tabelas

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

    1. Enquanto o Vinyl carrega os dados da tabela Quick Books, você pode ver o processamento do handshake da conexão através da aba Remote Connector Status

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

Recursos¶

Os sites a seguir 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