View a markdown version of this page

QuickBooks integrazione - Amazon Quick

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, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

Configurazione QuickBooks

Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e procedi con. Configurazione del connettore in Amazon Quick

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 sul sito Web di Intuit Developer.

  1. Accedi al portale Intuit Developer sul sito Web di Intuit.

  2. Dal tuo spazio di lavoro, scegli il pulsante più (+) per creare una nuova app.

  3. Per Tipo, seleziona la piattaforma QuickBooks online.

  4. Inserisci il nome dell'app per la tua applicazione.

  5. Per Autorizzazioni, in QuickBooks Online e Pagamenti, seleziona gli ambiti di autorizzazione richiesti dall'integrazione. Per gli ambiti consigliati, consulta. Ambiti consigliati

  6. Completa la creazione dell'app. Nella pagina di conferma, scegli Mostra credenziali per visualizzare le credenziali di sviluppo.

  7. Registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.

    • ID cliente

    • Client secret

  8. 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

  9. 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 openidemail,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.

  2. Nella scheda Disponibile, trova QuickBookse scegli Connect.

  3. 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.

  2. Scegli la scheda Crea per il tuo team.

  3. 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.

  4. Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.

  5. Per Tipo di connessione, scegli Rete pubblica.

  6. 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.

    2. 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.

  7. Scegli Next (Successivo).

  8. 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.

  9. Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).

  10. 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.

  11. 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, consultaGestione delle integrazioni esistenti.

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 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.