个人医疗签相关回调

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

1. 回调触发时机

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

2. 回调消息类型

OpenUserAutoSign

3. 其他说明

无

4. 回调结构体

MsgData结构体定义

名称	类型	描述
Name	String	签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。 示例值：小明
IdCardType	String	证件类型，支持以下类型 ID_CARD : 居民身份证 (默认值) HONGKONG_AND_MACAO : 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证) 示例值：ID_CARD
IdCardNumber	String	证件号码，应符合以下规则 居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。 港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。 港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。 示例值：610*1X
SceneKey	String	自动签使用的场景值, 可以选择的场景值如下: E_PRESCRIPTION_AUTO_SIGN : 电子处方场景 OTHER : 通用场景 示例值：E_PRESCRIPTION_AUTO_SIGN
IsSuccess	Boolean	是否操作成功: false: 否 true: 是
LicenseFrom	Integer	个人自动签账号许可有效期起始时间
LicenseTo	Integer	个人自动签账号许可有效期截止时间
OrgInfo	CallbackOrgInfo	执行本接口操作的企业信息
UserData	String	调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中，该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称	类型	描述
AppId	String	渠道子客应用ID
ProxyAppId	String	渠道应用ID
OrganizationId	String	渠道子客企业ID
ProxyOrganizationId	String	渠道企业ID
OrganizationOpenId	String	渠道子客企业OpenID
ProxyOrganizationOpenId	String	渠道企业OpenID

5. 示例

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

{
    "MsgId": "12345",
    "MsgType": "OpenUserAutoSign",
    "MSgVersion": "ThirdPartyApp",
    "MsgData": {
        "Name": "典子签",
        "IdCardNumber": "620000199902020000",
        "IdCardType": "ID_CARD",
        "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
        "IsSuccess": true,
        "LicenseFrom": 1684413039,
        "LicenseTo": 1684413040,
        "OrgInfo": {
            "AppId": "yDxbWUyKQDxgXVUuO4333mxCcDjAyF",
            "ProxyAppId": "yDxbWUyKQDxgXVUu4448mxCcDjAyF",
            "OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
            "ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
            "OrganizationOpenId": "org_dianziqian",
            "ProxyOrganizationOpenId": "n123"
        },
        "UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
    }
}

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

1. 回调触发时机

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

2. 回调消息类型

AutoSignSealImg

3. 其他说明

无

4. 回调结构体

MsgData结构体定义

名称	类型	描述
Name	String	签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。 示例值：小明
IdCardType	String	证件类型，支持以下类型 ID_CARD : 居民身份证 (默认值) HONGKONG_AND_MACAO : 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证) 示例值：ID_CARD
IdCardNumber	String	证件号码，应符合以下规则 居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。 港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。 港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。 示例值：610*1X
SceneKey	String	自动签使用的场景值, 可以选择的场景值如下: E_PRESCRIPTION_AUTO_SIGN : 电子处方场景 OTHER : 通用场景 示例值：E_PRESCRIPTION_AUTO_SIGN
ESignFileContent	String	用户自动签使用的签名图片内容，格式为base64编码
OrgInfo	CallbackOrgInfo	执行本接口操作的企业信息。
UserData	String	调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中，该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称	类型	描述
AppId	String	渠道子客应用ID
ProxyAppId	String	渠道应用ID
OrganizationId	String	渠道子客企业ID
ProxyOrganizationId	String	渠道企业ID
OrganizationOpenId	String	渠道子客企业OpenID
ProxyOrganizationOpenId	String	渠道企业OpenID

5. 示例

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

{
    "MsgId": "12345",
    "MsgType": "AutoSignSealImg",
    "MSgVersion": "ThirdPartyApp",
    "MsgData": {
        "Name": "典子签",
        "IdCardNumber": "620000199902020000",
        "IdCardType": "ID_CARD",
        "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
        "IsSuccess": true,
        "ESignFileContent": "****",
        "OrgInfo": {
            "AppId": "yDxbWUyKQDxgXVUuO4333mxCcDjAyF",
            "ProxyAppId": "yDxbWUyKQDxgXVUu4448mxCcDjAyF",
            "OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
            "ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
            "OrganizationOpenId": "org_dianziqian",
            "ProxyOrganizationOpenId": "n123"
        },
        "UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
    }
}

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

