Votre structure utilise des logiciels de Gestion que vous souhaitez combiner avec les applications proposées par Isidoor ? Cet article vous explique comment utiliser notre API pour les développeurs de votre éditeur de Paie ou Comptabilité !
Introduction
Isidoor met à la disposition des associations une API qui leur permet de lier des applications externes à celles proposées par Isidoor.
Ces informations peuvent être utilisées à diverses fins :
- Synchroniser les salariés avec vos applications
- Transférer chaque mois les éléments permettant d’établir les bulletins de Paie lorsque ce traitement est externalisé
- Mettre en place l’espace salarié proposé par la branche professionnelle
- et bien d’autres encore !
Autorisation d’accès
Une fois que vous votre éditeur aura implémenté l’API Isidoor dans son logiciel, vous devrez copier votre clé Isidoor dans votre paramétrage de ce logiciel, lui permettant ainsi de communiquer avec votre dossier Isidoor.
Notice pour les éditeurs
Authentification
L’API Isidoor est sécurisée par l’utilisation du protocole OAuth2. Vous devez obtenir de l’administrateur Isidoor (admin@fnogec.org), un CLIENT_ID et un CLIENT_SECRET propre à chaque éditeur.
Pour pouvoir utiliser les points d’API Isidoor vous devez d’abord obtenir un token d’accès en
appelant le serveur d’authentification OAuth 2.0 : https://www.isidoor.org/Auth
Pour obtenir un token d’accès (access_token), procédez à un appel POST sur l’URL
https://www.isidoor.org/Auth/connect/token
Header :
content-type: application/x-www-form-urlencoded
Body :
client_id : votre client id
client_secret : votre client secret
grant_type : « client_credentials »
scope : « ApiIsidoor »
Environnements
Isidoor possède un environnement de test et de production :
- Environnement de production : https://www.isidoor.org/Api/V2
- Environnement de test : https://www.isidoor.org/Api2/V2
Utilisation de l’API Isidoor
Les données échangées sont au format JSON.
Les fonctions disponibles sur l’API Isidoor sont consultables par cette url : https://www.isidoor.org/Api2/swagger/ui/index
Pour chaque appel de l’API Isidoor, il faut préciser dans le Header :
authorization: “Bearer “ + votre access_token récupéré dans Authentification
Tester la connexion avec un dossier Isidoor
Pour tester la connexion d’un dossier de Paie avec le dossier Isidoor correspondant :
Point de terminaison /V2/Dossier
Il faudra préciser la Clé API du dossier Isidoor (voir Autorisation d’accès)
Initialiser le dossier Isidoor avec les salariés présents dans le logiciel de Paie
Certaines rubriques de la fiche salarié font appel à des nomenclatures accessibles par
Point de terminaison /V2/Dictionnaire
Pour transférer les salariés dans le dossier Isidoor