Release Note

OpenAPI & Collection Postman

OpenAPI

Collection Postman (Périmètre Modèle 1B)

Prévu le 10 décembre 2024

• Mise en place d'un rate limiting sur l'authentification API (demande de token / token) :
  • Pour rappel, l'usage des API en mode REST nécessite une authentification préalable via l'URL https://payroll-api-auth.silae.fr/oauth2/v2.0/token, qui donne lieu à la délivrance d'un token.
  • Comme précisé dans la page Authentification et appel endpoint, ce token est d'une validité de 60 minutes et peut être utilisé et réutilisé pour tous les appels réalisés durant cette période.
  • Une mauvaise pratique consiste à ne jamais réutiliser un token et donc à se réauthentifier à chaque nouvel API : cette pratique peut avoir des conséquences sur les performances des API.
  • Pour prévenir cette mauvaise pratique et garantir un service optimal pour tous, nous mettons en place une limite d’authentification à 60 token / min sur la production à partir du mardi 10/12/24.

Livraison en production le 10/12/24 (idem pour les environnements de test)

• Modifications :
  • LectureInformationsPaie : ajout de 2 motifs d'erreurs liés au matriculeSalarie.
    • Si le matricule n'existe pas sur le dossier alors on renvoie désormais une erreur 400 de type "Aucun salarié ne correspond au matricule" (auparavant, on renvoyait un code 200 avec une liste vide).
    • Si plusieurs salariés portent le même matricule sur le dossier alors on renvoie désormais une erreur 400 de type "Plusieurs salariés correspondent au matricule" (auparavant, on renvoyait un code 200 avec une liste vide).

Livraison sur les environnements de test le 05/11/24 et en production le 10/12/24.

Mise à jour du 12 novembre 2024

• Modifications :
  • CreationSalarieEmplois et StatutCreationSalarieEmploisAsynchrone : ajout du N° de matricule du salarié dans le résultat de la fonction API
  • SoldeRepos et SoldeReposAsynchrone : ajout du N° de Matricule du salarié dans les paramètres de la requête
  • Ajout du paramètre format dans les fonctions API - Etats de paie : Permet de générer l'édition au format PDF ou EXCEL encodée en base64 :
    • EditionDetailDesCotisations | EditionDetailDesCotisationsAsynchrone
    • EditionEtatDesPaiements | EditionEtatDesPaiementsAsynchrone
    • EditionJournalDePaie | EditionJournalDePaieAsynchrone
    • EditionRecapDePaie | EditionRecapDePaieAsynchrone
    • EditionSoldeDeRepos | EditionSoldeDeReposAsynchrone
    • EditionTableauDesCharges | EditionTableauDesChargesAsynchrone

Mise à jour du 5 novembre 2024

• Ajouts :
  • SalarieBulletinStatutEtatAvancement : Permet de connaître le statut du bulletin de chaque salarié dans l'état d'avancement pour un période donnée
• Modifications :
  • ListeDossiers : ajout du numéro interne de la fiche Client (Gestion interne) dans le résultat de la fonction API

Mise à jour du 16 octobre 2024

• Ajouts :
  • RecupererFichiersEcrituresComptablesAsynchrone et StatutRecupererFichiersEcrituresComptablesAsynchrone : Identique à la fonction API RecupererFichiersEcrituresComptable, elle permet de lancer le traitement en mode asynchrone

Mise à jour du 1 octobre 2024

• Ajouts :
  • EcrituresComptables4Asynchrone et StatutEcrituresComptables4Asynchrone : Identique à la fonction API EcrituresComptables4, elle permet de lancer le traitement en mode asynchrone

Mise à jour du 24 septembre 2024

• Ajouts :
  • EcrituresComptables4 : Identique à la fonction API EcrituresComptables3, elle permet de prendre en charge également les options paramétrées dans la fonction Liaison comptable de Silae Paie
  • ListeModulesMySilae : Permet de récupérer la liste des dossiers de paie où MySilae est activé avec les modules associés et leurs statuts respectifs
• Modifications :
  • creationcomptecollaborateur, LectureCompteCollaborateur, CreationCompteCollaborateurDepuisModele, LectureCompteCollaborateurModeles : Pris en charge du droit "Autoriser accès aux menus import /export de paramétrages"
  • ModificationPersonnesLiees : contrôle sur la date de décès qui ne peut être inférieure à la date de naissance
  • ListeModulesActifs : Ajout du paramètre CodeAgence (facultatif) et dans le résultat de la requête, la Date de dernière Modification

Mise à jour du 10 septembre 2024

• Ajouts :
  • CreationCompteCollaborateurDepuisModele : Permet de créer un compte collaborateur à partir d'un modèle déjà enregistré.
  • LectureCompteCollaborateurModeles : Permet de lire les modèles de comptes collaborateurs déjà existants.

Mise à jour du 3 septembre 2024

• Ajouts :
  • ListeUtilisateursDossierPaieV2 : Permet de lire les informations relatives aux identifiants, noms, prénoms, fonctions, téléphones et emails des utilisateurs.
