Télécharger la fiche au format PDF

API Isidoor

Temps de lecture estimé : 1 min
Télécharger la fiche au format PDF

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

Point de terminaison /V2/Salarie

Cet article vous a t-il aidé ?
Non 0
Vues : 170
Aller en haut