DB4403/T 335-2023 基于二维码的电子处方流转接口规范

ICS11.020

CCSC07

DB4403

深圳市地方标准

DB4403/T335—2023

基于二维码的电子处方流转接口规范

Interfacespecificationofelectronicprescriptioncirculationbasedon

QRcode

2023-06-07发布2023-07-01实施

深圳市市场监督管理局发布

DB4403/T335—2023

目次

前言.................................................................................II

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4缩略语.............................................................................1

5业务结构...........................................................................1

6电子处方查询业务接口数据格式及调用方法.............................................2

6.1概述...........................................................................2

6.2电子处方二维码生成URL格式.....................................................2

6.3电子处方URL生成二维码示例.....................................................3

6.4电子处方查询报文结构...........................................................3

6.5电子处方查询报文数据属性.......................................................4

7电子处方状态更新业务接口数据格式及调用方法.........................................7

7.1概述...........................................................................7

7.2电子处方状态更新报文结构.......................................................7

7.3电子处方状态更新报文数据属性...................................................8

8接口提供要求.......................................................................9

9接口使用要求.......................................................................9

9.1安全授权码申请.................................................................9

9.2接口使用.......................................................................9

10接口安全要求......................................................................9

附录A（资料性）电子处方生成二维码示例..............................................10

附录B（资料性）接口使用申请信息表模板..............................................11

附录C（资料性）接口参数填写示例....................................................12

参考文献.............................................................................15

I

DB4403/T335—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

本文件由深圳市卫生健康委员会提出并归口。

本文件起草单位：深圳市第二人民医院、深圳市龙华区卫生健康局。

本文件主要起草人：熊文举、杨雷、樊铭一、熊淑华、陈广、李澎灏、方智野、朱伟民、于德伟、

王克俊、魏沛群、黄舜霞。

II

DB4403/T335—2023

基于二维码的电子处方流转接口规范

1范围

本文件规定了基于二维码的电子处方流转的电子处方查询业务接口数据格式及调用方法、电子处方

状态更新业务和接口要求。

本文件适用于基于二维码的电子处方流转接口的数据交换。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T22239—2019信息安全技术网络安全等级保护基本要求

GB/T35273—2020信息安全技术个人信息安全规范

3术语和定义

下列术语和定义适用于本文件。

3.1

电子处方提供方electronicprescriptionprovider

开出任意电子处方的医疗机构。

注：包括医院、社区健康服务中心等。

3.2

电子处方调用方electronicprescriptioncaller

需要识别电子处方的机构。

注：包括药店、第三方药品配送机构以及相关移动APP、小程序等。

4缩略语

下列缩略语适用于本文件。

EMPI：病人主索引档案号（EnterpriseMasterPatientIndex）

JSON：JavaScript对象简谱（JavaScriptObjectNotation）

URL：统一资源定位器（UniformResourceLocator）

5业务结构

5.1电子处方生成、数据流转、数据获取是一套完整的接口方案，电子处方接口业务结构见图1。

1

DB4403/T335—2023

5.2第6章定义了电子处方查询接口的数据格式和类型结构。

5.3第7章定义了电子处方状态更新接口的数据格式和类型结构。

5.4第8章、第9章、第10章定义了电子处方提供方系统与电子处方调用方系统之间接口的调用要求、

调用方式和安全规范要求。

图1电子处方接口业务结构

6电子处方查询业务接口数据格式及调用方法

6.1概述

接口规范定义二维码生成标准，电子处方提供方的医生开出电子处方后应形成符合本文件的二维码，

包括开放的共享服务地址及电子处方等信息。电子处方调用方扫描患者提供的电子处方二维码查询电子

处方数据，进行消息传递。

6.2电子处方二维码生成URL格式

6.2.1电子处方二维码URL由接口地址、患者标识号、处方号和安全授权码四部分组成，电子处方二

维码生成格式见图2。

2

DB4403/T335—2023

图2电子处方二维码生成格式

6.2.2二维码生成数据说明如下：

a)接口地址：标识电子处方提供方提供的电子处方查询接口服务地址；

b)患者识别号：标识该电子处方所属患者的门诊号或者EMPI；

c)处方号：标识该电子处方于所属医疗机构的唯一编码；

d)安全授权码：标识该电子处方查询时的安全授权码，由电子处方提供方提供，由电子处方调

用方填写，安全授权码默认为0，电子处方提供方如果需要对电子处方进行授权访问，电子处

方提供方给各电子处方调用方提供安全授权码，电子处方调用方调用电子处方时应填写正确

的安全授权码；

e)患者识别号、处方号、安全授权码均填写正确，电子处方提供方才返回有效的电子处方数据。

6.3电子处方URL生成二维码示例

电子处方URL生成二维码示例见附录A。

6.4电子处方查询报文结构

6.4.1电子处方查询请求报文结构见图3。

图3电子处方查询请求报文结构

3

DB4403/T335—2023

6.4.2电子处方查询响应报文结构见图4。

图4电子处方查询响应报文结构

6.5电子处方查询报文数据属性

6.5.1电子处方查询向指定的资源提交数据处理（以下简称POST）请求，以JSON格式返回数据，请

求报文内容包括患者识别号、处方号码、安全授权码；响应报文内容包括结果信息、医疗机构信息、患

者信息、医生信息、药师信息、诊断信息和处方明细。

6.5.2电子处方查询请求数据信息见表1。

表1电子处方查询请求数据信息

参数代码参数名称参数类型是否必填说明

patn_no患者识别号字符型是患者身份的唯一号，如门诊号或EMPI等

rp_no处方号码字符型是电子处方提供方处方流转的唯一号

key安全授权码字符型是核实调用方授权信息

6.5.3电子处方查询返回数据信息见表2。

4

DB4403/T335—2023

表2电子处方查询返回数据信息

参数代码参数名称参数类型是否必填说明

result结果标识字符型是成功：true失败：false

errMsg错误信息字符型—失败时标识具体错误信息

rp_no处方号码字符型是电子处方提供方处方流转的唯一号

org_code医疗机构编码字符型是—

org_name医疗机构名称字符型是—

mdtrt_id就诊ID字符型是患者该次就诊的唯一号

日期时间

mdtrt_time就诊时间是格式：yyyy-mm-ddhh24:mi:ss

型

med_type医疗类别数值型是1：自费2：医保3：其它

patn_no患者标识号字符型是患者身份的唯一号，门诊号或EMPI

patn_name患者姓名字符型是—

patn_age_unit年龄单位字符型是岁，月，日

patn_age_value年龄值数值型是—

patn_gend性别数