Comprendre les capacités de connexion et les autorisations
Cette référence explique quelles cartes de connecteur sont prises en charge dans Settings > Integrations, de quelles informations d’identification chacun a besoin, et ce qui se passe lorsque vous enregistrez des identifiants, connectez Plaid, ou demandez une synchronisation ou un backfill. Elle indique aussi le rôle et les autorisations de l’espace de travail requis pour ces actions, ainsi que la marche à suivre lorsqu’une demande est ignorée, désactivée ou rejetée.
Avant de commencer
- Vous devez être connecté à l’espace de travail qui possède le connecteur que vous souhaitez examiner.
- Pour les actions de gestion, vous devez avoir le rôle owner/admin dans cet espace de travail.
- Certaines actions exigent aussi l’autorisation de gestion Integrations, et certaines cartes de connecteur exigent une autorisation propre au connecteur avant de pouvoir être utilisées.
- Pour les actions de connexion Plaid, le navigateur doit terminer le chargement de Plaid Link avant que vous puissiez connecter ou reconnecter une banque.
- Pour les actions de synchronisation manuelle ou de backfill, l’espace de travail doit autoriser les synchronisations manuelles; sinon, le bouton reste désactivé. Pour les actions liées à la synchronisation, la page peut indiquer que la synchronisation nocturne s’exécutera automatiquement. Ce message ne s’applique pas à la branche de backfill seulement.
Ce que couvre cette référence
Cet article explique les portées de connecteur affichées dans la zone Integrations, les informations d’identification attendues par chaque connecteur, et la différence entre configuré, disponible et absent. Il explique aussi les effets visibles de l’enregistrement des identifiants, de la connexion des banques, du démarrage des synchronisations et des demandes de backfill.
Portées de connecteur prises en charge
| Connecteur | Actions visibles | Champs d’identification affichés | Remarques |
|---|---|---|---|
| Plaid | Connect Bank (Plaid), Reconnect, Trigger Sync | Aucun champ d’identification sur la carte | Le flux de connexion bancaire utilise Plaid Link et la carte peut être disponible même lorsqu’aucun connecteur n’est prérempli. |
| Mercury | Manage Mercury Connectors, Refresh accounts, Save account selection, Add Connector | Mercury API key | La carte prend en charge plusieurs instances de connecteur Mercury et la sélection de compte. |
| Wise | Save Credentials, Trigger Sync, Trigger Backfill | Wise API token; Wise API base (optional) | L’URL de base est facultative et n’est enregistrée que si elle est fournie. |
| PayPal | Save Credentials, Trigger Sync, Trigger Backfill | PayPal client_id; PayPal client_secret; PayPal base_url (optional) | L’URL de base est facultative et doit être saisie comme une URL sécurisée si elle est utilisée. |
| ERPNext | Save Credentials, Trigger Sync, Trigger Backfill | ERPNext base_url; ERPNext api_key; ERPNext api_secret; ERPNext company | Ce connecteur est la destination du grand livre utilisée par le flux d’importation. |
| Shopify | Save Credentials, Trigger Sync, Trigger Backfill | Shopify shop_domain; Shopify access_token | Le domaine et le jeton sont enregistrés ensemble. |
| Flexport | Save Credentials, Trigger Sync, Trigger Backfill | Flexport api_token; Flexport api_base (optional) | L’URL de base est facultative et doit être sécurisée si elle est utilisée. |
Ce que signifie configuré
Un connecteur est marqué comme configuré uniquement lorsque les secrets requis pour ce connecteur sont présents, et, pour ERPNext, lorsque le champ company est également présent. Si un secret requis ou une valeur de configuration manque, la carte peut quand même s’afficher, mais elle reste non configurée.
Comment ajouter ou mettre à jour les identifiants d’un connecteur
- Ouvrez Settings, puis ouvrez Integrations.Integrations
- Trouvez la carte de connecteur que vous souhaitez configurer.
- Saisissez les champs visibles pour ce connecteur. Les valeurs secrètes sont masquées dans le formulaire, mais elles sont enregistrées lorsque vous cliquez sur Save Credentials ou sur le bouton d’enregistrement propre au connecteur.Save Credentials
- Cliquez sur Save Credentials, ou pour Mercury utilisez Save Selected Connector Key après avoir choisi le connecteur cible dans la fenêtre modale.Save CredentialsSave Selected Connector Key
- Attendez le message de réussite, puis actualisez. Pour Mercury, la liste des comptes se recharge après un enregistrement réussi.
Si l’enregistrement réussit, les champs sont effacés dans le formulaire et la page recharge l’état enregistré du connecteur. Si l’enregistrement échoue, l’erreur reste à l’écran et les valeurs ne sont pas effacées.
Connexion, reconnexion et synchronisation Plaid
- Sur la carte Plaid, cliquez sur Connect Bank (Plaid) pour commencer une nouvelle connexion.Connect Bank (Plaid)
- Si vous reconnectez une connexion bancaire existante, cliquez plutôt sur Reconnect.Reconnect
- Après une nouvelle connexion réussie, la page échange le jeton de connexion retourné et indique combien de comptes ont été connectés.
- Pour demander une synchronisation manuelle Plaid, cliquez sur Trigger Sync si la synchronisation manuelle est activée dans votre espace de travail.Trigger Sync
Les boutons Connect Bank et Reconnect ne sont utiles qu’après le chargement du SDK Link Plaid par le navigateur. Jusque-là, la carte indique que Link Plaid est toujours en cours de chargement. Si le SDK ne se charge jamais, les boutons Plaid restent indisponibles.
Gestion du connecteur Mercury
- Sur la carte Mercury, cliquez sur Manage Mercury Connectors.Manage Mercury Connectors
- Dans la fenêtre modale, choisissez l’instance de connecteur avec laquelle vous souhaitez travailler.
- Saisissez ou mettez à jour le Mercury API key pour ce connecteur sélectionné, puis enregistrez-le.Mercury API key
- Refresh accounts pour charger les comptes accessibles avec cette clé.Refresh accounts
- Sélectionnez les comptes que votre espace de travail doit utiliser et enregistrez la sélection.
- Au besoin, cliquez sur Add Connector pour créer une autre instance de connecteur Mercury.Add Connector
La sélection Mercury se fait par instance de connecteur. L’enregistrement des comptes sélectionnés met à jour les comptes Mercury qui seront utilisés pour les synchronisations ultérieures, et le message de la page confirme combien de comptes ont été connectés.
Comportement de la synchronisation manuelle et du backfill
La synchronisation manuelle et le backfill sont des actions distinctes. La synchronisation manuelle demande une exécution de synchronisation pour le connecteur actif, tandis que le backfill demande une fenêtre historique à l’aide des champs visibles depuis et until. Les deux actions dépendent du fait que l’espace de travail autorise les synchronisations manuelles.
- Le champ Sync from date définit la date de début utilisée par la synchronisation manuelle et les demandes de synchronisation Plaid sur la page.
- Le champ until est utilisé avec les demandes de backfill, et il est soumis exactement tel qu’il est saisi.
- Si la synchronisation manuelle est désactivée, le bouton affiche un message au lieu d’envoyer une demande.
- Si une demande de backfill ou de synchronisation échoue, l’erreur s’affiche et vous pouvez réessayer après avoir corrigé le problème d’entrée ou d’autorisation.
Dépendances des fonctionnalités et des rôles
- Le rôle owner/admin est requis pour les changements d’identifiants de connecteur et plusieurs actions bancaires.
- L’autorisation de gestion Integrations est requise pour les actions de la page Integrations qui gèrent les connecteurs.
- Les autorisations propres au connecteur déterminent si une carte de connecteur donnée peut être utilisée.
- Certains flux d’importation et de comptabilité exigent aussi une autorisation liée à ERPNext et une société de destination connectée.
Ce qui se passe après l’enregistrement ou la soumission
| Action | À quoi vous attendre | Ce qui ne change pas immédiatement |
|---|---|---|
| Enregistrer les identifiants du connecteur | La page efface le formulaire, affiche un message d’enregistrement et actualise l’état du connecteur. | Aucun livre n’est comptabilisé simplement par l’enregistrement des identifiants. |
| Connecter une banque Plaid | La page confirme la connexion et lance le flux du compte bancaire. | Une connexion bancaire ne crée pas en soi d’écritures comptables. |
| Déclencher la synchronisation | Une exécution de synchronisation est mise en file d’attente et la page affiche la référence retournée de cette exécution. | La synchronisation est asynchrone; le résultat final des transactions n’est pas confirmé immédiatement. |
| Déclencher le backfill | Une exécution de backfill est mise en file d’attente pour la plage de dates sélectionnée. | Les données ne sont pas comptabilisées immédiatement au moment du clic lui-même. |
| Enregistrer la sélection de comptes Mercury | La page confirme le nombre de comptes connectés et recharge l’état. | Aucune comptabilisation immédiate au grand livre n’est affichée dans la page. |
| Rafraîchissement des soldes récents | La page affiche des données de solde de compte rafraîchies ou un résultat ignoré. | Le rafraîchissement peut être ignoré si la fenêtre quotidienne a déjà utilisé le rafraîchissement ou si les soldes récents payants sont désactivés. |
Récupération des échecs courants
- Si l’enregistrement d’un identifiant échoue, corrigez le champ et cliquez de nouveau sur le même bouton d’enregistrement.
- Si Plaid indique qu’il est toujours en cours de chargement, attendez que le navigateur termine le chargement du SDK Plaid avant de réessayer.
- Si la synchronisation manuelle est désactivée, demandez à un owner/admin de l’activer dans les paramètres de l’espace de travail si cela est permis pour votre espace de travail.
- Si une demande de synchronisation ou de backfill échoue, corrigez la plage de dates visible ou le problème d’identification, puis réessayez avec un nouvel enregistrement ou une nouvelle demande.
- Si un compte Mercury manque dans la liste, actualisez les comptes après avoir enregistré la bonne clé Mercury.
Flux de travail connexes
- Connecter ERPNext
- Gérer les intégrations
- Connecter Mercury
Mis à jour