Establishing the Tellent HR and Silae connection

A. Connection Requirements

Before connecting Tellent HR to your Silae account, your accounting firm or payroll manager must contact Silae to request access to the Silae Rest API covering all relevant dossiers and obtain the following three credentials:

The Client ID
The Client Secret
The API Subscription Key (clé de configuration d'accès API)

Silae can take a few weeks to grant you access to their API. Once granted, you'll be able to obtain your credentials by following Silae's provided instructions: https://silae-api.document360.io/docs/partenaire-premiere-connexion-au-portail-api.

Once you’ve obtained your credentials, proceed with the connection setup.

B. Connection Setup

To get help setting up the integration with Silae, you can contact our certified service partner: Resolution Project.

1. In Tellent HR, go to Settings > Configuration > Integrations > Apps > Silae. If the Silae listing does not appear in your Apps view, please reach out to Tellent HR customer support.

2. Open the Silae integration listing and click the + Connect new SILAE instance button.

3. Enter the name that will help you identify this connection in Tellent HR interface and click Connect in the bottom right.

4. Follow the instructions that appear on the Silae connector modal. Throughout the authentication process, you will have to provide your Client ID, Client Secret and API Subscription Key.

5. After providing the credentials, click Set up connection and wait until the connection is established. This usually takes about one minute.

6. Once the connection is established, select the Dossier corresponding to your entity.

📌 Note: For organizations with multiple legal entities, the integration supports managing multiple Silae dossiers. You simply need to set up a connection for each dossier using the same API credentials.

7. Next, click Assign employees in the Employees tab to select Tellent HR users whose data will be exchanged with Silae in this connection. For each user, select the corresponding user account in Silae.

8. Then, open the Time Off tab to match the Tellent HR and Silae absence types that you want to synchronise in this connection.

9. Click Save changes to confirm your connection settings.

Syncing employee data with Silae

A. Employee data synchronization

Tellent HR synchronizes the following employee data with Silae:

Tellent HR record name	Silae record name	Field Required	Notes
First name	Prenom	yes
Last name	Nom usuel	yes
Social Security Number	NIR	yes	The Social Security number needs to match with the date of birth.
Account number	IBAN	no
BIC	BIC	no
Account email	EmailPro	no
Date of birth	Data de naissance	no	The Date of birth needs to match with NIR.
Gender	Civilite	no
Nationality	codePaysNationalite	no
Personal phone	telPortable	no
Personal email	eMail	no
Country (name)	pays	no
Postal code	codePostal	no
City	nomVille	no
Country (code)	codePays (Ex. “FR”)	no

B. Creating a new user in Silae via Tellent HR

Through the integration, you can create a new user in Silae by following these steps:

Add a new employee to Tellent HR by navigating to Employees > List > Add employee.
Fill in the employee’s details, such as email address, first name, and last name.
Set up access by toggling on HR and select the desired role from the dropdown menu.
Click Add 1 member.
Fill in Employment information and click Save Changes.
Go to the employee profile to add his social security number and complete his profile data.
Once the employee profile is complete, navigate to the Silae Integration details.
Select the desired connection and click Edit assignees in the Employees tab.
Select the newly created profile and click Assign.
Select + Create new under SILAE User section and click Save changes.

Syncing time off requests from Tellent HR and importing payslips from Silae

A. Syncing time off requests with Silae

Once approved, time off requests are automatically sent from Tellent HR to Silae in real time if the following conditions are met:

Your Tellent HR instance is connected to a working Silae instance.
The time off type selected for a request is correctly matched with Silae absence type in the connection settings.
The user for whom the time-off request is created is correctly assigned to a connection and matched with their account in Silae.
The user for whom the time-off request is created has an employment start date recorded in Silae.

⚠️ Important: Absence requests that were approved in Tellent HR before activating the connector are not synchronized with Silae. You can export them via the Time Off > Requests tab or via the Pay run and send them to your payroll manager.

Tellent HR sends to Silae the following information:

Date range of absence
Absence type
Requester’s comment

If you wish to add more information to a particular time off request, that has to be done from the Silae interface.

B. Distributing Silae payslips within Tellent HR

Within the integration, Tellent HR can retrieve from Silae payslips for a particular month and securely distribute them to employees through the Payroll module.

To get and distribute payslips, first you need to create a Pay run. It is a feature of the Payroll module that allows to gather payroll-relevant data for selected employees within a specified pay period.

1. Go to Payroll > Pay runs > New.

2. Select the month for which payslips are going to be retrieved. It is also obligatory to select payment date and user that will serve as an Approver. Those choices will not affect the process of downloading and distributing payslips. Click Add to confirm.

📌 Note: Please note, that to get the payslips from Silae correctly, the entire month has to be selected. If you switch pay period to a custom range that does not cover the entire month, payslips will not be downloaded from Silae.

3. Assign to created pay run all employees for which you wish to import and distribute payslips.

4. In the top-right corner, press the SILAE button and select Import payslips.

5. From the modal, choose your Silae connection. The system will then display a summary of employees whose payslips will be imported (those assigned to both a pay run and the selected Silae connection). After reviewing this summary, click Import payslips.

6. Confirm the action again in the next modal by clicking Import Payslips.

7. In the pay run details section, you will see that the payslips are being synced. Once imported, you will see the timestamp of successful operation.

8. You can preview the payslips that were imported by going to Salary and opening the files that appeared next to each employee.

📌 Note: Employees do not see the payslips until pay run is marked as Closed.

9. To distribute payslips to employees, close the pay run by pressing the Close pay run button in the top right corner.

10. Once pay run is closed, employees will receive in-app notification and (accordingly to notification settings) e-mail about their pay sheets being available in their Tellent HR profiles.

11. Employees will see the pay sheet summaries in their profile, where they’ll also be able to download Silae payslips.

FAQs:

General

Is this integration available for free with my current Tellent HR plan?

No, the integration is offered as an optional add-on at an extra cost.

I do not see Silae in my Tellent HR account. What should I do?

Please contact our Support Team to activate your Silae Payroll add-on.

Integration setup

Do I need a different API credential for each dossier (legal entity)?

No, the same API credentials can be used across dossiers, however, you’ll need to set up a connection per dossier.

Can I configure the integration with my Silae test environment?

Yes, you can configure the integration using Silae API credentials that are enabled for your test environment in Silae.

My credentials are not working. What should I do?

Please review whether the credentials you were given are correct, without any extra characters or spaces.
Verify the credentials with your Payroll manager to ensure they are correct.
Make sure you inserted the Clé de configuration d’accès API and not the ID unique de configuration; these two identifiers have different use cases.

What should you consider before setting up the integration?

Make sure to manually export all the upcoming time off requests that were validated before activating the integration. Time off requests that were validated prior to the integration setup will not be synchronized with Silae.
Avoid creating a time-off request in Tellent HR if it has already been entered in MySilae, as this will cause a duplicate in MySilae.

User synchronization and syncing time off requests

Can new users be added in Silae from Tellent HR during integration setup?

Yes. When setting up the integration, you can now create new users in Silae, rather than only selecting from existing ones.

What happens if an employee isn’t matched correctly?

If there is a mismatch, the target’s employee data will be overwritten. E.g, employee Léa is incorrectly matched with Zoé in Silae, as a consequence, Zoé’s profile will be filled with Léa’s data.
If an employee is not matched in a connection, then no data will be transmitted for that employee in Silae.

Can I synchronize only certain employees with Silae?

Yes, you can choose the users you want to synchronize in each connection.

Can I see if there are synchronization errors?

Yes, you can see if you have synchronization errors in the Synchronization tab of your connection details:

If an employee cancels an approved time off request within Tellent HR, is that cancellation automatically reflected and taken into account in Silae?

Yes, a cancelled time off request in Tellent HR will be removed from Silae as well as we cross-check absences in Silae based on their dates and time off types.

Is there a deadline on the employee’s side to create a time off request for a certain month?

There is no hard deadline. Once a payrun is closed, new time off requests will not affect that pay cycle. The approved request will still synchronize to Silae, but they will not appear on the payrun.

Are time-off request attachments transmitted to Silae?

No, time-off request attachments are not being transmitted to Silae.

Can time-off balances be synchronized from Silae to Tellent HR?

At this time, the integration does not support such option.

Is the synchronization between Tellent HR and Silae real-time?

The data will only be synchronized will Silae from the moment the connection is properly configured. Any time off requests submitted after the integration is set up will be synced when they are approved.

Distributing Silae payslips

Are the employees' payslips being distributed automatically every month?

No, you need to add a new pay run every month and follow the steps explained in the “B. Distributing Silae payslips within Tellent HR” section.

Can my payroll manager receive automatic notifications after the payroll cycle closes to review and validate the payslips generated by Silae?

This is not possible if your payroll manager lacks access to your Tellent HR company account

However, if your payroll manager has a Tellent HR account within the company and has been granted the "Payroll management" access level, they can manage pay runs and receive notifications to review payroll data three days before the pay date.

Where can employees find and download their Silae paysheets?

Under each employee profile under the Payroll section, click Paysheets and select the desired month.
Once the document is open, there is a download option to export the document.