Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# QuickBooks integrazione
Con l' QuickBooks Action Connector, puoi accedere a QuickBooks Online direttamente in Amazon Quick tramite linguaggio naturale. Puoi gestire fatture, clienti, fornitori, conti e generare report finanziari senza uscire da Amazon Quick.
Amazon Quick supporta diversi metodi di autenticazione per QuickBooks. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
+ App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account Intuit.
+ App **OAuth personalizzata: utilizza un'applicazione** gestita dal cliente registrata nel portale per sviluppatori Intuit. Questa opzione offre all'organizzazione il pieno controllo sulla configurazione OAuth.
Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).
## Prima di iniziare
Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un account QuickBooks online attivo con accesso ai dati aziendali che desideri utilizzare.
+ Per l'**app OAuth personalizzata**: accesso al [portale Intuit Developer](https://developer.intuit.com/) sul sito Web Intuit per creare un'app.
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).
## Configurazione QuickBooks
Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e procedi con. [Configurazione del connettore in Amazon Quick](#quickbooks-quicksuite-setup)
Per l'autenticazione personalizzata delle app OAuth, completa i seguenti passaggi nel portale per sviluppatori Intuit prima di configurare Amazon Quick.
### Crea un'app Intuit Developer (app OAuth personalizzata)
Crea un'app nel portale Intuit Developer per ottenere le credenziali client di cui hai bisogno per Amazon Quick. Per ulteriori informazioni, consulta [OAuth 2.0](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0) sul sito Web di Intuit Developer.
1. Accedi al [portale Intuit Developer sul sito Web di Intuit](https://developer.intuit.com/).
1. Dal tuo spazio di lavoro, scegli il pulsante più (\+) per creare una nuova app.
1. Per **Tipo**, seleziona la piattaforma QuickBooks online.
1. Inserisci il **nome dell'app** per la tua applicazione.
1. Per **Autorizzazioni**, in **QuickBooks Online e Pagamenti**, seleziona gli ambiti di autorizzazione richiesti dall'integrazione. Per gli ambiti consigliati, consulta. [Ambiti consigliati](#quickbooks-oauth-scopes)
1. Completa la creazione dell'app. Nella pagina di conferma, scegli **Mostra credenziali** per visualizzare le credenziali di sviluppo.
1. Registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.
+ **ID cliente**
+ **Client secret**
1. Nelle impostazioni dell'app, scegli la scheda **Reindirizza URI**. Aggiungi l'URL di callback di Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Scegli **Save** (Salva).
### Ambiti consigliati
Quando crei un'app Intuit Developer, seleziona i seguenti ambiti di autorizzazione in base alle azioni che desideri utilizzare.
**QuickBooks ambiti consigliati**
| Scope | Description |
| --- | --- |
| com.intuit.quickbooks.accounting | Accede ai dati contabili QuickBooks online, tra cui fatture, clienti, fornitori, conti e report finanziari. |
| com.intuit.quickbooks.payment | Accede ai dati di pagamento QuickBooks online, inclusi acquisti e transazioni di pagamento. |
| openid | Autentica l'identità dell'utente. |
| email | Legge l'indirizzo e-mail dell'utente. |
| profile | Legge le informazioni del profilo dell'utente. |
| phone | Legge il numero di telefono dell'utente. |
| address | Legge l'indirizzo dell'utente. |
**Nota**
Gli `address` ambiti `openid``email`,`profile`,`phone`, e vengono utilizzati per l'autenticazione degli utenti con l'app OAuth personalizzata.
## Configurazione del connettore in Amazon Quick
### Connect dalla scheda Available
Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.
1. Nella console Amazon Quick, scegli **Connettori**.
1. Nella scheda **Disponibile**, trova **QuickBooks**e scegli **Connect**.
1. Completa il flusso di QuickBooks accesso e concedi le autorizzazioni richieste.
Per configurare invece un connettore con l'app OAuth personalizzata, usa la scheda **Crea per il tuo team** come descritto di seguito.
### Crea dalla scheda Crea per il tuo team
Dopo aver completato la QuickBooks configurazione richiesta, crea il connettore in Amazon Quick.
1. Nella console Amazon Quick, scegli **Connettori**.
1. Scegli la scheda **Crea per il tuo team**.
1. Trova e scegli **QuickBooks**.
**Nota**
Se esiste già un QuickBooks connettore, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, selezionalo. Per crearne uno nuovo, scegli **No, crea nuovo**.
1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.
1. Per **Tipo di connessione**, scegli **Rete pubblica**.
1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.
1. Per l'app **OAuth predefinita:**
Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.
1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
+ **URL di base** (opzionale): l'URL di base dell' QuickBooks API. Ad esempio: `https://quickbooks.api.intuit.com`
+ **ID cliente**: l'ID client dell'app Intuit Developer.
+ **Segreto del cliente**: il segreto del client dell'app Intuit Developer.
+ **URL del token: l'**endpoint del token. Ad esempio: `https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer`
+ **URL di autorizzazione: l'**endpoint di autorizzazione. Ad esempio: `https://appcenter.intuit.com/connect/oauth2`
+ URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.
1. Scegli **Next (Successivo)**.
1. Se scegli l'app **OAuth predefinita o l'app OAuth** **personalizzata, si apre una finestra di autorizzazione Intuit**. Controlla le autorizzazioni richieste e scegli **Connect**.
1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.
1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.
1. Seleziona **Pubblica**.
## Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni.
**QuickBooks azioni disponibili**
| Categoria | Azione | Description |
| --- | --- | --- |
| Query | Entità di ricerca | Cerca tra le QuickBooks entità utilizzando un'interrogazione. |
| Account | Ottieni i dettagli dell'account | Recupera i dettagli di un account specifico tramite interrogazione. |
| Account | Ottieni un account | Recupera un account specifico tramite ID. |
| Account | Crea un account | Crea un nuovo conto nel piano dei conti. |
| Fatture | Ottieni fattura | Recupera una fattura specifica tramite ID. |
| Fatture | Elenca le fatture | Elenca le fatture con filtri opzionali. |
| Fatture | Crea fattura | Crea una nuova fattura. |
| Clienti | Ottieni cliente | Recupera un cliente specifico tramite ID. |
| Clienti | Crea cliente | Crea un nuovo record di cliente. |
| Fornitori | Crea fornitore | Crea un nuovo record del fornitore. |
| Purchases (Acquisti) | Crea acquisto | Crea una nuova transazione di acquisto. |
| Purchases (Acquisti) | Crea fattura | Crea una nuova fattura da un fornitore. |
| Voci del diario | Crea una voce di diario | Crea una nuova voce del diario. |
| Report | Ottieni un rapporto su profitti e perdite | Genera un rapporto su profitti e perdite. |
| Report | Ottieni il rapporto sul saldo dei clienti | Genera un rapporto di riepilogo del saldo dei clienti. |
| Report | Ottieni i dettagli del saldo del cliente | Genera un rapporto dettagliato sul saldo dei clienti. |
| Report | Ottieni il rapporto sull'equilibrio dei fornitori | Genera un rapporto riepilogativo sul saldo del fornitore. |
| Report | Ottieni dettagli sul saldo del fornitore | Genera un rapporto dettagliato sul saldo del fornitore. |
| Report | Ottieni il rapporto General Ledger | Genera un rapporto di contabilità generale. |
| Operazioni batch | Operazione Batch Execute | Esegue più operazioni in un'unica richiesta batch. |
| Azienda | Ottieni informazioni sull'azienda | Recupera informazioni sulla società connessa. |
**Nota**
Le azioni che è possibile utilizzare dipendono dai dati aziendali accessibili all'utente autenticato.
## Gestione e risoluzione dei problemi
Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).
### Problemi di autenticazione
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**: verifica che il tuo account Intuit sia attivo e che tu possa accedere a [quickbooks.intuit.com](https://quickbooks.intuit.com) direttamente sul sito web Intuit. Per l'app OAuth personalizzata, verifica che l'URI di reindirizzamento nella tua app Intuit Developer corrisponda all'URL di callback Amazon Quick.
+ **Credenziali client non valide (app OAuth personalizzata)**: verifica che l'ID cliente e il segreto del cliente corrispondano ai valori dell'app Intuit Developer. Puoi visualizzare le tue credenziali dalle impostazioni dell'app nel portale Intuit Developer.
+ **Autorizzazioni insufficienti**: verifica che gli ambiti configurati per la tua app Intuit Developer includano le autorizzazioni necessarie per le azioni che desideri utilizzare. Per informazioni, consulta [Ambiti consigliati](#quickbooks-oauth-scopes).