跳到主要内容

个人医疗签相关回调

一. 开通医疗自动签回调通知

1. 回调触发时机

当医生或药师完成自动签署的开通操作后会触发此通知。

2. 回调消息类型

OpenUserAutoSign

3. 其他说明

4. 回调结构体

MsgData结构体定义

名称类型描述
NameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
示例值:小明
IdCardTypeString证件类型,支持以下类型
  • ID_CARD : 居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)

示例值:ID_CARD
IdCardNumberString证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给香港居民,“M”字头签发给澳门居民;第2位至第11位为数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:610*1X
SceneKeyString自动签使用的场景值, 可以选择的场景值如下:
  • E_PRESCRIPTION_AUTO_SIGN : 电子处方场景
  • OTHER : 通用场景

示例值:E_PRESCRIPTION_AUTO_SIGN
IsSuccessBoolean是否操作成功:
  • false: 否
  • true: 是
LicenseFromInteger个人自动签账号许可有效期起始时间
LicenseToInteger个人自动签账号许可有效期截止时间
OrgInfoCallbackOrgInfo执行本接口操作的企业信息
UserDataString调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中,该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称类型描述
OrganizationIdString企业ID
ProxyOrganizationIdString集团主企业ID
OrganizationOpenIdString企业OpenID
ProxyOrganizationOpenIdString集团主企业OpenID

5. 示例

示例一: 开通医疗自动签回调通知

{
"MsgId": "12345",
"MsgType": "OpenUserAutoSign",
"MSgVersion": "CustomApp",
"MsgData": {
"Name": "典子签",
"IdCardNumber": "620000199902020000",
"IdCardType": "ID_CARD",
"SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
"IsSuccess": true,
"LicenseFrom": 1684413039,
"LicenseTo": 1684413040,
"OrgInfo": {
"OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
"OrganizationOpenId": "308999999",
"ProxyOrganizationOpenId": "308444444"
},
"UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
}
}

二. 创建自动签署印章签名回调

1. 回调触发时机

当医生或药师完成自动签署的开通后,在腾讯电子签创建个人自动签署签名时触发此回调。

2. 回调消息类型

AutoSignSealImg

3. 其他说明

4. 回调结构体

MsgData结构体定义

名称类型描述
NameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
示例值:小明
IdCardTypeString证件类型,支持以下类型
  • ID_CARD : 居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)

示例值:ID_CARD
IdCardNumberString证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给香港居民,“M”字头签发给澳门居民;第2位至第11位为数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:610*1X
SceneKeyString自动签使用的场景值, 可以选择的场景值如下:
  • E_PRESCRIPTION_AUTO_SIGN : 电子处方场景
  • OTHER : 通用场景

示例值:E_PRESCRIPTION_AUTO_SIGN
ESignFileContentString用户自动签使用的签名图片内容,格式为base64编码
OrgInfoCallbackOrgInfo执行本接口操作的企业信息。
UserDataString调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中,该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称类型描述
OrganizationIdString企业ID
ProxyOrganizationIdString集团主企业ID
OrganizationOpenIdString企业OpenID
ProxyOrganizationOpenIdString集团主企业OpenID

5. 示例

示例一: 创建自动签署印章签名回调

{
"MsgId": "12345",
"MsgType": "AutoSignSealImg",
"MSgVersion": "CustomApp",
"MsgData": {
"Name": "典子签",
"IdCardNumber": "620000199902020000",
"IdCardType": "ID_CARD",
"SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
"IsSuccess": true,
"ESignFileContent": "****",
"OrgInfo": {
"OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
"OrganizationOpenId": "308999999",
"ProxyOrganizationOpenId": "308444444"
},
"UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
}
}

三. 关闭医疗自动签回调通知

1. 回调触发时机

当企业调用关闭个人用户自动签功能接口时触发此回调。

2. 回调消息类型

DisableUserAutoSign

3. 其他说明

4. 回调结构体

MsgData结构体定义

名称类型描述
NameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
示例值:小明
IdCardTypeString证件类型,支持以下类型
  • ID_CARD : 居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)

示例值:ID_CARD
IdCardNumberString证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给香港居民,“M”字头签发给澳门居民;第2位至第11位为数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:610*1X
SceneKeyString自动签使用的场景值, 可以选择的场景值如下:
  • E_PRESCRIPTION_AUTO_SIGN : 电子处方场景
  • OTHER : 通用场景

示例值:E_PRESCRIPTION_AUTO_SIGN
IsSuccessBoolean是否操作成功:
  • false: 否
  • true: 是
OrgInfoCallbackOrgInfo执行本接口操作的企业信息。
UserDataString调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中,该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称类型描述
OrganizationIdString企业ID
ProxyOrganizationIdString集团主企业ID
OrganizationOpenIdString企业OpenID
ProxyOrganizationOpenIdString集团主企业OpenID

5. 示例

示例一: 关闭医疗自动签回调通知

{
"MsgId": "12345",
"MsgType": "DisableUserAutoSign",
"MSgVersion": "CustomApp",
"MsgData": {
"Name": "典子签",
"IdCardNumber": "620000199902020000",
"IdCardType": "ID_CARD",
"SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
"IsSuccess": true,
"OrgInfo": {
"OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
"OrganizationOpenId": "308999999",
"ProxyOrganizationOpenId": "308444444"
},
"UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
}
}

四. 撤销医疗自动签回调通知

1. 回调触发时机

当企业调用撤销个人用户自动签的开通链接接口时触发此回调。

2. 回调消息类型

CancelUserAutoSign

3. 其他说明

4. 回调结构体

MsgData结构体定义

名称类型描述
NameString签署方经办人的姓名。
经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
示例值:小明
IdCardTypeString证件类型,支持以下类型
  • ID_CARD : 居民身份证 (默认值)
  • HONGKONG_AND_MACAO : 港澳居民来往内地通行证
  • HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)

示例值:ID_CARD
IdCardNumberString证件号码,应符合以下规则
  • 居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。
  • 港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给香港居民,“M”字头签发给澳门居民;第2位至第11位为数字。
  • 港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。

示例值:610*1X
SceneKeyString自动签使用的场景值, 可以选择的场景值如下:
  • E_PRESCRIPTION_AUTO_SIGN : 电子处方场景
  • OTHER : 通用场景

示例值:E_PRESCRIPTION_AUTO_SIGN
IsSuccessBoolean是否操作成功:
  • false: 否
  • true: 是
OrgInfoCallbackOrgInfo执行本接口操作的企业信息。
UserDataString调用方自定义的个性化字段(可自定义此字段的值),并以base64方式编码,支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中,该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称类型描述
OrganizationIdString企业ID
ProxyOrganizationIdString集团主企业ID
OrganizationOpenIdString企业OpenID
ProxyOrganizationOpenIdString集团主企业OpenID

5. 示例

示例一: 撤销医疗自动签回调通知

{
"MsgId": "12345",
"MsgType": "CancelUserAutoSign",
"MSgVersion": "CustomApp",
"MsgData": {
"Name": "典子签",
"IdCardNumber": "620000199902020000",
"IdCardType": "ID_CARD",
"SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
"IsSuccess": true,
"OrgInfo": {
"OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
"OrganizationOpenId": "308999999",
"ProxyOrganizationOpenId": "308444444"
},
"UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
}
}
购买咨询
微信客服
4006-808-062
4006-808-062