• Modifications :
  • CreationUtilisateurClientPaie : Ajout de la possibilité d'insérer une fonction et le téléphone.
  • AffectationDossierPaie : Ajout de la possibilité d'affecter une agence à un dossier.
  • AffectationDossierPaieLecture : Ajout de la possibilité de lire l'agence affectée à un dossier.
  • ModificationpersonnesLiee : Ajout de la possibilité de mettre une date de décès et l'information sur le handicap des personnes liées.
  • LecturePersonnesLiees : Ajout de la lecture des champs date de décès et l'information sur le handicap des personnes liées à un salarié.
  • SalariesBulletins : Ajout de la possibilité de filtrer sur l'établissement.

Mise à jour du 27 août 2024

• Ajouts :
  • EditionRecapDePaieDetailleParSalarie (équivalence en mode asynchrone : EditionRecapDePaieDetailleParSalarieAsynchrone et Statut EditionRecapDePaieDetailleParSalarieAsynchrone) : Permet de générer et récupérer l'édition récapitulatif de paie détaillé par salarié.
  • ModificationCCNEtablissement : Permet de modifier la convention collective liée à l'établissement selon les différentes conventions collectives rattachées à la fiche Société.
  • ListeOrganismes : Permet de récupérer la liste de tous les organismes (Urssaf, Retraite, Prévoyance…) avec toutes les données rattachées depuis un numéro de dossier
  • SalarieActiviteJournaliere : Permet de connaître la grille de l'activité journalière pour un salarié sur une période donnée
• Modifications :
  • ListeDossiers : ajout du Jour Paiement de l'organisme dont le code nature est SSOC et Etat du dossier de paie (Inactif, en montage, en production)

Mise à jour de juillet 2024

• Modifications :
  • Contrôle du nom de naissance (valeur obligatoire en création de fiche Salarié)
    • CreationSalarieEmploi
    • StatutCreationSalarieEmploiAsynchone / CreationSalarieEmploiAsynchone
  • Ajout de la gestion des Axes Analytiques 1, 2 et 3 (si existants) pour :
    • ExtraCreationManifestation
    • ExtraSalarieAcquisitionVacations
    • ExtraSalarieAjouterVacations

Mise à jour de juin 2024

