用户组保存接口

业务场景

可以使用「用户组保存接口」保存或更新用户组，该接口内支持部分更新用户组的信息。

接口说明

1. 接口支持批量导入多个用户组，单次导入最多支持10组数据
2. 某个用户组的失败不会导致整体的失败
3. 用户组子组导入，若员工工号不存在（employeeIds），则该用户组下所有子组同步失败
4. 用户组子组导入，若子组的管理范围内的值部分不存在，不会导致整个子组失败
5. fullReload字段true值慎用，会将原来的子组全部删除，如果在流程中被使用，则可能导致流程不正常运行。如不知哪些子组需要被删除，可以通过查询接口查询后比对再删除。

接口限制

 1. 10次/秒;
 2. 用户组子组一次导入数量不能大于50个，超出可以尝试使用该接口的增量模式分批次导入。

接口地址

用户组编辑接口

/api/openapi/usergroup

请求类型

POST

请求参数

参数说明

用户组子组（subUserGroups）

条件（conditions）

内部档案信息（referenceDatas）

新增内部档案信息（含分摊）（shareReferenceDatas）

外部档案信息（externalReferenceDatas）

外部档案选项信息（details）

默认子组（defaultSubUserGroup)

费用类型合计金额条件（expenseTypeTotalAmountCondition）

参数示例

{
  "userGroups": [
    {
      "name": "部门主管",
      "nameEn": "userGroup EnglishName",
      "bizCode": "业务编码",
      "categoryName": "职级",
      "comment": "这是描述",
      "affiliatedCompanyBizCodes": [
        "00001",
        "00002"
      ],
      "source": "Maycur",
      "subUserGroups": [
        {
          "name": "测试分组",
          "bizCode": "subBizCode",
          "affiliatedCompanyBizCodes": [
            "00001",
            "00002"
          ],
          "employeeIds": [
            "Maycur003"
          ],
          "responsiblePersonIds": [
            "Maycur004"
          ],
          "conditions": [
            {
              "departmentBizCodes": [
                "departmentBizCode"
              ],
              "currentDepartmentBizCodes": [
                "departmentBizCode"
              ],
              "internalUserDepartmentBizCodes": ["internalUserDepartmentBizCodes"],
              "internalUserCurrentDepartmentBizCodes": ["internalUserCurrentDepartmentBizCodes"],
              "referenceDatas": [
                {
                  "bizCode": "referenceDataBizCode",
                  "details": [
                    "detailBizCode1",
                    "detailBizCode2"
                  ]
                }
              ],
              "externalReferenceDatas": [
                {
                  "bizCode": "externalReferenceDatas",
                  "details": [
                    {
                      "bizCode":"bizCode1",
                      "name":"name1"
                    }
                  ]
                }
              ],
              "notExpression": false,
              "expenseTypeTotalAmountCondition": {
                "expenseTypeTotalAmountComparison": ">=",
                "expenseTypeTotalAmountIncludedExpenseTypeBizCodes": [
                  "expenseTypeBizCode1",
                  "expenseTypeBizCode2"
                ],
                "expenseTypeTotalAmount": "100"
              }
            }
          ]
        }
      ],
      "defaultSubUserGroup": {
        "bizCode": "Maycur001",
        "employeeIds": [
          "Maycur003"
        ]
      },
      "fullReload": true
    }
  ]
}

响应参数

参数样例

1. 正常响应参数示例

   {
   "success":true,
   "code": "ACK",
   "message": "保存成功！",
   "data": null
   }
   

2. 错误返回示例

{
  "code": "NACK",
  "message": "保存失败！",
  "data": [
    {
      "userGroupName": "部门主管",
      "userGroupNameEn": "EnglishName",
      "errorMsg": "部门子组编码不能为空"
    }
  ],
  "success": false
}

{
  "code": "NACK",
  "message": "保存失败",
  "data": [
    {
      "userGroupName": "测试2333",
      "userGroupNameEn": null,
      "userGroupBizCode": "ces2333",
      "errorMsg": "子组编码为【Maycur001】的子组条件中具体的业务对象不存在！"
    }
  ],
  "errorCode": null,
  "success": false
}

errorCode 说明

常见报错说明

修改记录

2022-01-19 新增
2023-11-03 添加条件：部门编码（承担部门）（含分摊）（不含下级部门）