Skip to content
Navigation

Lister les feuilles de temps

Liste les feuilles de temps hebdomadaires, de la plus récente à la plus ancienne : heures prévues, travaillées, supplémentaires et leur compensation.

Une semaine appartient au mois de paie de son dimanche, celui que filtrent year et month. Seules les semaines déjà ouvertes dans Puncto (par le collaborateur, un responsable ou une relance) sont listées ; la lecture n’en crée aucune.

GET
https://api.puncto.fr/public/v1/timesheets

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 mois de paie de rattachement.

    maximum: 2100 · minimum: 2000
  • month
    optionnel
    integer

    Mois de paie de rattachement, 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 feuilles de temps

JSON
  • data
    tableau de
    object
    requis
    • timesheetId
      string
      requis

      Identifiant Puncto de la feuille de temps

    • 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

    • weekStartDate
      string
      requis

      Lundi de la semaine

      format: date
    • year
      number
      requis

      Année du mois de paie de rattachement : celui du dimanche de la semaine

    • month
      number
      requis

      Mois de paie de rattachement (1-12) : celui du dimanche de la semaine

    • status
      DRAFT
      ou
      TO_VALIDATE
      ou
      VALIDATED
      requis

      Brouillon, à valider ou validée

    • days
      tableau de
      object
      requis

      Les sept jours de la semaine

      • date
        string
        requis

        Jour

        format: date
      • kind
        WORKED
        ou
        NOT_WORKED
        ou
        OUT_OF_CONTRACT
        ou
        PUBLIC_HOLIDAY
        ou
        ABSENCE
        requis

        Nature de la journée : travaillée, non travaillée, hors contrat, fériée ou absence

      • expectedMinutes
        number
        requis

        Minutes prévues par le planning du contrat, 0 pour une journée non travaillée

      • expectedMorningMinutes
        number | null
        requis

        Minutes prévues le matin, null sur les feuilles créées avant l'ajout de ce détail

      • expectedAfternoonMinutes
        number | null
        requis

        Minutes prévues l'après-midi, null sur les feuilles créées avant l'ajout de ce détail

      • workedMinutes
        number
        requis

        Minutes travaillées saisies

      • morning
        requis

        Plage travaillée le matin, null si le matin n'est pas travaillé

        One of the following:

        • WorkScheduleTimeRange
          • start
            string
            requis

            Heure au format HH:mm, sur 24 h.

          • end
            string
            requis

            Heure au format HH:mm, sur 24 h.

        • null
      • afternoon
        requis

        Plage travaillée l'après-midi, null si l'après-midi n'est pas travaillé

        One of the following:

        • WorkScheduleTimeRange
          • start
            string
            requis

            Heure au format HH:mm, sur 24 h.

          • end
            string
            requis

            Heure au format HH:mm, sur 24 h.

        • null
      • absenceType
        requis

        Type de l'absence du jour, null sans absence

        One of the following:

        • AbsenceType
        • null
      • absencePeriod
        requis

        Partie de la journée couverte par l'absence, null sans absence

        One of the following:

        • TimesheetAbsencePeriod
        • null
    • contractWeeklyMinutes
      number
      requis

      Durée hebdomadaire du contrat, en minutes

    • expectedMinutes
      number
      requis

      Minutes prévues sur la semaine

    • workedMinutes
      number
      requis

      Minutes travaillées sur la semaine

    • overtimeMinutes
      number
      requis

      Minutes au-delà de la durée hebdomadaire du contrat

    • compensationMode
      requis

      Compensation des heures supplémentaires choisie à la validation : paiement ou repos compensateur ; null avant la validation ou sans heures supplémentaires

      One of the following:

      • TimesheetCompensationMode
      • null
    • restHours
      number | null
      requis

      Heures de repos créditées (majoration comprise) quand compensationMode vaut REST

    • payrollVariableId
      requis

      Variable de paie des heures supplémentaires payées, créée à la validation, null sinon

      One of the following:

      • string
      • null
    • submittedAt
      requis

      Date de soumission par le collaborateur

      One of the following:

      • string
      • null
    • validatedAt
      requis

      Date de validation

      One of the following:

      • string
      • null
    • createdAt
      string
      requis

      Date de création de la feuille de temps

      format: date-time
    • updatedAt
      string
      requis

      Date de dernière modification de la feuille de temps

      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