通过模板发起合同
开始接入
准备工作
1、下载 SDK
2、下载 DEMO
您的第一个合同
1、打开 src/main/java/com/tencent/essbasic/config/Config.java 修改设置 SecretId 、SecretKey、AppId、ProxyOrganizationOpenId、ProxyOperatorOpenId、TemplateId;
2、打开 src/main/java/com/tencent/essbasic/bytemplate/ByTemplate.java 修改 personName、personMobile,设置姓名和手机号为自己的信息;
3、在 idea 下打开文件 src/main/java/com/tencent/essbasic/bytemplate/ByTemplateQuickStart.java,右键执行 run 启动 main 函数:
此时,给自己发起的第一个合同已经成功,控制台输出:
您的控制台入口为: https://beta.ess.tencent.cn/xxxxxxxxxxxxxxxxxxxxxxx
您创建的合同 id 为:
yDRxxxxxxxxxx
签署链接(请在手机浏览器中打开)为:
请访问以下地址下载您的合同: https://file.test.ess.tencent.cn/file/xxx
您可以查收短信或直接到 DEMO 小程序登录进行签署。Demo 小程序码如下:
三步完成正式环境接入
第一步:配置接入信息
打开 src/main/java/com/tencent/essbasic/config/Config.java 根据注释设置 EndPoint、FileServiceEndPoint 为正式环境域名; 修改设置 SecretId 、SecretKey、AppId、ProxyOrganizationOpenId、ProxyOperatorOpenId、TemplateId 为您正式环境下的信息
第二步:通过模板发起合同
打开 src/main/java/com/tencent/essbasic/bytemplate/ByTemplateQuickStart.java,根据您的实际业务需求修改:
- flowName:
合同名称,根据您的实际业务场景来自行定义,名称为不超过 200 个字符的中英文均可;
- flowApproverInfos:
flowApproverInfos 指定了合同的签署方信息、合同签署方的签署控件等内容;
- 快速学习:关于签署方、签署控件相关信息: 签署方、签署控件相关信息
参数配置完成后,即可: 打开文件 src/main/java/com/tencent/essbasic/bytemplate/ByTemplateQuickStart.java,右键执行 run 启动 main 函数,在正式环境键发起合同!
第三步:下载合同文件
第二步调用发起合同得到的 FlowId,会自动传入 DescribeFileUrls 函数用于获取合同链接,在浏览器中访问控制台打印出的链接即可下载合同文件。
至此,恭喜,您已完成腾讯电子签第三方应用集成正式环境的全部接入工作,您可以继续:
- 将接入代码修改为接口并部署在服务端,提供给客户使用
- 继续探索更高级的特性
正式接入
准备工作
1.准备 SecretId 和 SecretKey
2.准备 AppId、ProxyOrganizationOpenId、ProxyOperatorOpenId
3.准备 TemplateId 通过接口查询模板信息列表,得到模版 Id
4.修改配置文件 设置 SecretId 、 SecretKey、AppId、ProxyOrganizationOpenId、ProxyOperatorOpenId、TemplateId 为您正式环境下的信息
服务端正式环境接入
通过模板发起合同
服务端如果要集成模板发起合同功能,需要在接口(客户入参)、本地环境获取发起合同的相关参数,例如: 根据您的实际业务场景,封装通过模板发起合同函数(可以直接参考“第一个合同”中的代码); 例如:
public class main {
public static void main(String[] args) {
...
// 根据您的实际业务构造签署人
FlowApproverInfo[] flowApproverInfos = ByTemplate.BuildApprovers(Arrays.asList(recipients));
...
// 发起合同
...
// 获取:
// FlowId:resp.get("flowId");
// 签署链接:resp.get("url");
// 您的其他业务逻辑
...
}
}
签署回调
签署回调简介:
通过签署回调,您可以在合同状态产生变化接受到来自电子签的通知,通知包含合同、签署人的信息等内容。如您需要开通此功能,需提供一个能接受 HTTP POST 请 求的回调地址,请确保该地址提供的服务可公网访问并正常处理回调通知。