外部流程选人
使用了“外部流程预演”功能后,如果需要提交人选择外部审批人,则需要配置接口内提供审批人的可选范围,否则审批人的可选范围将是该公司在每刻系统的全部人员。当采用外部审批人时,为方便做数据展示,接口返回的数据须符合每刻系统的数据规范。
接口限制
该接口每次最多返回50条数据给客户端,需要您将接口的返回数据数量限制在50条。
请求方式
POST
请求参数
参数说明
参数名 | 类型 | 是否必须 | 参数说明 |
---|---|---|---|
formDataCode | String | 是 | 每刻单据code |
formCode | String | 是 | 如果您在webHook节点处理时返回了formCode则该Code为您的单据code,否则每刻会自动生成一个唯一code |
formType | String | 是 | 每刻单据标示 REIMBURSE表示报销单, PRECONSUME表示申请单 |
content | String | 是 | 查询时输入的文本内容 |
formData | Object | 是 | 单据的具体数据 |
参数示例
{
"formDataCode": "xxxxxxxx",
"formCode": "您的单据code",
"formType": "xxxxxx",
"content": "查询时输入的文本内容",
"formData": {
}
}
数据响应参数说明
字段名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
code | String | 是 | 员工code,会回传的参数,可在您的系统用于人员区分 |
name | String | 是 | 外部审批人的name |
userEmployeeId | String | 是 | 员工工号,会回传的参数,可在您的系统用于人员区分 |
departmentName | String | 否 | 外部审批人所在部门名称 |
description | String | 否 | 描述,用于对同名员工进行区分,可以传部门,或者工号等。只做展示,没有业务含义 |
sourceAvatar | String | 否 | 员工头像,需要能直接get请求获取 |
示例:
{
"code": "0000",
"data": {
"staffs": [
{
"code": "UI00123",
"name": "张三",
"userEmployeeId": "zhangsan001",
"departmentName": "张三部门",
"description": "张三描述信息",
"sourceAvatar": ""
},
{
"code": "UI00123489485",
"name": "李四",
"userEmployeeId": "lisi001",
"departmentName": "李四部门",
"description": "李四描述信息",
"sourceAvatar": ""
}
]
},
"success": true,
"errorMsg": ""
}