Mapper, synchroniser et exploiter un connecteur
Vous avez connecté votre logiciel comptable à Impera — Pennylane, Fulll, Cegid Loop, Cegid Quadra ou Sage Business Cloud. Il reste maintenant à relier vos dossiers distants à vos clients Impera, lancer les synchronisations et tirer 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
ℹ️ À savoir — Le mapping et la synchronisation sont réservés aux utilisateurs Expert-Comptable et Administrateur. Les Collaborateurs ont un accès limité en lecture. Les utilisateurs Client n'ont pas accès à l'onglet Intégrations.
- Un connecteur actif (statut Connecté) — voir Connecter un logiciel comptable
- Au moins un client créé dans votre cabinet Impera (avec son SIREN renseigné, de préférence)
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 Impera. Sans ce lien, aucune synchronisation n'est possible.
- Rendez-vous dans Paramètres > Intégrations
- Sur la carte de votre connecteur, repérez la section Mapping — un tableau s'affiche avec la liste des entités récupérées depuis votre logiciel
Le tableau contient cinq colonnes :
| Colonne | Contenu |
|---|---|
| Entité distante | Nom du client ou de la société dans votre logiciel comptable |
| SIREN | Numéro SIREN récupéré automatiquement (si disponible) |
| Client local | Menu déroulant pour sélectionner le dossier Impera 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 Impera 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 au-dessus du tableau. Chaque société distante doit être mappée individuellement à un dossier Impera pour que la synchronisation multi-sociétés fonctionne.
💡 Astuce
💡 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.
Provisionner en lot
Le provisioning 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.
Prévisualiser l'onboarding
- Cliquez sur Prévisualiser onboarding en haut du tableau de mapping
- Impera simule l'opération sans rien modifier (dry-run) 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'Impera)
- 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
⚠️ 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
- Impera 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 Impera.
- Dans la section Synchronisation (sous le tableau de mapping), 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 job
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
ℹ️ À 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.
Prévisualiser la synchronisation en lot
- Cliquez sur Prévisualiser sync lot
- Impera 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
💡 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 jobs
Sous la section de synchronisation, un panneau Jobs async liste les opérations en cours et récentes. Chaque job affiche :
| Information | Description |
|---|---|
| Statut | Badge coloré — gris (PENDING), bleu (RUNNING), vert (COMPLETED), rouge (FAILED) |
| Type | Nature de l'opération : synchronisation unitaire, synchronisation en lot ou provisioning |
| Identifiant | Référence unique du job |
| Horodatage | Date et heure de lancement et de fin |
| Erreur | Message d'erreur en rouge si le job a échoué |
Quand un job est en cours, Impera 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)
Pour les connecteurs qui exposent des limites d'appels (notamment Pennylane et Fulll), un encadré Rate-limit 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 |
Un détail du dernier échantillon est affiché en dessous : horodatage, point d'accès sollicité et nombre de requêtes restantes avant saturation.
ℹ️ À savoir
ℹ️ À savoir — Si le compteur HTTP 429 augmente, espacez vos synchronisations. Impera 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 Impera, elles alimentent automatiquement plusieurs fonctionnalités.
Rapprochement comptable
Les écritures synchronisées sont disponibles dans le module Comptabilité. Elles apparaissent dans le grand livre et la balance, et peuvent être rapprochées avec vos relevés bancaires importé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 Impera. Le fichier produit est conforme à la norme DGFiP et intègre les écritures issues de votre logiciel source.
Export vers le logiciel comptable
Pour les connecteurs qui le supportent (Fulll, Cegid Loop, Quadra, Sage Business Cloud), le bouton Exporter permet de pousser des données depuis Impera vers votre logiciel comptable (fiches clients, écritures, données de prévisionnel).
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 du provisioning, 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 |
| Job échoué | Badge rouge FAILED dans la file de jobs, 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. Impera 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
⚠️ 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.