Before the Silae integration through Kombo can take place, there is some setup necessary that can be tricky if done for the first time. This guide will help you to navigate the complexity.

Involved stakeholders

• End-customer: Your customer and the company using Silae for their payroll
• SaaS Vendor (You): The software application that wants to read data from Silae or write/update data in the system 
• Accountant/Silae partner: The accountant that takes care of payroll for the end-customer. The accountant is also the main point of contact for the end-customer regarding this integration as Silae doesn't really get in touch with end-customers
• Kombo: We built the software to exchange data with Silae. Once the end-customer has authorized the connection, you will use our API to interact with the Silae system
• Silae: Silae enables the API and also takes care of the billing

Non-technical setup

1. The end-customer reaches out to the accountant, letting them know that they would like to get access
2. The accountant reaches out to Silae, requesting access to the Silae REST API (it's important that they request access to the REST and not the outdated SOAP API; read more here)
   
   • They will either directly reach out to their Silae sales contact
   • or alternatively get in touch with them via the contact form
3. 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
4. The accountant has to provide the following details to Silae for finalizing the access:
   • Company Name of the end-customer
   • Silae-subdomain in the format of https://<subdomain>.silae.fr
   • Main user: Email address of a staff member of the end-customer. They will get an invite to the API portal later
   • Technical contact: Email address of a staff member of the end-customer that will receive all information concerning the API (can be the same as the main user)
   • Main test user: Email address of a staff member that will be the main user for the Silae test domain (can be same as the main user)
   • API usage model: Silae has different models for using their API. For this case, Model 2 (Modèle 2) is needed
5. 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 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

1. Log into the API portal under https://api-portal.silae.fr/
2. Open the API accounts tab (Mes comptes API)
3. Click on the three dots at the right of your API account and then on "Éditer"
4. 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
   
5. Now, in the tile where it says "ClientSecret Principal", click on "Regénérer"
   
6. 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
   
7. 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

1. Log into the Silae Client application
2. At the top, go to API
3. At the very right, click on "Créer une configuration"
4. 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 is able to do. It's therefore important to take into account what rights they have

Activate the API access configuration

This step is done by the end-customer via the API Portal

1. Log into the API portal under https://api-portal.silae.fr/
2. Open the API accounts tab (Mes comptes API)
3. Click on the three dots at the right of your API account and then on "Éditer"
4. 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
5. Lastly, click on the 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

FAQ

Billing

There are two APIs of Silae

What is the API portal