Connecteur source Quickbooks Online

Le connecteur source Quickbooks Online permet à DataSync de récupérer les données de QuickBooks Online et de les charger dans un entrepôt de données. Avant de configurer la connexion, vérifier que DataSync est installé avec HTTPS activé et qu'un compte QuickBooks Online avec des droits d'administration est disponible.

La configuration se fait en deux parties qui se référencent mutuellement : la création d'une application dans le portail Intuit Developer pour autoriser l'accès de DataSync, puis la création d'une connexion source dans DataSync à partir des identifiants de cette application. Il est conseillé de garder le portail Intuit Developer et DataSync ouverts côte à côte pendant ces étapes.

Une fois la connexion source créée, configurez la connexion de destination pour finaliser l'installation.

Étape 1 : configurer une application dans Intuit Developer

Créer un compte développeur

1. Connectez-vous au portail Intuit Developer avec un compte administrateur.
2. Sélectionnez Tableau de bord dans la navigation supérieure.
3. Cliquez sur Créer une application.
4. Choisissez la plateforme QuickBooks en ligne et Paiements.
5. Saisissez un nom d'application et sélectionnez les portées requises.
6. Cliquez sur Créer l'application.

Récupérer les identifiants de l'application

1. Dans le panneau de navigation à gauche, sous Production, sélectionnez Clés & OAuth.
2. Copiez l'ID client et le Secret client. Ces deux valeurs seront nécessaires dans DataSync.

Étape 2 : créer la connexion source dans DataSync

Configurer la connexion

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions de la source, cliquez sur Nouveau.
4. Sélectionnez Quickbooks Online.
5. Complétez toutes les propriétés de connexion requises.
6. Copiez l'URL de rappel depuis le panneau Propriétés de la connexion.

Ajouter l'URL de rappel dans Intuit Developer

1. Connectez-vous au portail Intuit Developer.
2. Dans le panneau de navigation à gauche, sous Production, sélectionnez Clés & OAuth.
3. Dans URI de redirection, sélectionnez Ajouter une URI et collez l'URL de rappel.
4. Cliquez sur Enregistrer.

Authentifier et autoriser

1. (Facultatif) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et définissez les paramètres supplémentaires nécessaires.
2. Configurez les paramètres avancés selon votre environnement, notamment le Type de suivi.
3. Cliquez sur Enregistrer. Intuit affiche un écran de connexion pour terminer l'authentification.
4. Vérifiez l'identité si demandé.
5. Sélectionnez la société à connecter et cliquez sur Suivant.
6. Cliquez sur Connecter pour autoriser DataSync.

Propriétés de la connexion

Propriété	Description
Description	Nom unique attribué à la connexion. Exemple : Quickbooks en ligne.
URL de rappel	URL générée automatiquement par DataSync. Doit être ajoutée aux URI de redirection de l'application dans le portail Intuit Developer.
ID client	ID client provenant du portail Intuit Developer. Exemple : ABcDEfGHiJkLmNoPQRsTuVwXyZ1234567890abcd.
Secret client	Valeur secrète provenant du portail Intuit Developer. Exemple : aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890AbCdEf.
Scope	Définit les accès à l'API QuickBooks demandés par l'application. Plusieurs portées peuvent être saisies sous forme de liste séparée par des espaces. Valeur par défaut : com.intuit.quickbooks.accounting.
Code du pays	Code du pays du fichier de société QuickBooks Online. Valeurs disponibles : US, AU, CA, IN, UK.
Verbosité	Contrôle le niveau de détail écrit dans le journal. Chaque niveau inclut tout ce qui précède plus des informations supplémentaires. 1 enregistre les requêtes, les nombres de lignes, les heures de début et de fin d'exécution ainsi que les erreurs. 2 ajoute les requêtes de cache et les en-têtes HTTP. 3 ajoute les corps de requête et de réponse. 4 ajoute la communication au niveau du transport. 5 ajoute toutes les commandes d'interface.
Activer le pooling	Active le pooling de connexions, qui conserve un ensemble de connexions ouvertes et les réutilise entre les extractions au lieu d'ouvrir une nouvelle connexion à chaque fois. Réduit la charge et améliore les performances lorsque plusieurs extractions s'exécutent en même temps.
Délai d'inactivité du pool	Temps d'inactivité maximal en secondes avant qu'une connexion soit retournée au pool.
Taille maximale du pool	Nombre maximum de connexions autorisées dans le pool en même temps.
Temps d'attente du pool	Temps d'attente maximal en secondes pour obtenir une connexion avant qu'une erreur ne soit générée.

Autres propriétés de la connexion

Ce panneau permet d'ajouter des propriétés de chaîne de connexion qui ne figurent pas dans le panneau Propriétés de la connexion. Pour les valeurs sensibles comme les mots de passe, choisissez le type Crypté. La valeur reste alors masquée dans l'interface et stockée de façon chiffrée côté serveur.

Propriété	Description
UseSandBox	Connexion à l'environnement de test (sandbox) QuickBooks pour les essais avant la mise en production. Exemple : True.
ConverDateTimeToGMT	Définie automatiquement sur True. Convertit toutes les valeurs DateTime en GMT.

Paramètres avancés

Ces paramètres déterminent la façon dont le connecteur suit les modifications de données, gère l'heure et la région, et traite les enregistrements pendant l'extraction. Ajustez-les selon votre environnement Quickbooks Online afin que les résultats restent exacts et cohérents.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications de données : Aucun ou Date.
Region	Paramètre régional du connecteur, si la configuration l'exige.
Fuseau horaire	Fuseau horaire correspondant à l'environnement Quickbooks Online.
Décalage de temps	Décalage d'actualisation en secondes pour compenser les écarts de synchronisation lors de la sélection des enregistrements. Minimum 0, maximum 3600.
Taille du lot	Nombre d'enregistrements traités par lot lors de l'extraction. Des lots plus grands peuvent améliorer les performances mais consomment davantage de mémoire. La valeur par défaut est 2000, le maximum est 10000. À ajuster selon la vitesse du réseau et les performances du disque. La valeur par défaut convient dans la plupart des cas.

Exemple de configuration

Connexion source QuickBooks Online entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.