发起方拖拽设置签署区位置

更新时间:2025-12-19 10:55:12

基础介绍

当开发者平台不确定签署的具体页码和位置坐标信息时,并想要通过e签宝的可视化页面选取盖章区域时,可参考本篇文档。

效果展示

一、通过拖章页面获取位置后再发起签署

适用场景:由业务方提前选取合同盖章位置,再由开发者获取位置坐标后传入接口直接发起签署。

1、通过《获取拖章定位页面》接口,获取可视化界面,然后嵌入在自己平台或者其他前端页面,然后由发起方在页面上面手动设置/拖拽签署区。

2、开发者需要接收e签宝发送的异步回调通知《获取签章位置信息通知》获取发起方设置的签署区坐标值和页码,再传到发起签署接口《基于文件发起签署》

注:开发者需要在e签宝开放平台提前给appid勾选“获取签章位置信息”事件(配置方式见《获取签章位置信息通知》)。

《获取拖章定位页面》页面效果参考:

《基于文件发起签署》接口指定坐标位置部分代码参考:

"signFields": [
    {
        "fileId": "1b6ddce257884d469685db8053xxxxxxx",
        "normalSignFieldConfig": {
            "signFieldPosition": {
                "positionPage": "1",
                "positionX": 470,
                "positionY": 200
            },
            "signFieldStyle": 1
        }
    }
]


二、通过页面发起签署

适用场景:开发者通过接口获取e签宝的发起签署页面,发起方可以在页面里上传文件,添加签署方、拖拽签署位置等,设置后直接在页面发起签署。

1、使用《通过页面发起签署》接口获取发起合同页面链接,把链接嵌入到平台或者其他前端界面,可由需要发起合同的操作人员在界面上传文件底稿、设置签署方信息。

2、页面发起签署成功后,开发者需要接收e签宝发送的异步回调通知《签署发起成功通知》获取签署流程signFlowId。

注:若平台方要固定签署文件或者某些签署方信息,需要在【通过页面发起签署】接口传docs和signers对应的参数信息。

《通过页面发起签署》接口代码参考:

{
    "initiatePageConfig": {
        "customBizNum": "这是一串开发者自定义的业务编号",
        "redirectUrl": "https://xxx.cn",
        "uneditableFields": [
            "signFlowTitle",
            "signFlowExpireTime",
            "copiers",
            "attachments"
        ]
    },
    "signFlowConfig": {
        "signFlowTitle": "这是本次签署任务的主题",
        "autoFinish": true,
        "noticeConfig": {
            "noticeTypes": "1"
        },
        "redirectConfig": {
            "redirectUrl": "https://xxx.cn/"
        },
        "notifyUrl": "http://xx.xx.xx.xx:8081/notify"
    },
    "docs": [
        {
            "fileName": "如果要传签署文件可在这指定.pdf",
            "fileId": "349def13c0c84684a***b0aaf88adbc1"
        }
    ]
}

我要纠错