Intégrations

Guide Utilisateur - Connecteurs Comptables

A quoi servent les connecteurs

Les connecteurs permettent de:

  • recuperer les clients depuis votre logiciel comptable,
  • relier ces clients a vos dossiers Impera (mapping),
  • synchroniser des ecritures,
  • exporter les donnees Impera (client, ecritures, previsionnel).

Connecteurs disponibles:

  • Pennylane
  • Full (RCA)
  • ACD i-Suite Expert
  • Cegid Loop
  • Cegid Quadra
  • Sage 50
  • Sage 100
  • Sage Business Cloud

Ou configurer

Dans Impera:

  1. Dashboard
  2. Parametres
  3. Integrations

Chaque connecteur a sa carte dediee.

Bouton aide sur chaque connecteur

Un bouton i est disponible en haut a droite de chaque carte connecteur.

Ce panneau d aide donne:

  • les prerequis,
  • les etapes de configuration,
  • les points de controle avant sync/export.

Procedure standard (tous connecteurs)

  1. Connecter le logiciel (OAuth, token API ou acces i-Suite selon le connecteur).
  2. Verifier que le statut passe en Connecte.
  3. Faire le mapping client externe -> dossier Impera.
  4. Lancer une synchronisation.
  5. Lancer un export dry-run pour verifier.
  6. Lancer ensuite l export reel.

OAuth vs token API

  • OAuth: vous autorisez Impera depuis la page du provider (ex: Pennylane, Sage Business Cloud).
  • Token API: vous collez la cle API dans le champ de connexion (ex: Full, Cegid, Sage 50/100).
  • i-Suite Expert: vous saisissez l URL i-Suite, le CNX, le login et le mot de passe (ACD).

Bonnes pratiques

  • Toujours commencer par un dry-run.
  • Eviter de connecter plusieurs dossiers Impera au meme client externe.
  • Refaire une sync apres changement de mapping.
  • En cas de doute, deconnecter/reconnecter le connecteur puis recontroler le mapping.

Problemes frequents

  • Verification KO: token invalide, scope insuffisant, ou endpoint provider non accessible.
  • Aucun client: verifier Company ID et droits API.
  • State invalide (OAuth): relancer la connexion OAuth depuis Impera.

Aide supplementaire

  • Checklist de prod: docs/INTEGRATIONS_PROD_CHECKLIST.md
  • Doc technique: docs/technical/integrations/INTEGRATIONS_COMPTA_ARCHITECTURE.md