算薪结果

scope:hades:salaryresult:list

接口作用

分页查询指定发薪活动的个人算薪结果，包含员工信息、计算状态、考勤期间、有效算薪区间和各薪资项结果。

接口信息

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

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
payingActivityId	String	是	发薪活动ID
page	int	否	当前页码，默认1，最小1
pageSize	int	否	每页大小，默认30，最小1，最大100

请求示例:

{
  "corpId": "corp_123456",
  "payingActivityId": "pa_001",
  "page": 1,
  "pageSize": 30
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	SalaryResultOpenApiResponse	算薪结果分页数据

SalaryResultOpenApiResponse 字段说明:

参数名	类型	说明
total	Integer	总记录数
page	Integer	当前页码
pageSize	Integer	每页大小
list	List<SalaryResultItem>	算薪结果列表

SalaryResultItem 字段说明:

参数名	类型	说明
id	Long	记录ID
empId	String	员工ID
empName	String	员工姓名
calStatus	String	计算状态值（0-未计算, 1-计算中, 2-部分计算, 3-计算失败, 4-计算完成）
calStatusName	String	计算状态名称
atcRange	String	考勤期间
validSalaryRanges	String	有效算薪区间
salaryItems	List<SalaryItemResult>	薪资项结果列表

SalaryItemResult 字段说明:

参数名	类型	说明
itemId	String	薪资项ID
itemName	String	薪资项名称
value	Object	薪资项值

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "total": 50,
    "page": 1,
    "pageSize": 30,
    "list": [
      {
        "id": 10001,
        "empId": "emp_001",
        "empName": "张三",
        "calStatus": "4",
        "calStatusName": "计算完成",
        "atcRange": "2026-01-01 ~ 2026-01-31",
        "validSalaryRanges": "2026-01-01 ~ 2026-01-31",
        "salaryItems": [
          {
            "itemId": "item_001",
            "itemName": "基本工资",
            "value": 15000
          },
          {
            "itemId": "item_002",
            "itemName": "绩效奖金",
            "value": 3000
          },
          {
            "itemId": "item_003",
            "itemName": "应发合计",
            "value": 18000
          }
        ]
      },
      {
        "id": 10002,
        "empId": "emp_002",
        "empName": "李四",
        "calStatus": "4",
        "calStatusName": "计算完成",
        "atcRange": "2026-01-01 ~ 2026-01-31",
        "validSalaryRanges": "2026-01-01 ~ 2026-01-31",
        "salaryItems": [
          {
            "itemId": "item_001",
            "itemName": "基本工资",
            "value": 12000
          },
          {
            "itemId": "item_002",
            "itemName": "绩效奖金",
            "value": 2000
          },
          {
            "itemId": "item_003",
            "itemName": "应发合计",
            "value": 14000
          }
        ]
      }
    ]
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
  "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
  "payingActivityId": "act404a7add0b564d83929dcbcdea52f7bd",
  "page": 1,
  "pageSize": 30
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
	"data": {
		"list": [
			{
				"atcRange": "2026-01-01~2026-01-31",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"empId": "emp_15d4d92f6d0a47189335e1ef118cf70f",
				"empName": "测试苗瑞枫",
				"id": 1202603,
				"salaryItems": [
					{
						"itemId": "corp_item_name",
						"itemName": "姓名",
						"value": "测试苗瑞枫"
					},
					{
						"itemId": "corp_item_employeeNumber",
						"itemName": "工号",
						"value": ""
					},
					{
						"itemId": "corp_item_empId",
						"itemName": "EmpId",
						"value": "emp_15d4d92f6d0a47189335e1ef118cf70f"
					},
					{
						"itemId": "corp_item_grossPay",
						"itemName": "应发工资",
						"value": "30000"
					},
					{
						"itemId": "corp_item_wageLabor",
						"itemName": "个税（工资薪金/劳务报酬）",
						"value": "690.00"
					},
					{
						"itemId": "corp_item_official_business_traffic_fee",
						"itemName": "公务交通费用（个税）",
						"value": "0"
					},
					{
						"itemId": "corp_item_communication_fee",
						"itemName": "通讯费用（个税）",
						"value": "0"
					},
					{
						"itemId": "corp_item_compensation",
						"itemName": "个税（一次性补偿金）",
						"value": "0"
					},
					{
						"itemId": "corp_item_d95334362de44ff8a8c322949743cb7f",
						"itemName": "数字-3",
						"value": "0"
					}
				],
				"validSalaryRanges": "2026-01-01 至 2026-01-31"
			}
		],
		"page": 1,
		"pageSize": 30,
		"total": 1
	},
	"rid": "5264b9c3488d4be499bee8964051857b",
	"success": true
}

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数