Skip to content
Navigation

Lister les relevés forfait jours

Liste les relevés mensuels des collaborateurs au forfait jours, du plus récent au plus ancien : jours travaillés et d’absence par demi-journée, repos et charge de travail déclarés.

GET
https://api.puncto.fr/public/v1/forfait-jour-declarations

Authentification

  • bearerAuth
    HTTP
    requis

Query parameters

  • page
    optionnel
    integer

    Numéro de page, à partir de 1.

    minimum: 1 · default: 1
  • perPage
    optionnel
    integer

    Nombre d’éléments par page, 200 au plus.

    maximum: 200 · minimum: 1 · default: 50
  • year
    optionnel
    integer

    Année du relevé.

    maximum: 2100 · minimum: 2000
  • month
    optionnel
    integer

    Mois du relevé, de 1 (janvier) à 12.

    maximum: 12 · minimum: 1
  • status[]
    optionnel
    tableau de
    string

    Statuts à garder. Répétez le paramètre pour en passer plusieurs.

  • contractId
    optionnel
    string

    Identifiant Puncto du contrat.

  • collaboratorId
    optionnel
    string

    Identifiant Puncto du collaborateur. Ne pas combiner avec collaboratorForeignErpId.

  • collaboratorForeignErpId
    optionnel
    string

    Identifiant du collaborateur dans votre système (foreignErpId). Ne pas combiner avec collaboratorId.

Retour

200

Page de relevés forfait jours

JSON
  • data
    tableau de
    object
    requis
    • forfaitJourDeclarationId
      string
      requis

      Identifiant Puncto du relevé

    • collaboratorId
      string
      requis

      Identifiant Puncto du collaborateur

    • collaboratorForeignErpId
      string | null
      requis

      Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné

    • contractId
      string
      requis

      Identifiant Puncto du contrat

    • year
      number
      requis

      Année du relevé

    • month
      number
      requis

      Mois du relevé (1-12)

    • status
      PENDING
      ou
      CONFORM
      ou
      ANOMALY
      requis

      En attente, conforme ou anomalie

    • isCalendarAccurate
      boolean
      requis

      Le collaborateur confirme que le calendrier du mois est exact

    • calendarComment
      string | null
      requis

      Commentaire du collaborateur sur le calendrier

    • isRestRespected
      boolean
      requis

      Le collaborateur confirme avoir respecté les temps de repos

    • restComment
      string | null
      requis

      Commentaire du collaborateur sur les temps de repos

    • workloadStatus
      requis

      Charge de travail ressentie, null avant la soumission

      One of the following:

      • ForfaitJourDeclarationWorkloadStatus
      • null
    • workloadComment
      string | null
      requis

      Commentaire du collaborateur sur sa charge de travail

    • workedDaysCount
      number
      requis

      Jours travaillés du mois

    • sickDaysCount
      number
      requis

      Jours d'arrêt maladie du mois

    • unpaidDaysCount
      number
      requis

      Jours de congé sans solde du mois

    • familyDaysCount
      number
      requis

      Jours de congés familiaux du mois

    • parentalLeaveDaysCount
      number
      requis

      Jours de congé parental du mois

    • days
      tableau de
      object
      requis

      Jours du mois, par demi-journée

      • date
        string
        requis

        Jour

        format: date
      • morningDayType
        JT
        ou
        JF
        ou
        CP
        ou
        JNT
        ou
        CSS
        ou
        MO
        +7 de plus
        requis

        Nature du matin

      • afternoonDayType
        JT
        ou
        JF
        ou
        CP
        ou
        JNT
        ou
        CSS
        ou
        MO
        +7 de plus
        requis

        Nature de l'après-midi

    • submittedAt
      requis

      Date de soumission par le collaborateur, null tant qu'il ne l'a pas soumis

      One of the following:

      • string
      • null
    • createdAt
      string
      requis

      Date de création du relevé

      format: date-time
    • updatedAt
      string
      requis

      Date de dernière modification du relevé

      format: date-time
  • meta
    object
    requis
    • total
      integer
      requis

      Nombre total d’éléments.

    • page
      integer
      requis

      Page renvoyée.

    • perPage
      integer
      requis
    • currentPage
      integer
      requis
    • firstPage
      integer
      requis
    • lastPage
      integer
      requis

401

Clé d’API absente, invalide ou révoquée
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

403

Opération hors de l’accès de la clé d’API
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

404

Collaborateur du filtre introuvable
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

422

Paramètres invalides
JSON
  • errors
    tableau de
    object
    requis
    • message
      string
      requis
    • rule
      string
      requis

      Règle de validation en échec.

    • field
      string
      requis

      Chemin du champ, par exemple absences.0.type.

Type to search…

↑↓ navigate↵ selectEsc close