Mise à jour du statut d’un relevé d’heures PATCH /api/v1/timesheets/{id}/status

Cette opération est accessible côté EU et ETT, mais les transitions autorisées sont différentes pour chacun.

Cette opération permet de modifier le statut d’un relevé d’heures.

Transitions autorisées côté EU :

• A partir d’un timesheet au statut EMPTY :
  • Transition vers IN_PROGRESS : le pointage type est enregistré immédiatement, les rubriques sont générées et le relevé d’heures est modifiable
• A partir d’un timesheet au statut IN_PROGRESS :
  • Transition vers EMPTY : toute saisie préalablement faite sur le relevé d’heures est effacée, le relevé est réinitialisé à son statut initial
  • Transition vers FILLED : le relevé d’heures ne peut plus être modifié et est prêt à être envoyé
• A partir d’un timesheet au statut FILLED :
  • Transition vers IN_PROGRESS : le relevé d’heures peut de nouveau être modifié
• A partir d’un timesheet au statut SENT ou SENT_AND_APPROVED :
  • Transition vers IN_PROGRESS : le relevé d’heures peut de nouveau être modifié

Transitions autorisées côté ETT :

• A partir d’un timesheet au statut SENT :
  • Transition vers SENT_AND_APPROVED : le relevé d’heures est approuvé par l’agence

Paramètres :

• id (identifiant du relevé d’heures)
• customerId (identifiant Peopulse du client – obligatoire pour une ETT)

Payload :

Champ	Type	Obligatoire	Description	Notes
period	string	✅	Période sur laquelle on demande de modifier le statut	Format ISO 8601 Exemple : 2025-12
value	enum	✅	Statut IN_PROGRESS┃FILLED┃SENT┃SENT_AND_APPROVED┃IN_DISPUTE	En cours de saisie / à envoyer / envoyé, envoyé et approuvé / en litige

Exemple :

curl -X PATCH "https://api.dev.peopulse.com/api/v1/timesheets/f0bdf1ab-fc22-4e73-a7ff-49a3be9728ba/status" \
 -H 'accept: application/json'\
 -H 'authorization: Bearer XXX'\
 -H 'content-type: application/json' \
 -d '{"period":"2025-08","value":"EMPTY"}' 

{
  "period": "2025-08",
  "value": "EMPTY"
}