跳到主要内容

电子处方单

电子处方单​

电子处方单，是指由医生开具的、以电子形式生成、传输、存储和管理的数字化处方。它完全取代了传统的纸质处方，是“互联网+医疗”和医疗数字化转型中的关键环节。 其核心特征是具有与纸质处方同等的法律效力。这背后依靠的是《中华人民共和国电子签名法》所认可的可靠电子签名、可信时间戳等技术，确保处方内容在生成、传输和存储过程中不被篡改，并且身份可确认、时间可追溯。

注意：在接入电子处方单功能前，需先联系对接腾讯电子签的同事开通相应权限。

电子处方单接入流程​

一. 环境准备​

在开始接入前，请先完成自建应用环境的搭建。具体操作请参考：腾讯电子签自建应用集成接入指南

二. 接入步骤​

1. 上传医师的电子印章​

注：如使用电子签系统自动生成的印章，则无需执行“上传医师的电子印章”这个步骤。

为了上传医师的电子印章，您需要按照以下步骤操作：

1.1. 上传文件：首先使用上传文件接口上传医师的电子印章图片，并获取文件ID。

1.2. 创建医师电子印章：随后，调用创建导入处方单个人印章接口，上传指定医师的电子印章。此操作需要提供图片的文件ID、医师的姓名、证件号码以及手机号等基础信息。

调用创建导入处方单个人印章接口的示例

请求

{
    "Operator": {
        "UserId": "yDt4eUUckp9kif98Uue3MJ0R7N6zlp02"
    },
    "UserName": "刘波",//医师的姓名
    "IdCardType": "ID_CARD",
    "IdCardNumber": "370222200002022222",//医师的证件号码
    "Mobile": "18500000000",//医师的手机号
    "FileId": "yDtruUUckp9vga7qUEJmMgNEYmoNnJnc"//用上传文件接口上传的医师印章图片的文件ID
}

返回

{
  "Response": {
    "RequestId": "b7318bd8-a647-44bc-9dcc-7cb449a549a9",
    "SealId": "yDtruUUckp9v2gd2Uyc4pqFRPOzuoVAp" // 生成的医师的电子印章的ID
  }
}

2. 生成医生授权链接​

通过获取个人用户自动签的开通链接接口，生成医师生成专属的授权链接。调用接口接口也需传递医师的姓名、证件号等信息。

调用获取个人用户自动签的开通链接接口的示例

请求

{
   "Operator": {
      "UserId": "yDt4eUUckp9kif98Uue3MJ0R7N6zlp02"
   },
   "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",//处方单固定为E_PRESCRIPTION_AUTO_SIGN
   "AutoSignConfig": {
      "UserInfo": {
         "Name": "刘波",//医师的姓名
         "IdCardType": "ID_CARD",
         "IdCardNumber": "370222200002022222"//医师的证件号码
      }
   }
}

返回

{
   "Response": {
      "Path": "pages/guide/index?path=/pages/extra/auto-sign?confToken=yDtruUUckp9v2d9zUyc4pqFy0npfM1yw",//医师开通授权电子处方单的小程序PATH
      "RequestId": "eab58f41-ba8b-4933-931e-86d0cbb5338c",
      "Url": "https://test.essurl.cn/nkOzUBOh2W",//医师开通授权电子处方单的链接, 短链形式。
   }
}

一旦通过接口获取到签署链接（Url），请将此链接发送给相应的医师。医师可通过该链接直接访问并完成授权流程。

3. 医师完成授权​

将获取个人用户自动签的开通链接生成的授权链接发送给医生，医生打开链接后完成人脸识别、签署授权协议就完成了授权流程。

3.1 医师打开链接，打开链接后需要确认身份信息。​
医师打开链接
3.2 医师签署协议，医师需要阅读并签署授权协议，签署过程需要人脸识别校验。​
医师签署协议
3.3 医师开通授权完成。​
医师开通授权完成

4. 确认授权状态​

