DB4403T335-2023基于二維碼的電子處方流轉接口規(guī)范

ICS11.020ICS11.020CCSC07深 圳 市 地 方 標 準DB4403/T335—2023基于二維碼的電子處方流轉接口規(guī)范InterfacespecificationofelectronicprescriptioncirculationbasedonQRcode2023-06-072023-06-072023-07-01深圳市市場監(jiān)督管理局發(fā)布目次目次前言 II112范引文件 13語定義 14略語 15務構 16子方詢務數(shù)據(jù)式調(diào)方法 26.1概述 2電處二碼成URL格式 2電處方URL生維碼例 3電處查報構 3電處查報據(jù)屬性 47子方態(tài)新接口據(jù)式調(diào)方法 77.1概述 7電處狀更文結構 7電處狀更文數(shù)屬性 88口供求 99口用求 99.1安授碼99.2接使用 910口全求 9附錄A（料）電處方成維示例 10附錄B（料）接使用請息模板 11附錄C（料）接參數(shù)寫例 12參考獻 15前言前言本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件由深圳市衛(wèi)生健康委員會提出并歸口。本文件起草單位：深圳市第二人民醫(yī)院、深圳市龍華區(qū)衛(wèi)生健康局。本文件主要起草人：熊文舉、楊雷、樊銘一、熊淑華、陳廣、李澎灝、方智野、朱偉民、于德偉、王克俊、魏沛群、黃舜霞?；诙S碼的電子處方流轉接口規(guī)范基于二維碼的電子處方流轉接口規(guī)范范圍本文件適用于基于二維碼的電子處方流轉接口的數(shù)據(jù)交換。（GB/T22239—2019信息安全技術網(wǎng)絡安全等級保護基本要求GB/T35273—2020信息安全技術個人信息安全規(guī)范3術語和定義3術語和定義下列術語和定義適用于本文件。3.1電子處方提供方electronicprescriptionprovider開出任意電子處方的醫(yī)療機構。注：包括醫(yī)院、社區(qū)健康服務中心等。3.2電子處方調(diào)用方electronicprescriptioncaller需要識別電子處方的機構。注：包括藥店、第三方藥品配送機構以及相關移動APP、小程序等。4縮略語下列縮略語適用于本文件。EMPI：病人主索引檔案號（EnterpriseMasterPatientIndex）JSON：JavaScript對象簡譜（JavaScriptObjectNotation）URL：統(tǒng)一資源定位器（UniformResourceLocator）5業(yè)務結構5.1電子處方生成、數(shù)據(jù)流轉、數(shù)據(jù)獲取是一套完整的接口方案，電子處方接口業(yè)務結構見圖1。67第8910圖1電子處方接口業(yè)務結構概述URLURL圖2電子處方二維碼生成格式EMPI；安全授權碼：標識該電子處方查詢時的安全授權碼，由電子處方提供方提供，由電子處方調(diào)URL電子處方URL生成二維碼示例見附錄A。3圖3電子處方查詢請求報文結構6.4.24圖4電子處方查詢響應報文結構（POST）JSON1表1電子處方查詢請求數(shù)據(jù)信息參數(shù)代碼參數(shù)名稱參數(shù)類型是否必填說明patn_no患者識別號字符型是EMPIrp_no處方號碼字符型是電子處方提供方處方流轉的唯一號key安全授權碼字符型是核實調(diào)用方授權信息2表2電子處方查詢返回數(shù)據(jù)信息表2電子處方查詢返回數(shù)據(jù)信息參數(shù)代碼參數(shù)名稱參數(shù)類型是否必填說明result結果標識字符型是成功：true失?。篺alseerrMsg錯誤信息字符型—失敗時標識具體錯誤信息rp_no處方號碼字符型是電子處方提供方處方流轉的唯一號org_code醫(yī)療機構編碼字符型是—org_name醫(yī)療機構名稱字符型是—mdtrt_id就診ID字符型是患者該次就診的唯一號mdtrt_time就診時間日期時間型是格式：yyyy-mm-ddhh24:mi:ssmed_type醫(yī)療類別數(shù)值型是1：自費2：醫(yī)保3：其它patn_no患者標識號字符型是EMPIpatn_name患者姓名字符型是—patn_age_unit年齡單位字符型是歲，月，日patn_age_value年齡值數(shù)值型是—patn_gend性別數(shù)值型是1：男2：女3：其他patn_tel聯(lián)系電話—是—patn_addr聯(lián)系地址———psn_cert_type人員證件類型數(shù)值型—9：出生醫(yī)學證明（回鄉(xiāng)證來往內(nèi)地通行證（臺胞證。certno證件號碼字符型——dep_name就診科室名稱字符型是—prsc_time開方時間日期時間型是格式：yyyy-mm-ddhh24:mi:ssdoct_code電子處方醫(yī)生編號字符型是醫(yī)生院內(nèi)唯一編號doct_name電子處方醫(yī)生姓名字符型是醫(yī)生姓名drug_chk_code審核藥劑師編號字符型—審核藥師院內(nèi)唯一編號drug_chk_name審核藥劑師姓名字符型—審核藥師姓名drug_chk_time藥師審核時間日期時間型—格式：yyyy-mm-ddhh24:mi:ssalgs_his過敏史字符型——diag_code主診斷代碼———diag_name主診斷名稱—是—表2處方查詢返回數(shù)據(jù)信息表2處方查詢返回數(shù)據(jù)信息（續(xù)）參數(shù)代碼參數(shù)名稱參數(shù)類型是否必填說明diag_dscr診斷描述———diag_ver診斷ICD版本———diag_orther其它診斷以及妊?(孕周)等其它信息字符型——rp_type電子處方類型數(shù)值型是1：西藥2：中成藥3：中草藥rp_pdf電子處方pdf連接字符型—用于獲取電子處方pdf文件rp_nums電子處方劑數(shù)數(shù)值型—以下字段中草藥電子處方必填rp_way_code電子處方整劑用法編號字符型——rp_way_name電子處方整劑用法名稱字符型——rp_freq_code電子處方整劑頻次編號字符型——rp_freq_name電子處方整劑頻次名稱字符型——rp_dosunt電子處方整劑劑量單位字符型——rp_doscnt電子處方整劑單次劑量數(shù)值型——rp_drord_dscr電子處方整劑醫(yī)囑說明字符型——rp_valid_days電子處方天數(shù)數(shù)值型——grp_id分組編號數(shù)值型是藥品分組rp_detail_no處方明細編號字符型是每條電子處方明細的唯一編碼prod_barc商品名編碼字符型—醫(yī)保局統(tǒng)一編碼drug_prodname藥品商品名字符型——genname_code通用名編碼字符型是醫(yī)保局統(tǒng)一編碼drug_genname藥品通用名字符型是—chemname化學名稱字符型——drugstdcode藥品本位碼字符型——drug_dosform藥品劑型字符型是—drug_spec藥品規(guī)格字符型是—prdr_name生產(chǎn)廠家字符型——drug_cnt藥品數(shù)量數(shù)值型是—drug_cnt_unit藥品數(shù)量單位字符型是—medc_way_code用藥途徑代碼字符型是值域見WS364.12—2011中表2參數(shù)代碼參數(shù)名稱參數(shù)類型是否必填說明medc_way_dscr用藥途徑描述字符型是—medc_days用藥天數(shù)數(shù)值型是—drug_dosunt藥品劑量單位字符型是—sin_dosunt單次劑量數(shù)值型是—used_frqu_code使用頻次編碼字符型是值域見WS445.3—2014中表5used_frqu_name使用頻次名稱字符型是—singnature電子簽名內(nèi)容字符型——singnature_value電子簽名值字符型——概述7.2.17.2.1電子處方狀態(tài)更新請求報文結構見圖5。圖5電子處方狀態(tài)更新請求報文結構7.2.26圖6電子處方狀態(tài)更新響應報文結構發(fā)信息、安全授權碼；響應報文內(nèi)容包括結果信息和錯誤明細信息。7.3.23。表3電子處方狀態(tài)更新請求數(shù)據(jù)信息7.3.3發(fā)信息、安全授權碼；響應報文內(nèi)容包括結果信息和錯誤明細信息。7.3.23。表3電子處方狀態(tài)更新請求數(shù)據(jù)信息7.3.34。表4電子處方狀態(tài)更新返回數(shù)據(jù)信息參數(shù)代碼參數(shù)名稱參數(shù)類型是否必填說明rp_detail_no處方明細編號字符型是每條電子處方明細的唯一編碼disp_no配發(fā)藥流水號字符型是配發(fā)藥唯一編碼disp_code配發(fā)藥人編號字符型是配藥藥師院內(nèi)唯一編號disp_name配發(fā)藥人名稱字符型是配藥藥師姓名disp_date配發(fā)藥時間日期時間型是格式：yyyy-mm-ddhh24:mi:ssdisp_org_code配發(fā)藥機構代碼字符型是—disp_org_name配發(fā)藥機構名稱字符型是—disp_mode配發(fā)藥方式數(shù)值型是1：門店自取2：物流配送pay_mode支付方式數(shù)值型是1：自費2：醫(yī)保3：其他oper_mode操作類型數(shù)值型是1：配發(fā)藥-1：取消配發(fā)藥key安全授權碼字符型是用于核實調(diào)用方身份參數(shù)代碼參數(shù)名稱參數(shù)類型是否必填說明result結果信息字符型是成功：true失?。篺alseerrMsg錯誤信息字符型—失敗時標識具體錯誤信息電子處方提供方的接口應滿足的要求包括但不限于：99.99接口使用方應獲取授權認證信息后進行接口調(diào)用，調(diào)用的具體步驟如下：C.1調(diào)用電子處方、返回數(shù)據(jù)等信息。10接口安全要求接口安全應滿足GB/T22239—2019、GB/T35273—2020中的要求。附錄A附錄A（資料性）電子處方生成二維碼示例圖A.1給出了電子處方生成二維碼的示例。圖A.1電子處方生成二維碼示例附錄B附錄B（資料性）接口使用申請信息表模板接口使用申請信息表模板見表B.1。表B.1接口使用申請信息表模板序號名稱描述1接口名稱接口使用方申請使用的接口名稱2接口使用方代碼接口使用方的統(tǒng)一社會信用代碼3接口使用方名稱接口使用方的名稱4接口使用方聯(lián)系人接口使用方的聯(lián)系人5接口使用方聯(lián)系人電話接口使用方的聯(lián)系人電話6接口使用方聯(lián)系人郵箱接口使用方的聯(lián)系人電子郵箱7接口應用系統(tǒng)名稱使用該接口的業(yè)務系統(tǒng)名稱8涉及的辦理事項名稱使用該接口用于辦理的業(yè)務事項名稱9申請依據(jù)描述接口使用方辦理所涉及事項時使用該接口的具體依據(jù)，如相關法律、法規(guī)、政策等10接口使用期限365如1月1日-5月1日等11接口使用時間范圍接口使用的具體時間范圍，比如1：工作日（8:00-18:00）或2：全天（含非工作日）12附件附件包括但不限于加蓋接口使用方印章的申請表掃描件、復印件等附錄C附錄C（資料性）接口參數(shù)填寫示例電子處方查詢業(yè)務接口請求、返回JSON示例見表C.1。表C.1電子處方查詢業(yè)務接口請求、返回JSON示例名稱描述請求數(shù)據(jù)示例電子處方查詢接口請求JSON示例如下：{ "patn_no":0, "rp_no":21360258, "key":"IHsKCSJwYXRuX25vIjogMCwKCSJycF9ubyI6IDIxMzYwMjU4LAoJImtleSI6IDAKfQ"}正常響應數(shù)據(jù)示例電子處方查詢接口正常響應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":"醫(yī)生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":""}]}]}異常響應數(shù)據(jù)示例電子處方查詢接口異常響應JSON示例如下：{ "res