常规授权批量创建/更新

说明

创建或全量更新企业的常规授权。企业须开通 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
    }
  }
]

响应参数

参数样例

  1. 正常响应参数示例
{
  "code": "ACK",
  "message": "",
  "data": null,
  "errorCode": null,
  "success": true
}
  1. 错误返回示例

当有数据发生错误时,code 返回 NACKdata.errorData 仅包含失败条目;key 为该条 businessCodeerrorIndex 为其在请求数组中的下标(从 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 未归类的服务端错误
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-08-12 08:15:59

results matching ""

    No results matching ""

    results matching ""

      No results matching ""