跳到主要内容

个人医疗签相关回调

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

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