# 流程表单接口
# 新增流程接口
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/userDefined/v1/processFlow/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| flow_id | VARCHAR(32) | 是 | 流程id |
| emp_code | VARCHAR(100) | 是 | 勤策（原外勤365）系统中申请人代码 |
| approvers | VARCHAR(100) | 否 | 下一步骤处理人（下个节点的处理人为前一步骤处理时指定时需要必填） |
| ccs | VARCHAR(200) | 否 | 抄送人编码，多选，多位以","分隔 |
| form_data.pt | 是 | 该流程主记录 | |
| form_data.sts | 是 | 该流程明细（子表）记录 | |
| form_data.pt.slfdf_* | 否 | 主记录数据（字段编码详见页面接口数据） | |
| form_data.sts.id | CHAR(32) | 是 | 明细数据的表格id |
| form_data.sts.rows.slfdf_* | 否 | 明细数据（字段编码详见页面接口数据） |
响应示例：
{
"msg_id": "X000001",
"response_data": {
"formId":"7376519253924031447",
"approve_logs":[
{
"approver":"zy(职务1) 录入",
"node_name":"开始",
"exe_type":"1",
"comment":null
}
],
"dataId":"5937166066373570213",
"flowId":"8621940552826810569",
"status":"未审批"
},
"return_code": 0,
"return_msg": ""
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
| response_data | String | 参照查询流程接口的返回结果 |
# 查询流程接口
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/userDefined/v1/getFlowConfig/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| flowId | VARCHAR(32) | 否 | 流程id |
| startDate | CHAR(10) | 否 | 上报日期起 |
| endDate | CHAR(10) | 否 | 上报日期止 |
| empId | VARCHAR(32) | 否 | 申请人id |
| page | VARCHAR(10) | 否 | 页数 |
| rows | VARCHAR(10) | 否 | 每页条数 |
响应示例：
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"formId":"8380014622632604678",
"serialNo":"20200915000004",
"dataId":"6541954866021161128",
"flowId":"6933547335575721944",
"status":"未审批",
"recently_handle_time":"2020-09-22 09:40",
"recently_handler_name":"测试账号(初始化-3)",
"recently_handler_code":"ceshi",
"approve_logs":[
{
"approver":"测试账号(初始化-3) 录入",
"node_name":"开始",
"exe_type":"1",
"time":"2020-09-22 09:40:30",
"comment":""
}
]
}
]
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| flowId | VARCHAR(32) | 流程流水号 |
| serialNo | VARCHAR(32) | 流水号 |
| status | VARCHAR(32) | 流程当前状态 |
| formId | VARCHAR(32) | 相应流程的表单模板ID |
| dataId | CHAR(10) | 相应流程的表单数据ID |
| recently_handle_time | VARCHAR(32) | 最近处理时间 |
| recently_handler_name | VARCHAR(32) | 最近处理人姓名 |
| recently_handler_code | VARCHAR(32) | 最近处理人账号 |
| approve_logs.approver | VARCHAR(100) | 账号+操作 |
| approve_logs.node_name | VARCHAR(32) | 节点名称 |
| approve_logs.exe_type | CHAR(1) | 操作类型。1：录入，2：批准，3：拒绝 |
| approve_logs.time | VARCHAR(32) | 操作时间。格式：yyyy-MM-dd HH:mm:ss |
| approve_logs.comment | VARCHAR(500) | 评价 |
# 查询流程模板配置
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/userDefined/v1/getFlowSetConfig/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| flowSetId | VARCHAR(32) | 是 | 流程模板id |
响应示例：
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"formId":8380014622632604678,
"flowName":"小周",
"groupId":8380014622632604678,
"groupName":"分组名",
"sequence":0,
"userdRoleName":"",
"manageDeptName":"",
"syncToSwap":"0",
"repeatApproval":"0",
"remarks":""
}
]
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| formId | VARCHAR(32) | 相应流程的表单的ID |
| flowName | VARCHAR(200) | 流程名称 |
| groupId | VARCHAR(32) | 分组id |
| groupName | VARCHAR(200) | 分组名 |
| sequence | VARCHAR(32) | 排序号 |
| userdRoleName | VARCHAR(200) | 适用范围 |
| manageDeptName | VARCHAR(200) | 管理范围 |
| syncToSwap | VARCHAR(32) | 是否启用同步接口 |
| repeatApproval | VARCHAR(32) | 重复策略是否勾选 |
| remarks | VARCHAR(200) | 备注 |