查询合同拟定流程列表

接口描述

支持查询指定时间段内，接口发起的全部合同拟定流程列表信息。
支持指定具体的拟定流程状态，查询对应时间段内的全部流程列表。
支持指定发起方，查询其名下对应时间段内的全部流程列表。
支持指定填写方以及填写方具体的填写状态，查询其名下对应时间段内的全部流程列表。

注意事项：

仅能查询当前应用Id（appId）通过接口发起的合同拟定流程列表。

接口地址&请求方法

接口地址：https://{host}/v3/sign-flow/list

请求方法：POST

请求头格式

具体请求头参数，请查看公共请求头格式。

请求参数

展开全部参数参数名称		参数类型	必选	参数位置	参数说明
pageNum		int	是	body	页码（大于0，最小值为1）
pageSize		int	是	body	每页展示的数量（可选范围[1~100]）
signFlowStartTimeFrom		int64	是	body	开始时间（流程发起时间）毫秒级时间戳格式
signFlowStartTimeTo		int64	是	body	结束时间（流程发起时间）毫秒级时间戳格式【注】开始时间到结束时间的时间范围最长不可超过1年，且只能查询近5年的流程
initiator		object	否	body	发起方
	initiatorOrgId	string	否	body	机构发起方id
	transactorPsnId	string	否	body	机构发起方经办人id
operator		object	否	body	填写操作人（个人填写方本人为操作人，机构填写方经办人为操作人）
	psnId	string	否	body	填写操作人个人id
	psnAccount	string	否	body	填写操作人个人账号
organization		object	否	body	机构填写方
	orgId	string	否	body	机构填写方ID
	orgName	string	否	body	机构填写方名称
draftStatus		list	否	body	拟定流程状态（默认全部） 1 - 拟定中（填写中） 2 - 完成（拟定完成流转到签署过程） 3 - 撤销（撤销合同拟定触发） 4 - 拒填（用户侧在页面拒填后触发） 5 - 过期（填写截至日期到期后触发）
fillStatus		list	否	body	某个填写人的填写状态（默认全部） 1 - 未填写 2 - 填写中 3 - 已填写 4 - 拒填【注】查此状态，必须传入operator（签署操作人信息）

响应参数

展开全部参数参数名称							参数类型	必选	参数说明
code							int32	是	业务码，0表示成功，非0表示异常。
message							string	否	业务信息请根据 code 来判断错误情况，不应该依赖message 匹配，因为message 可能会调整。
data（点击“+”展开详情）							object	否	业务数据
	total						int	否	查询总数
	draftInfos（点击“+”展开详情）						array	否	拟定流程信息列表
	signFlowInitiator（点击“+”展开详情）					object	否	拟定流程发起方
		orgId				string	否	机构发起方ID
		orgName				string	否	机构发起方名称
		transactor				object	否	机构发起经办人信息
		psnId			string	否	个人发起方ID
		psnAccount			object	否	个人发起方账号
		accountMobile		string	否	e签宝服务个人登录手机号
accountEmail		string	否	e签宝服务个人登录邮箱
drafters（点击“+”展开详情）					array	否	填写方信息列表
		draftOrder				int	否	填写顺序顺序值 1-255 ，不同参与人顺序不会重复
	fillStatus				int	否	填写人的填写状态 1 - 未填写 2 - 填写中 3 - 已填写 4 - 拒填
	psnDrafter				object	否	个人填写方信息
		psnId			string	否	个人填写方ID
psnAccount			object	否	个人填写方账号
		accountMobile		string	否	e签宝服务个人登录手机号
	accountEmail		string	否	e签宝服务个人登录邮箱
orgDrafter				object	否	机构填写方
	orgId			string	否	机构ID
	orgName			string	否	机构名称
	transactor			object	否	机构参与方经办人
	psnId		string	否	经办人个人ID
	psnAccount		string	否	经办人手机号/邮箱
	accountMobile	string	否	e签宝服务个人登录手机号
	accountEmail	string	否	e签宝服务个人登录邮箱
signFlowId					string	否	签署流程ID
draftStartTime					int64	否	拟定流程开启时间，时间戳
draftFinishTime					int64	否	拟定流程结束时间，时间戳
draftStatus					list	否	拟定流程状态 1 - 拟定中（填写中） 2 - 完成（拟定完成流转到签署过程） 3 - 撤销（撤销合同拟定触发） 4 - 拒填（用户侧在页面拒填后触发） 5 - 过期（填写截至日期到期后触发）
signFlowTitle					string	否	签署流程标题

请求示例

{
    "pageNum": 1,
    "pageSize": 20,
    "signFlowStartTimeFrom": 1674295319000,
    "signFlowStartTimeTo": 1676973733064,
    "draftStatus": [
        1,
        2
    ]
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "total": 2,
        "draftInfos": [
            {
                "signFlowInitiator": {
                    "orgId": "842ec8ce*****91662f",
                    "orgName": "企业名称",
                    "transactor": null
                },
                "drafters": [
                    {
                        "psnDrafter": {
                            "psnId": "626629f******1d8c1d",
                            "psnAccount": {
                                "accountMobile": "166*****1",
                                "accountEmail": null
                            }
                        },
                        "orgDrafter": null
                    },
                    {
                        "psnDrafter": null,
                        "orgDrafter": {
                            "orgId": "0daec218********eb",
                            "orgName": "企业名称",
                            "transactor": {
                                "psnId": "39c4d6*******634438c8",
                                "psnAccount": {
                                    "accountMobile": "153****50",
                                    "accountEmail": null
                                }
                            }
                        }
                    }
                ],
                "signFlowId": "b3713b6******1db463",
                "draftStartTime": 1676959878000,
                "draftFinishTime": 1676969696000,
                "draftStatus": 2,
                "signFlowTitle": "这是本次签署任务的主题1"
            },
            {
                "signFlowInitiator": {
                    "orgId": "842ec8c******fc91662f",
                    "orgName": "esig*****限公司",
                    "transactor": null
                },
                "drafters": [
                    {
                        "psnDrafter": {
                            "psnId": "626629f483*****299f1d8c1d",
                            "psnAccount": {
                                "accountMobile": "166****61",
                                "accountEmail": null
                            }
                        },
                        "orgDrafter": null
                    }
                ],
                "signFlowId": "ba57046f******671d539dc",
                "draftStartTime": 1676958612000,
                "draftFinishTime": null,
                "draftStatus": 1,
                "signFlowTitle": "这是本次签署任务的主题2"
            }
        ]
    }
}

流程模板签署服务API

查询合同拟定流程列表

接口描述

接口地址&请求方法

请求头格式

请求参数

响应参数

请求示例

响应示例