Connecteur source Quickbooks en ligne

Le connecteur source Quickbooks en ligne dans DataSync vous permet de récupérer des données depuis QuickBooks en ligne pour les charger ou les synchroniser dans votre entrepôt de données. Avant de configurer la connexion, assurez-vous que DataSync est installé avec HTTPS activé et que vous disposez d'un compte QuickBooks Desktop avec des permissions administratives.

Après avoir créé toutes les connexions source requises, configurez votre source de destination pour compléter la configuration de la connexion.

Configurer l'application sur Intuit Developer

Créer un compte développeur

1. Connectez-vous au Portail Développeur Intuit 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. Entrez un nom d'application et sélectionnez les scopes nécessaires à votre application.
6. Cliquez sur Créer l'application pour terminer.

Récupérer vos identifiants d'application

1. Dans le panneau de navigation gauche, sous Production, sélectionnez Clés & OAuth.
2. Copiez le Client ID et le Client Secret — vous en aurez besoin dans DataSync.

Créer une connexion source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions source, cliquez sur Nouveau.
4. Sélectionnez Quickbooks en ligne.
5. Dans le panneau Propriétés de connexion, entrez les propriétés de connexion.
6. Copiez l'URL de rappel depuis le panneau Propriétés de connexion.
7. Connectez-vous à nouveau au Portail Développeur Intuit.
8. Dans le panneau de navigation, sous Production, sélectionnez Clés & OAuth.
9. Dans URI de redirection, cliquez sur Ajouter une URI, collez l'URL de rappel, puis cliquez sur Enregistrer.
10. (Optionnel) Dans le panneau Propriétés de connexion supplémentaires, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
11. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos exigences.
12. Cliquez sur Enregistrer.
13. Vous serez redirigé vers l'écran de connexion Intuit pour vous authentifier.
14. Vérifiez votre identité si cela est demandé.
15. Sélectionnez l'entreprise dont vous souhaitez récupérer les données et cliquez sur Suivant.
16. Cliquez sur Connecter pour autoriser l'accès entre QuickBooks en ligne et DataSync.

Paramètres

Propriétés de connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : Quickbooks en ligne.
URL de rappel	URL de redirection générée automatiquement par DataSync. Doit être ajoutée aux URI de redirection de votre application QuickBooks en ligne dans Intuit Developer.
Client ID	Identifiant du client de l'application provenant du Portail Développeur Intuit.
Client Secret	Valeur secrète provenant du Portail Développeur Intuit.
Scope	Identifiant qui définit l'accès à l'API QuickBooks que votre application demande. Plusieurs scopes peuvent être spécifiés sous forme de liste séparée par des espaces. Par défaut : com.intuit.quickbooks.accounting.
Code de pays	Code de pays pour votre fichier d'entreprise QuickBooks en ligne. Valeurs supportées : US, AU, CA, IN, UK.
Verbosité	1 – Journaliser les requêtes, nombres de lignes, début/fin d'exécution, erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps de requête/réponse. 4 – Inclut le niveau 3 plus la communication au niveau du transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer le pooling	Option de pooling de connexion pour la performance.
Délai d'inactivité du pool	Temps d'inactivité maximum pour les connexions avant de les retourner au pool, en secondes.
Taille maximale du pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du pool	Temps d'attente maximum pour l'allocation de connexion avant qu'une erreur ne soit lancée, en secondes.

Propriétés de connexion supplémentaires

Propriétés supplémentaires de chaîne de connexion non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Chiffré. La sélection de Chiffré masque la valeur de l'interface et la stocke chiffrée en arrière-plan, comme lors de la définition des mots de passe.

Propriété	Valeur
UseSandBox	Réglage pour activer l'utilisation de l'environnement sandbox de QuickBooks pour tester votre application avant de vous connecter à la production. Exemple : True
ConverDateTimeToGMT	Réglage configuré automatiquement sur True. Convertit toutes les valeurs DateTime en GMT.

Paramètres avancés

Les paramètres avancés contrôlent comment le connecteur Quickbooks en ligne suit les changements, gère la configuration régionale et temporelle, et traite les lots de données lors de l'extraction. Ces options permettent un réglage fin pour la performance et la précision, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode de suivi des changements : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si requis par votre configuration.
Fuseau horaire	Fuseau horaire correspondant au serveur d'application Quickbooks en ligne.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de timing dans la sélection des enregistrements. La valeur minimum est 0 ; la valeur maximum est 3600 secondes.
Taille de lot	Quantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot plus importantes augmentent l'utilisation de la mémoire mais peuvent améliorer la performance jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez selon la vitesse de votre réseau et la performance de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple