Skip to content
Navigation

Importer des absences

Route historique : utilisez POST /public/v1/absences et PUT /public/v1/absences/{absenceId}.

Crée ou met à jour des absences par lot, en une transaction, sans contrôle de chevauchement, de solde ni de durée légale, et sans arrêt de travail pour la DSN.

  • Collaborateur ou contrat introuvable : l’absence est ignorée et listée dans errors. Vérifiez errors même en 200.
  • Un congé payé importé pending va en PTO_N ; les congés validés sont répartis entre PTO_N, PTO_N-1 et PTO_N-2 selon les soldes.
POST
https://api.puncto.fr/public/v1/absences/actions/import

Authentification

  • bearerAuth
    HTTP
    requis

Corps de la requête JSON requis

  • absences
    tableau de
    object
    requis
    • status
      pending
      ou
      validated
      ou
      rejected
      ou
      canceled
      requis
      • pending : En attente
      • validated : Accepté
      • rejected : Refusé
      • canceled : Annulé
    • type
      JNT
      ou
      RTT
      ou
      COR
      ou
      RCR
      ou
      PTO_N
      ou
      PTO_N-1
      +12 de plus
      requis
      • 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
      • PARENTAL : Congés parentaux
      • REST : Repos
      • SICK : Maladie ordinaire
      • SICK_AT : Accident du travail
      • SICK_MP : Maladie professionnelle
      • SICK_ATJ : Accident de trajet
      • SENIORITY : Ancienneté
      • INTERN_CP : Congé payé stage
      • PREGNANCY_EXAM : Examens obligatoires de grossesse
    • startDate
      string
      requis

      Premier jour d’absence.

      format: date
    • endDate
      string
      requis

      Dernier jour d’absence, inclus.

      format: date
    • contractMatching
      object
      requis

      Désigne le collaborateur. Puncto retient son contrat actif à eventDate, à défaut sur le mois concerné.

      • type
        BY_COLLABORATOR_FOREIGN_ERP_ID
        ou
        BY_PUNCTO_COLLABORATOR_ID
        requis

        Clé de correspondance utilisée par value.

        • BY_COLLABORATOR_FOREIGN_ERP_ID : value est le foreignErpId du collaborateur
        • BY_PUNCTO_COLLABORATOR_ID : value est l’identifiant Puncto du collaborateur
      • value
        string
        requis

        Identifiant du collaborateur.

      • eventDate
        optionnel
        string

        Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.

        format: date
    • foreignErpId
      optionnel
      string

      Identifiant de l’élément dans votre système. Réimporter le même foreignErpId met à jour l’élément existant.

    • parentalLeaveType
      optionnel
      BIRTH_ADDITIONAL_LEAVE

      Requis quand type vaut PARENTAL.

      • BIRTH_ADDITIONAL_LEAVE : Congé supplémentaire de naissance ou d'adoption
    • pregnancyExamBeneficiary
      optionnel
      PREGNANT_EMPLOYEE
      ou
      PARTNER

      Requis quand type vaut PREGNANCY_EXAM. 3 examens au plus par grossesse.

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

      L’absence prolonge un arrêt précédent.

      default: false
    • onlyHalfDayAtStart
      optionnel
      boolean

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

      default: false
    • onlyHalfDayAtEnd
      optionnel
      boolean

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

      default: false
    • childArrivalDate
      optionnel
      string

      Date de naissance ou d’arrivée au foyer de l’enfant, requise pour PARENTAL. Pour PREGNANCY_EXAM, date présumée de l’accouchement, facultative.

      format: date
    • createdAt
      optionnel
      string

      Date de création de la demande. Par défaut, maintenant.

      format: date-time
  • disableIdempotency
    optionnel
    boolean

    Rend foreignErpId facultatif : chaque élément est alors créé, même s’il a déjà été importé.

    default: false

Retour

200

Bilan de l’import

JSON
  • createdCount
    integer
    requis

    Éléments créés.

  • modifiedCount
    integer
    requis

    Éléments existants mis à jour.

  • errors
    tableau de
    string
    requis

    Un message par élément ignoré ; les autres sont importés.

400

foreignErpId manquant sans disableIdempotency, ou import annulé
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.

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