常规授权批量创建/更新
说明
创建或全量更新企业的常规授权。企业须开通 AUTHORIZED_REIMBURSEMENT 功能,单次最多处理 50 条。以 businessCode
为幂等键:同一企业的有效授权中不存在时创建,存在时按本次请求全量覆盖更新。
批次内逐条处理;单条失败只回滚该条,不影响后续条目。数组参数会先过滤 null、空字符串和纯空白字符串后再校验。
接口限制
1. 单次最多处理 50 条数据;
2. 单条失败模式。批次内各条数据互不影响,某条失败不影响其他条目继续执行。
接口地址
/api/openapi/user-delegation/batch/save
请求类型
POST
请求参数
参数说明
请求体为数组。更新时,被授权人、单据类型、部门及金额范围均以本次请求为准。
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| businessCode |
String |
是 |
外部授权编码;同一企业有效授权中唯一,也是创建/更新幂等键 |
| delegatorEmployeeId |
String |
是 |
授权人的企业内员工工号 employeeId;员工须在职,旗舰版还须具备期间许可 |
| delegateeEmployeeIds |
List<String> |
是 |
被授权人的企业内员工工号列表;均须在职,且不能包含授权人 |
| startDate |
String |
是 |
开始日期,格式为 yyyy-MM-dd |
| endDate |
String |
是 |
结束日期,格式为 yyyy-MM-dd,不得早于开始日期 |
| reimburseDelegation |
Object |
否 |
提交单据授权配置;不传或 checked=false 表示关闭 |
| approvalDelegation |
Object |
否 |
审批授权配置;不传或 checked=false 表示关闭 |
| payOrderDelegation |
Object |
否 |
支付处理授权配置;不传或 checked=false 表示关闭 |
| signDelegation |
Object |
否 |
签收授权配置;不传或 checked=false 表示关闭 |
reimburseDelegation 参数说明:
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| checked |
boolean |
是 |
是否开启提交单据授权 |
| formSubTypeBizCodes |
List<String> |
否 |
可提交单据类型的业务编码 formSubTypeBizCode;空数组表示不限制 |
| notifyMe |
boolean |
否 |
被授权人提交时是否通知授权人 |
| timeLimitSwitch |
boolean |
否 |
是否按授权起止日期限制可查看单据范围 |
approvalDelegation 参数说明:
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| checked |
boolean |
是 |
是否开启审批授权 |
| allowApproveSelfSubmitFrom |
boolean |
否 |
是否允许审批被授权人自己提交的单据 |
| formSubTypeBizCodes |
List<String> |
否 |
可审批单据类型的业务编码 formSubTypeBizCode;空数组表示不限制 |
| departmentBizCodes |
List<String> |
否 |
部门业务编码 businessCode;空数组表示不限制 |
| includeChildDept |
boolean |
否 |
部门范围是否包含下级部门 |
| lowerLimit |
Decimal |
否 |
人民币金额下限 |
| capLimit |
Decimal |
否 |
人民币金额上限,不得小于下限 |
payOrderDelegation 参数说明:
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| checked |
boolean |
否 |
是否开启支付处理授权 |
signDelegation 参数说明:
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| checked |
boolean |
否 |
是否开启签收授权 |
参数样例
[
{
"businessCode": "AUTH-2026-001",
"delegatorEmployeeId": "E001",
"delegateeEmployeeIds": [
"E002",
"E003"
],
"startDate": "2026-08-01",
"endDate": "2026-12-31",
"reimburseDelegation": {
"checked": true,
"formSubTypeBizCodes": [
"REIMBURSE",
"TRAVEL"
],
"notifyMe": false,
"timeLimitSwitch": true
},
"approvalDelegation": {
"checked": true,
"allowApproveSelfSubmitFrom": false,
"formSubTypeBizCodes": [
"REIMBURSE"
],
"departmentBizCodes": [
"DEPT-BIZ-001"
],
"includeChildDept": true,
"lowerLimit": 100,
"capLimit": 50000
},
"payOrderDelegation": {
"checked": true
},
"signDelegation": {
"checked": false
}
}
]
响应参数
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "",
"data": null,
"errorCode": null,
"success": true
}
- 错误返回示例
当有数据发生错误时,code 返回 NACK,data.errorData 仅包含失败条目;key 为该条 businessCode,errorIndex
为其在请求数组中的下标(从 0 开始)。成功条目已保存,不会回滚。
{
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"key": "AUTH-2026-002",
"errorCode": "DELEGATOR_EQUALS_DELEGATEE",
"errorMessage": "授权人与被授权人不能相同",
"errorIndex": 0
}
]
},
"errorCode": null,
"success": false
}
errorData 中的 errorCode 说明
| 错误码 |
说明 |
BUSINESS_CODE_REQUIRED |
授权编码不能为空 |
BUSINESS_CODE_DUPLICATE |
批次内授权编码不能重复 |
BUSINESS_CODE_OCCUPIED |
授权编码已被离职授权占用 |
DELEGATOR_REQUIRED |
授权人不能为空 |
DELEGATEE_REQUIRED |
被授权人不能为空 |
DELEGATOR_INVALID |
授权人不存在或非在职员工 |
DELEGATOR_NO_LICENSE |
授权人无旗舰版期间许可 |
DELEGATEE_INVALID |
被授权人不存在或非在职员工 |
DELEGATOR_EQUALS_DELEGATEE |
授权人与被授权人不能相同 |
DATE_RANGE_INVALID |
授权日期为空或格式错误或结束日期早于开始日期 |
AUTH_TYPE_REQUIRED |
至少需要开启一类授权 |
FORM_TYPE_INVALID |
单据类型业务编码不存在 |
DEPARTMENT_INVALID |
部门业务编码不存在或已停用 |
AMOUNT_RANGE_INVALID |
金额范围不合法 |
AUTHORIZED_REIMBURSEMENT_NOT_ENABLED |
企业未开通常规授权管理功能 |
999997 |
批量请求为空或参数无效 |
999998 |
单次请求超过 50 条 |
999999 |
未归类的服务端错误 |