Skip to content
Navigation

Modifier une absence (route historique)

Route historique : utilisez PUT /public/v1/absences/{absenceId}. Même corps, mêmes règles et mêmes réponses.

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

Authentification

  • bearerAuth
    HTTP
    requis

Path parameters

  • absenceId
    string
    requis

    Identifiant Puncto de l’absence.

Corps de la requête JSON requis

  • status
    optionnel
    validated
    ou
    rejected
    ou
    canceled
    • validated : Accepté
    • rejected : Refusé
    • canceled : Annulé
  • type
    optionnel
    JNT
    ou
    RTT
    ou
    COR
    ou
    RCR
    ou
    PTO_N
    ou
    PTO_N-1
    +7 de plus

    Les arrêts de travail (SICK, SICK_AT, SICK_ATJ, SICK_MP) et les congés parentaux (PARENTAL) sont refusés : saisissez-les dans Puncto.

    • JNT : Jours Non Travaillés (forfait jour)
    • RTT : RTT
    • COR : Contrepartie Obligatoire en Repos
    • RCR : Repos Compensateur
    • PTO_N : Congés payés
    • PTO_N-1 : Congés payés N-1
    • PTO_N-2 : Congés payés N-2
    • UNPAID : Congés sans solde
    • FAMILY : Congés familiaux
    • REST : Repos
    • SENIORITY : Ancienneté
    • INTERN_CP : Congé payé stage
    • PREGNANCY_EXAM : Examens obligatoires de grossesse
  • startDate
    optionnel
    string

    Premier jour d’absence.

    format: date
  • endDate
    optionnel
    string

    Dernier jour d’absence, inclus.

    format: date
  • onlyHalfDayAtStart
    optionnel
    boolean

    Le premier jour, seul l’après-midi est pris.

  • onlyHalfDayAtEnd
    optionnel
    boolean

    Le dernier jour, seule la matinée est prise.

  • familyEventType
    optionnel
    mariage_pacs_salarie
    ou
    mariage_pacs_enfant
    ou
    deces_conjoint_pacs
    ou
    deces_enfant_moins_25_oui
    ou
    deces_enfant_moins_25_non_parent_oui
    ou
    deces_enfant_moins_25_non_parent_non
    +9 de plus

    Événement familial. Requis quand type vaut FAMILY.

  • childArrivalDate
    optionnel
    string

    Date de naissance de l’enfant, requise pour un congé de naissance. Pour PREGNANCY_EXAM, date présumée de l’accouchement, facultative.

    format: date
  • pregnancyExamBeneficiary
    optionnel
    PREGNANT_EMPLOYEE
    ou
    PARTNER

    Requis quand type vaut PREGNANCY_EXAM.

    • PREGNANT_EMPLOYEE : Salariée enceinte ou en parcours de PMA
    • PARTNER : Conjoint, partenaire de PACS ou concubin

Retour

200

Absence modifiée

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

400

Modification ou transition de statut refusée
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

Absence 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