• Modifications :
  • Nouveau format de date acceptée et à respecter : AAAA-MM-JJ pour :
    • CreationSalarieEmploi
    • StatutCreationSalarieEmploiAsynchone / CreationSalarieEmploiAsynchone
    • ModificationChampSalarie
    • ExtraSalarieAjouterVacations
    • ExtraCreationManifestation
  • CreationSalarieEmploi et CreationSalarieEmploiAsynchrone :
    • Ajout Année de naissance
    • Contrôles sur le numéro de sécurité sociale (cf. Messages d'erreur de ces fonctions API)
  • Fiche Salarié - Informations salarié : Ajout Année de naissance.

Mise à jour de mars 2024

• Modifications :
  • AnalyseProductionPaie et StatutAnalyseProductionPaieAsynchrone : ajout du nombre de bulletins CoffresForts éditiques
  • AnalyseProductionPaieDetail : ajout de l'analyse "NbBulletinsCoffresFortsEditique"

Mise à jour de février 2024

• Modifications :
  • Prise en compte de la DFS (Déduction Forfaitaire Spécifique) par code secteur d'activité et de l'option Lissage annuel dans les différentes fonctions API concernées : CreationSalarieEmplois, LectureInformationsPaie​... (consulter les articles correspondants)

Mise à jour de janvier 2024

• Modifications :
  • LectureReponsesQuestionnaireFicheSalarie : Permet de récupérer les réponses au questionnaire Salarié depuis sa fiche, ainsi que les libellés des questions qui lui correspondent.
  • EcritureReponsesQuestionnaireFicheSalarie : Permet de modifier les réponses au questionnaire Salarié sur sa fiche.
  • LectureReponsesQuestionnaireConventionnelSalarie : Permet de lire le questionnaire conventionnel d'un emploi d'un salarié.
  • EcritureReponsesQuestionnaireConventionnelSalarie : Permet de modifier les réponses au questionnaire conventionnel d'un emploi d'un salarié
  • ListeDSNmensuelles : gestion erreur sur Siret
  • Fiche Salarié Emploi : Gestion du Code territoire pour la CCN M110 - Métallurgie
  • SiteGenereMotDePasseAlternatif : pour exploiter cette fonction API, il est nécessaire d'activer l'option Utilisation API > Génération de mot de passe alternatif (pour le détail, consulter l'article correspondant)

Mise à jour de décembre 2023

• Modifications :
  • ValideCleDossier : de nouveaux types d'erreur sont générés (consulter l'article correspondant pour le détail)
  • SalarieSyntheseCarriere et StatutSalarieSyntheseCarriereAsynchrone : Ajout de l'identifiant emploi dans la réponse

Mise à jour de septembre 2023

• Modifications :
  • CreationSalarieEmploi : ajout de la donnée Date de début de contrat

Mise à jour de juillet 2023

• Modifications :
  • SalarieBulletinCumuls : ajout de la donnée impot sur le revenu - prélèvement à la source en résultat

Mise à jour de juin 2023

Périmètre API - Usage Éditeur - Écritures comptables (Modèle 4) :
Ajout de fonctions API appartenant au groupe Info technique dossier

• Modifications :
  • AcquisitionQuestionnaireContratComplementaire : Permet de récupérer les questionnaires complémentaires tels que configurés dans un dossier (compléter de champs supplémentaires sur le résultat)
• Ajouts :
  • ListeAgences : Permet de récupérer la liste des agences du domaine.
  • LectureFicheAgence : Permet de récupérer certaines informations de l'agence.
  • ListeDossiersAgence : Permet de récupérer la liste des dossiers affectés à une agence.
  • ListeDossiersDemoSilae : Permet de récupérer la liste des dossiers de démo mis à disposition par Silae pour des démonstrations/présentations.
  • ImportDossierDemoAsynchrone : Permet de lancer l'import d'un dossier de démonstration Silae (sur le même principe que la fonction Outils > Importer un dossier de démonstration)
  • StatutImportDossierDemoAsynchrone : Cette fonction sert à récupérer le résultat de l'appel à la fonction ImportDossierDemoAsynchrone
  • CreationQuestionnaireContratComplementaire : Permet de créer ou modifier un questionnaire de contrat complémentaire pour un dossier.
  • LectureQuestionnaireContratComplementaireSalarie : Permet de lire les réponses d'un salarié à un questionnaire de contrat complémentaire.
  • ModificationQuestionnaireContratComplementaireSalarie : Permet de modifier les réponses aux questions relatives aux contrats complémentaires.

Mise à jour de mai 2023

• Ajouts :
  • ListeModulesActifs : Permet de lister les modules activés par dossier.
  • ListeComptesApi : Permet de récupérer la liste des comptes API disponibles (actifs) sur le domaine courant.
  • CreationConfigurationAccesApi : Permet de créer ou de modifier une configuration d'accès API
  • GenerationFichierTR : Permet de générer le fichier d'export des tickets restaurant au format spécifié en paramètre (Edenred, sodexo, etc...)
  • SalarieBulletinCumuls : Permet de récupérer le cumul de certains éléments du bulletin pour un salarié sur une période donnée.
  • CreationCompteCollaborateur : Permet de créer et modifier un compte collaborateur sans avoir besoin de l'utilisateur "Administrateur Général de Domaine"
  • LectureCompteCollaborateur : Permet de récupérer les informations d'un compte Collaborateur sans avoir besoin de l'utilisateur "Administrateur Général de Domaine"

Mise à jour d'avril 2023

• Ajouts :
  • RecupererFichiersEcrituresComptables : Permet de récupérer le ou les fichiers d'écritures comptables tel que paramétré dans l'écran de génération des fichiers séquentiels.
  • LectureContactEmetteurDSN : Permet de récupérer les infos du contact émetteur DSN paramétré sur un numéro de dossier et le numero de siren de la société de rattachement (optionnel).
  • AnalyseConfigurationAccesApi : Permet de récupérer la liste des configurations d'accès API déclarées dans un domaine.
• Modifications :
  Les fonctions API suivantes affichent le résultat en fonction des droits d'accès aux dossiers de l'utilisateur courant :
  • AnalyseProductionPaie
  • AnalyseProductionPaieAsynchrone + StatutAnalyseProductionPaieAsynchrone
  • AnalyseProductionPaieUtilisateurs
  • AnalyseProductionPaieEntreesSorties
  • AnalyseProductionPaieEntreesSortiesAsynchrone + StatutAnalyseProductionPaieEntreesSortiesAsynchrone

Mise à jour de mars 2023

• Mise en production de la gestion multi-comptes dans le portail API. Via l'interface, un utilisateur peut désormais gérer plusieurs comptes API, et un même compte API peut être géré par plusieurs utilisateurs.

• Ajouts :

  • RecupererDuplicatasBulletins : Permet d'obtenir uniquement les duplicatas de bulletins en un seul fichier PDF pour 1 seul salarié d'une société sur plusieurs mois ou plusieurs salariés d'une même société sur 1 seul mois (Combinaison des fonctionnalités SalariesBulletins et RecupererImage)

Cette même fonction est disponible en mode asynchrone :

• Mise à disposition de endpoints asynchrones permettant la récupération d'éléments prenant du temps sans risquer de timeout.** :

Tous les détails sur le mode de fonctionnement de ces endpoints asynchrones dans les Fonctions API en mode asynchrone

Mise à jour de février 2023

• Modifications :
  • SoldeRepos : Ajout des soldes acquis/pris pour les RCR, RCO, RCC et RC.
  • ClassificationMetierComplete : Ajout des informations sur la période de validité dans la réponse
• Ajouts :
  • SalarieBulletinDetails : Permet de récupérer les informations (entête et/ou lignes) du ou des bulletins pour un salarié pour une période de paie donnée
  • RecupererFichiersVirementHorsBulletin
  • RecupererFichiersVirementHorsBulletinChiffres
  • AdministrationCollaborateurLectureParIdentifiant
  • RechercheCCNParCode