As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# QuickBooks integração
Com o conector de QuickBooks ação, você pode acessar o QuickBooks Online diretamente no Amazon Quick por meio de linguagem natural. Você pode gerenciar faturas, clientes, fornecedores, contas e gerar relatórios financeiros sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para QuickBooks. Escolha o método mais adequado aos requisitos de segurança da sua organização.
+ Aplicativo **OAuth padrão — usa um aplicativo** OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta da Intuit.
+ Aplicativo **OAuth personalizado — usa um aplicativo** gerenciado pelo cliente registrado no portal do desenvolvedor da Intuit. Essa opção dá à sua organização controle total sobre a configuração do OAuth.
Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulte[Métodos de autenticação](quick-action-auth.md).
## Antes de começar
Certifique-se de ter o seguinte antes de configurar a integração.
+ Uma conta QuickBooks on-line ativa com acesso aos dados da empresa que você deseja usar.
+ Para **aplicativo OAuth personalizado**: acesso ao [portal do desenvolvedor da Intuit](https://developer.intuit.com/) no site da Intuit para criar um aplicativo.
+ Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).
## Configurando QuickBooks
Se você estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e continue até. [Configurando o conector no Amazon Quick](#quickbooks-quicksuite-setup)
Para a autenticação personalizada do aplicativo OAuth, conclua as etapas a seguir no portal do desenvolvedor da Intuit antes de configurar o Amazon Quick.
### Crie um aplicativo Intuit Developer (aplicativo OAuth personalizado)
Crie um aplicativo no portal do Intuit Developer para obter as credenciais de cliente necessárias para o Amazon Quick. Para obter mais informações, consulte [OAuth 2.0](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0) no site do Intuit Developer.
1. Faça login no [portal do desenvolvedor da Intuit no site](https://developer.intuit.com/) da Intuit.
1. No seu espaço de trabalho, escolha o botão de adição (\+) para criar um novo aplicativo.
1. Em **Tipo**, selecione a plataforma QuickBooks Online.
1. Insira um **nome de aplicativo** para seu aplicativo.
1. Em **Permissões**, em **QuickBooks Online e Pagamentos**, selecione os escopos de autorização que sua integração exige. Para obter os escopos recomendados, consulte[Escopos recomendados](#quickbooks-oauth-scopes).
1. Conclua a criação do aplicativo. Na página de confirmação, escolha **Mostrar credenciais** para ver suas credenciais de desenvolvimento.
1. Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.
+ **ID do cliente**
+ **Segredo do cliente**
1. Nas configurações do aplicativo, escolha a guia **Redirecionar URIs**. Adicione a URL de retorno de chamada do Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Escolha **Salvar**.
### Escopos recomendados
Ao criar um aplicativo Intuit Developer, selecione os seguintes escopos de autorização com base nas ações que você deseja usar.
**QuickBooks escopos recomendados**
| Escopo | Description |
| --- | --- |
| com.intuit.quickbooks.accounting | Acessa dados contábeis QuickBooks on-line, incluindo faturas, clientes, fornecedores, contas e relatórios financeiros. |
| com.intuit.quickbooks.payment | Acessa dados de pagamento QuickBooks on-line, incluindo compras e transações de pagamento. |
| openid | Autentica a identidade do usuário. |
| email | Lê o endereço de e-mail do usuário. |
| profile | Lê as informações do perfil do usuário. |
| phone | Lê o número de telefone do usuário. |
| address | Lê o endereço do usuário. |
**nota**
Os `address` escopos `openid``email`,`profile`,`phone`, e são usados para autenticação do usuário com o aplicativo OAuth personalizado.
## Configurando o conector no Amazon Quick
### Conecte-se a partir da guia Disponível
Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia **Disponível** sem configuração adicional.
1. No console do Amazon Quick, escolha **Conectores**.
1. Na guia **Disponível**, **QuickBooks**localize e escolha **Connect**.
1. QuickBooks Conclua o fluxo de login e conceda as permissões solicitadas.
Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia **Criar para sua equipe**, conforme descrito abaixo.
### Crie a partir da guia Criar para sua equipe
Depois de concluir qualquer QuickBooks configuração necessária, crie o conector no Amazon Quick.
1. No console do Amazon Quick, escolha **Conectores**.
1. Escolha a guia **Criar para sua equipe**.
1. Encontre e escolha **QuickBooks**.
**nota**
Se um QuickBooks conector já existir, uma caixa de diálogo será exibida com os conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha **Não, criar novo**.
1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição.
1. Em **Tipo de conexão**, escolha **Rede pública**.
1. Para **Configuração do OAuth**, escolha um dos seguintes métodos de autenticação e configure os campos obrigatórios.
1. Para o **aplicativo OAuth padrão**:
Nenhuma credencial adicional é necessária. Escolha **Próximo** para continuar.
1. Para o **aplicativo OAuth personalizado**, configure os seguintes campos:
+ **URL base** (opcional) — A URL base da QuickBooks API. Exemplo: `https://quickbooks.api.intuit.com`
+ **ID do cliente** — A ID do cliente do seu aplicativo Intuit Developer.
+ **Segredo do cliente** — O segredo do cliente do seu aplicativo Intuit Developer.
+ **URL do token** — O endpoint do token. Exemplo: `https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer`
+ **URL de autorização** — O endpoint de autorização. Exemplo: `https://appcenter.intuit.com/connect/oauth2`
+ URL de **redirecionamento — Pre-filled com o URL** de retorno de chamada do Amazon Quick.
1. Escolha **Próximo**.
1. Se você escolher o aplicativo **OAuth padrão ou o aplicativo** **OAuth personalizado**, uma janela de autorização da Intuit será aberta. Revise as permissões solicitadas e escolha **Connect**.
1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**.
1. Na página **Publicar**, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.
1. Selecione **Publish**.
## Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
**QuickBooks ações disponíveis**
| Categoria | Ação | Description |
| --- | --- | --- |
| Consultas | Entidades de pesquisa | Pesquisa em QuickBooks entidades usando uma consulta. |
| Contas | Obter detalhes da conta | Recupera detalhes de uma conta específica por consulta. |
| Contas | Obter conta | Recupera uma conta específica por ID. |
| Contas | Criar conta | Cria uma nova conta no plano de contas. |
| Faturas | Obter fatura | Recupera uma fatura específica por ID. |
| Faturas | Listar faturas | Lista as faturas com filtragem opcional. |
| Faturas | Criar fatura | Cria uma nova fatura. |
| Clientes | Obtenha o cliente | Recupera um cliente específico por ID. |
| Clientes | Criar cliente | Cria um novo registro de cliente. |
| Fornecedores | Criar fornecedor | Cria um novo registro de fornecedor. |
| Compras | Criar compra | Cria uma nova transação de compra. |
| Compras | Criar fatura | Cria uma nova fatura de um fornecedor. |
| Entradas do diário | Criar entrada de diário | Cria uma nova entrada no diário. |
| Relatórios | Obtenha o relatório de lucros e perdas | Gera um relatório de lucros e perdas. |
| Relatórios | Obtenha o relatório de saldo do cliente | Gera um relatório resumido do saldo do cliente. |
| Relatórios | Obtenha detalhes do saldo do cliente | Gera um relatório detalhado do saldo do cliente. |
| Relatórios | Obtenha o relatório de saldo do fornecedor | Gera um relatório resumido do saldo do fornecedor. |
| Relatórios | Obtenha detalhes do saldo do fornecedor | Gera um relatório detalhado do saldo do fornecedor. |
| Relatórios | Obtenha o relatório do General Ledger | Gera um relatório contábil geral. |
| Operações em lote | Operação de execução em lote | Executa várias operações em uma única solicitação em lote. |
| Empresa | Obtenha informações sobre a empresa | Recupera informações sobre a empresa conectada. |
**nota**
As ações que você pode usar dependem dos dados da empresa acessíveis ao usuário autenticado.
## Gerenciamento e solução de problemas
Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
### Problemas de autenticação
+ **Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado)** — Verifique se sua conta da Intuit está ativa e se você pode entrar diretamente em [quickbooks.intuit.com](https://quickbooks.intuit.com) no site da Intuit. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu aplicativo Intuit Developer corresponde ao URL de retorno de chamada do Amazon Quick.
+ **Credenciais de cliente inválidas (aplicativo OAuth personalizado)** — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores em seu aplicativo Intuit Developer. Você pode ver suas credenciais nas configurações do aplicativo no portal do desenvolvedor da Intuit.
+ **Permissões insuficientes** — Verifique se os escopos configurados para seu aplicativo Intuit Developer incluem as permissões necessárias para as ações que você deseja usar. Consulte [Escopos recomendados](#quickbooks-oauth-scopes).