Connexions logicielles actives et couplages
Créer des clés de connexion dans eConnect

Créer des clés de connexion (App Key et Secret), utiliser la Connexion rapide et révoquer une connexion.

Pour connecter votre logiciel comptable à eConnect, vous avez besoin de clés de connexion. Il s'agit d'une App Key et d'un Secret grâce auxquels votre logiciel communique de manière sécurisée avec la plateforme eConnect. Vous les créez en quelques étapes.

Que sont les clés de connexion ?

Les clés de connexion se composent de deux éléments :

  • App Key (également appelée Consumer Key) : le code d'identification de votre connexion
  • Secret (également appelé Consumer Secret) : le mot de passe qui sécurise la connexion

Ensemble, elles forment les identifiants grâce auxquels votre logiciel peut envoyer et recevoir des factures via eConnect. Traitez le Secret comme un mot de passe, ne le partagez pas publiquement.

Créer des clés
  1. Connectez-vous sur platform.econnect.eu.
  2. Allez dans Mon environnement et sélectionnez l'organisation pour laquelle vous souhaitez configurer la connexion.
  3. Naviguez vers Connexions ou Connecter un logiciel (selon la version de votre abonnement).
  4. Cliquez sur Créer une nouvelle connexion.
  5. Sélectionnez votre logiciel dans la liste.
  6. La plateforme génère votre App Key et votre Secret. Copiez-les immédiatement : le Secret n'est affiché qu'une seule fois.

Saisir les clés dans votre logiciel

Après la création, saisissez les clés dans votre logiciel. L'emplacement exact varie selon le logiciel, mais suit généralement ce schéma :

  • Ouvrez les paramètres ou la configuration de votre logiciel.
  • Recherchez la section e-facturation, eConnect ou Peppol.
  • Collez l'App Key et le Secret dans les champs prévus à cet effet.
  • Enregistrez les paramètres et testez la connexion.

Pour certains logiciels (comme via la Connexion rapide), vous pouvez coller les clés avec CTRL+V en une seule fois dans la fenêtre de connexion.

Connexion rapide

Avec la Connexion rapide, vous saisissez les clés de manière accélérée. Au lieu de copier l'App Key et le Secret séparément, une fenêtre de connexion s'ouvre dans laquelle vous collez les deux clés en une fois avec CTRL+V.

  1. Créez des clés de connexion (voir ci-dessus).
  2. Cliquez sur Connexion rapide à côté de la connexion créée.
  3. Une nouvelle fenêtre s'ouvre. Appuyez sur CTRL+V : les clés sont automatiquement importées.
  4. Sélectionnez l'administration pour laquelle vous souhaitez récupérer les factures.
  5. Saisissez l'adresse e-mail liée à l'administration dans votre logiciel (pas votre adresse e-mail eConnect).
  6. Définissez éventuellement une date de début.
  7. Choisissez si vous souhaitez également traiter les factures de vente.
  8. Cochez la confirmation et cliquez sur Appliquer.
Logiciels pris en charge pour la Connexion rapide
LogicielDirectionBaseconeRéception (achat + vente)Exact MultiversEnvoi + RéceptionWhiteVisionRéception (achat + vente)YukiRéception (achat + vente)RadarEnvoi

Conseil : l'adresse e-mail que vous saisissez lors de la Connexion rapide doit être l'adresse liée à l'administration dans votre logiciel. N'utilisez pas l'adresse e-mail de votre compte eConnect.

Connecter plusieurs organisations

Si vous gérez plusieurs organisations dans votre environnement, créez un jeu de clés de connexion distinct par organisation. L'App Key est unique par couple organisation-connexion. Il est possible d'utiliser la même clé API pour plusieurs organisations au sein du même logiciel, mais l'identifiant spécifique à l'organisation (comme l'eConnect ID) doit être configuré par organisation.

Clés perdues ?

Si vous avez perdu le Secret, vous ne pouvez pas demander un nouveau Secret ; vous devez créer un nouveau jeu de clés de connexion. Les anciennes clés deviennent alors invalides. N'oubliez pas de mettre à jour les nouvelles clés dans votre logiciel.

Sécurité

Les clés de connexion offrent un accès sécurisé à votre organisation eConnect. Tenez compte de ce qui suit :

  • Ne partagez les clés qu'avec la personne qui configure la connexion.
  • Conservez le Secret dans un endroit sûr (gestionnaire de mots de passe).
  • Si vous soupçonnez que les clés ont été compromises, créez-en immédiatement de nouvelles.
Révoquer une connexion

Vous souhaitez passer à une autre méthode de connexion ou arrêter d'utiliser un logiciel ? Vous pouvez révoquer la connexion.

  1. Connectez-vous sur platform.econnect.eu.
  2. Allez dans Connexions dans l'organisation concernée.
  3. Cliquez sur la connexion que vous souhaitez révoquer.
  4. Cliquez sur Révoquer la clé.
  5. La connexion est désormais inactive.

Après la révocation, vous pouvez supprimer entièrement la connexion : retournez à l'aperçu, cliquez sur les trois points à côté de la connexion révoquée et choisissez Supprimer la connexion.

Révoquez également la connexion dans votre logiciel. Sinon, le logiciel continue de tenter de communiquer via les anciennes clés.

Se reconnecter

Vous souhaitez vous reconnecter ? Créez un nouveau jeu de clés de connexion. Les anciennes clés ne fonctionnent plus après la révocation.

Attention : si vous passez à l'Autopilot, vous devez d'abord révoquer l'ancienne connexion. Deux connexions actives vers la même administration peuvent entrer en conflit.

Qu'advient-il de vos factures ?

La révocation n'affecte pas les factures déjà envoyées ou reçues. Les nouvelles factures ne sont plus échangées via l'ancienne connexion. Les factures qui étaient prêtes mais non récupérées peuvent être récupérées ultérieurement en vous reconnectant et en utilisant "Reproposer via l'API".

Questions fréquentes
Que faire si j'ai perdu mon Secret ?

Si vous avez perdu le Secret, vous ne pouvez pas en demander un nouveau. Vous devez créer un nouveau jeu de clés de connexion, ce qui invalide les anciennes clés. N'oubliez pas de mettre à jour les nouvelles clés dans votre logiciel également.

Puis-je utiliser les mêmes clés de connexion pour plusieurs organisations ?

Il est possible d'utiliser la même clé API pour plusieurs organisations au sein du même logiciel, mais l'identifiant spécifique à l'organisation (comme l'eConnect ID) doit être configuré par organisation. Pour une meilleure sécurité, il est recommandé d'utiliser un jeu de clés distinct par organisation.

Qu'advient-il de mes factures si je révoque une connexion ?

La révocation n'a aucun effet sur les factures déjà envoyées ou reçues. Les nouvelles factures ne sont plus échangées via l'ancienne connexion. Les factures qui étaient prêtes mais non récupérées peuvent être récupérées ultérieurement en se reconnectant.


Prêt à connecter votre logiciel ? Découvrez quelle méthode d'intégration convient à votre logiciel.

Créer des clés de connexion