API开放平台

TIP

# 流程表单接口

# 新增流程接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/userDefined/v1/processFlow/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "emp_code":"11111",
    "approvers": "",
	"ccs":"22222",
    "flow_id":"7599877067002364152",
    "form_data":{
        "pt":{
            "slfdf_633172":"",
            "slfdf_623593":"2020-05-12",
            "slfdf_119047":"",
            "slfdf_606207":"泰州",
            "slfdf_855810":"",
            "slfdf_820645":"",
            "slfdf_352300":"1",
            "slfdf_194010":"111",
            "slfdf_595402":"",
            "slfdf_191584":"111",
            "slfdf_340307":"",
            "slfdf_191400":"2020-05-13",
            "terminal_type":"3"
        },
        "sts":[
            {
                "id":"8317290435308000015",
                "rows":[
                    {
                        "slfdf_482477":"飞机票",
                        "slfdf_955369":"111",
                        "slfdf_730543":""
                    }
                ]
            }
        ]
    }
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 说明
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":"7599877067002364152",
    "startDate": "2020-05-12",
	"endDate":"2020-05-12",
    "empId":"7599877067002364152",
	"page":"1",
	"rows":"100"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 说明
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":"7599877067002364152"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 说明
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) 备注

← 流程表单数据推送 →