国家医疗保障信息平台医保电子处方中心定点医药机构接入规范
目录
1.11.2 文档阅读对象 目的.1.3 术语说明,
2.2 2.1 接口规则 接口地址2.3 安全规范2.3.1 签名算法(SM2)2.3.2 加密算法(SM4) 报文公共参数2.3.3 10
3.1 电子处方线下流转授权 103.1.1 交易对象 103.1.2 3.1.3 接口描述. 请求方式 II3.1.4 出入参说明. II3.2 电子处方二维码解码 123.2.1 交易对象. 123.2.2 3.2.3 接口描述, 请求方式. 12 123.2.4 出入参说明 123.3 电子处方线上流转令牌获取 133.3.1 3.3.2 接口描述 交易对象 133.3.3 请求方式. 13 133.3.4 出入参说明 143.4 3.4.1 电子处方下载 143.4.2 交易对象. 接口描述 14 143.4.3 请求方式. 153.4.4 出入参说明 153.5 3.5.1 电子处方信息核验 交易对象. 183.5.2 接口描述, 18 183.5.3 请求方式. 813.5.4 出入参说明 183.6 3.6.1 电子处方药师审方信息上传 交易对象, 61 193.6.2 接口描述, 613.6.3 请求方式.3.6.4 出入参说明 07
3.7 药品销售出库明细上传3.7.1 交易对象 203.7.2 3.7.3 接口描述. 请求方式.3.7.4 出入参说明 21 213.8 药品销售出库明细撤销 233.8.1 交易对象 233.8.3 3.8.2 接口描述, 请求方式. .23 233.8.4 出入参说明 233.9 药品配送信息同步3.9.1 交易对象, 243.9.3 3.9.2 接口描述, 请求方式. ..24 243.9.4 出入参说明 .243.10 药品配送签收确认 253.10.2 3.10.1 交易对象. 接口描述, .25 253.10.3 请求方式..3.10.4 出入参说明. 26附录A... 27A.0处方类别代码(rx_type_code) A.1药物使用-途径代码(drug_medc_way_code) 27 27A.2药物类型代码(medn_type_code) 27A.3使用频次(used_frqu)A.4 处方项目分类代码(rx_item_type_code) A.5 中药类别代码(tcndrug_type_code) 30A.6 性别(gend). 30A.7人员证件类型(psn_cert_type) 30A.9 审方药师职称(phar_pro_tech_duty) A.8开单医生职称(drord_dr_proftt1) .31A.10 医院审批标志(hosp_appr_flag) 31 31A.11医保费用结算类型(hi_feeset1_type) 31A. 12 诊断类别(diag_type) 32A. 13 医疗类别(nmed_type).A.14 险种类型(insutype) A.15 医保电子处方状态(rx_stas_codg) 35 34A.16 医保电子处方使用状态(rx_used_stas_codg) 35A.17处方审核状态(rx_chk_stas_codg) 35A.19 配送位置经纬度类型(delver_geo_type) A.18 配送状态(delv_stas_codg) .35 35A.20返回值代码表. 35A.21参保地、统筹区编码.
1引言
1.1目的
本文档主要表述了定点医药机构接入医保电子处方中心业务的相关流程及接口.编写该文档的目的是为接口开发人员提供详细的说明指导.
1.2文档阅读对象
本文档的读者为定点医药机构的系统承建商的软件开发人员、软件设计人员、软件实施人员、测试人员以及与该项目相关的其他人员等.
1.3术语说明
定点医药机构 术语 医保定点医院和医保定点药店. 说明
2服务调用规范
2.1接口规则
表1接口规则
传输方式 为保证交易安全性,采用HTTPS传输提交方式 采用POST方法提交数据格式 提交和返回数据都为JSON格式字符编码 统一采用UTF-8字符编码签名算法 加密算法 国密算法SM2(SM3withSM2) 国密算法SM4请求和接收数据均需要校验签名,详细方法请参考安全规范签名要求 -签名算法加密要求 请求数据需加密,接收数据需解密,详细方法请参考安全规判断逻辑 范-加密算法先判断协议字段返回,再判断业务返回,最后判断交易状态
2.2接口地址
测试地址:地方医保电子处方中心服务域名/epc/api/
2.3安全规范
2.3.1签名算法(SM2)
2.3.1.1概述
根据SM2算法(Signature的algorithm选择SM3withSM2),签名报文.通过对报文数据筛选、排序和拼接,组成待签名报文数据(参考实现:医保电子凭证中心下发的“(1-24)医保局加解密方法工具类V1.0”中的SignUtil和EasyGmltils).
2.3.1.2请求参数签名
筛选
获取请求参数,不包括字节类型参数,如文件、字节流,剔除signData、encData、extra字段.
排序
字符则按照第二个字符的键值ASCII码递增排序,以此类推. 将筛选的参数按照第一个字符的键值ASCII码递增排序(字母升序排序),如果遇到相同
拼接
接起来,最后拼接上应用密钥appSecret在“参数=参数值”后,此时生成的字符串为待签名字符串,将待签名字符串SM2运算,即是签名(signData)的值.(“signData”、“encData”、“extra”参数不参与签名).
JOSN对象签名规范(如data):内部按字母顺序升序排列空值不参与签名将整理好的JSON内容,输出JSON字符串后拼接参与签名,例如下面的示例请求报文,参数值都是示例,开发者仅参考报文格式即可.
加签报文示例:
WCQ_bd* ~idNo°:“35018119901193519~ * idType°: “01* ~phoneNunberd: ~ ~userName: data : (appId* :~43AF047BBA47FC8A1AE8EFB232BDBBCB° *appl/serId° : o8z4C5avQXqCOaMFPr1Mzu6D7“测试”],~encType~ :~SMM4*