Comment importer mes données sociales par API à partir de mon logiciel de paie sur Finthesis ?
Pour alimenter le volet "Social" dans votre module reporting, vous pouvez intégrer vos exports de DSN ou importer vos DSN via API
. Ce tutoriel décrit comment créer la connexion API.
⚠️
Important : Cette fonctionnalité est réservée aux partenaires experts-comptables. Si vous êtes le client final, l’import des DSN par API n’est pas disponible pour votre espace Finthesis. Vous devrez donc
importer vos DSN manuellement.
Etape 1 : Se rapprocher de son partenaire de paie
Dans un premier temps, il vous faut obtenir l'ouverture des comptes API pour votre société sous le format "Modèle 1A". Pour des renseignements relatifs à la contractualisation auprès de votre logiciel de paie, vous pouvez vous référer au lien suivant :
Contractualisation et facturationEtape 2 : Récupérez les clés d'API
Une fois le contrat finalisé, vous aurez la possibilité d'accéder à vos clés d'API. Pour ce faire, vous pouvez consulter le lien suivant :
Récupération des clés API2.1 Activez votre compte, et récupérez votre Client ID.
Depuis la rubrique "Mes comptes", modifier votre compte API :
Vous pourrez ensuite récupérer votre Client ID et activer votre compte :
2.2 Récupérez votre Client Secret
Depuis l'onglet "Gestion des ClientSecrets", cliquez sur le bouton "Regénérer".
Vous pourrez ensuite copier le Client Secret :
2.3 Récupérez la clé de configuration
Depuis l'onglet "Configuration d'accès API", regénérez la clé.
⚠️ Important : clé à conserver précieusement pour l'accès aux dossiers.
Etape 3 : Renseignez les clés d'API récupérées dans Finthesis
Dans votre module reporting, allez dans l'onglet "Suivi des imports" puis dans la rubrique données sociales cliquez sur "Importer de nouvelles données" :
Ensuite, sélectionnez "Logiciel de paie" puis renseignez alors les informations suivantes : clé d'API / Secret de la clé d'API / Clé principale :
Messages d'erreur
Voici un état synthètique des messages d'erreurs et comment les résoudre :
| Message d'erreur | Résolution |
| Vous ne pouvez pas appeler un endpoint sans être autorisé à utiliser la famille associé | Vérifier auprès de Silae d'avoir un contrat d'API de type modèle 1A. Si oui, leur transmettre ce message |
| invalid_client. The specified client_secret does not match the expected value for this client. Please correct the client_secret and try again. | Le paramètre client_secret ne correspond pas au paramètre client_id renseigné |
| 401: backend, authorization, SubscriptionKeyInvalid, Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription | Vérifier les id et clés renseignés |
Si le problème persiste, nous vous recommandons de contacter le support technique via le chatbot.