基础介绍
当一个用户需要一次签署多个相关文件(开发者在一个签署流程中添加多个文件),或者文件有多个位置需要一次性签章时,可以参考本场景对接说明。
效果展示
多文件多位置签章演示
单文件内多个签署位置只需要选一次章即可多位置自动添加。多个文件时每个文件都需要进行一次选章。
API接口
API接口(点击直接跳转相关API文档) | API描述 | 是否必需 |
此接口用来发起签署,发起成功后会返回签署流程标识:signFlowId。 | 必需 | |
此接口获取签署方签署页面链接,可用于签署或预览。 | 按需 |
基于文件发起签署接口代码案例
相关参数
- fileId(待签署文件ID)、(签署区所在待签署文件ID),需要两处传参。
- signFieldStyle(签章区样式:1 - 单页签章,2 - 骑缝签章),演示为单页签署。
- signFieldPosition(签章区位置信息),传入具体的页码,X坐标和Y坐标。
发起签署的基础完整传参案例:
{
"docs": [
{
"fileId": "请设置待签署文件001的fileId",
"fileName": "文件名称-001.pdf"
},
{
"fileId": "请设置待签署文件002的fileId",
"fileName": "文件名称-002.pdf"
}
],
"signFlowConfig": {
"signFlowTitle": "请设置当前签署任务的主题:此场景演示多文件,多位置签署"
},
"signers": [
{
"psnSignerInfo": {
"psnAccount": "请设置个人用户的手机号/邮箱",
"psnInfo": {
"psnName": "个人用户的姓名"
}
},
"signerType": 0,
"signFields": [
{
"fileId": "文件001的fileId",
"normalSignFieldConfig": {
"signFieldStyle": 1,
"signFieldPosition": {
"positionPage": "1",
"positionX": 440,
"positionY": 703
}
}
},
{
"fileId": "文件001的fileId",
"normalSignFieldConfig": {
"signFieldStyle": 1,
"signFieldPosition": {
"positionPage": "3",
"positionX": 480,
"positionY": 197
}
}
},
{
"fileId": "文件002的fileId",
"normalSignFieldConfig": {
"signFieldStyle": 1,
"signFieldPosition": {
"positionPage": "1",
"positionX": 441,
"positionY": 138
}
}
}
]
}
]
}