Skip to content
Navigation

Lister les absences

Liste paginée des absences de l’entreprise, par date de début décroissante.

Une prolongation d’arrêt de travail a isProlongation à true : son workStoppage est l’arrêt initial, avec l’avis de prolongation pour justificatif.

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

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
  • type[]
    optionnel
    tableau de
    string

    Types d’absence à garder. Répétez le paramètre pour en passer plusieurs.

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

  • minCreationDate
    optionnel
    string

    Absences créées à partir de cette date (ISO 8601).

    format: date-time
  • maxCreationDate
    optionnel
    string

    Absences créées jusqu’à cette date (ISO 8601).

    format: date-time

Retour

200

Page d’absences

JSON
  • data
    tableau de
    object
    requis
    • startDate
      string
      requis
      format: date
    • endDate
      string
      requis
      format: date
    • duration
      number
      requis
    • durationExplanation
      string
      requis
    • parentalLeaveType
      requis

      Type de congé parental (congé de maternité, de paternité, d'adoption, supplémentaire de naissance), null pour toute autre absence.

      One of the following:

      • ParentalLeaveType
      • null
    • foreignErpId
      string | null
      requis
    • contractId
      string
      requis

      Identifiant Puncto

    • collaboratorId
      string
      requis

      Identifiant Puncto

    • createdAt
      string
      requis

      Date à laquelle la demande d'absence a été posée.

      format: date-time
    • isLocked
      boolean
      requis

      True when the absence can no longer be modified: one of its payroll months is closed and no open payslip can carry the regularisation (lockState.state === 'BLOCKED').

    • lockState
      requis

      État de saisie sur les mois couverts par l'absence (saisie tardive possible)

      One of the following:

      • object
      • object
      • object
    • isDsnLocked
      boolean
      requis

      True when the DSN of the underlying work stoppage is being transmitted or already deposited. The absence can then no longer be edited, cancelled or deleted.

    • id
      string
      requis

      Identifiant Puncto

    • type
      JNT
      ou
      RTT
      ou
      COR
      ou
      RCR
      ou
      PTO_N
      ou
      PTO_N-1
      +12 de plus
      requis
    • status
      pending
      ou
      validated
      ou
      rejected
      ou
      canceled
      ou
      technical-cancel
      requis
    • onlyHalfDayAtStart
      boolean
      requis
    • onlyHalfDayAtEnd
      boolean
      requis
    • collaboratorForeignErpId
      string | null
      requis
    • isProlongation
      boolean
      requis

      Prolongation d'un arrêt de travail : workStoppage est alors l'arrêt initial, avec l'avis de prolongation pour justificatif.

    • familyEventType
      optionnel

      One of the following:

      • FamilyEventType
      • null
    • childArrivalDate
      optionnel

      One of the following:

      • string
      • null
    • pregnancyExamBeneficiary
      optionnel

      Examens de grossesse : la salariée enceinte elle-même, ou son conjoint.

      One of the following:

      • PregnancyExamBeneficiary
      • null
    • maternityLeaveSituation
      optionnel

      Congé de maternité : rang de l'enfant ou naissance multiple, qui fixe la durée légale.

      One of the following:

      • MaternityLeaveSituation
      • null
    • actualBirthDate
      optionnel

      Congé de maternité : date réelle de l'accouchement, une fois connue.

      One of the following:

      • string
      • null
    • hasPathologicalPrenatalState
      optionnel
      boolean

      Congé de maternité : état pathologique prénatal prescrit (14 jours de plus avant la naissance).

    • adoptionLeaveSituation
      optionnel

      Congé d'adoption : nombre d'enfants à charge ou adoption multiple, qui fixe la durée légale.

      One of the following:

      • AdoptionLeaveSituation
      • null
    • childArrivalType
      optionnel

      Congé de naissance : naissance ou adoption de l'enfant, purement informatif.

      One of the following:

      • ChildArrivalType
      • null
    • familyProofFile
      optionnel

      One of the following:

      • ApiCompanyFile
        • id
          string
          requis

          Identifiant Puncto

        • displayFileName
          string
          requis
        • fileType
          PAYSLIP
          ou
          PAYSLIP_ARCHIVED
          ou
          DSN_MONTHLY
          ou
          DSN_WORK_STOPPAGE
          ou
          DSN_WORK_STOPPAGE_RESUMPTION
          ou
          DSN_FCTU
          +40 de plus
          requis
        • file
          object
          requis
          • key
            string
            requis
          • mimeType
            requis

            One of the following:

            • ImageMimeType
            • OtherMimeType
        • collaborator
          requis

          One of the following:

          • object
          • null
        • generatedByUserAccount
          requis

          One of the following:

          • object
          • null
        • createdAt
          string
          requis
          format: date-time
      • null
    • workStoppage
      optionnel
      object
      • lastWorkedDay
        string
        requis
        format: date
      • accidentDate
        requis

        One of the following:

        • string
        • null
      • diseaseObservationDate
        requis

        One of the following:

        • string
        • null
      • proofFile
        requis

        One of the following:

        • ApiCompanyFile
          • id
            string
            requis

            Identifiant Puncto

          • displayFileName
            string
            requis
          • fileType
            PAYSLIP
            ou
            PAYSLIP_ARCHIVED
            ou
            DSN_MONTHLY
            ou
            DSN_WORK_STOPPAGE
            ou
            DSN_WORK_STOPPAGE_RESUMPTION
            ou
            DSN_FCTU
            +40 de plus
            requis
          • file
            object
            requis
            • key
              string
              requis
            • mimeType
              requis

              One of the following:

              • ImageMimeType
              • OtherMimeType
          • collaborator
            requis

            One of the following:

            • object
            • null
          • generatedByUserAccount
            requis

            One of the following:

            • object
            • null
          • createdAt
            string
            requis
            format: date-time
        • null
      • withSubrogation
        boolean
        requis
      • isProlongation
        boolean
        requis

        Nature de l'arrêt porté par cette absence : prolongation d'un arrêt initial ou arrêt initial.

    • workStoppageDsn
      optionnel
      object

      État déclaratif de l'arrêt de travail porté par cette absence.

      Renseigné par les listes internes seulement : le calculer suppose de lire les suivis DSN et la reprise, ce que l'API publique ne fait pas. Son absence ne veut donc pas dire « rien à déclarer », mais « information non chargée ici ».

      • declaredForecastEndDate
        requis

        Date de fin prévisionnelle (S21.G00.60.003) telle que le signalement d'arrêt l'a déclarée. Null tant qu'aucun signalement n'a abouti : c'est elle qui dit si une reprise est anticipée.

        One of the following:

        • string
        • null
      • isDsnDeclared
        boolean
        requis

        Vrai quand un signalement d'arrêt a été déposé et validé (idFlux obtenu).

      • resumption
        requis

        Reprise anticipée déclarée sur cet arrêt, le cas échéant.

        One of the following:

        • ApiWorkStoppageResumption
          • id
            string
            requis

            Identifiant Puncto

          • resumptionDate
            string
            requis

            Premier jour travaillé et payé suite à l'arrêt (S21.G00.60.010).

            format: date
          • resumptionMotive
            01
            ou
            02
            ou
            03
            requis

            Motif de la reprise (S21.G00.60.011).

          • signalementRequired
            boolean
            requis

            Faux quand la reprise n'appelle pas de signalement : l'information passe par la DSN mensuelle.

          • trackingStatus
            requis

            Statut du signalement de reprise, null tant qu'aucun n'a été déclenché.

            One of the following:

            • DsnTrackingStatus
            • null
        • null
      • pendingDeclaration
        requis

        Signalement d'arrêt que l'automatisation doit encore déposer : aucune reprise ne peut être saisie avant lui. Null quand l'arrêt est déclaré, ou que l'automatisation ne le déclarera pas.

        One of the following:

        • ApiPendingWorkStoppageDeclaration
        • null
    • lateInputRegularisation
      optionnel

      Dernière saisie tardive faite sur cette entité, null s'il n'y en a pas. Renseigné par les listes internes seulement : son absence veut dire « information non chargée ici ».

      One of the following:

      • ApiLateInputRegularisation
        • status
          PENDING
          ou
          CARRIED
          requis
        • carrierYear
          number
          requis
        • carrierMonth
          number
          requis
      • null
  • 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