Skip to content
Navigation

Consulter une absence

Renvoie une absence, au même format que la liste des absences.

Pour une prolongation d’arrêt de travail, workStoppage décrit l’arrêt initial (dernier jour travaillé, subrogation, dates d’accident ou de constatation), avec l’avis de prolongation pour justificatif.

Les justificatifs (familyProofFile, workStoppage.proofFile) se téléchargent avec GET /public/v1/documents/{documentId}/download, leur id servant de documentId.

GET
https://api.puncto.fr/public/v1/absences/{absenceId}

Authentification

  • bearerAuth
    HTTP
    requis

Path parameters

  • absenceId
    string
    requis

    Identifiant Puncto de l’absence.

Retour

200

Absence

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

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

Absence introuvable
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

Type to search…

↑↓ navigate↵ selectEsc close