Cet article s'adresse uniquement aux contrats en gestion horaire réelle avec un taux horaire défini au contrat.
L'envoi des heures se fait en ajout par défaut. Si vous devez modifier une déclaration, il faut récupérer l'ID technique de la ligne à éditer et envoyer la mise à jour via l'utilisation de la méthode PUT
Données en entrée
| Donnée | Contraintes et règles d'alimentation |
|---|---|
| ID technique du contrat | Récupérer la liste des salariés d'un établissement et récupérer la valeur de "contratActif" |
| ID technique de la période concernée | Récupérer les informations de vos établissements et récupérer la valeur de "currentPeriodDate" pour l'établissement concerné. |
| Type d'heures | Récupérer les types d'heures |
| Coefficient (optionnel) | Dans le cas où le coefficient est supérieur aux dispositions conventionnelles, il est possible de surcharger le coefficient par défaut prévu dans la définition du type concerné. |
| Libellé (optionnel) | Si le client souhaite un libellé spécifique à afficher sur le bulletin, il est possible de le définir pour remplacer le libellé par défaut (limité à 50 caractères) Il est également possible d'envoyer plusieurs déclarations sur le même type d'heure mais avec des libellés différents. Dans ce cas il y aura autant de lignes sur le bulletin qu'il y a de couples type/libellé déclarés. |
Exemple de déclaration d'une heure réalisée
curl --location --request POST '<Environnement>/api/contrat_salaries' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"type": "/api/type_heure_reelles/<Code du type d'heure>",
"coefficient": 0, "#ne rien envoyer si il n'est pas nécessaire de modifier le coefficient par défaut",
"duree": 0, "#Quantité d'heures déclarées, nombre avec 2 décimales",
"libelle": "<Libellé personnalisé>", "#ne rien envoyer si il n'est pas nécessaire de modifier le libellé par défaut",
"periode": "/api/periods/<ID Période>",
"contrat": "/api/contrats/<ID Contrat>",
"recurrente": true "#Il est possible d'indiquer la ligne déclarée devra se retrouver sur les futures périodes. Mettre false sinon",
}'