QuickBooks Connector OAuth 2.0 Crie um Aplicativo QuickBooks¶

Antes de começar, certifique-se de atender aos requisitos definidos em QuickBooks Connector OAuth 2.0 - Pré-requisitos.

A configuração de um aplicativo QuickBooks Online usando a autenticação OAuth 2.0 no QuickBooks é a primeira etapa para permitir o acesso do Harmony à sua instância do QuickBooks Online. Durante a criação de seu aplicativo QuickBooks Online, você também gerará um ID do cliente, Segredo do cliente, Código de autorização e ID do domínio para entrar no Harmony Design Studio posteriormente no processo de configuração.

As etapas a seguir mostram como criar seu aplicativo QuickBooks OAuth 2.0 Online no QuickBooks.

Ambiente de Teste¶

Estas etapas pressupõem que você esteja usando uma conta sandbox do QuickBooks ao desenvolver e testar sua integração.

1. Acesse desenvolvedor e faça login usando as credenciais da sua conta do QuickBooks.

   Nota

   Se você acabou de se inscrever para uma avaliação do QuickBooks, pode ser necessário aceitar as solicitações para se tornar um "Desenvolvedor Intuit". Isso é necessário para configurar o acesso do Harmony à sua conta do QuickBooks.

2. No menu na parte superior da página, clique em Meus aplicativos. Se você já tiver aplicativos existentes criados em sua conta, você os verá listados aqui. Selecione o botão Create new app para ir para a próxima página.

3. Agora você deve ver uma página semelhante à página mostrada abaixo. Na seção Apenas comece a codificar, clique no botão Selecionar APIs.

   

4. Um pop-up deve solicitar que você selecione a API. A API "Accounting" é a API principal para integração com QuickBooks Online e deve ser selecionada para integração com Harmony. Marque a caixa da API de contabilidade e clique no botão Criar aplicativo.

   

5. Depois que seu aplicativo for criado, você será direcionado para a aba Painel. Como seu aplicativo acabou de ser criado, ele terá o nome padrão de "Sem título".

   Nota

   Você pode retornar ao seu aplicativo a qualquer momento voltando para Meus aplicativos no menu na parte superior de qualquer página.

   

6. Vá para a aba Chaves. As chaves de desenvolvimento listadas nesta página são pré-geradas para seu novo aplicativo. Essas chaves serão necessárias em seções posteriores desta documentação – tanto quando você gerar o código de autorização do sandbox quanto para entrar no Design Studio mais tarde. Você retornará a esta aba mais tarde.

   

7. Vá para a aba Configurações. Aqui é onde você pode alterar o título do seu novo aplicativo, bem como outras informações, dependendo do seu projeto de integração específico. Clique na parte que deseja editar para alterar qualquer informação do seu aplicativo e clique no botão Salvar quando as alterações estiverem concluídas. Neste exemplo, o nome do aplicativo foi alterado para "JBConnectorApp".

   

8. Retorne à aba Painel. Na seção Recursos, clique no link OAuth Playground.

   

9. Agora você deve ver uma página semelhante à página mostrada abaixo, indicando que você está no OAuth 2.0 Playground. Clique em Selecionar escopos, passe o mouse sobre Contabilidade na lista suspensa e clique na caixa de seleção de Contabilidade. Clique no botão Obter código de autorização.

   

10. Uma mensagem pop-up de aviso indica que você sairá do site. Selecione o botão Sair.

11. Agora você deve ver uma página semelhante à página mostrada abaixo. Esta é a etapa final no QuickBooks para autorizar o Jitterbit QuickBooks Connector a acessar seus dados do QuickBooks Online. Selecione o botão Conectar.

    

12. Agora você deve ver uma página semelhante à página mostrada abaixo e exibindo o código de autorização do sandbox e o ID do domínio. O Código de Autorização e o ID do Reino serão necessários em seções posteriores desta documentação para entrar no Design Studio. Deixe esta página aberta em seu navegador para permitir o acesso a essas informações conforme você passa para a próxima etapa na configuração do QuickBooks Connector.

    Aviso

    NÃO selecione nenhuma ação adicional nesta página. Agora você tem todas as informações para inserir no QuickBooks Connector para criar um endpoint de sandbox. O conector do QuickBooks regenera internamente o token de acesso usando o token de atualização quando ele expira. O token de acesso é gerado dinamicamente e não é armazenado. Se o botão Obter tokens for selecionado, o QuickBooks esperará que o conector passe o token de acesso gerado online para autenticação e a conexão falhará. O processo descrito neste documento se aplica apenas ao aplicativo usado especificamente para configurar o Harmony QuickBooks Connector. Para criar qualquer outro aplicativo QuickBooks, você precisará consultar o Intuit Developer Blog.

    