可通过获取个人用户自动签的开通状态接口主动查询医师的授权状态。授权成功后，腾讯电子签将通过个人医疗签相关回调将结果推送至企业端。

调用获取个人用户自动签的开通状态接口的示例

请求

{
   "Operator": {
      "UserId": "yDt4eUUckp9kif98Uue3MJ0R7N6zlp02"
   },
   "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",//处方单固定为E_PRESCRIPTION_AUTO_SIGN
   "UserInfo": {
      "Name": "刘波",//医师的姓名
      "IdCardType": "ID_CARD",
      "IdCardNumber": "370222200002022222"//医师的证件号码
   }
}


返回

{
   "Response": {
      "IsOpen": true, //是否已经授权
      "RequestId": "b196217f-2c5b-423c-b1d0-7b19e02028e8"
   }
}

5. 发起电子处方单​

完成授权后，就可以通过用PDF文件创建签署流程接口或者模板发起合同发起处方单的合同。

调用用PDF文件创建签署流程接口的示例。在本示例中，我们包含两个参与方：

  • 医师：已授权可以电子签署处方单，会进行自动签署。
  • 患者：需要手动签署处方合同。

请求


{
    "Approvers": [
        {
            "ApproverIdCardNumber": "370222200002022222",//医师的证件号码
            "ApproverIdCardType": "ID_CARD",
            "ApproverMobile": "18500000000",//医师的手机号
            "ApproverName": "刘波",//医师的姓名
            "ApproverType": 7, //处方单自动签署方（医师）的ApproverType为7
            "SignComponents": [//医师的自动签署的位置
                {
                    "ComponentHeight": 100,
                    "ComponentId": "处方医生",
                    "ComponentPage": 1,
                    "ComponentType": "SIGN_SIGNATURE",
                    "ComponentValue": "",
                    "ComponentWidth": 200,
                    "FileIndex": 0,
                    "ComponentPosX": 0,
                    "ComponentPosY": 0,
                    "GenerateMode": "KEYWORD",
                    "OffsetX": 80
                }
            ]
        },
        {
            "ApproverIdCardNumber": "37000019890303000X",//患者的证件号
            "ApproverIdCardType": "ID_CARD",
            "ApproverMobile": "18888888888",//患者的手机号
            "ApproverName": "张三",//患者的名字
            "ApproverType": 1,//患者手动签署
            "SignComponents": [//患者的签署控件
                {
                    "ComponentHeight": 100,
                    "ComponentId": "患者签名",
                    "ComponentPage": 1,
                    "ComponentType": "SIGN_SIGNATURE",
                    "ComponentValue": "",
                    "ComponentWidth": 200,
                    "FileIndex": 0,
                    "GenerateMode": "KEYWORD",
                    "OffsetX": 80,
                    "ComponentPosX": 0,
                    "ComponentPosY": 0
                }
            ]
        }
    ],
    "AutoSignScene": "E_PRESCRIPTION_AUTO_SIGN",//处方单固定为E_PRESCRIPTION_AUTO_SIGN
    "FileIds": [
        "yDwqpUUckp3yptnhUxknKKxRmjIJ7ZHf" //通过上传文件上传的处方单的文件ID
    ],
    "FlowName": "处方87235号",//处方单的名字
    "Operator": {
        "UserId": "yDt4eUUckp9kif98Uue3MJ0R7N6zlp02"
    }
}


返回


{
    "Response": {
        "FlowId": "yDRsDUUgyg1aczxtUuNAW8Cx4WsAiEB5",//处方单的合同id
        "RequestId": "43b9474a-c909-4d89-aa7b-3632f02fa8a4"
    }
}

6. 下载签署好的处方单​

完成签署后，就可以通过查询文件下载URL接口生成处方单PDF的下载URL。生成的链接是有时间限制的，过期后将无法访问。您可以在调用查询文件下载URL接口的时候指定过期时间。为避免错误，请确保在链接过期之前进行下载操作。 请求的示例如下

请求


