Récupérer la liste des absences posées
Il est possible de récupérer un fichier détaillant les absences sur une période donnée au format XLSX
curl --location --request GET '<Environnement>/api/etablissements/<ID Etablissement>/absences/<Date début période AAAA-MM-JJ>/<Date fin période AAAA-MM-JJ>' \
--header 'Authorization: Bearer <Token>'
Récupérer l'état des compteurs de congés (CP, RTT, Samedis Pris)
Il est possible de récupérer l'état des compteurs de congés des salariés d'un établissement à une date donnée au format XLSX
curl --location --request GET '<Environnement>/api/etablissements/<ID Etablissement>/compteurs/<Date concernée AAAA-MM>' \
--header 'Authorization: Bearer <Token>'
Récupérer l'état des compteurs d'un salarié
curl --location --request GET '<Environnement>/api/contrats/<ID Contrat>/compteurs-temps/<Période AAAA-MM>' \
--header 'Authorization: Bearer <Token>'
Exemple de retour
{
"CP N": {
"Acquis": "!Valeur!",
"Pris": "!Valeur!"
},
"CP N-1": {
"Acquis": "!Valeur!",
"Pris": "!Valeur!"
},
"Samedi pris": {
"Acquis": "!Valeur!",
"Pris": "!Valeur!"
}
}
Déclarer une nouvelle absence
Données en entrée
La CPAM attend les déclarations d'arrêts et autres absences exceptionnelles au plus tôt. On peut considérer qu'il est important de ne pas dépasser un délai de 48 heures entre le début de l'arrêt et son enregistrement dans Listo.
De manière générale il est impératif que les absences soient transmises au fil de l'eau et au plus tôt pour éviter des rattrapages sur une période clôturée.
Listo réalise par défaut les DSN de signalement pour télétransmettre les informations.
De fait, en cas de modification d'une déclaration d'absence ayant provoquée l'envoi par Listo d'une DSN de signalement, il est impératif de prévenir le support Listo pour étudier les impacts de cette modification.
Il n'est pas possible de déclarer une absence au delà de la date éventuelle de fin du contrat.
Les absences transmises par API sont considérées comme validées.
| Donnée | Contraintes et règles d'alimentation |
|---|---|
| Type d'absence | Récupérer les types d'absences disponibles |
| ID technique du contrat | Récupérer la liste des salariés d'un établissement et récupérer la valeur de "contratActif" |
| Prolongation | Si l'absence est une prolongation d'une autre, et si le type de l'absence initiale permet la prolongation, alors il faut indiquer l'identifiant de l'absence initiale. |
Exemple de déclaration d'une absence
curl --location --request POST '<Environnement>/api/absences' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"dateDebut": "<Date début de l'absence>",
"dateFin": "<Date de fin de l'absence>",
"demiJourneeEnDebut": false, "#Mettre à true si l'absence commence par une 1/2 journée",
"demiJourneeEnFin": false, "#Mettre à true si l'absence termine par une 1/2 journée",
"dureeHeuresEnDebut": {},
"dureeHeuresEnFin": {},
"type": "/api/type_absences/<type_absence_id>",
"contrat": "/api/contrats/<contrat_id>"
}'