Mapper, synchroniser et exploiter un connecteur
Une fois votre logiciel comptable connecté à Node Pulse, il reste à relier vos dossiers distants à vos clients.
Pennylane, Fulll (RCA), ACD i-Suite Expert, Cegid Loop, Cegid Quadra ou Sage Business Cloud : vous lancez ensuite les synchronisations et tirez parti des données importées au quotidien.
Cet article vous guide à travers chaque étape, de la table de mapping jusqu'à l'exploitation des écritures synchronisées dans vos prévisionnels, reportings et exports FEC.
Prérequis
ℹ️ À savoir
L'onglet Intégrations n'est accessible qu'aux membres d'un cabinet. Il est masqué pour les comptes Client et pour les comptes individuels.
- Un connecteur actif (statut Connecté) — voir Connecter un logiciel comptable
- Au moins un client créé dans votre cabinet Node Pulse (avec son SIREN renseigné, de préférence)
⚠️ Attention
Les opérations décrites ici ne sont pas toutes disponibles pour tous les connecteurs. ACD i-Suite Expert se limite au mapping et à la synchronisation dossier par dossier : ni onboarding en lot, ni synchronisation en lot, ni export. Pennylane couvre tout sauf l'export vers le logiciel. Le tableau des capacités figure dans l'article Connecter un logiciel comptable.
Mapper les dossiers distants
Le mapping est l'étape qui relie chaque entité de votre logiciel comptable (client, société, dossier) à un dossier client dans Node Pulse. Sans ce lien, aucune synchronisation n'est possible.
- Rendez-vous dans Paramètres > Intégrations
- Ouvrez le sous-onglet Mapping — chaque connecteur y dispose de son propre tableau (Mapping clients Fulll, Mapping Cegid Loop, etc.), avec la liste des entités récupérées depuis votre logiciel
Le tableau contient cinq colonnes :
| Colonne | Contenu |
|---|---|
| Client (suivi du nom du connecteur) | Nom du client ou de la société dans votre logiciel comptable. L'en-tête reprend le connecteur : Client Fulll, Client Cegid Loop, Client Pennylane… |
| SIREN | Numéro SIREN récupéré automatiquement (si disponible) |
| Client local | Menu déroulant pour sélectionner le dossier Node Pulse correspondant |
| Statut | Lié (vert) si le mapping est actif, Non lié (gris) sinon |
| Action | Bouton de suppression du lien pour les dossiers déjà mappés |
Relier un dossier
- Identifiez l'entité distante dans le tableau
- Dans la colonne Client local, ouvrez le menu déroulant et sélectionnez le dossier Node Pulse correspondant
- Le statut passe automatiquement à Lié
Supprimer un lien
Cliquez sur le bouton de suppression (icône de lien barré) dans la colonne Action. Le statut repasse à Non lié et le dossier n'est plus synchronisé.
Rechercher dans le tableau
Utilisez le champ Rechercher en haut à droite du tableau pour filtrer par nom d'entité, SIREN ou nom de client local. Pratique quand votre portefeuille compte des dizaines de dossiers.
Mode cabinet (multi-sociétés)
Si votre connecteur fonctionne en mode cabinet (compte multi-sociétés), un encadré bleu Mode cabinet actif s'affiche dans le sous-onglet Synchronisation : la synchronisation s'exécute alors sur le contexte distant mappé au dossier sélectionné. Chaque société distante doit donc être mappée individuellement à un dossier Node Pulse.
💡 Astuce
Un compteur en bas du tableau indique le nombre de dossiers liés sur le total (par exemple « 12 / 15 clients liés »). Visez 100 % avant de lancer une synchronisation en lot. Le bouton Rafraîchir, juste à côté, recharge la liste des dossiers distants.
Provisionner en lot
L'onboarding automatise la création des dossiers manquants et le mapping en une seule opération. Cette fonctionnalité est particulièrement utile lors du déploiement initial, quand vous connectez un portefeuille entier.
ℹ️ À savoir
L'onboarding en lot est disponible pour Pennylane, Fulll (RCA), Cegid Loop, Cegid Quadra et Sage Business Cloud. Il ne l'est pas pour ACD i-Suite Expert.
Prévisualiser l'onboarding
- Cliquez sur Prévisualiser onboarding en haut du tableau de mapping
- Node Pulse simule l'opération sans rien modifier et affiche un résumé :
- Nombre de mappings qui seraient créés ou mis à jour
- Nombre de dossiers locaux qui seraient créés (clients absents d'Node Pulse)
- Nombre de dossiers déjà liés (pas de changement)
- Nombre d'entités sans correspondance
- Nombre de conflits éventuels (même SIREN lié à deux dossiers différents)
- Nombre de synchronisations planifiées
⚠️ Attention
Vérifiez toujours la prévisualisation avant de lancer l'onboarding complet. Si des conflits apparaissent, résolvez-les manuellement dans le tableau de mapping.
Lancer l'onboarding complet
- Cliquez sur Onboarding complet
- Node Pulse exécute trois opérations en séquence :
- Création des dossiers locaux manquants (à partir du SIREN et du nom de l'entité distante)
- Mapping automatique de chaque entité à son dossier local
- Synchronisation des écritures pour tous les dossiers nouvellement mappés
L'opération s'exécute en arrière-plan. Une bannière bleue confirme le lancement et vous renvoie vers l'historique de synchronisation pour suivre l'avancement.
Synchroniser un dossier
La synchronisation unitaire importe les données d'un seul dossier client depuis votre logiciel comptable vers Node Pulse.
- Ouvrez le sous-onglet Synchronisation de Paramètres > Intégrations, puis repérez le bloc de votre connecteur
- Sélectionnez le client local à synchroniser dans le menu déroulant
- Cliquez sur Synchroniser
- L'opération s'exécute en arrière-plan — un message de confirmation s'affiche avec l'identifiant du traitement
Données importées
Chaque synchronisation récupère les données suivantes depuis votre logiciel comptable :
| Catégorie | Données |
|---|---|
| Clients et fournisseurs | Raison sociale, SIREN, SIRET, coordonnées de contact |
| Écritures comptables | Numéro de compte, date, libellé, montant au débit, montant au crédit |
| Axes analytiques | Codes et libellés des sections analytiques (si disponibles dans le logiciel source) |
ℹ️ À savoir
En mode cabinet, la synchronisation cible uniquement la société distante mappée au dossier sélectionné. Si le dossier n'est pas encore mappé, le bouton Synchroniser reste désactivé et un message vous invite à effectuer le mapping.
Synchroniser en lot — mode cabinet
Quand vous gérez plusieurs sociétés via un même connecteur, la synchronisation en lot vous évite de traiter chaque dossier un par un.
ℹ️ À savoir
La synchronisation en lot est disponible pour Pennylane, Fulll (RCA), Cegid Loop, Cegid Quadra et Sage Business Cloud. Elle ne l'est pas pour ACD i-Suite Expert, qui se synchronise dossier par dossier.
Prévisualiser la synchronisation en lot
- Cliquez sur Prévisualiser sync lot
- Node Pulse calcule le nombre de dossiers mappés qui seront synchronisés, sans lancer de transfert
Le résumé indique le nombre de dossiers planifiés. Vérifiez que ce chiffre correspond bien au nombre de dossiers que vous souhaitez mettre à jour.
Lancer la synchronisation en lot
- Cliquez sur Sync tous les dossiers mappés
- Tous les dossiers ayant le statut Lié dans le tableau de mapping sont synchronisés en parallèle
- L'opération s'exécute en arrière-plan — suivez l'avancement dans la file de jobs
💡 Astuce
Lancez la synchronisation en lot en début de semaine pour démarrer avec des données fraîches sur l'ensemble de votre portefeuille.
Suivre les synchronisations
File de traitements
Dans le sous-onglet Synchronisation, un panneau Jobs async (suivi du nom du connecteur, par exemple Jobs async Fulll) liste les opérations en cours et récentes. Chaque ligne affiche :
| Information | Description |
|---|---|
| Statut | Badge coloré — gris (PENDING), bleu (RUNNING), vert (COMPLETED), rouge (FAILED) |
| Type | Nature de l'opération : synchronisation d'un dossier, synchronisation en lot ou onboarding |
| Identifiant | Référence unique du traitement |
| Horodatage | Date et heure de lancement |
| Erreur | Message d'erreur en rouge si le traitement a échoué |
Quand un traitement est en cours, Node Pulse actualise automatiquement son statut toutes les 10 secondes.
Historique récent
La section Historique récent affiche les dernières synchronisations terminées, avec pour chacune :
- Un badge de statut coloré
- La date et l'heure d'exécution
- Le nombre d'éléments créés (en vert, par exemple +42)
- Le nombre d'éléments en erreur (en rouge, par exemple -3)
Métriques de débit (rate-limit)
Un encadré Métriques rate-limit (suivi du nom du connecteur) affiche trois indicateurs sur une fenêtre glissante de 60 minutes :
| Indicateur | Signification |
|---|---|
| Échantillons | Nombre total de requêtes observées |
| HTTP 429 | Nombre de requêtes rejetées par le serveur distant (quota dépassé) |
| Sous pression | Nombre de requêtes où le quota restant était faible |
Le détail du dernier échantillon est affiché en dessous : horodatage, point d'accès sollicité et nombre de requêtes restantes avant saturation.
ℹ️ À savoir
Ces métriques sont disponibles pour Pennylane, Fulll (RCA), Cegid Loop, Cegid Quadra et Sage Business Cloud. Le connecteur ACD i-Suite Expert n'en expose pas. Si le compteur HTTP 429 augmente, espacez vos synchronisations : Node Pulse gère automatiquement les ralentissements, mais des synchronisations trop rapprochées peuvent retarder l'ensemble du traitement.
Exploiter les données synchronisées
Une fois les écritures importées dans Node Pulse, elles alimentent automatiquement plusieurs fonctionnalités.
Prévisionnels et historique fiscal
L'historique fiscal des prévisionnels se remplit automatiquement à partir des écritures synchronisées. Les indicateurs réels (chiffre d'affaires, charges, résultat) servent de base de comparaison pour vos projections.
Reporting multi-dossiers
Avec le mode cabinet, les données de chaque société synchronisée alimentent le cockpit cabinet. Vous obtenez une vue consolidée de votre portefeuille sans ressaisie.
Export FEC
Les données synchronisées sont incluses dans les exports FEC générés depuis Node Pulse. Le fichier produit est conforme à la norme DGFiP et intègre les écritures issues de votre logiciel source.
Export vers le logiciel comptable
Depuis le sous-onglet Synchronisation, le bouton Exporter vers (suivi du nom du connecteur : Exporter vers Fulll, Exporter vers Cegid Loop…) pousse les données d'Node Pulse vers votre logiciel comptable : fiche client, écritures et données de prévisionnel.
⚠️ Attention
L'export est disponible pour Fulll (RCA), Cegid Loop, Cegid Quadra et Sage Business Cloud uniquement. Pennylane et ACD i-Suite Expert ne proposent pas d'export vers le logiciel : la synchronisation y est à sens unique, du logiciel vers Node Pulse. Notez aussi que l'export se déclenche immédiatement : il n'y a pas de prévisualisation avant envoi. Sélectionnez bien le dossier concerné avant de cliquer.
Cas d'erreur fréquents
| Erreur | Symptôme | Solution |
|---|---|---|
| Token expiré | Badge orange Token expiré sur la carte du connecteur | Reconnectez le connecteur depuis Paramètres > Intégrations (OAuth : relancez l'autorisation ; token API : saisissez un nouveau token) |
| Conflit de mapping | Lors de l'onboarding, le résumé affiche un nombre de conflits supérieur à zéro | Deux entités distantes pointent vers le même dossier local, ou inversement. Supprimez le doublon dans le tableau de mapping, puis relancez |
| Traitement échoué | Badge rouge FAILED dans la file de traitements, avec un message d'erreur | Lisez le message d'erreur. Causes courantes : token invalide, dossier supprimé côté logiciel source, ou erreur réseau temporaire. Relancez la synchronisation |
| Trop de requêtes (429) | Le compteur HTTP 429 augmente dans les métriques rate-limit | Attendez quelques minutes avant de relancer. Node Pulse ralentit automatiquement ses appels, mais une synchronisation en lot sur un gros portefeuille peut saturer le quota |
| Dossier non mappé | Le bouton Synchroniser est désactivé en mode cabinet | Mappez d'abord le dossier local à son entité distante dans le tableau de mapping |
| Aucun client trouvé | Le tableau de mapping est vide | Vérifiez que le connecteur est bien connecté (statut Connecté). Pour les connecteurs à token : vérifiez la clé API et les droits associés. Pour OAuth : relancez l'autorisation |
⚠️ Attention
Si un token OAuth expire, toutes les synchronisations planifiées sont suspendues. Reconnectez le connecteur dès que possible pour éviter un décalage de données.