Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
QuickBooks intégration
Grâce au connecteur QuickBooks d'action, vous pouvez accéder à QuickBooks Online directement dans Amazon Quick via le langage naturel. Vous pouvez gérer les factures, les clients, les fournisseurs, les comptes et générer des rapports financiers sans quitter Amazon Quick.
Amazon Quick prend en charge plusieurs méthodes d'authentification pour QuickBooks. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.
-
Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Les utilisateurs s'authentifient directement avec leur compte Intuit.
-
Application OAuth personnalisée : utilise une application gérée par le client enregistrée sur le portail Intuit Developer. Cette option donne à votre organisation le contrôle total de la configuration OAuth.
Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.
Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
-
Un compte QuickBooks en ligne actif avec accès aux données de l'entreprise que vous souhaitez utiliser.
-
Pour l'application OAuth personnalisée : accès au portail des développeurs Intuit
sur le site Web d'Intuit pour créer une application. -
Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.
Configuration QuickBooks
Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick
Pour l'authentification personnalisée de l'application OAuth, effectuez les étapes suivantes sur le portail Intuit Developer avant de configurer Amazon Quick.
Création d'une application Intuit Developer (application OAuth personnalisée)
Créez une application sur le portail Intuit Developer pour obtenir les informations d'identification client dont vous avez besoin pour Amazon Quick. Pour plus d'informations, consultez OAuth 2.0
-
Connectez-vous au portail Intuit Developer sur le site
Web d'Intuit. -
Dans votre espace de travail, cliquez sur le bouton plus (+) pour créer une nouvelle application.
-
Pour Type, sélectionnez la plateforme QuickBooks en ligne.
-
Entrez un nom d'application pour votre application.
-
Pour les autorisations, sous En QuickBooks ligne et paiements, sélectionnez les étendues d'autorisation requises par votre intégration. Pour les portées recommandées, voirÉscopes recommandés.
-
Terminez la création de l'application. Sur la page de confirmation, choisissez Afficher les informations d'identification pour afficher vos informations d'identification de développement.
-
Enregistrez les valeurs suivantes. Vous en avez besoin lorsque vous configurez Amazon Quick.
-
Identifiant du client
-
Secret client
-
-
Dans les paramètres de l'application, choisissez l'onglet Redirect URI. Ajoutez l'URL de rappel Amazon Quick :
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback -
Choisissez Enregistrer.
Éscopes recommandés
Lorsque vous créez une application Intuit Developer, sélectionnez les étendues d'autorisation suivantes en fonction des actions que vous souhaitez utiliser.
| Scope | Description |
|---|---|
com.intuit.quickbooks.accounting |
Accède aux données comptables QuickBooks en ligne, notamment les factures, les clients, les fournisseurs, les comptes et les rapports financiers. |
com.intuit.quickbooks.payment |
Accède aux données de paiement QuickBooks en ligne, y compris les achats et les transactions de paiement. |
openid |
Authentifie l'identité de l'utilisateur. |
email |
Lit l'adresse e-mail de l'utilisateur. |
profile |
Lit les informations du profil de l'utilisateur. |
phone |
Lit le numéro de téléphone de l'utilisateur. |
address |
Lit l'adresse de l'utilisateur. |
Note
Les address champsopenid,email, profilephone, et sont utilisés pour l'authentification des utilisateurs avec l'application OAuth personnalisée.
Configuration du connecteur dans Amazon Quick
Se connecter depuis l'onglet Disponible
Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Dans l'onglet Disponible, recherchez QuickBookset choisissez Connect.
-
Terminez le QuickBooks processus de connexion et accordez les autorisations demandées.
Pour configurer un connecteur avec l'application OAuth personnalisée à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.
Créez à partir de l'onglet Créer pour votre équipe
Après avoir effectué toute QuickBooks configuration requise, créez le connecteur dans Amazon Quick.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Choisissez l'onglet Créer pour votre équipe.
-
Trouvez et choisissez QuickBooks.
Note
Si un QuickBooks connecteur existe déjà, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.
-
Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.
-
Pour Type de connexion, sélectionnez Réseau public.
-
Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.
-
Pour l'application OAuth par défaut :
Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.
-
Pour l'application OAuth personnalisée, configurez les champs suivants :
-
URL de base (facultatif) — URL de base de l' QuickBooks API. Exemple :
https://quickbooks.api.intuit.com -
ID client : ID client de votre application Intuit Developer.
-
Secret client — Le secret client de votre application Intuit Developer.
-
URL du jeton : point de terminaison du jeton. Exemple :
https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer -
URL d'autorisation : point de terminaison d'autorisation. Exemple :
https://appcenter.intuit.com/connect/oauth2 -
URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.
-
-
-
Choisissez Suivant.
-
Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Intuit s'ouvre. Vérifiez les autorisations demandées et choisissez Connect.
-
Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.
-
Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.
-
Choisissez Publier.
Actions disponibles
Après avoir configuré le connecteur, les actions suivantes sont disponibles.
| Catégorie | Action | Description |
|---|---|---|
| Requêtes | Entités de recherche | Effectue des recherches dans QuickBooks les entités à l'aide d'une requête. |
| Comptes | Obtenir les détails du compte | Récupère les détails d'un compte spécifique par requête. |
| Comptes | Obtenir un compte | Récupère un compte spécifique par identifiant. |
| Comptes | Créer un compte | Crée un nouveau compte dans le plan comptable. |
| Factures | Obtenir une facture | Récupère une facture spécifique par identifiant. |
| Factures | Lister les factures | Répertorie les factures avec un filtrage facultatif. |
| Factures | Créer une facture | Crée une nouvelle facture. |
| Clients | Obtenir un client | Récupère un client spécifique par identifiant. |
| Clients | Créer un client | Crée un nouvel enregistrement client. |
| Vendors | Créer un fournisseur | Crée un nouvel enregistrement de fournisseur. |
| Purchases (Achats) | Créer un achat | Crée une nouvelle transaction d'achat. |
| Purchases (Achats) | Créer une facture | Crée une nouvelle facture émanant d'un fournisseur. |
| Entrées de journal | Créer une entrée de journal | Crée une nouvelle entrée de journal. |
| Rapports | Obtenez un rapport sur les profits et pertes | Génère un rapport de profits et pertes. |
| Rapports | Obtenir le rapport du solde client | Génère un rapport récapitulatif du solde client. |
| Rapports | Obtenez le détail du solde du client | Génère un rapport détaillé du solde client. |
| Rapports | Obtenir le rapport sur le solde des fournisseurs | Génère un rapport récapitulatif du solde des fournisseurs. |
| Rapports | Obtenez le détail du solde des fournisseurs | Génère un rapport détaillé sur le solde des fournisseurs. |
| Rapports | Obtenir le rapport General Ledger | Génère un rapport du grand livre général. |
| Opérations par lots | Opération d'exécution par lots | Exécute plusieurs opérations dans une seule demande par lots. |
| Société | Obtenir des informations sur l'entreprise | Récupère des informations sur l'entreprise connectée. |
Note
Les actions que vous pouvez utiliser dépendent des données de l'entreprise accessibles à l'utilisateur authentifié.
Gestion et résolution des problèmes
Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.
Problèmes d’authentification
-
Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) : vérifiez que votre compte Intuit est actif et que vous pouvez vous connecter directement à quickbooks.intuit.com
sur le site Web d'Intuit. Pour l'application OAuth personnalisée, vérifiez que l'URI de redirection dans votre application Intuit Developer correspond à l'URL de rappel Amazon Quick. -
Informations d'identification client non valides (application OAuth personnalisée) : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre application Intuit Developer. Vous pouvez consulter vos informations d'identification dans les paramètres de l'application sur le portail Intuit Developer.
-
Autorisations insuffisantes — Vérifiez que les étendues configurées pour votre application Intuit Developer incluent les autorisations requises pour les actions que vous souhaitez utiliser. Consultez Éscopes recommandés.
