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, consulteMétodos de autenticação.
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
no site da Intuit para criar um aplicativo. -
Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.
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
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
-
Faça login no portal do desenvolvedor da Intuit no site
da Intuit. -
No seu espaço de trabalho, escolha o botão de adição (+) para criar um novo aplicativo.
-
Em Tipo, selecione a plataforma QuickBooks Online.
-
Insira um nome de aplicativo para seu aplicativo.
-
Em Permissões, em QuickBooks Online e Pagamentos, selecione os escopos de autorização que sua integração exige. Para obter os escopos recomendados, consulteEscopos recomendados.
-
Conclua a criação do aplicativo. Na página de confirmação, escolha Mostrar credenciais para ver suas credenciais de desenvolvimento.
-
Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.
-
ID do cliente
-
Segredo do cliente
-
-
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 -
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.
| 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 openidemail,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.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, QuickBookslocalize e escolha Connect.
-
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.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
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.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos seguintes métodos de autenticação e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
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.
-
-
-
Escolha Próximo.
-
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.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
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.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão 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, consulteGerenciando integrações existentes.
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
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.
