---
title: "Importer des absences"
description: "**Route historique** : utilisez `POST /public/v1/absences` et `PUT /public/v1/absences/{absenceId}`.\n\nCré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.\n\n- Collaborateur ou contrat introuvable : l’absence est ignorée et listée dans `errors`. **Vérifiez `errors` même en `200`.**\n- 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."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

> **Deprecated.**

Path: API Puncto › Absences

`POST /public/v1/absences/actions/import`

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

## Authentication

- `bearerAuth`, http, header `Authorization`

## Request body

_Required._

- `absences` (`importAbsences.absences`; array<object>, required)
  - `status` (`importAbsences.absences.status`; string, required) — - `pending` : En attente - `validated` : Accepté - `rejected` : Refusé - `canceled` : Annulé
    - one of `"pending"`, `"validated"`, `"rejected"`, `"canceled"`
  - `type` (`importAbsences.absences.type`; string, required) — - `JNT` : Jours Non Travaillé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
    - one of `"JNT"`, `"RTT"`, `"COR"`, `"RCR"`, `"PTO_N"`, `"PTO_N-1"`, `"PTO_N-2"`, `"UNPAID"`, `"FAMILY"`, `"PARENTAL"`, `"REST"`, `"SICK"`, `"SICK_AT"`, `"SICK_MP"`, `"SICK_ATJ"`, `"SENIORITY"`, `"INTERN_CP"`, `"PREGNANCY_EXAM"`
  - `startDate` (`importAbsences.absences.startDate`; string, required) — Premier jour d’absence.
    - format `date`; example `"2026-10-05"`
  - `endDate` (`importAbsences.absences.endDate`; string, required) — Dernier jour d’absence, inclus.
    - format `date`; example `"2026-10-05"`
  - `contractMatching` (`importAbsences.absences.contractMatching`; object, required) — Désigne le collaborateur. Puncto retient son contrat actif à `eventDate`, à défaut sur le mois concerné.
    - `type` (`importAbsences.absences.contractMatching.type`; string, required) — 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
      - one of `"BY_COLLABORATOR_FOREIGN_ERP_ID"`, `"BY_PUNCTO_COLLABORATOR_ID"`
    - `value` (`importAbsences.absences.contractMatching.value`; string, required) — Identifiant du collaborateur.
    - `eventDate` (`importAbsences.absences.contractMatching.eventDate`; string, optional) — Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.
      - format `date`; example `"2026-10-05"`
  - `foreignErpId` (`importAbsences.absences.foreignErpId`; string, optional) — Identifiant de l’élément dans votre système. Réimporter le même `foreignErpId` met à jour l’élément existant.
  - `parentalLeaveType` (`importAbsences.absences.parentalLeaveType`; string, optional) — Requis quand `type` vaut `PARENTAL`. - `BIRTH_ADDITIONAL_LEAVE` : Congé supplémentaire de naissance ou d'adoption
    - one of `"BIRTH_ADDITIONAL_LEAVE"`
  - `pregnancyExamBeneficiary` (`importAbsences.absences.pregnancyExamBeneficiary`; string, optional) — 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
    - one of `"PREGNANT_EMPLOYEE"`, `"PARTNER"`
  - `isProlongation` (`importAbsences.absences.isProlongation`; boolean, optional) — L’absence prolonge un arrêt précédent.
    - default `false`
  - `onlyHalfDayAtStart` (`importAbsences.absences.onlyHalfDayAtStart`; boolean, optional) — Le premier jour, seul l’après-midi est pris.
    - default `false`
  - `onlyHalfDayAtEnd` (`importAbsences.absences.onlyHalfDayAtEnd`; boolean, optional) — Le dernier jour, seule la matinée est prise.
    - default `false`
  - `childArrivalDate` (`importAbsences.absences.childArrivalDate`; string, optional) — 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` (`importAbsences.absences.createdAt`; string, optional) — Date de création de la demande. Par défaut, maintenant.
    - format `date-time`
- `disableIdempotency` (`importAbsences.disableIdempotency`; boolean, optional) — Rend `foreignErpId` facultatif : chaque élément est alors créé, même s’il a déjà été importé.
  - default `false`

## Example request

```json
{
  "absences": [
    {
      "foreignErpId": "absence-123",
      "status": "validated",
      "type": "RTT",
      "startDate": "2026-10-05",
      "endDate": "2026-10-05",
      "contractMatching": {
        "type": "BY_COLLABORATOR_FOREIGN_ERP_ID",
        "value": "salarie-123"
      }
    }
  ]
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url https://api.puncto.fr/public/v1/absences/actions/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "absences": [
    {
      "foreignErpId": "absence-123",
      "status": "validated",
      "type": "RTT",
      "startDate": "2026-10-05",
      "endDate": "2026-10-05",
      "contractMatching": {
        "type": "BY_COLLABORATOR_FOREIGN_ERP_ID",
        "value": "salarie-123"
      }
    }
  ]
}
'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/absences/actions/import';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    absences: [
      {
        foreignErpId: 'absence-123',
        status: 'validated',
        type: 'RTT',
        startDate: '2026-10-05',
        endDate: '2026-10-05',
        contractMatching: {type: 'BY_COLLABORATOR_FOREIGN_ERP_ID', value: 'salarie-123'}
      }
    ]
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/absences/actions/import"

payload = { "absences": [
        {
            "foreignErpId": "absence-123",
            "status": "validated",
            "type": "RTT",
            "startDate": "2026-10-05",
            "endDate": "2026-10-05",
            "contractMatching": {
                "type": "BY_COLLABORATOR_FOREIGN_ERP_ID",
                "value": "salarie-123"
            }
        }
    ] }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 200

Bilan de l’import

#### Example

```json
{
  "createdCount": 1,
  "modifiedCount": 0,
  "errors": []
}
```

- `createdCount` (`importAbsences.response.200.createdCount`; integer, required) — Éléments créés.
- `modifiedCount` (`importAbsences.response.200.modifiedCount`; integer, required) — Éléments existants mis à jour.
- `errors` (`importAbsences.response.200.errors`; array<string>, required) — Un message par élément ignoré ; les autres sont importés.

### 400

`foreignErpId` manquant sans `disableIdempotency`, ou import annulé

#### Example

```json
{
  "error": "Une erreur est survenue lors de l’importation des absences (aucune donnée importée)"
}
```

- `error` (`importAbsences.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`importAbsences.response.400.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`importAbsences.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`importAbsences.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`importAbsences.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`importAbsences.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 422

Paramètres invalides

#### Example

```json
{
  "errors": [
    {
      "message": "Le champ statut de l’absence doit être une valeur autorisée",
      "rule": "enum",
      "field": "status"
    }
  ]
}
```

- `errors` (`importAbsences.response.422.errors`; array<object>, required)
  - `message` (`importAbsences.response.422.errors.message`; string, required)
  - `rule` (`importAbsences.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`importAbsences.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/absences/import/index.md
