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

ICS11.020ICS11.020CCSC07深 圳 市 地 方 标 准DB4403/T335—2023基于二维码的电子处方流转接口规范InterfacespecificationofelectronicprescriptioncirculationbasedonQRcode2023-06-072023-06-072023-07-01深圳市市场监督管理局发布目次目次前言 II112范引文件 13语定义 14略语 15务构 16子方询务数据式调方法 26.1概述 2电处二码成URL格式 2电处方URL生维码例 3电处查报构 3电处查报据属性 47子方态新接口据式调方法 77.1概述 7电处状更文结构 7电处状更文数属性 88口供求 99口用求 99.1安授码99.2接使用 910口全求 9附录A（料）电处方成维示例 10附录B（料）接使用请息模板 11附录C（料）接参数写例 12参考献 15前言前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由深圳市卫生健康委员会提出并归口。本文件起草单位：深圳市第二人民医院、深圳市龙华区卫生健康局。本文件主要起草人：熊文举、杨雷、樊铭一、熊淑华、陈广、李澎灏、方智野、朱伟民、于德伟、王克俊、魏沛群、黄舜霞。基于二维码的电子处方流转接口规范基于二维码的电子处方流转接口规范范围本文件适用于基于二维码的电子处方流转接口的数据交换。（GB/T22239—2019信息安全技术网络安全等级保护基本要求GB/T35273—2020信息安全技术个人信息安全规范3术语和定义3术语和定义下列术语和定义适用于本文件。3.1电子处方提供方electronicprescriptionprovider开出任意电子处方的医疗机构。注：包括医院、社区健康服务中心等。3.2电子处方调用方electronicprescriptioncaller需要识别电子处方的机构。注：包括药店、第三方药品配送机构以及相关移动APP、小程序等。4缩略语下列缩略语适用于本文件。EMPI：病人主索引档案号（EnterpriseMasterPatientIndex）JSON：JavaScript对象简谱（JavaScriptObjectNotation）URL：统一资源定位器（UniformResourceLocator）5业务结构5.1电子处方生成、数据流转、数据获取是一套完整的接口方案，电子处方接口业务结构见图1。67第8910图1电子处方接口业务结构概述URLURL图2电子处方二维码生成格式EMPI；安全授权码：标识该电子处方查询时的安全授权码，由电子处方提供方提供，由电子处方调URL电子处方URL生成二维码示例见附录A。3图3电子处方查询请求报文结构6.4.24图4电子处方查询响应报文结构（POST）JSON1表1电子处方查询请求数据信息参数代码参数名称参数类型是否必填说明patn_no患者识别号字符型是EMPIrp_no处方号码字符型是电子处方提供方处方流转的唯一号key安全授权码字符型是核实调用方授权信息2表2电子处方查询返回数据信息表2电子处方查询返回数据信息参数代码参数名称参数类型是否必填说明result结果标识字符型是成功：true失败：falseerrMsg错误信息字符型—失败时标识具体错误信息rp_no处方号码字符型是电子处方提供方处方流转的唯一号org_code医疗机构编码字符型是—org_name医疗机构名称字符型是—mdtrt_id就诊ID字符型是患者该次就诊的唯一号mdtrt_time就诊时间日期时间型是格式：yyyy-mm-ddhh24:mi:ssmed_type医疗类别数值型是1：自费2：医保3：其它patn_no患者标识号字符型是EMPIpatn_name患者姓名字符型是—patn_age_unit年龄单位字符型是岁，月，日patn_age_value年龄值数值型是—patn_gend性别数值型是1：男2：女3：其他patn_tel联系电话—是—patn_addr联系地址———psn_cert_type人员证件类型数值型—9：出生医学证明（回乡证来往内地通行证（台胞证。certno证件号码字符型——dep_name就诊科室名称字符型是—prsc_time开方时间日期时间型是格式：yyyy-mm-ddhh24:mi:ssdoct_code电子处方医生编号字符型是医生院内唯一编号doct_name电子处方医生姓名字符型是医生姓名drug_chk_code审核药剂师编号字符型—审核药师院内唯一编号drug_chk_name审核药剂师姓名字符型—审核药师姓名drug_chk_time药师审核时间日期时间型—格式：yyyy-mm-ddhh24:mi:ssalgs_his过敏史字符型——diag_code主诊断代码———diag_name主诊断名称—是—表2处方查询返回数据信息表2处方查询返回数据信息（续）参数代码参数名称参数类型是否必填说明diag_dscr诊断描述———diag_ver诊断ICD版本———diag_orther其它诊断以及妊♘(孕周)等其它信息字符型——rp_type电子处方类型数值型是1：西药2：中成药3：中草药rp_pdf电子处方pdf连接字符型—用于获取电子处方pdf文件rp_nums电子处方剂数数值型—以下字段中草药电子处方必填rp_way_code电子处方整剂用法编号字符型——rp_way_name电子处方整剂用法名称字符型——rp_freq_code电子处方整剂频次编号字符型——rp_freq_name电子处方整剂频次名称字符型——rp_dosunt电子处方整剂剂量单位字符型——rp_doscnt电子处方整剂单次剂量数值型——rp_drord_dscr电子处方整剂医嘱说明字符型——rp_valid_days电子处方天数数值型——grp_id分组编号数值型是药品分组rp_detail_no处方明细编号字符型是每条电子处方明细的唯一编码prod_barc商品名编码字符型—医保局统一编码drug_prodname药品商品名字符型——genname_code通用名编码字符型是医保局统一编码drug_genname药品通用名字符型是—chemname化学名称字符型——drugstdcode药品本位码字符型——drug_dosform药品剂型字符型是—drug_spec药品规格字符型是—prdr_name生产厂家字符型——drug_cnt药品数量数值型是—drug_cnt_unit药品数量单位字符型是—medc_way_code用药途径代码字符型是值域见WS364.12—2011中表2参数代码参数名称参数类型是否必填说明medc_way_dscr用药途径描述字符型是—medc_days用药天数数值型是—drug_dosunt药品剂量单位字符型是—sin_dosunt单次剂量数值型是—used_frqu_code使用频次编码字符型是值域见WS445.3—2014中表5used_frqu_name使用频次名称字符型是—singnature电子签名内容字符型——singnature_value电子签名值字符型——概述7.2.17.2.1电子处方状态更新请求报文结构见图5。图5电子处方状态更新请求报文结构7.2.26图6电子处方状态更新响应报文结构发信息、安全授权码；响应报文内容包括结果信息和错误明细信息。7.3.23。表3电子处方状态更新请求数据信息7.3.3发信息、安全授权码；响应报文内容包括结果信息和错误明细信息。7.3.23。表3电子处方状态更新请求数据信息7.3.34。表4电子处方状态更新返回数据信息参数代码参数名称参数类型是否必填说明rp_detail_no处方明细编号字符型是每条电子处方明细的唯一编码disp_no配发药流水号字符型是配发药唯一编码disp_code配发药人编号字符型是配药药师院内唯一编号disp_name配发药人名称字符型是配药药师姓名disp_date配发药时间日期时间型是格式：yyyy-mm-ddhh24:mi:ssdisp_org_code配发药机构代码字符型是—disp_org_name配发药机构名称字符型是—disp_mode配发药方式数值型是1：门店自取2：物流配送pay_mode支付方式数值型是1：自费2：医保3：其他oper_mode操作类型数值型是1：配发药-1：取消配发药key安全授权码字符型是用于核实调用方身份参数代码参数名称参数类型是否必填说明result结果信息字符型是成功：true失败：falseerrMsg错误信息字符型—失败时标识具体错误信息电子处方提供方的接口应满足的要求包括但不限于：99.99接口使用方应获取授权认证信息后进行接口调用，调用的具体步骤如下：C.1调用电子处方、返回数据等信息。10接口安全要求接口安全应满足GB/T22239—2019、GB/T35273—2020中的要求。附录A附录A（资料性）电子处方生成二维码示例图A.1给出了电子处方生成二维码的示例。图A.1电子处方生成二维码示例附录B附录B（资料性）接口使用申请信息表模板接口使用申请信息表模板见表B.1。表B.1接口使用申请信息表模板序号名称描述1接口名称接口使用方申请使用的接口名称2接口使用方代码接口使用方的统一社会信用代码3接口使用方名称接口使用方的名称4接口使用方联系人接口使用方的联系人5接口使用方联系人电话接口使用方的联系人电话6接口使用方联系人邮箱接口使用方的联系人电子邮箱7接口应用系统名称使用该接口的业务系统名称8涉及的办理事项名称使用该接口用于办理的业务事项名称9申请依据描述接口使用方办理所涉及事项时使用该接口的具体依据，如相关法律、法规、政策等10接口使用期限365如1月1日-5月1日等11接口使用时间范围接口使用的具体时间范围，比如1：工作日（8:00-18:00）或2：全天（含非工作日）12附件附件包括但不限于加盖接口使用方印章的申请表扫描件、复印件等附录C附录C（资料性）接口参数填写示例电子处方查询业务接口请求、返回JSON示例见表C.1。表C.1电子处方查询业务接口请求、返回JSON示例名称描述请求数据示例电子处方查询接口请求JSON示例如下：{ "patn_no":0, "rp_no":21360258, "key":"IHsKCSJwYXRuX25vIjogMCwKCSJycF9ubyI6IDIxMzYwMjU4LAoJImtleSI6IDAKfQ"}正常响应数据示例电子处方查询接口正常响应JSON示例如下：{ "result":"true", "errMsg "rp_title":[{ "rp_no":"21360258", "org_code":"455000000", "org_nameXXXX "mdtrt_id":"16893237", "mdtrt_time":"2021-11-0416:52:53", "med_type":"1", "patn_no":"10250", "patn_name*", "patn_age_unit "patn_age_value":"23", "patn_gend":"2", "patn_tel":"1588****2533", "patn_addrXXX1000 "psn_cert_type":"99", "certno":"0", "dep_name "prsc_time":"2021-11-0416:55:22", "doct_code":"001", "doct_name":"医生A", "drug_chk_code":"", "drug_chk_name":"",C.1JSON（） "drug_chk_time":"2021-11-0417:00:30","drug_time":"2021-11-0416:55:22","algs_his":"","diag_code":"Z00.001", "diag_name "diag_dscr":"", "diag_ver":"", "diag_orther":"", "rp_type":"1", "rp_nums":"1", "rp_way_code":"", "rp_way_name":"", "rp_freq_code":"", "rp_freq_name":"", "rp_dosunt":"", "rp_doscnt":"", "rp_drord_dscr":"", "rp_valid_days":"", "rp_pdf":"szrch.rp.11010122-0028693701.pdf", "rp_drugdetail":[{ "grp_id":"1", "rp_detail_no":"33379199", "prod_barc":"10078_6214", "drug_prodnameXXX "genname_code":"XR05CBA1XXX2020300066", "drug_genname":"XXX "chemname":"XXX "drugstdcode":"86900000000000", "drug_dosform "drug_spec0.3*18/盒", "prdr_name":"北京XXX "drug_cnt":"1", "drug_cnt_unit":"盒", "medc_way_code":"1", "medc_way_dscr":"口服", "medc_days":"1", "drug_dosunt "sin_dosunt":"0.3", "used_frqu_code":"08", "used_frqu_name":"q8h","singnature":"","singnature_value":""}]}]}异常响应数据示例电子处方查询接口异常响应JSON示例如下：{ "res