Silae
French payroll software for accounting firms and employers (Silae Paie)
Overview
Connect your firm's Silae API account so Taxxa can read your clients' payroll dossiers directly from Silae Paie: employees and their contracts, payslips, payroll reports and employer costs, payroll accounting entries, DSN declarations and absences. One connection covers the dossiers of one Silae API access configuration, and you link each dossier to its client company in Taxxa. This is an office connection: people who can manage office access, a permission a workspace admin gives, connect it. Everyone else can use it only with access to its clients, given per client or to all clients on the Office access page.
What Taxxa can access
- The payroll dossiers that the API access configuration reaches, with their company and establishment details, headcount and collective agreement.
- Employees, with their jobs, contracts, base salary and work schedule.
- Payslips with their lines and cumulative totals, payslip PDFs, and payroll reports such as the payroll journal, the payroll summary, the charges table and salary costs.
- Payroll accounting entries, DSN declarations and their states, absences and leave balances.
- Each request is pinned to the dossier of the client the chat is about. Silae sees every request as your firm's API account, and Taxxa records which member made it.
- Taxxa can also prepare changes where the Silae API allows them, such as an absence, a bonus, hours or an advance, for members with Read & write access to the client. Silae allows only what the mySilae Paie user of the configuration may do. Keep the Client Secret and the subscription key like passwords.
Before you connect
- A Silae API account for your firm. Silae opens API accounts: if you do not have one, ask your Silae sales contact.
- A Silae user with the Configuration API right and access to every payroll dossier of the domain, who creates the API access configuration.
- A mySilae Paie user for the configuration, for example a contact of the type Contact dédié API (dedicated API contact). The API reaches only the dossiers and functions that this user can reach.
- Access to the Silae API portal (api-portal.silae.fr), to activate the configuration and copy the Client ID, a Client Secret and the subscription key.
- The office access permission in Taxxa, given by a workspace admin. Only office access managers can connect Silae.
How to connect
- In Silae, go to Paramétrage paie → Options → Configuration API and choose Créer une configuration API (create an API configuration) in the menu on the right. Silae's labels are in French, so this guide keeps them in French.
- Select the Compte API (API account), the Utilisateur mySilae Paie (mySilae Paie user) whose dossiers Taxxa may reach, the Type d'accès (access type: all dossiers of the domain, or one or more dossiers) and a Libellé (label), for example Taxxa. Save with Sauvegarder (save).
- Silae creates the configuration disabled. In the Silae API portal, open Mes comptes API (my API accounts), select the account, go to the Configurations d'accès API (API access configurations) tab and activate the configuration.
- On the same tab, open the ⋮ menu of the configuration and copy its primary key. This is the subscription key.
- Go to the Gestion des ClientSecrets (client secret management) tab and copy the Client ID. Generate a secret in the slot with no expiry date, or in the slot that expires first, and copy it at once: the portal shows it only one time.
- In Taxxa, open Connectors and select Silae. Select Connect, enter the Client ID, the Client Secret and the subscription key, and select Connect.
- Choose which Silae dossiers belong to which client companies in Taxxa, then save. Taxxa matches a dossier to a client company by its SIRET where it can.
- In Taxxa, open the Office access page from Connectors and give members access per client or to all clients: Read for the read actions, or Read & write for every action. People who can manage office access have full access. A write action still follows each member's own approval setting: Taxxa asks before each change unless that member chose to allow changes without asking.
- To give access to many clients at once, select Edit next to a member on the Office access page, filter the clients, for example by connector, select all matching clients, choose Read or Read & write, and save.
- Each Client Secret expires one year after it is generated, and Silae sends a reminder email 31, 7 and 1 days before. Before it expires, generate a new secret in the API portal and reconnect Silae in Taxxa with it.
- One connection covers the dossiers of one API access configuration. To reach the dossiers of another configuration, connect Silae again in Taxxa with that configuration's subscription key.
Where to find your details
- Client ID
- The Client ID of your firm's Silae API account. In the Silae API portal, open Mes comptes API, select the account and copy the Client ID on the Gestion des ClientSecrets tab.
- Client Secret
- A secret generated for the same API account on the Gestion des ClientSecrets tab. The portal shows it only one time, and it expires one year after it is generated. Keep it like a password: with the Client ID and the subscription key, it opens every dossier of the configuration.
- Subscription key
- The primary key of the API access configuration. In the Silae API portal, open Mes comptes API, select the account, go to the Configurations d'accès API tab and copy the key from the ⋮ menu of the configuration. The key decides which dossiers the connection reaches. It does not expire.
Troubleshooting
- The connection fails with invalid_client or invalid_grant.
- The Client Secret expired or is wrong, or the Client ID belongs to another API account. Generate a new secret on the Gestion des ClientSecrets tab and reconnect Silae in Taxxa with it.
- Silae answers SubscriptionKeyInvalid.
- The subscription key is wrong or was regenerated. Copy the full primary key again from the ⋮ menu of the configuration and reconnect Silae in Taxxa with it.
- Silae answers invalidSubscriptionIdClientIdPair.
- The subscription key belongs to another API account than the Client ID, or the configuration is not active. Activate the configuration on the Configurations d'accès API tab, or reconnect with the key of a configuration of the same API account.
- A dossier is missing.
- The configuration reaches only the dossiers of its access type that its mySilae Paie user can open. Add the dossier to the configuration under Paramétrage paie → Options → Configuration API, or give the user access to it. Silae takes about 10 minutes to apply a change of dossiers.
- Silae does not answer at night.
- Silae updates its platforms every day between 01:00 and 05:00 Paris time. Try again after that.
- A member cannot use Silae in Taxxa.
- Someone who can manage office access must give the member access to that client, or to all clients, on the Office access page.
Disconnect
Disconnect Silae in Taxxa under Connectors. To stop all access in Silae as well, deactivate the API access configuration in the Silae API portal, or block it under Paramétrage paie → Options → Configuration API.
Connect Silae in Taxxa
Already a customer? Go to Connectors and choose Silae.