发薪活动列表

scope:hades:payingactivity:list

接口作用

查询指定企业在某月份的发薪活动列表，支持按薪资方案ID和核算组ID精确过滤。

接口信息

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

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
month	String	是	月份，yyyyMM格式
schemaId	String	否	薪资方案ID（精确过滤）
ruleId	String	否	核算组ID（精确过滤）

请求示例:

{
  "corpId": "corp_123456",
  "month": "202501",
  "schemaId": "schema_001",
  "ruleId": "rule_001"
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	PayingActivityListResponse	发薪活动列表结果

PayingActivityListResponse 字段说明:

参数名	类型	说明
payingActivityList	List<PayingActivityDetailResponse>	发薪活动列表（字段说明见接口4）

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "payingActivityList": [
      {
        "payingActivityId": "pa_001",
        "payingActivityName": "2025年1月技术部发薪",
        "calVersion": 1,
        "salaryStart": "2025-01-01",
        "salaryEnd": "2025-01-31",
        "atcStart": "2025-01-01",
        "atcEnd": "2025-01-31",
        "calStatus": "4",
        "calStatusName": "计算完成",
        "calBizId": "202501M",
        "approvalStatus": "2",
        "approvalStatusName": "已通过",
        "lockStatus": "1",
        "lockStatusName": "已锁定"
      }
    ]
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
  "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
  "month": "202601",
  "schemaId": "",
  "ruleId": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
	"data": {
		"payingActivityList": [
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "3",
				"calStatusName": "计算失败",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "actf87afc378af443a898d90f1149ea35e5",
				"payingActivityName": "西藏",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act0c5a21e149464f26b286208cd2b26818",
				"payingActivityName": "律师",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act4ee059c4354447748223802890fef9f4",
				"payingActivityName": "三月算税人员01",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "0",
				"calStatusName": "未计算",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act69282e55570645b5bc295ed68734d2e3",
				"payingActivityName": "三月算税（包含其他）",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act404a7add0b564d83929dcbcdea52f7bd",
				"payingActivityName": "小毛测试环境算税",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "0",
				"calStatusName": "未计算",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act97b66b57813d4df6982014fe7ac5b330",
				"payingActivityName": "26年税，但是包含25年个税项",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "3",
				"calStatusName": "计算失败",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act8df566d7c14d4ac590f9eb6f2304691e",
				"payingActivityName": "三月算税人员22",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "acteedaf35d65e74c47bb449ad42f08799d",
				"payingActivityName": "三月-考勤组",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "0",
				"calStatusName": "未计算",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act32905daed8ec4c8f9f7a8f5713a05b9c",
				"payingActivityName": "三月算税人员",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "0",
				"calStatusName": "未计算",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act977bae6e17ec438c95270d989a0f4909",
				"payingActivityName": "测试常晨",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act1618d7f875274c9496ef2f1e412bc426",
				"payingActivityName": "毛新焕算薪-bug",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "0",
				"calStatusName": "未计算",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "actc3575974cb52481b8207fbea93d96ea9",
				"payingActivityName": "毛新焕算薪",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "0",
				"approvalStatusName": "未发起",
				"atcEnd": "2026-01-31",
				"atcStart": "2026-01-01",
				"calStatus": "0",
				"calStatusName": "未计算",
				"calVersion": 0,
				"lockStatus": "0",
				"lockStatusName": "未锁定",
				"payingActivityId": "act48d53335aeea41beb01a68df28165d61",
				"payingActivityName": "csb测试",
				"salaryEnd": "2026-01-31",
				"salaryStart": "2026-01-01"
			},
			{
				"approvalStatus": "2",
				"approvalStatusName": "审批通过",
				"atcEnd": "2026-02-08",
				"atcStart": "2026-01-09",
				"calStatus": "4",
				"calStatusName": "计算完成",
				"calVersion": 0,
				"lockStatus": "1",
				"lockStatusName": "已锁定",
				"payingActivityId": "actd75dd429c6ab488cb89aeff4e9f83551",
				"payingActivityName": "薪资方案-含个税-外部数据-考勤",
				"salaryEnd": "2026-02-08",
				"salaryStart": "2026-01-09"
			}
		]
	},
	"rid": "4d0db93334744dfaa6f3a1e434b4b3c6",
	"success": true
}

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数