一、最佳实践概述
适用场景
适用于在医院内部系统中集成电子签章。本实践可指引企业开发者快速接入电子签名产品,实现医生,护士签署电子处方、电子病例等文件。此方案签署前需要医生实名认证和身份授权,在安全性方面得到有更好的保证。
适用系统
医院信息系统(his系统)、电子病历系统(emr系统)、医学影像系统(pacs系统)、实验室信息管理系统(lis系统)等
适用产品
二、开发前准备步骤
开发者在对接时,需注意:
- 代开发能力:开发者对应的企业在e签宝官网进行实名注册,并成为e签宝的“生态伙伴”后,即具备代其他企业客户开发的能力,开发者可以基于其他企业客户的业务场景进行对接开发,请点击参考对接。
- 自研开发能力:开发者对应的企业在e签宝官网进行实名注册后,即具备自研开发能力,开发者可以基于自己企业的业务场景进行对接开发。

沙箱环境使用说明
1、开通沙箱环境
使用e签宝企业账号登录e签宝开放平台(https://open.esign.cn),进入【控制台】-【沙箱服务】后即可开通沙箱环境,获取沙箱环境开发调试权限。
2、创建沙箱应用
开发者登录e签宝开放平台,进入【沙箱服务】创建沙箱应用(应用选择标准版),用于开发调试。
3、配置沙箱应用IP白名单
开发者登录e签宝开放平台,进入【沙箱服务】找到对应沙箱应用配置IP白名单。沙箱应用配置IP白名单后即可进行API接口集成和调试。
转正式环境使用说明
4、创建正式应用(正式环境上线前准备)
API接口集成调试完毕,开发者登录e签宝开放平台,进入【正式服务】创建正式应用(应用选择标准版),用于线上生产使用。
5、配置正式应用IP白名单(正式环境上线前准备)
开发者登录e签宝开放平台,进入【正式服务】找到对应正式应用配置IP白名单。正式应用配置IP白名单后即可在线上生产使用。
6、激活套餐正式上线(正式环境上线前准备)
在计划上线日的前2天开发者应联系e签宝工作人员进行报备,以便e签宝安排人员协助上线操作配置套餐。
三、医护签署流程说明
1、身份认证
1)钉钉扫码
医生需要登录相关系统时,在相关系统登录界面显示登录二维码。打开钉钉手机APP扫描二维码。
2)刷脸确认身份
在钉钉上进行刷脸确认身份。
3)登录成功
刷脸完成后确认是医生本人,即可实现系统登录。

2、医护签名
1)文书系统图片印章签名
医生在完成个人实名后,我们就能够为医生生成默认图片印章。医院的系统可调用我们的接口将医生的图片印章取走“放”在医院的系统内展示。这里提供的只是印章图片,还不是真正的电子签名。这个签名只供院内系统展示使用。
2)电子签名
医生处方写完后,点击提交。医疗系统即可调用e签宝的服务对处方内容进行电子签名。这个操作对医生来说可以是无感的。这就确保了医生的体验足够好。


四、e签宝钉签医疗版接口接入概述
接口时序图

接口列表
列表所示是流程必须调用接口API,其他接口参考对接文档。API接口文档链接:【请点击】
接口名 | API接口 | 请求方式 |
获取扫码登录并授权Url地址 | /v1/accounts/loginAuth/info | POST |
查询扫码登录结果 | /v1/signAuth/queryLoginResult | GET |
查询扫码授权结果 | /v1/accounts/{accountId}/signAuth/queryAuthResult | GET |
数据签署 | /v1/accounts/{accountId}/signAuth/textHashSign | POST |
数据验签 | /v1/signAuth/verify | POST |
查询个人印章 | /v1/accounts/{accountId}/seals | GET |
五、注意事项
此方案对接需提前获取钉钉企业corpId并在钉钉中安装e签宝微应用。具体流程参考:【请点击】