---
title: "Supprimer une variable de paie"
description: "Supprime une variable de paie et ses justificatifs, et recalcule les bulletins en brouillon concernés. Sur un mois de paie clôturé ou dont le bulletin est validé, c’est une saisie tardive, régularisée par la prochaine paie ouverte.\n\nRefusé : heures d’une feuille de temps, intéressement, prime de vacances ou chèques-vacances de la page Primes, indemnité de fin de contrat du mois du solde de tout compte, acompte sur salaire d’un mois clôturé. Une PPV de la page Primes se supprime."
---

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

Path: API Puncto › Variables de paie

`DELETE /public/v1/payroll-variables/{payrollVariableId}`

Supprime une variable de paie et ses justificatifs, et recalcule les bulletins en brouillon concernés. Sur un mois de paie clôturé ou dont le bulletin est validé, c’est une saisie tardive, régularisée par la prochaine paie ouverte.

Refusé : heures d’une feuille de temps, intéressement, prime de vacances ou chèques-vacances de la page Primes, indemnité de fin de contrat du mois du solde de tout compte, acompte sur salaire d’un mois clôturé. Une PPV de la page Primes se supprime.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `payrollVariableId` (`deletePayrollVariable.path.payrollVariableId`; string, required) — Identifiant Puncto de la variable de paie. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/payroll-variables/{payrollVariableId}?matchingBy=BY_FOREIGN_ERP_ID`.
  - example `"pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Code samples

### cURL

```bash
curl --request DELETE \
  --url https://api.puncto.fr/public/v1/payroll-variables/pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/payroll-variables/pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

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/payroll-variables/pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)
```

## Responses

### 204

Variable de paie supprimée

### 400

Variable gérée ailleurs, ou mois qu’aucune paie ouverte ne peut régulariser

#### Example

```json
{
  "error": "Cette variable de paie provient de la page Primes et ne peut pas être modifiée directement."
}
```

- `error` (`deletePayrollVariable.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`deletePayrollVariable.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` (`deletePayrollVariable.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`deletePayrollVariable.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` (`deletePayrollVariable.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`deletePayrollVariable.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Variable de paie introuvable dans l’entreprise. Si l’identifiant désigne une variable récurrente, le message donne son identifiant Puncto et la route à utiliser.

#### Example

```json
{
  "error": "Variable de paie non trouvée"
}
```

- `error` (`deletePayrollVariable.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`deletePayrollVariable.response.404.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` (`deletePayrollVariable.response.422.errors`; array<object>, required)
  - `message` (`deletePayrollVariable.response.422.errors.message`; string, required)
  - `rule` (`deletePayrollVariable.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`deletePayrollVariable.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/payroll-variables/delete/index.md
