Saltar a contenido

DELETE Eliminar nómina

Método/Ruta: DELETE /api/v2/payrolls/:id
Auth: Bearer JWT (rol: admin)

Descripción: Elimina una nómina por su ID. También elimina el archivo asociado de S3 para evitar archivos huérfanos.

Params

  • id (path, number, required) — ID de la nómina a eliminar

cURL

curl -X DELETE "http://localhost:7001/api/v2/payrolls/456" \
  -H "Authorization: Bearer <TOKEN>"

Response (200)

{
  "success": true,
  "message": "Payroll deleted successfully"
}

Errores

Código Descripción
401 Token inválido o expirado
403 Sin permisos de administrador
404 Payroll not found
500 Failed to delete file from storage / Error interno

Notas

  • La eliminación es completa: se elimina el registro de la nómina, el registro del archivo en BD, y el archivo físico en S3
  • Si falla la eliminación del archivo en S3, la operación se aborta y no se elimina nada