Skip to content
Navigation

Lister les soldes de congés

Calcule à une date les compteurs de congés de chaque contrat en vigueur : congés payés N, N-1 et N-2, ancienneté, fractionnement, jours non travaillés des forfaits jours, RTT, repos compensateurs et congés de stage. Les absences validées sont décomptées, pas les demandes en attente. Rien n’est enregistré.

  • Un solde incalculable vaut null, avec sa raison dans unavailableReason, sans faire échouer la page.
  • Les mandats sociaux n’ont pas de compteurs et ne sont pas listés.
  • 50 contrats par page au plus ; date de calcul au plus tard la fin du douzième mois à venir.
GET
https://api.puncto.fr/public/v1/holidays-balances

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, 50 au plus.

    maximum: 50 · minimum: 1 · default: 50
  • calculationDate
    optionnel
    string

    Date de calcul des soldes. Par défaut, aujourd’hui (heure de Paris). Au plus tard la fin du douzième mois à venir (le 31/10/2027 pour une demande du 28/10/2026), sinon 422.

    format: date
  • contractId
    optionnel
    string

    Identifiant Puncto du contrat. Page vide s’il n’est pas en vigueur à calculationDate.

  • 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 soldes de congés

JSON
  • data
    tableau de
    object
    requis
    • contractId
      string
      requis

      Identifiant Puncto du contrat

    • 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é

    • calculationDate
      string
      requis

      Date à laquelle les soldes sont calculés

      format: date
    • balance
      requis

      Compteurs de congés, null quand ils ne peuvent pas être calculés (voir unavailableReason)

      One of the following:

      • PublicApiHolidaysBalanceCounters
        • pto
          object
          requis

          Congés payés en cours d'acquisition (période N)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • ptoN1
          object
          requis

          Congés payés acquis sur la période précédente (N-1)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • ptoN2
          object
          requis

          Congés payés acquis il y a deux périodes (N-2)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • seniority
          object
          requis

          Congés d'ancienneté

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • splitDays
          object
          requis

          Jours de fractionnement

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • jnt
          object
          requis

          Jours non travaillés des forfaits jours (JNT)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • rtt
          object
          requis

          Jours de réduction du temps de travail (RTT)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • cor
          object
          requis

          Contrepartie obligatoire en repos (COR)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • rcr
          object
          requis

          Repos compensateur de remplacement (RCR)

          • earned
            number
            requis

            Jours acquis

          • used
            number
            requis

            Jours pris

        • internshipPto
          requis

          Congés payés d'un stage, null tant qu'aucun jour n'est acquis ni pris

          One of the following:

          • PublicApiHolidayCounter
          • null
      • null
    • periods
      object
      requis

      Périodes de référence des compteurs

      • pto
        object
        requis

        Période des congés payés en cours d'acquisition (N)

        • startDate
          string
          requis

          Premier jour de la période

          format: date
        • endDate
          string
          requis

          Dernier jour de la période

          format: date
      • ptoN1
        object
        requis

        Période des congés payés N-1

        • startDate
          string
          requis

          Premier jour de la période

          format: date
        • endDate
          string
          requis

          Dernier jour de la période

          format: date
      • ptoN2
        object
        requis

        Période des congés payés N-2

        • startDate
          string
          requis

          Premier jour de la période

          format: date
        • endDate
          string
          requis

          Dernier jour de la période

          format: date
      • seniority
        object
        requis

        Période des congés d'ancienneté

        • startDate
          string
          requis

          Premier jour de la période

          format: date
        • endDate
          string
          requis

          Dernier jour de la période

          format: date
      • splitDays
        object
        requis

        Période des jours de fractionnement

        • startDate
          string
          requis

          Premier jour de la période

          format: date
        • endDate
          string
          requis

          Dernier jour de la période

          format: date
      • jnt
        object
        requis

        Période des jours non travaillés (forfait jours)

        • startDate
          string
          requis

          Premier jour de la période

          format: date
        • endDate
          string
          requis

          Dernier jour de la période

          format: date
    • unavailableReason
      string | null
      requis

      Raison pour laquelle balance vaut null, null sinon

  • 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

400

Date de calcul antérieure au paramétrage de paie de l’entreprise dans Puncto
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

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