La mise en place de l'API Silaé se fait au travers de deux étapes cruciales :
- La création d'un compte API
- L'activation de l'API pour la connecter à Eurécia
Qui est concerné par cet article ?
Nos clients effectuant une migration vers les API Rest de Silaé et surtout leur gestionnaire de paie en charge de réaliser ces actions.
Remplir le formulaire de demande de création d'un compte API
Au programme de cette section :
Étape 1 : La demande
Votre gestionnaire de paie doit effectuer la demande auprès de son commercial Silaé pour obtenir le formulaire d'accès au portail API Rest.
Vous n'êtes pas encore partenaire Silaé et vous n'avez pas de contact commercial chez Silaé ? Rien n'est perdu ! Vous pouvez contacter directement Silaé via ce formulaire : formulaire de contact Silaé.
Étape 2 : La complétion du formulaire
Ce formulaire est à remplir par le partenaire Silaé (Gestionnaire de paie, Expert-comptable,...).
Voici les éléments demandés par Silaé.
- Demandeur : L'adresse e-mail du partenaire Silaé (Gestionnaire de paie, Expert-comptable,...).
- Date de la demande : La date du jour où vous effectuez la demande.
- Contact commercial : Le nom de commercial Silae.
- Nom du partenaire : Le nom du partenaire ou du cabinet de paie ou de comptabilité.
- Modèle : Sélectionnez "Modèle 2".
- URL de sous-domaine : Attention, l'adresse doit suivre ce format spécifique : https://xxxxx.silae.fr, sans le www. Votre cabinet est généralement représenté par les XXX. En cas de doute, demandez à votre prestataire informatique.
- Nom du client : Indiquez ici le nom de la société cliente pour laquelle vous activez l'API.
- Usage API antérieur : Indiquez 'nouvel utilisateur' ou 'API rest'.
- Utilisateur pour l'environnement test : Il s'agit de l'e-mail convenu avec votre client pour la phase de tests. Les informations de connexion pour l'environnement test seront envoyées à cette adresse.
- Utilisateur portail API : Il s'agit de l'e-mail convenu avec votre client. Ce sera le login de l'utilisateur principal. C'est à cette adresse que sera envoyée l'invitation pour s'inscrire au portail API. Attention, le lien ne sera valide que 24h, l'utilisateur doit donc être présent sur cette période.
- Contact technique : Indiquez l'adresse mail de votre contact technique le cas échéant ou reprenez l'adresse mail précédente. Il sera destinataire des communications Silaé liées à l'API.
- Nom de la solution connectée à Silae : C'est nous : "Eurécia" ! 😊
|
Silaé enverra à l'adresse de l'utilisateur principal du portail API un mail d'invitation au portail API sous 15 jours. Attention, oui, on se répète mais cette invitation n'est valable que 24h !
|
Activer et connecter l'API REST
Vous avez reçu un mail de Silaé vous invitant à créer votre compte sur le portail Silaé ? C'est parfait ! Nous verrons ici quelles sont les informations attendues et comment procéder à l'activation de votre compte.
Lors de cette étape, les actions seront à réaliser alternativement par vous client et votre gestionnaire de paie.
|
Petit rappel crucial ! L'e-mail indiqué pour le portail API est capital. Pourquoi ? Parce que le formulaire envoyé ne sera valide que pour 24 heures. Il faut que le destinataire soit sur le qui-vive, prêt à agir promptement pour créer le compte portail API
|
|
|
Au programme de cette section :
- Le mail d'invitation au portail API Silaé (par le client)
- Étape 1 - Se connecter au portail API Silaé (par le client)
- Étape 2 - Activer le compte API (par le client final)
- Étape 3 - Préparation de de l'environnement de production dans Silaé (par le gestionnaire de paie)
- Étape 4 - Activation de la configuration d'accès API (par le client)
- Étape 5 - Établir la connexion avec Eurécia
Le mail d'invitation au portail API Silaé (par le client)
Le mail d'invitation au portail APi est envoyé par Silaé au contact principal désigné par votre gestionnaire de paie.
Attention, ce lien n'est valide que 24 h !
- Je clique sur le lien 'Création de mon compte',
- J'accède au formulaire ci-dessous :
- L'adresse mail est préremplie. Il ne faut pas la modifier.
- Je renseigne mon nom, prénom et mot de passe,
- Je clique sur 'Créer mon compte'.
|
Le mot de passe choisi doit être sécurisé et absolument conservé. Sans ce mot de passe, il ne sera pas possible d'établir la connexion avec Eurécia ni de procéder à d'éventuelles modifications. L'utilisation d'un gestionnaire de mots de passes est fortement recommandé !
|
Étape 1 - Se connecter au portail API Silaé (par le client)
Une fois mon compte crée dans les 24h, j'accède au portail API Silaé. Je peux l'ajouter dans les favoris de mon navigateur. 😉
Mes comptes API
- le compte de production, le VRAI !
- le compte de Test : le nom du compte commencera par 'TEST'
Ma société
Je retrouve :
- des informations générales,
- la liste des utilisateurs : c'est par ici qu'il faudra passer pour ajouter de nouveaux utilisateurs le cas échéant.
Étape 2 - Activer le compte API (par le client final)
Récupérer le client ID
- J'ouvre l'onglet 'Mes comptes API' dans mon portail API Silaé,
- Je clique sur les 'trois points' au bout de la ligne de mon compte de production et je choisis 'Modifier' :
Dans l'onglet Informations générales,
- Je copie le Client ID, que je conserve précieusement car il me sera utile par la suite !
- J'active le compte en switchant le bouton.
Générer le client Secret
Dans l'onglet 'Gestion des ClientsSecrets',
- Je clique 'Regénérer',
- Je copie le ClientSecret, que je conserve aussi très précieusement, il me sera utile par la suite.
L'étape suivante sera à effectuer par votre gestionnaire de paie. Contactez-le afin qu'il procède aux manipulations directement sur Silaé.
Une fois qu'il aura terminé sa partie, vous pourrez continuer la procédure ! Courage, nous y sommes presque. 😊
Étape 3 - Préparation de de l'environnement de production dans Silaé (par le gestionnaire de paie)
|
Cet accès est réservé aux administrateurs ou aux équipes techniques.
|
Premier cas : Une clé d'accès est configurée dans les dossiers de paie
Créer un contact API
Lorsqu'une clé d'accès a été associée au dossier dans SILAE comme ci-dessous :
La première étape consiste à créer un contact dans le dossier de paie pour permettre la synchronisation Eurécia/SILAE sans avoir besoin d'envoyer la clé d'accès au dossier dans les requêtes API.
Dans le dossier de paie concerné :
- Je clique sur 'Relation Client' > 'Contact' puis 'Créer un contact'
- Je complète la fiche du contact en y associant les paramètres suivants : Nom, Prénom, adresse mail
- Je coche la case 'Ce contact peut se connecter'
- Je renseigne l'identifiant
- Je clique ensuite sur 'changer les droits' et je les définis comme ci-dessous
|
Il est important de mettre un mail valide et accessible afin de pouvoir finaliser la création du compte via la messagerie
|
- J'initialise le compte via le mail envoyé par SILAE à la suite de la création du contact
Deuxième cas : Pas de clé d'accès configurée
Créer un utilisateur-APi
La première étape consiste à créer un utilisateur fictif qui ne sera utilisé que pour la connexion API. Le mail utilisé sera donc aussi fictif.
Nous recommandons d'utiliser un mail de type : api-eurecia@votrenomdedomaine.com ou api-client-eurecia@votrenomdedomaine.com
Vous ne souhaitez pas utiliser votre nom de domaine ? Vous pouvez aussi utiliser notre nom de domaine @emaileurecia.com. Il est maitrisé et sécurisé !
|
Les adresses mails fictives ne doivent JAMAIS être renseignées en utilisant des noms de domaines non-maitrisés comme @pasdemail.fr ou @mailfictif.com. Des informations potentiellement sensibles ou des mails permettant la réinitialisation du mot de passe pourraient être envoyés vers cette adresse.
|
Pour créer un utilisateur dans Silaé :
- Dans l'onglet 'Admin.collaborateurs', je clique sur 'Créer un collaborateur',
- Je le sélectionne dans la liste en le cochant,
- Je clique sur 'Droits',
- Je clique sur 'Accès à la gestion des droits' :
- J'active les droits en cochant 'Production', 'Gestion interne' et 'Analyse de production'. Tous les droits inclus dans Analyse de production doivent être cochés (en se servant du +).
- Je clique sur 'Valider et fermer'.
Configurer l'accès API
Dans la configuration API (onglet Paramétrage paie > API) :
- Je clique sur 'Créer une configuration',
- Dans le champ 'Compte API', je sélectionne le compte API de mon client (NOM DE MA SOCIETE - NOM DU CLIENT),
- Dans le champ 'Utilisateur Silaé', je sélectionne l'utilisateur ou le contact précédemment créé
|
Le compte utilisateur peut mettre du temps à s'afficher. Un redémarrage de Silaé peut-être nécessaire.
|
- Je coche 'Accès à un ou plusieurs dossiers' et ajouter uniquement les dossier de paie du client concerné. Cela déterminera le nombre de bulletins facturés par Silaé.
Et voilà, c'est tout pour vous ! 😊
Il ne reste qu'à transmettre à notre client commun l'ID unique de configuration API' que vous trouverez dans l'onglet 'Paramétrage paie > API'.
Étape 4 - Activation de la configuration d'accès API (par le client)
- J'ouvre l'onglet 'Mes comptes API' dans mon portail API Silaé,
- Grace à l'ID unique de configuration API fourni par mon gestionnaire de paie, j'identifie le compte à activer, et je clique sur les 'trois points' au bout de la ligne et je choisis 'Modifier',
- Dans l'onglet 'Configuration d'accès API', je clique sur les 'trois points' en bout de ligne de mon accès API',
- je clique sur 'Activer'.
- je clique sur 'regénérer clé principale'. Cette Subscription Key (composée de 32 caractères hexadécimaux) doit elle aussi être conservée très précieusement pour la suite.
Étape 5 - Établir la connexion avec Eurécia
Accès : Espace admin > Paramètres généraux> Fiche société > Onglet Paramétrage
Voilà, vous y êtes !
Il ne vous reste plus qu'à vous armer des 3 informations indispensables :
- le ClientID, que vous avez obtenu à l'étape 2,
- le ClientSecret, que vous avez obtenu à l'étape 2,
- la SubscriptionKey, que vous avez obtenu à l'étape 4.
Rendez-vous maintenant sur Eurécia et allez dans Espace admin > Paramètres généraux> Fiche société > Onglet Paramétrage.
Dans l'encart 'Synchronisation logiciel de paie' :
- Dans "Logiciel cible", je sélectionne "SILAE avec API REST" dans la liste déroulante ,
- Je renseigne :
- le ClientID,
- le ClientSecret,
- la SubscriptionKey.
- J'enregistre.
|
il peut aussi être renseigné par structure dans l'onglet Organisation > Encart Structure.
|
Et voilà, c'est fini !
Mots clés associés à cet article :Silaé - silae - silaeexpert - APi - REST - SOAP - migration - synchronisation configurer - configuration - connexion
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.