获取人员范围

scope:hades:payingactivity:empScope
获取发薪活动对应的有权限的人员范围

接口作用

查询指定月份下操作人有权限的发薪活动及其下的算薪人员列表。需要操作人对发薪活动中所有核算组都有权限才返回该活动。

接口信息

属性	值
URL	`/open/api/v1/payingactivity/empScope`
Method	POST
Content-Type	application/json
权限标识	`hades:payingactivity:empScope`

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
empId	String	是	操作人员工ID
month	String	是	月份，yyyyMM格式

请求示例:

{
  "corpId": "corp_123456",
  "empId": "emp_admin_001",
  "month": "202501"
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	List<PayingActivityEmpScopeResponse>	发薪活动人员范围列表

PayingActivityEmpScopeResponse 字段说明:

参数名	类型	说明
payingActivityId	String	发薪活动ID
empScope	List<String>	该发薪活动下的员工ID列表

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "payingActivityId": "pa_001",
      "empScope": ["emp_001", "emp_002", "emp_003"]
    },
    {
      "payingActivityId": "pa_002",
      "empScope": ["emp_004", "emp_005"]
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200empScope-Example

text/plain

示例

{
    "data": [
        {
            "payingActivityId": "", //发薪活动ID
            "empScope": [ //有权限的人员范围(人员empIds)
                ""
            ]
        }
    ],
    "success": false,
    "errorCode": "",
    "errorMsg": ""
}

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数