获取算薪数据

scope:hades:salary:list
根据薪资月和empId获取算薪数据, 同一个人在一个薪资月里可能存在于多个发薪活动

接口作用

按月份批量获取指定员工的薪资计算结果。一个员工可能存在于多个发薪活动中，因此返回列表。单次最多查询5000条数据。返回数据以薪资项名称为key。

接口信息

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

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
month	String	是	薪资月，yyyyMM格式
empIds	List<String>	是	员工ID列表（最多5000个）

请求示例:

{
  "corpId": "corp_123456",
  "month": "202601",
  "empIds": ["emp_001", "emp_002", "emp_003"]
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	SalaryListResponse	批量薪资查询结果

SalaryListResponse 字段说明:

参数名	类型	说明
empSalary	List<EmpSalary>	员工薪资列表

EmpSalary 字段说明:

参数名	类型	说明
empId	String	员工ID
data	List<Map<String, Object>>	薪资数据列表（一个员工可能有多个发薪活动），每个Map的key为薪资项名称，value为薪资项值

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "empSalary": [
      {
        "empId": "emp_001",
        "data": [
          {
            "基本工资": 15000,
            "绩效奖金": 3000,
            "交通补贴": 500
          }
        ]
      },
      {
        "empId": "emp_002",
        "data": [
          {
            "基本工资": 12000,
            "绩效奖金": 2000,
            "交通补贴": 500
          },
          {
            "基本工资": 12000,
            "年终奖": 24000
          }
        ]
      }
    ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

salaryList-Example成功示例

{
    "data": {
        "empSalary": {
            "data": [
                {
                    "key": {}
                }
            ],
            "empId": ""
        }
    },
    "success": false,
    "errorCode": "",
    "errorMsg": ""
}

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数