1. 回调触发时机

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

2. 回调消息类型

DisableUserAutoSign

3. 其他说明

无

4. 回调结构体

MsgData结构体定义

名称	类型	描述
Name	String	签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。 示例值：小明
IdCardType	String	证件类型，支持以下类型 ID_CARD : 居民身份证 (默认值) HONGKONG_AND_MACAO : 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证) 示例值：ID_CARD
IdCardNumber	String	证件号码，应符合以下规则 居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。 港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。 港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。 示例值：610*1X
SceneKey	String	自动签使用的场景值, 可以选择的场景值如下: E_PRESCRIPTION_AUTO_SIGN : 电子处方场景 OTHER : 通用场景 示例值：E_PRESCRIPTION_AUTO_SIGN
IsSuccess	Boolean	是否操作成功: false: 否 true: 是
OrgInfo	CallbackOrgInfo	执行本接口操作的企业信息。
UserData	String	调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中，该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称	类型	描述
AppId	String	渠道子客应用ID
ProxyAppId	String	渠道应用ID
OrganizationId	String	渠道子客企业ID
ProxyOrganizationId	String	渠道企业ID
OrganizationOpenId	String	渠道子客企业OpenID
ProxyOrganizationOpenId	String	渠道企业OpenID

5. 示例

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

{
    "MsgId": "12345",
    "MsgType": "DisableUserAutoSign",
    "MSgVersion": "ThirdPartyApp",
    "MsgData": {
        "Name": "典子签",
        "IdCardNumber": "620000199902020000",
        "IdCardType": "ID_CARD",
        "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
        "IsSuccess": true,
        "OrgInfo": {
            "AppId": "yDxbWUyKQDxgXVUuO4333mxCcDjAyF",
            "ProxyAppId": "yDxbWUyKQDxgXVUu4448mxCcDjAyF",
            "OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
            "ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
            "OrganizationOpenId": "org_dianziqian",
            "ProxyOrganizationOpenId": "n123"
        },
        "UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
    }
}

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

1. 回调触发时机

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

2. 回调消息类型

CancelUserAutoSign

3. 其他说明

无

4. 回调结构体

MsgData结构体定义

名称	类型	描述
Name	String	签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。 示例值：小明
IdCardType	String	证件类型，支持以下类型 ID_CARD : 居民身份证 (默认值) HONGKONG_AND_MACAO : 港澳居民来往内地通行证 HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证) 示例值：ID_CARD
IdCardNumber	String	证件号码，应符合以下规则 居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。 港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。 港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。 示例值：610*1X
SceneKey	String	自动签使用的场景值, 可以选择的场景值如下: E_PRESCRIPTION_AUTO_SIGN : 电子处方场景 OTHER : 通用场景 示例值：E_PRESCRIPTION_AUTO_SIGN
IsSuccess	Boolean	是否操作成功: false: 否 true: 是
OrgInfo	CallbackOrgInfo	执行本接口操作的企业信息。
UserData	String	调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。 在个人自动签的开通、关闭等回调信息场景中，该字段的信息将原封不动地透传给贵方。

CallbackOrgInfo结构体定义

名称	类型	描述
AppId	String	渠道子客应用ID
ProxyAppId	String	渠道应用ID
OrganizationId	String	渠道子客企业ID
ProxyOrganizationId	String	渠道企业ID
OrganizationOpenId	String	渠道子客企业OpenID
ProxyOrganizationOpenId	String	渠道企业OpenID

5. 示例

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

{
    "MsgId": "12345",
    "MsgType": "CancelUserAutoSign",
    "MSgVersion": "ThirdPartyApp",
    "MsgData": {
        "Name": "典子签",
        "IdCardNumber": "620000199902020000",
        "IdCardType": "ID_CARD",
        "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",
        "IsSuccess": true,
        "OrgInfo": {
            "AppId": "yDxbWUyKQDxgXVUuO4333mxCcDjAyF",
            "ProxyAppId": "yDxbWUyKQDxgXVUu4448mxCcDjAyF",
            "OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
            "ProxyOrganizationId": "yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP",
            "OrganizationOpenId": "org_dianziqian",
            "ProxyOrganizationOpenId": "n123"
        },
        "UserData": "e1wiU2Nlbm3d3LmFiYy5jb21cIn0="
    }
}