# Eliminar (/docs/developers/api-reference/payroll-concepts/delete)

## Descripcion general [#descripcion-general]

Esta ruta realiza el **borrado** de un concepto de nómina **extralegal** (`origin: "custom"`): a partir de ese momento se trata como no encontrado en `PATCH`/`DELETE` (`404`). Los conceptos de ley no se eliminan por la API. El borrado **no procede** si el concepto tiene importes capturados o créditos de empleado activos; en esos casos desactívalo con `PATCH is_active=false`.

La API key necesita el permiso **Eliminar conceptos de nómina** y alcance sobre toda la organización.

## Ruta [#ruta]

`DELETE https://app.integranom.com/api/v1/payroll-concepts/{payroll_concept_number}`

**Parámetro de ruta:** `payroll_concept_number`: entero positivo, el número del concepto dentro de la organización.

## Solicitud [#solicitud]

***

Sin cuerpo. La API responde `204 No Content` si el borrado tuvo éxito.

**cURL**

```bash
curl -X DELETE "https://app.integranom.com/api/v1/payroll-concepts/42" \
-H "Authorization: Bearer $API_KEY"
```

**Respuesta**

```text
204 No Content
```

## Comportamiento [#comportamiento]

1. **Rechaza** la solicitud (`403`) si el concepto es de ley.
2. **Rechaza** la solicitud (`400`) si es **Desc Patronal Fondo Ahorro** o **Vales de despensa entregados**: descuentan lo que pagan **Desc Aportación Trabajador F.A** y **Vales de despensa**, así que nunca se eliminan. Mientras ese concepto está activo, el código es `SAVINGS_FUND_PAIR_ACTIVE` o `FOOD_VOUCHER_PAIR_ACTIVE`; si está inactivo, `PAIRED_DEDUCTION_NOT_DELETABLE`.
3. **Rechaza** la solicitud (`400`) si el concepto tiene importes capturados o créditos de empleado activos.
4. **Marca** el concepto como eliminado e inactivo.

### `400`: deducción que descuenta otro concepto activo [#400-deducción-que-descuenta-otro-concepto-activo]

```json
{
  "message": "Vales de despensa entregados no se puede eliminar mientras Vales de despensa esté activo.",
  "code": "FOOD_VOUCHER_PAIR_ACTIVE"
}
```

### `400`: deducción que descuenta otro concepto inactivo [#400-deducción-que-descuenta-otro-concepto-inactivo]

```json
{
  "message": "Vales de despensa entregados no se puede eliminar porque descuenta lo que paga Vales de despensa.",
  "code": "PAIRED_DEDUCTION_NOT_DELETABLE"
}
```

## Errores [#errores]

| Status | Causa                                                                                                                                                                                                           |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | `payroll_concept_number` inválido en la URL.                                                                                                                                                                    |
| `400`  | Es **Desc Patronal Fondo Ahorro** con **Desc Aportación Trabajador F.A** activo (`SAVINGS_FUND_PAIR_ACTIVE`), o **Vales de despensa entregados** con **Vales de despensa** activo (`FOOD_VOUCHER_PAIR_ACTIVE`). |
| `400`  | Es **Desc Patronal Fondo Ahorro** o **Vales de despensa entregados** y su concepto pareado está inactivo (`PAIRED_DEDUCTION_NOT_DELETABLE`).                                                                    |
| `400`  | El concepto tiene importes capturados o créditos de empleado activos.                                                                                                                                           |
| `403`  | El concepto es de ley, o la API key no tiene alcance sobre toda la organización.                                                                                                                                |
| `404`  | El concepto no existe o ya fue eliminado en esta organización.                                                                                                                                                  |