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