NominexDocs
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

DELETEhttps://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


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

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

{
  "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

StatusCausa
400payroll_concept_number inválido en la URL.
400Es 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).
400Es Desc Patronal Fondo Ahorro o Vales de despensa entregados y su concepto pareado está inactivo (PAIRED_DEDUCTION_NOT_DELETABLE).
400El concepto tiene importes capturados o créditos de empleado activos.
403El concepto es de ley, o la API key no tiene alcance sobre toda la organización.
404El concepto no existe o ya fue eliminado en esta organización.
Abrir Nominex