基础介绍

当合同仅需要单方盖章时，例如：证明材料，对账单等单方企业盖章场景，可以参考本流程。其中发起签署前的合同的生成可以参考《生成合同》模块。

效果展示

用户签署操作页面效果：点击查看 SaaS API V3版用户签署页操作手册

签署后效果展示：

API列表

API接口（点击直接跳转相关API文档）	API描述	是否必需
基于文件发起签署	此接口用来发起签署，发起成功后会返回签署流程标识：signFlowId。	必需
获取签署页面链接	此接口获取签署方签署页面链接，可用于签署或预览。	按需
查询签署流程详情	此接口可以根据发起签署接口返回的signFlowId，来查询签署状态、签署配置等信息。	按需
下载已签署文件及附属材料	此接口可在签署流程结束后，下载签署后的PDF文件以及其他查看类附件。	建议

基于文件发起签署接口代码案例

关键参数

autoSign（是否后台自动落章）
signerType（签署方类型，0 - 个人，1 - 机构，2 - 法定代表人）
orgSignerInfo（机构签署方信息）自动签署场景，建议不传此对象，e签宝后台会取默认值
assignedSealId（指定印章ID）

平台自身企业自动盖章案例

平台方/集成方：指自主接入电子签名服务的开发方，e签宝开放平台应用appId所属的主体公司。

autoSign 设置为：true （后台自动签署），e签宝后台会自动获取当前appid所属公司的信息、印章，所以可以不传入签署方信息。
平台属于机构类型，所以 signerType 设置为：1（机构）。
assignedSealId 不传会取默认印章，如需指定其他样式印章可以登录e签宝官网获取【请点击】。

{
    "docs": [
        {
            "fileId": "请设置待签署文件的fileId",
            "fileName": "请设置待签署文件的文件名称.pdf"
        }
    ],
    "signFlowConfig": {
        "signFlowTitle": "请设置当前签署任务的主题：此场景演示平台自身企业自动盖章",
        "autoFinish": true,
        "noticeConfig": {
            "noticeTypes": "1,2"
        },
        "notifyUrl": "请设置异步回调地址，以http/https开头(不需要通知可不设置)"
    },
    "signers": [
        {
            "signerType": 1,
            "signFields": [
                {
                    "customBizNum": "自定义编码001",
                    "fileId": "请设置待签署文件的fileId",
                    "normalSignFieldConfig": {
                        "autoSign": true,
                        "signFieldStyle": 1,
                        "signFieldPosition": {
                            "positionPage": "1",
                            "positionX": 458,
                            "positionY": 466
                        }
                    }
                }
            ]
        }
    ]
}

其他企业自动盖章案例

其他除平台自身外的其他企业（集团子公司、合作企业等）需要自动落章时，需要做印章授权（点击查看印章授权方案），将印章Id授权给开发者自身应用ID，需额外加上授权企业的 assignedSealId（印章ID）参数：

assignedSealId（指定印章ID）设置：被授权的印章ID值。
autoSign 设置为：true （后台自动签署）。
signerType 设置为：1（机构）。

{
    "docs": [
        {
            "fileId": "请设置待签署文件的fileId",
            "fileName": "请设置待签署文件的文件名称.pdf"
        }
    ],
    "signFlowConfig": {
        "signFlowTitle": "请设置当前签署任务的主题：此场景演示其他授权企业自动盖章",
        "autoFinish": true,
        "noticeConfig": {
            "noticeTypes": "1,2"
        },
        "notifyUrl": "请设置异步回调地址，以http/https开头(不需要通知可不设置)"
    },
    "signers": [
        {
            "signerType": 1,
            "signFields": [
                {
                    "customBizNum": "自定义编码001",
                    "fileId": "请设置待签署文件的fileId",
                    "normalSignFieldConfig": {
                        "autoSign": true,
                        "assignedSealId": "需传入被授权的印章ID值",
                        "signFieldStyle": 1,
                        "signFieldPosition": {
                            "positionPage": "1",
                            "positionX": 458,
                            "positionY": 466
                        }
                    }
                }
            ]
        }
    ]
}

企业用户手动盖章案例

当签署方企业需要在e签宝合同签署页面手动盖章时，可以参考此参数案例：

orgSignerInfo 传入企业用户的身份信息。
autoSign 默认：false（非后台自动落章），可不传。
企业用户属于机构类型，所以 signerType 设置为：1 （机构）。

{
    "docs": [
        {
            "fileId": "请设置待签署文件的fileId",
            "fileName": "请设置待签署文件的文件名称.pdf"
        }
    ],
    "signFlowConfig": {
        "signFlowTitle": "请设置当前签署任务的主题：此场景演示企业用户手动盖章",
        "autoFinish": true,
        "noticeConfig": {
            "noticeTypes": "1,2"
        },
        "notifyUrl": "请设置异步回调地址，以http/https开头",
        "redirectConfig": {
            "redirectUrl": "请设置重定向跳转地址，例如：https://www.esign.cn/"
        }
    },
    "signers": [
        {
            "orgSignerInfo": {
                "orgName": "请设置企业用户企业名称",
                "orgInfo": {
                    "orgIDCardNum": "请设置企业用户的统一社会信用代码",
                    "orgIDCardType": "CRED_ORG_USCC"
                },
                "transactorInfo": {
                    "psnAccount": "请设置企业用户经办人的手机号",
                    "psnInfo": {
                        "psnName": "个人用户的姓名"
                    }
                }
            },
            "signerType": 1,
            "signFields": [
                {
                    "customBizNum": "自定义编码001",
                    "fileId": "请设置待签署文件的fileId",
                    "normalSignFieldConfig": {
                        "signFieldStyle": 1,
                        "signFieldPosition": {
                            "positionPage": "3",
                            "positionX": 200,
                            "positionY": 200
                        }
                    }
                }
            ]
        }
    ]
}

常见场景对接说明

单方签署