基础介绍
接口发起签署时可通过availableSealIds、assignedSealId、orgSealBizTypes三个字段来指定印章(字段见下文),本文将具体介绍三个字段的效果及区别。
指定印章适用于以下场景:
- 发起方自身业务需要去限制签署方盖章时使用的印章类型/印章ID ,可以使用availableSealIds或assignedSealId或orgSealBizTypes字段来实现,其中availableSealIds和orgSealBizTypes仅支持企业签署方,不支持个人签署方。
- 希望简化签署方的操作步骤,进入签署页面后,印章自动在签署页面指定位置中展示,不需要额外进行手动拖拽或选择印章。可以使用assignedSealId字段来实现。
API接口
API接口(点击直接跳转相关API文档) | API描述 | 是否必需 |
此接口用来发起签署,发起成功后会返回签署流程标识:signFlowId。 | 必需 | |
此接口获取签署方签署页面链接,可用于签署或预览。 | 按需 |
基于文件发起签署接口相关参数
- assignedSealId 指定印章ID(印章ID是e签宝SaaS官网的印章编号)
- availableSealIds 手动签章时页面可选的印章列表
- orgSealBizTypes 页面可选机构印章类型,默认全部展示

(1)assignedSealId
用于直接将印章落到签署区,无需手动再选择印章。支持个人和企业签署方类型。
效果展示
未指定字段,默认展示个人所有印章:

指定assignedSealId后,进入签署页面,印章自动会落到个人签署区中,无需人工手动拖拽。

未指定字段,默认展示企业所有印章:

指定assignedSealId后,进入签署页面,印章自动会落到企业签署区中,无需经办人手动拖拽:

基于文件发起签署接口代码案例
"signFields": [
{
"fileId": "1b6ddce257884d469685db8053xxxxxxx",
"normalSignFieldConfig": {
"assignedSealId": "7524ab90-400c-4cd2-99cd-xxxxxxx",
"signFieldPosition": {
"positionPage": "1",
"positionX": 470,
"positionY": 200
},
"signFieldStyle": 1
}
}
](2)availableSealIds
用于指定签署页面中,经办人可选的企业印章列表。仅支持企业签署方,不支持个人签署方。
效果展示
未指定字段,默认展示企业下所有的印章:

指定availableSealIds后,仅展示指定的印章id列表:
(如果希望仅展示一个,availableSealIds中仅传入一个印章id即可)

注意:该字段不支持个人签署类型使用。否则报错:{"code":1435002,"message":"参数错误: 不支持指定印章列表的任务类型","data":null}
基于文件发起签署接口代码案例
"signFields": [
{
"fileId": "1b6ddce257884d469685db8053xxxxxxx",
"normalSignFieldConfig": {
"availableSealIds": [
"eab918fb-0931-447e-ba0f-xxxxx",
"60026652-ce5b-4c06-b946-xxxxxx"
],
"signFieldPosition": {
"positionPage": "1",
"positionX": 470,
"positionY": 200
},
"signFieldStyle": 1
}
}
](3)orgSealBizTypes
用于指定签署页面中,经办人可选的企业印章类型。仅支持企业签署方,不支持个人签署方。
效果展示
未指定字段,默认展示企业下所有的印章:

指定orgSealBizTypes后,仅展示指定的印章类型(下图指定的是只要合同专用章):

注意:指定印章类型的方式可能存在部分企业下没有指定的印章类型,导致无可用印章。
基于文件发起签署接口代码案例
"signFields": [
{
"fileId": "1b6ddce257884d469685db8053xxxxxxx",
"normalSignFieldConfig": {
"orgSealBizTypes": "CONTRACT",
"signFieldPosition": {
"positionPage": "1",
"positionX": 470,
"positionY": 200
},
"signFieldStyle": 1
}
}
]