发薪活动 - 移除算薪人员

scope: hades:payingactivity:reduceSalaryEmp
发薪活动-移除算薪人员

接口作用

从指定发薪活动中移除算薪人员。支持移除指定员工或清除所有算薪人员。

接口信息

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

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
payingActivityId	String	是	发薪活动ID
calBizId	String	是	薪资月（如 202501M）
empIds	List<String>	条件必填	要移除的员工ID列表（reduceAll=false时必填）
reduceAll	Boolean	否	是否清除所有算薪人员，默认false。为true时empIds必须为空

请求示例:

{
  "corpId": "corp_123456",
  "payingActivityId": "pa_001",
  "calBizId": "202501M",
  "empIds": ["emp_001", "emp_002"],
  "reduceAll": false
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	PayingActivityAddSalaryEmpResponse	移除算薪人员结果（结构同接口1）

PayingActivityAddSalaryEmpResponse 字段说明:

参数名	类型	说明
payingActivityId	String	发薪活动ID
calBizId	String	薪资月
successEmpIds	List<String>	移除成功的员工ID列表
failEmpIds	List<ErrorItem>	移除失败的员工列表

ErrorItem 字段说明:

参数名	类型	说明
empId	String	员工ID
failReason	String	失败原因

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "payingActivityId": "pa_001",
    "calBizId": "202501M",
    "successEmpIds": ["emp_001", "emp_002"],
    "failEmpIds": []
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

按empIds清除清除所有发薪活动中算薪人员

{
    "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
    "payingActivityId": "act0aac834200804b79bc1f4a23950ec8b3",
    "calBizId": "202402M",
    "empIds": [
        "emp_dae8e0ab585842278d353d78d9896eaa"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

发薪活动 - 移除算薪人员

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数