集成指南

1. 集成说明

1.1 集成流程

集成流程如下图所示。

集成流程.svg

1.1.1 注册eSignGlobal账号

1.1.2 创建应用

登录eSignGlobal,管理员可以通过设置-集成-应用菜单下添加应用,并在应用编辑页面获取密钥,配置回调地址。

1.1.3 定义业务流程

开发者在阅读完本文档之后,梳理现有业务流程,并在业务发生签约节点接入对应接口,即可在现有业务流程上实现电子签名能力。

1.1.4 接口集成

在此步正式开展对接工作。如在对接过程中遇到问题,可以联系eSignGlobal团队协助解决。

1.1.5 业务测试

完成接口功能对接后,按需进行几轮业务流程测试。如在测试过程中遇到问题,可以联系eSignGlobal团队协助解决。

1.1.6 项目上线

开发者完成以下操作即可上线项目:

  • 切换接口访问环境:沙箱环境➡ 正式环境
  • 切换应用信息:沙箱app_id、app_secret ➡ 正式 app_id、app_secret

2. 流程示例

以下展示几个典型应用场景的接口调用流程,具体调用方式以您的业务设计为主。

图中序号内容为标准电子签名业务操作流程,灰色框为eSginGlobal提供的API服务。

2.1 接口调用流程(经典场景)—— 分步发起

分步发起流程.svg

2.2接口调用流程(经典场景)—— 快捷发起

一步发起.svg

3. 小结

电子签名业务流程分为三个阶段:初始化、创建并开启信封、签署。

关键流程节点说明如下:

  1. 提取签署关键信息:通过eSignGlobal发起电子签署时,对接平台最少仅需提供签署人信息、待签署文件等内容即可发起合同签署。这些信息来源一般在前置业务过程中已经采集并保存在业务系统中。
  2. 创建信封:eSignGlobal旨在打造可靠的全球电子签名服务,因此针对待签署文件的签署行为(也称签署任务)均通过信封来表示。对接平台在创建签署流程时,可自定义配置相关功能,如主题、备注等内容。
  3. 生成待签署文件:目前eSignGlobal仅支持PDF格式的待签署文件,需要对接平台前准备好签署文件,并通过“文件上传的相关接口”添加至签署流程中。
  4. 添加签署人:对接平台在此步可以为信封添加签署方,同时可以配置签署人的用户体验,如签署顺序、签署位置、是否需要访问口令等。
  5. 开启信封:即允许签署人开始签署文件,信封开启后不支持新增和修改待签署文件,同时会自动按照预先设置的签署顺序开始流转,并由eSignGlobal发送签署通知。
  6. 结束信封:即当所有签署人完成签署后,对接平台手动关闭信封。(后续eSignGlobal将支持在流程未关闭前,添加签署人。)
  7. 下载签署文件:即下载所有签署人完成签署后的文件,仅在信封结束后可以调用。

1. 集成说明
1.1 集成流程
1.1.1 注册eSignGlobal账号
1.1.2 创建应用
1.1.3 定义业务流程
1.1.4 接口集成
1.1.5 业务测试
1.1.6 项目上线
2. 流程示例
2.1 接口调用流程(经典场景)—— 分步发起
2.2接口调用流程(经典场景)—— 快捷发起
3. 小结