Gérer les connexions et lire l’état de synchronisation
Gérez vos intégrations connectées à partir de la page Integrations, où vous pouvez ajouter ou mettre à jour les identifiants du connecteur, vérifier si un connecteur est actif et configuré, et lancer des tâches de synchronisation ou de reprise historique lorsqu’elles sont disponibles. La page indique aussi si des secrets sont présents par rapport au fait qu’une connexion a réellement été authentifiée, afin que vous puissiez distinguer la configuration d’une connexion fonctionnelle.
Avant de commencer
- Vous devez avoir accès à l’espace de travail avec le rôle administrateur pour les actions qui modifient les intégrations ou déclenchent des synchronisations.
- La page Integrations doit être disponible dans votre plan actuel ou dans les droits de votre espace de travail.
- Pour les actions Plaid, le script navigateur Plaid Link doit terminer son chargement avant que vous puissiez connecter ou reconnecter une banque.
- Pour les actions de synchronisation ou de reprise historique, la synchronisation manuelle doit être activée pour l’espace de travail lorsque la page ou l’action l’exige.
Ouvrir Integrations
Allez dans Settings et ouvrez Integrations. La page répertorie les instances du connecteur pour l’espace de travail actuel et affiche l’état de chacune, si elle est configurée, ainsi que tout secret requis manquant ou toute configuration requise manquante.
- Ouvrez Settings.
- Sélectionnez Integrations.Integrations
- Examinez les cartes de connecteur et leurs étiquettes d’état.
Lire l’état du connecteur
Un connecteur peut apparaître comme actif ou inactif, et son état configuré dépend des champs secrets requis et de toute configuration non secrète requise. Pour ERPNext, le nom de l’entreprise doit aussi être présent. Un connecteur peut avoir des valeurs secrètes enregistrées sans être entièrement configuré s’il manque encore un champ requis.
- Configured signifie que les champs secrets requis sont présents et que tous les champs non secrets requis sont remplis.
- Les secrets requis manquants répertorient les champs d’identifiants qui doivent encore être enregistrés.
- La configuration requise manquante affiche les champs non secrets qui sont encore incomplets, comme ERPNext company.
- Les empreintes de secrets apparaissent dans la liste comme des indicateurs de secret enregistré, et non comme les valeurs secrètes elles-mêmes.
Ajouter ou modifier un connecteur
Utilisez la carte du connecteur pour l’intégration que vous souhaitez gérer. Certaines cartes vous permettent d’enregistrer directement les identifiants. Mercury dispose aussi d’une fenêtre modale de gestion des connecteurs pour choisir un connecteur Mercury existant, enregistrer sa clé API, actualiser les comptes accessibles, sélectionner des comptes ou ajouter un nouveau connecteur Mercury.
- Sur la carte du connecteur, saisissez les champs demandés pour ce fournisseur.
- Sélectionnez Save Credentials, ou pour Mercury ouvrez Manage Mercury Connectors et travaillez dans la fenêtre modale.Manage Mercury Connectors
- Si vous créez un nouveau connecteur Mercury, saisissez un nom d’affichage et, au besoin, une clé API, puis sélectionnez Add Connector.Add Connector
- Si vous mettez à jour Mercury, choisissez d’abord l’instance du connecteur, puis enregistrez la clé API ou la sélection de compte que vous souhaitez utiliser.
Champs du fournisseur que vous pouvez enregistrer
| Fournisseur | Champs visibles | Notes |
|---|---|---|
| Mercury | Mercury API key | La fenêtre modale Mercury vous permet aussi d’actualiser les comptes, de choisir l’accès au compte et d’ajouter un nouveau connecteur Mercury. |
| Wise | Wise API token; Wise API base (optional) | L’URL de base est facultative et peut être laissée vide. |
| PayPal | PayPal client_id; PayPal client_secret; PayPal base_url (optional) | L’URL de base est facultative. |
| ERPNext | ERPNext base_url; ERPNext api_key; ERPNext api_secret; ERPNext company | Le champ company est requis pour une configuration complète de ERPNext. |
| Shopify | Shopify shop_domain; Shopify access_token | Le domaine de la boutique et le jeton d’accès sont enregistrés ensemble. |
| Flexport | Flexport api_token; Flexport api_base (optional) | L’URL de base est facultative. |
| Plaid | Aucun champ secret sur cette page; utilisez Connect Bank (Plaid) ou Reconnect | La connexion Plaid utilise le flux Link puis se synchronise par l’intermédiaire du connecteur. |
Connecter ou reconnecter Plaid
La carte Plaid peut connecter un compte bancaire ou reconnecter un compte existant. Si le SDK Plaid Link est encore en cours de chargement, la page affiche Loading... et les boutons Plaid restent indisponibles jusqu’à ce que le navigateur ait fini de charger le script.
- Sur la carte Plaid, sélectionnez Connect Bank (Plaid) pour démarrer une nouvelle connexion.Connect Bank (Plaid)
- Si la connexion existe déjà et est configurée, sélectionnez Reconnect pour la mettre à jour.Reconnect
- Terminez le flux Plaid Link dans la fenêtre du navigateur.
- Après une connexion réussie, la page se met à jour afin que vous puissiez voir l’état connecté et poursuivre avec les actions de synchronisation ultérieures.
Déclencher la synchronisation ou la reprise historique
Utilisez Trigger Sync pour une synchronisation normale du connecteur, ou Trigger Backfill lorsque vous avez besoin d’une fenêtre historique bornée. Les deux actions dépendent du fait que l’espace de travail autorise la synchronisation manuelle. Le champ Sync from date fournit la date de début utilisée par les actions de synchronisation, et le formulaire de reprise historique utilise aussi les valeurs since et until.
- Définissez Sync from date si vous voulez que la fenêtre de synchronisation manuelle commence à partir d’une date précise.Sync from date
- Sur la carte du connecteur, sélectionnez Trigger Sync lorsque vous voulez que le connecteur actuel synchronise les comptes et les transactions.Trigger Sync
- Utilisez Trigger Backfill lorsque vous avez besoin d’une plage historique. Remplissez since et until avant de soumettre.Trigger Backfill
- Si la synchronisation manuelle est désactivée, activez-la dans les paramètres de votre espace de travail ou demandez à un propriétaire ou à un administrateur de le faire avant de réessayer.
Sélection de compte Mercury
Les connecteurs Mercury peuvent afficher une liste de comptes accessibles. Vous pouvez actualiser cette liste, choisir les comptes qui doivent se synchroniser et enregistrer la sélection. La page affiche le nom du compte, les quatre derniers chiffres lorsqu’ils sont disponibles, le type et l’état.
- Ouvrez Manage Mercury Connectors.Manage Mercury Connectors
- Choisissez l’instance du connecteur Mercury que vous voulez gérer.
- Sélectionnez Refresh accounts pour charger les comptes Mercury disponibles.RefreshRefresh accounts
- Cochez les comptes que vous voulez que cet espace de travail utilise, puis sélectionnez Save account selection.Save account selection
Résultat attendu
Après une demande d’enregistrement ou de synchronisation réussie, la page met à jour la carte du connecteur, actualise les données d’intégration enregistrées et peut afficher un ID d’exécution de synchronisation en file d’attente ou un état configuré. Pour la sélection de compte Mercury, la page confirme combien de comptes ont été connectés et précise que les transactions récentes sont en cours de synchronisation.
Si quelque chose échoue
Si une sauvegarde ou une synchronisation échoue, la page affiche un message d’erreur et conserve l’écran actuel. Pour Plaid, attendez que le script Link ait terminé son chargement si vous voyez un message de chargement. Pour la synchronisation manuelle ou la reprise historique, vérifiez que l’espace de travail autorise la synchronisation manuelle et que vous avez rempli les champs de date dans le format attendu. Si vous avez modifié des identifiants ou des sélections de compte et que la page semble toujours obsolète, utilisez Refresh pour recharger la liste des connecteurs.
- Si la page indique que la fonctionnalité n’est pas disponible, il se peut que votre espace de travail n’ait pas l’autorisation requise.
- Si un champ est vide ou invalide, corrigez-le et enregistrez de nouveau.
- Si Plaid Link ne s’ouvre pas, réessayez après la fin du chargement du script.
- Si la synchronisation manuelle est désactivée, demandez à un propriétaire ou à un administrateur de l’activer avant de réessayer.
- Si l’enregistrement d’un connecteur Mercury échoue, essayez d’actualiser la liste des connecteurs et de rouvrir la fenêtre modale Mercury.
Mis à jour