批量创建发薪活动

scope:hades:payingactivity:batchCreate

接口作用

批量创建发薪活动，单次最多创建50个。返回成功和失败的活动列表。

接口信息

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

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
activities	List<PayingActivityBatchCreateItemRequest>	是	发薪活动列表（最多50个）

PayingActivityBatchCreateItemRequest 字段说明:

参数名	类型	必填	说明
payingActivityName	String	是	发薪活动名称
calBizId	String	是	薪资月（格式 yyyyMMM，如 202501M）
schemaId	String	是	薪资方案ID
ruleIds	List<String>	是	核算组ID列表
calScope	List<CalScopeItem>	否	有效算薪区间

CalScopeItem 字段说明:

参数名	类型	说明
fieldCode	String	字段编码
fieldName	String	字段名称
fieldValue	List<String>	字段值列表

请求示例:

{
  "corpId": "corp_123456",
  "activities": [
    {
      "payingActivityName": "2025年1月技术部发薪",
      "calBizId": "202501M",
      "schemaId": "schema_001",
      "ruleIds": ["rule_001", "rule_002"],
      "calScope": [
        {
          "fieldCode": "department",
          "fieldName": "部门",
          "fieldValue": ["技术部"]
        }
      ]
    },
    {
      "payingActivityName": "2025年1月市场部发薪",
      "calBizId": "202501M",
      "schemaId": "schema_002",
      "ruleIds": ["rule_003"]
    }
  ]
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	PayingActivityBatchCreateResponse	批量创建结果

PayingActivityBatchCreateResponse 字段说明:

参数名	类型	说明
successList	List<SuccessItem>	创建成功的活动列表
failList	List<FailItem>	创建失败的活动列表

SuccessItem 字段说明:

参数名	类型	说明
payingActivityId	String	发薪活动ID
payingActivityName	String	发薪活动名称

FailItem 字段说明:

参数名	类型	说明
payingActivityName	String	发薪活动名称
failReason	String	失败原因

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": {
    "successList": [
      {
        "payingActivityId": "pa_001",
        "payingActivityName": "2025年1月技术部发薪"
      }
    ],
    "failList": [
      {
        "payingActivityName": "2025年1月市场部发薪",
        "failReason": "薪资方案不存在"
      }
    ]
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
  "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
  "activities": [
    {
      "payingActivityName": "批量创建3",
      "calBizId": "202602M",
      "schemaId": "schema_d0cae5b5a271447394d7cf6519e851e9",
      "ruleIds": [
        "test_0203_03"
      ],
      "calScope": [
        {
          "fieldCode": "mainDepartment",
          "fieldValue": [
            "org_e5d652fd4e0f4752b6832e5c75871775"
          ]
        }
      ]
    },
    {
      "payingActivityName": "批量创建4",
      "calBizId": "202602M",
      "schemaId": "schema_d0cae5b5a271447394d7cf6519e851e9",
      "ruleIds": [
        "test_0203_03"
      ],
      "calScope": [
        {
          "fieldCode": "mainDepartment",
          "fieldValue": [
            "org_e5d652fd4e0f4752b6832e5c75871775"
          ]
        }
      ]
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
	"data": {
		"failList": [],
		"successList": [
			{
				"payingActivityId": "actfc935b0d30114681885dad80a5e4d0fe",
				"payingActivityName": "批量创建3"
			},
			{
				"payingActivityId": "act0640b8d52f0c4037ba15e6ffd942bf67",
				"payingActivityName": "批量创建4"
			}
		]
	},
	"rid": "8d16988c252c4480be63af63acbe3c46",
	"success": true
}

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数