发薪活动 - 添加算薪人员

scope: hades:payingactivity:addSalaryEmp
发薪活动-添加算薪人员

接口作用

向指定发薪活动中添加算薪人员。系统会校验员工是否在核算组范围内，不在核算组内的员工将添加失败。

接口信息

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

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
payingActivityId	String	是	发薪活动ID
calBizId	String	是	薪资月（如 202501M）
empIds	List<String>	是	员工ID列表

请求示例:

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

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	PayingActivityAddSalaryEmpResponse	添加算薪人员结果

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": [
      {
        "empId": "emp_003",
        "failReason": "该员工不在核算组范围内"
      }
    ]
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

发薪活动 - 添加算薪人员

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数