医疗保障信息平台 定点医药机构 对接医保业务综合服务终端 接口规范
(V1.1.0)
修订情况
修订前版版本 修订章节 修订内容功能描述 修订日期 修订人 批准人 备注本号V1.0.0 新建 2020 陈仁地 无 管方V1. 1.0 2 原章节无内容，删除 章节，其余章节号统 陈仁地 V1.0 管方一调整V1.1.0 4.1 按照最新接口规范进 陈仁地 V1.0 管方4.2 行调整 新增 陈仁地 V1.0 管方V1.1.0 V1.1.0 4.3 新增 陈仁地 V1.0 管方V1. 1.0 4. 4 新增 陈仁地 V1.0 管方V1. 1.0 4.5 新增 陈仁地 V1.0 管方
目次
引言.1.1 目的.1.2 1.3术语说明. 文档阅读对象1.4安全机制2 接口规则2.1协议规则， 2.2格式规定，2.2.1 日期时间格式.2.2.2 交易金额格式约定2.2.3 定点医药机构业务流水号约定3动态库调用方法.. 2.2.4 报文格式约定，3.1动态库：NationECCode.dl13.2交易接口调用函数. 6接口定义.4.1费用上传接口 4.1.1 接口描述，4.1.2 出入参说明4.2查询订单结算状态接口4. 2. 1 4.2.2 接口描述 出入参说明，4.3支付结果推送接口4.3. 1 接口描述.4.3.2 出入参说明4.4撤销费用明细上传 4.4.1 接口描述，4.4.2 出入参说明，4.5医保退费接口4.5. 1 接口描述，附录A... 4.5.2 出入参说明.A.1代码标识说明，
定点医药机构对接医保业务综合服务终端接口规范
1引言
1.1目的
本文档主要表述了定点医药机构接入医保业务涉及的业务流程以及接口出入参等内容.编写该文档的目的在于对医保业务综合服务终端的接口方案进行详细的说明，使接口开发人员能够深刻理解接口方案.
1.2文档阅读对象
本文档的读者为定点医药机构的系统承建商的软件开发人员、软件设计人员、软件实施人员、测试人员以及与该项目相关的其他人员等.
1.3术语说明
术语 定点医药机构 说明 医保定点医院和医保定点药店.
1.4安全机制
两定机构与动态库为明文交互，动态库内置安全认证机制，两定机构通过调用动态库接发起业务请求，动态库将传入的业务请求入参进行标准国密加密后，以密文形式进行串口通讯传输给医保综合服务终端，医保综合服务终端收到请求后，用对应密钥进行请求解密，以验证请求方的合法性和安全性，验证通过后进行终端业务交易，以确保本地请求安全.
2 接口规则
2.1协议规则
规则 规则描述调用方式 动态库
提交方式 动态库接口数据格式 提交和返回数据均为JSN格式字符编码 统一采用UTF-8字符编码判断逻辑 先判断协议字段返回，再判断业务返回，最后判断交易状态签名算法 请求和响应均需要签名
2.2格式规定
2.2.1 日期时间格式
格式：YYYYMDDHHMSS.
2.2.2 交易金额格式约定
交易金额默认为人民币交易，接口中参数支付金额单位为【元】.对账单中的交易金额单位为【元】.
2.2.3 定点医药机构业务流水号约定
定点医疗机构业务流水号由医疗机构自定义生成，并要求医疗机构业务流水号保持唯一性.建议按系统时 间（YYYYMMDDHHMISS）加3位随机字符串加机构编号的规则来生成流水号.
2. 2.4 报文格式约定
请求报文和响应报文都由报文头和报文体（data）组成：以下是通用报文头的说明：具体报文体参数（data)详 见各个业务接口说明.注：若业务接口无特殊说明，请求报文均需要组装报文头参数，若字段的可空属性出现N/Y的情况，则表明需要根据具体医院来定是否必传.
2.2.4.1 通用响应报文头参数说明
代码是否序号 数据元标识 数据元名称 类型长度 标识 必填 备注orgId 机构ID 字符40 N Y 机构代码2 transType 交易类型 字符 40 Y 接口交易代码data 接口请求参数 002 Y JSON格式字符串4 extData 扩展参数 N00 N JSON格式字符串
