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.

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.

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.

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.

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.

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.

L'une des connexions que vous créez via la Connexion rapide s'appelle dans la plateforme connecteur Email. Attention : malgré son nom, celui-ci fonctionne via des clés de connexion et la connexion appartient aux Connexions -- aucun e-mail n'est soumis. Ne le confondez pas avec l'Email Receiver : c'est une application avec laquelle vous recevez vous-même des factures par e-mail sur la plateforme. Le connecteur Email fait l'inverse : il transfère automatiquement les factures reçues via eConnect vers une adresse e-mail de votre choix.

Outre le connecteur Email standard, il existe des variantes qui transforment le document reçu dans un format spécifique (toujours SI 2.0, toujours BIS v3, toujours SI 1.2 ou toujours SALES005 Facture). La configuration est identique à celle du connecteur Email standard ; eConnect assure la livraison dans le format choisi.

En tant que destinataire, vous pouvez créer un connecteur Email pour faire transférer automatiquement les factures reçues via eConnect vers une adresse e-mail spécifiée. Par défaut, seul le XML est envoyé -- pas de PDF ni d'autres pièces jointes. Ce comportement est déterminé par le paramètre excludeAdditionalAttachments :

• excludeAdditionalAttachments=true (par défaut) : les pièces jointes supplémentaires comme un PDF ne sont pas envoyées.
• excludeAdditionalAttachments=false : le PDF et d'éventuelles autres pièces jointes sont également envoyés.

Pour le connecteur Email standard (l'auto-hook Collabrr), ce paramètre est défini sur true. Si vous souhaitez également recevoir le PDF, seul le Techsupport peut l'ajuster.

Attention après un ajustement du Techsupport : si vous, en tant que client, modifiez ensuite vous-même le connecteur Email, cette modification écrase automatiquement l'ajustement du Techsupport. Le PDF sera alors de nouveau supprimé et ne sera plus envoyé. Ne modifiez pas vous-même le connecteur après la correction.

Si vous utilisez plutôt le mailhook dans le PSB et configurez vous-même le connecteur, vous pouvez alors définir vous-même ce paramètre -- c'est une voie de self-service séparée et autonome.

Ce transfert est une alternative appropriée pour un destinataire qui n'est pas (encore) sur Peppol mais souhaite tout de même récupérer automatiquement les données de facture ou le document PDF.

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.

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.

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.

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.

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.

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".

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