Ambiente de Produção¶

Quando estiver pronto para trazer sua integração para um ambiente de produção, siga as etapas abaixo para obter chaves de produção específicas para seu aplicativo.

1. Acesse desenvolvedor e faça login usando as credenciais da sua conta do QuickBooks.

2. No menu na parte superior da página, clique em Meus aplicativos. Selecione o aplicativo que você criou durante o estágio de teste e desenvolvimento especificamente para configurar o Harmony QuickBooks Connector.

   

3. Agora você deve ver uma página semelhante à página mostrada abaixo. O perfil da conta deve ser concluído antes que as chaves de produção do seu aplicativo estejam disponíveis.

   1. Se você já completou o perfil da sua conta, clique na aba Configurações.

   2. Se o perfil da sua conta não foi concluído anteriormente, role para baixo até a seção 2. Coloque seu aplicativo no ar e clique no link Preencha o perfil da sua conta. Preencha as informações na página Perfil da conta e clique no botão Salvar. Retorne ao aplicativo conector e clique na aba Configurações.

      

4. Agora você deve ver uma página semelhante à página mostrada abaixo. Role para baixo até a seção Termos de links de serviço. Digite o End User License Agreement URL e o Privacy Policy URL para seu aplicativo. Clique no botão Salvar.

   

5. Selecione a aba Chaves e role para baixo até Chaves de produção. Assim que o perfil da conta e os links dos Termos de serviço forem concluídos, as chaves de produção do seu aplicativo deverão ser exibidas de forma semelhante à página abaixo. Essas chaves serão necessárias em seções posteriores desta documentação – tanto quando você gerar o código de autorização de produção quanto para entrar no Design Studio posteriormente. Você retornará a esta aba mais tarde.

   

6. Retorne à aba Painel. Role para baixo até a seção Resources e clique no link OAuth Playground.

   

7. Agora você deve ver uma página semelhante à página mostrada abaixo, indicando que você está no OAuth 2.0 Playground. Clique no menu suspenso abaixo de 1. Obter Código de Autorização. O aplicativo conector exibe duas versões. Selecione a versão (Produção) na lista.

   

8. Clique em Selecionar escopos, passe o mouse sobre Contabilidade na lista suspensa e clique na caixa de seleção Contabilidade. Selecione o botão Obter código de autorização.

   

9. Uma mensagem pop-up de aviso indica que você sairá do site. Selecione o botão Sair.

10. Agora você deve ver uma página semelhante à página mostrada abaixo. Esta é a etapa final no QuickBooks para autorizar o QuickBooks Connector a acessar seus dados de produção do QuickBooks Online. Selecione o botão Conectar.

    

11. Agora você deve ver uma página semelhante à página mostrada abaixo exibindo o código de autorização de produção e o ID do reino. O Código de Autorização e o ID do Reino serão necessários em seções posteriores desta documentação para entrar no Design Studio. Deixe esta página aberta em seu navegador para permitir o acesso a essas informações à medida que avança para a próxima etapa na configuração do QuickBooks Connector para acessar os dados de produção.

    Aviso

    NÃO selecione nenhuma ação adicional nesta página. Agora você tem todas as informações para inserir no QuickBooks Connector para criar um endpoint de produção. O conector do QuickBooks regenera internamente o token de acesso usando o token de atualização quando ele expira. O token de acesso é gerado dinamicamente e não é armazenado. Se o botão Obter tokens for selecionado, o QuickBooks esperará que o conector passe o token de acesso gerado online para autenticação e a conexão falhará. O processo descrito neste documento se aplica apenas ao aplicativo usado especificamente para configurar o Jitterbit QuickBooks Connector. Para criar qualquer outro aplicativo QuickBooks, você precisará consultar a Documentação do produto QuickBooks e/ou o Blog do desenvolvedor da Intuit.