Referencia de la APIConceptos de nómina
Eliminar
Elimina un concepto de nómina.
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
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.
Comportamiento
- Rechaza la solicitud (
403) si el concepto es de ley. - 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 esSAVINGS_FUND_PAIR_ACTIVEoFOOD_VOUCHER_PAIR_ACTIVE; si está inactivo,PAIRED_DEDUCTION_NOT_DELETABLE. - Rechaza la solicitud (
400) si el concepto tiene importes capturados o créditos de empleado activos. - Marca el concepto como eliminado e inactivo.
400: deducción que descuenta otro concepto activo
{
"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
{
"message": "Vales de despensa entregados no se puede eliminar porque descuenta lo que paga Vales de despensa.",
"code": "PAIRED_DEDUCTION_NOT_DELETABLE"
}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. |

