Catalogue des intégrations
Parcourir les connecteurs disponibles pour un dossier, les activer, les configurer, lancer une synchronisation et lire son historique.
L'onglet Intégrations présente les connecteurs qui alimentent un dossier depuis ses sources : documents, mouvements bancaires, immobilisations. Chaque connecteur s'active dossier par dossier. Cette page décrit l'écran et les actions communes ; les connecteurs disponibles ont chacun leur page.
Le catalogue
Chaque connecteur est présenté sous forme de carte, avec son nom, sa catégorie, une description, ses capacités et son état.
| Connecteur | Catégorie | État | Capacités |
|---|---|---|---|
| Novadesko | Comptabilité | Disponible | Import de documents, import bancaire, import des immobilisations |
| Peppol | Facturation électronique | Disponible | Facturation électronique |
| Import de fichiers | Documents | Disponible | Import bancaire, import de documents |
| Codabox | Banque | Bientôt | Import bancaire, import de documents |
| Codabill | Documents | Bientôt | Import de documents |
| Magello | Comptabilité | Bientôt | Import de documents, export des écritures |
| Ponto | Banque | Bientôt | Import bancaire |
Le champ Rechercher un connecteur… filtre par nom. Deux filtres rapides, Disponibles et Bientôt, limitent l'affichage selon l'état. Si aucun connecteur ne correspond, l'écran l'indique.
Le catalogue est géré par la plateforme. Un connecteur peut être masqué par l'administrateur ; il reste alors visible uniquement pour les dossiers où il est déjà connecté.
Les actions d'une carte
Les boutons proposés dépendent du connecteur et de son état pour le dossier.
| Bouton | Quand il apparaît | Effet |
|---|---|---|
| Activer | Connecteur disponible, non connecté | Ouvre la fenêtre d'activation, avec les paramètres à renseigner s'il y en a. |
| Configurer | Connecteur connecté qui demande des paramètres | Modifie les paramètres de connexion. |
| Synchroniser ou Importer | Connecteur connecté doté d'une synchronisation | Lance un import immédiat. |
| Tester la connexion | Idem | Vérifie que la connexion fonctionne, sans rien importer. |
| Ouvrir | Connecteur piloté depuis un autre onglet | Vous amène à l'onglet concerné. C'est le cas de Peppol. |
| Désactiver | Connecteur connecté | Arrête la synchronisation. |
| Me prévenir | Connecteur annoncé « Bientôt » | Enregistre votre intérêt. |
Activer un connecteur
- Sur la carte, cliquez sur Activer.
- Si le connecteur demande des paramètres, renseignez-les. Les champs marqués d'un astérisque sont obligatoires. S'il n'en demande aucun, la fenêtre vous invite simplement à confirmer.
- Validez. La carte passe à l'état Connecté.
L'activation est enregistrée dans la piste d'audit du dossier.
Modifier la configuration
Cliquez sur Configurer. Les champs secrets, comme une clé d'API, n'affichent jamais leur valeur complète : seule une forme masquée est rappelée, avec la mention « Laissez vide pour la conserver ». Saisissez une nouvelle valeur uniquement si vous voulez la remplacer.
Les paramètres de connexion d'un dossier sont stockés chiffrés. Ils n'apparaissent pas dans l'historique des modifications.
Synchroniser et lire le résultat
- Cliquez sur Synchroniser.
- À la fin, un message résume ce qui a été importé : nombre de documents, de mouvements bancaires et d'immobilisations.
- La carte affiche la date de la Dernière synchro.
En cas d'échec, le message « La synchronisation a échoué » est suivi du motif renvoyé par le connecteur, et l'état de la carte passe à Erreur.
Le détail d'un connecteur
Un clic sur la carte ouvre le détail, organisé en quatre blocs :
- Capacités : ce que le connecteur sait importer ou exporter ;
- État de connexion : Connecté, Déconnecté ou Erreur ;
- Configuration : les paramètres enregistrés, secrets masqués ;
- Historique des synchronisations : chaque exécution avec sa date, son statut (En cours, Réussie, Erreur) et son résumé.
Quand une synchronisation ne ramène pas ce que vous attendiez, ouvrez l'historique des synchronisations avant de la relancer. Le résumé de la dernière exécution indique souvent la cause : fichier déjà importé, source non liée, connexion refusée.
Désactiver un connecteur
- Cliquez sur Désactiver.
- Confirmez. Le message rappelle que la synchronisation sera arrêtée, que les données déjà importées restent dans le dossier et que la configuration est conservée.
Vous pouvez réactiver le connecteur plus tard sans ressaisir ses paramètres.
La connexion Novadesko d'un dossier importé de Novadesko ne peut pas être désactivée : elle est constitutive du dossier.
Peppol dans le catalogue
Peppol figure dans le catalogue pour mémoire, mais il ne s'active pas ici. Sa carte reflète l'état de l'inscription du dossier et propose Ouvrir, qui mène à l'onglet Peppol. Une tentative d'activation directe renvoie le message « Peppol s'active depuis l'onglet Peppol du dossier ».
Connecter un autre logiciel
Si la source que vous cherchez n'est pas au catalogue, deux voies existent :
- déposer des fichiers avec le connecteur Import de fichiers ou l'importateur de documents ;
- utiliser l'API publique de NovaFisko, qui permet à un logiciel tiers de pousser des documents et de lire les données d'un dossier. Voir la documentation de l'API.