{
    "Operator": {
        "UserId": "yDRsDUUgyg1aczxtUuNAW8Cx4WsAiEB5" 
    },
    "BusinessType": "FLOW",//现在处方单的PDF固定为FLOW
    "BusinessIds": [
        "yDt4eUUckp9kif98Uue3MJ0R7N6zlp02"//处方单的合同id
    ]
}

返回

{
    "Response": {
        "FileUrls": [
            {
                "Url": "https://file.test.ess.tencent.cn/file/FLOW/yDt4eUUckp9kif98Uue3MJ0R7N6zlp02/0/0.PDF?hkey=c80b3f1357"//处方单PDF下载的URL
            }
        ],
        "RequestId": "s1692272754129210855",
        "TotalCount": 1
    }
}

三. 其他功能​

1. 更换医师授权的印章的流程​

可通过获取设置自动签印章小程序链接接口生成医师更换授权的印章的链接，医师点击生成的链接进入等印章更换的流程。

调用获取设置自动签印章小程序链接接口的示例

请求


{
  "Operator": {
    "UserId": "yDRsDUUgyg1aczxtUuNAW8Cx4WsAiEB5"
  },
  "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",//处方单固定为E_PRESCRIPTION_AUTO_SIGN
  "UserInfo": {
    "Name": "刘波",//医师的姓名
    "IdCardType": "ID_CARD",
    "IdCardNumber": "370222200002022222"//医师的证件号码
  }
}

返回

{
  "Response": {
    "Path": "pages/guide/index?path=/pages/extra/auto-sign?confToken=yDtr1UUckp9vvjuaUuikdA1SvyTEiAqV", //医师更换授权印章的小程序PATH。
    "RequestId": "43b9474a-c909-4d89-aa7b-3632f02fa8a4",
    "Url": "https://essurl.cn/sdaLUBOiOt"  //医师更换授权印章的链接, 短链形式。
  }
}

医师打开链接后进入下面的印章选择界面

印章选择界面

选择完成后进入到成功更换的界面

印章选择界面

2.关闭处方单授权​

如果某个医师已经授权给我们处方单权限，我们也可通过关闭个人用户自动签功能接口关闭此医师的处方单授权，关闭以后就无法给此医师发送处方单。

调用关闭个人用户自动签功能接口的示例

请求


{
  "Operator": {
    "UserId": "yDRsDUUgyg1aczxtUuNAW8Cx4WsAiEB5"
  },
  "SceneKey": "E_PRESCRIPTION_AUTO_SIGN",//处方单固定为E_PRESCRIPTION_AUTO_SIGN
  "UserInfo": {
    "Name": "刘波",//医师的姓名
    "IdCardType": "ID_CARD",
    "IdCardNumber": "370222200002022222"//医师的证件号码
  }
}

返回

{
  "Response": {
    "RequestId": "f05c926d-8768-4548-9316-9c86eabe5bd5"
  }
}

3.获取医师证书图片​

可以通过获取个人用户认证证书图片获取医师的个人用户认证证书图片,接口返回证书的序号、证书的有效时间和一个5分钟有效的证书图片的URL，请在有效期限内下载证书图片。证书的图片样式如下图：

医师证书图片

调用获取个人用户认证证书图片接口的示例

请求


{
  "Operator": {
    "UserId": "yDRsDUUgyg1aczxtUuNAW8Cx4WsAiEB5"
  },
  "UserName": "刘波",//医师的姓名
  "IdCardType": "ID_CARD",
  "IdCardNumber": "370222200002022222"//医师的证件号码
  
}

返回

{
  "Response": {
    "AuthCertUrl": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=522d****6cb5",//  医师证书图片下载URL，有效期为5分钟，超过有效期后将无法再下载。
    "RequestId": "69c19f7e7240",
    "SerialNumber": "230904118773**19694",//医师证书的编号
    "ValidFrom": 1692788219,
    "ValidTo": 1724324219
  }
}

购买咨询
联系销售
预约咨询
购买热线
售后服务
技术顾问