指定印章场景说明

更新时间:2025-12-18 18:26:05

基础介绍

接口发起签署时可通过availableSealIds、assignedSealId、orgSealBizTypes三个字段来指定印章(字段见下文),本文将具体介绍三个字段的效果及区别。

指定印章适用于以下场景:

  1. 发起方自身业务需要去限制签署方盖章时使用的印章类型/印章ID ,可以使用availableSealIds或assignedSealId或orgSealBizTypes字段来实现,其中availableSealIds和orgSealBizTypes仅支持企业签署方,不支持个人签署方。
  2. 希望简化签署方的操作步骤,进入签署页面后,印章自动在签署页面指定位置中展示,不需要额外进行手动拖拽或选择印章。可以使用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
        }
    }
]
我要纠错