Introduction
💡 Important information:
The access requires specific authorizations (company manager).⚠️ If you’re already using Javelo and have users in the app, please read Preparing Javelo for External User Source Integration before proceeding.
The setup of the Silae connection is split up into two parts:
Non-technical setup: This is done together with your accountant, as they will have to reach out to Silae for you to get everything set up. This process can sometimes take a few days to a few weeks.
Setup: Once everything is prepared, the actual setup is straightforward. This is where you generate your API credentials and enter them into the connection flow. You also need your accountant for some of the steps here, but if you go through this together, it should take 15 minutes at most.
Non-technical setup
Contact your accountant to let them know you want to set up the Silae API integration.
The accountant will contact Silae and request access to the Silae REST API (they must request access to the REST and not the outdated SOAP API; read more here).
They will contact directly to their Silae sales contact.
Alternatively, get in touch with them via the contact form.
As access to the Silae API is paid (read more here), the accountant will either sign an appendix to their distribution contract that covers access to the REST API or sign the distribution contract.
The accountant has to provide the following details to Silae for finalizing the access:
Company Name of your company
Silae-subdomain in the format of https://<subdomain>.silae.fr
Main user: Your email address or the email of one of your colleagues. This email will get an invite to the API portal later in the process
Technical contact: Email address of you or a colleague who will receive all information concerning the API (can be the same as the main user)
Main test user: Email address of you or a colleague that will be the main user for the Silae test domain (can be the same as the main user)
API usage model: Silae has different models for using its API. For this case, Model 2 (Modèle 2) is needed.
Once the contract is signed and the information is submitted, Silae will create an API account and send a login/confirmation email to the main user's email address that was shared before.
Setup
Generate client ID and client secret
This step is done by the end-customer via the API Portal
Log into the API portal under https://api-portal.silae.fr/.
Open the API accounts tab (Mes comptes API).
Click on the three dots at the right of your API account and then on "Éditer".
Go to the tab "Gestion des ClientSecrets"
Copy the Client ID and store it somewhere safe, as it's later needed for the API connection.Now, in the tile where it says "ClientSecret Principal", click on "Regénérer"
The next step informs you that the client secret can only be seen once. If you lose it you have to invalidate the old one and create a new one Click "Valider" to continue.
Copy the client secret and store it somewhere safe, as it's later needed for the API connection.
Create a new API access configuration
This step is done by the accountant via the Silae Client application
Log into the Silae Client application.
At the top, go to API.
At the very right, click on "Créer une configuration".
Select the API account, the Silae user and the payroll folders that should be accessed via API.
It is only possible to do the things via API that Silae user selected here can do. It's therefore important to take into account what rights they have
Activate the API access configuration
Log into the API portal under https://api-portal.silae.fr/
Open the API accounts tab (Mes comptes API)
Click on the three dots at the right of your API account and then on "Éditer".
Go to the tab "Configurations d'accés API"
Click on the three dots at the right of the API access configuration
Click "Activer" to activate it.Important note: Once you activate the API access configuration, the billing cycle will start. To learn more about the pricing structure of the integration, read more here.
Lastly, click on the three dots again and then on "Regénérer clé principale" to view the key of the API access configuration
Copy the API access key and store it somewhere safe, as it's later needed for the API connection.
Create the connection
Once you have the client ID, client secret, and API access configuration key, you can put them into the connection modal to finish setting up the integration in Javelo :
Go to “Settings" (⚙️ icon) in the upper right corner of your Javelo account.
Select “Integrations” from the navigation menu under the Company section.
Click "Connect" in the "Silae" panel.
Fill in the client ID, client secret, and API access configuration key
Finally, click "Apply" at the bottom right of the modal.
What is synchronized with Silae?
⚠️ Users need to have an unique email addresses. User with duplicate email address will not be synchronised. Users with no email address will not be synced.
The following employee information can be synced from the platform Silae to Javelo:
Mandatory attributes
First name
Last name
E-mail address
👉 You can find more details about the user’s attributes here.