创建核算组

scope:hades:emprule:create

接口说明

创建核算组，支持自定义 ruleId（可选，不传则自动生成 UUID）。需要传入花名册选人配置（hrm）或考勤组选人配置（atc）二选一。

接口信息

项目	说明
URL	`/open/api/v1/emprule/create`
Method	POST
Content-Type	application/json
权限标识	hades:emprule:create

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
ruleId	String	否	核算组ID（可选，不传则自动生成，如传入需保证租户下唯一）
ruleName	String	是	核算组名称（1-30字符）
hrm	HrmSetting	条件必填	花名册选人配置（与 atc 二选一）
atc	AtcGroupSetting	条件必填	考勤组选人配置（与 hrm 二选一）

请求示例

{
  "corpId": "corp_001",
  "ruleId": "rule_custom_001",
  "ruleName": "研发部核算组",
  "hrm": {
    "条件配置": "具体配置内容"
  }
}

返回参数

EmpRuleOpenApiCreateResponse

参数名	类型	说明
ruleId	String	核算组ID
ruleName	String	核算组名称

返回示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "ruleId": "rule_custom_001",
    "ruleName": "研发部核算组"
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

示例 1 通过花名册示例 2 - 通过考勤组

{
  "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
  "ruleId": "test_0203_03",
  "ruleName": "开放接口测试2",
  "hrm": {
    "include": [
      {
        "hrmRule": [
          {
            "fieldCode": "employeeType",
            "fieldValues": [
              "regular"
            ]
          }
        ]
      }
    ],
    "exclude": [
      {
        "hrmRule": [
          {
            "fieldCode": "employeeStatus",
            "fieldValues": [
              "quitted"
            ]
          }
        ]
      }
    ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

示例

{
	"data": {
		"ruleId": "test_0203_03",
		"ruleName": "开放接口测试2"
	},
	"rid": "4a1c3a7bf0d340549497a17d085865b5",
	"success": true
}

接口说明#

接口信息#

请求参数#

请求示例#

返回参数#

EmpRuleOpenApiCreateResponse#

返回示例#

请求参数

请求示例代码

返回响应

接口说明

接口信息

请求参数

请求示例

返回参数

EmpRuleOpenApiCreateResponse

返回示例