国家医保电子凭证业务 标准动态库交互规范
2020年11月
文件状态： [√]草稿 报告编号： 当前版本：[]正式发布 编写人： 编写日期[]正在修改 审批人： 审批日期保密级别：保密
目录
1.11.2 文档阅读对象 目的，1.3 术语说明..1. 4 安全机制
2.1 协议规则，2.2 格式规定2.2.1 日期时间格式.2.2.3 2.2.2 交易金额格式约定2.2.4 医疗机构业务流水号约定 报文格式约定
动态库调用方法....
3.1 动态库名称3.2 3.3 交易接口调用函数 常见返回码3.4 调用示例..3.4.1 C.3.4.2 JAVA.
电子凭证中台业务接口，
4. 1 电子凭证二维码解码接口4. 1. 1 交易对象.4.1.2 接口描述..4.1.4 4.1.3 交易类型编码 出入参说明.4.1.5 报文示例.4.2 终端医保电子凭证码解码接口4.2.2 4.2.1 交易对象.4.2.3 接口描述. 交易类型编码.4.2.4 出人参说明 64.3 刷脸授权获取医保身份接口 104.3.2 4.3.1 接口描述. 交易对象. 104.3.3 交易类型编码. 10 104.3.4 出入参说明， 11
A.1代码标识说明. A.2证件类型代码表. 12 12A.3ordStas订单状态编码 13A.4返回值代码表.... 13A.5id_poolarea统筹区编码 15
1引言
1.1目的
本文档主要表述了医疗机构接入医保电子凭证业务的相关流程及接口.编写该文档的目的是为接口开发人员提供详细的说明指导.
1.2文档阅读对象
本文档的读者为医疗机构的系统承建商的软件开发人员、软件设计人员、软件实施人员、测试人员以及与该项目相关的其他人员等.
1.3术语说明
术语 说明医保业务综合服务终端（以下简称终端）通过专线或者VPDN的方式接入医保核心业务区网络.终端采用二维码、身份证及人脸识别技术进行身份核医保业务综合服务终端 医保支付结算等相关业务的办理功能.为了保障设备本身、应用及SDK的 验，基于模块化的各类SDK及终端业务中间件，提供基于医保电子凭证和安全，要求设备提供基于密码技术的安全加固功能.同时，终端设备需接受国家及当地医保部门的监控管理.定点医药机构 医保定点医院和医保定点药店.
1.4安全机制
两定机构与动态库为明文交互，动态库内置安全认证机制，两定机构通过调用动态库接发起业务请求，动态库将传入的业务请求入参进行标准国密加密后，以密文形式传输给电子凭证中台.电子凭证中台收到请求后，用对应密钥进行请求解密，以验证请求方的合法性和安全性，验证通过后进行业务交易，以确保本地请求安全.
2接口规则
2.1协议规则
规则 规则描述调用方式 动态库提交方式 动态库接口数据格式 提交和返回数据均为JSON格式字符编码 统一采用GBK字符编码判断逻辑 先判断协议字段返回，再判断业务返回，最后判断交易状态签名算法 请求和响应均需要签名
2.2格式规定
2.2.1日期时间格式
格式：YYYYMMDDHHMMSS.
2.2.2交易金额格式约定
2.2.3医疗机构业务流水号约定
医疗机构业务流水号由医疗机构自定义生成，并要求医疗机构业务流水号保持唯一性.建议按系统时间（YYYYMMDDHHMMSS）加3位随机字符串加机构编号的规则来生成流水号.
2.2.4报文格式约定
请求报文和响应报文都由报文头和报文体（data）组成：以下是通用报文头的说明：具体报文体参数（data）详见各个业务接口说明.注：若业务接口无特殊说明，请求报文均需要组装报文头参数，若字段的可空属性出现N/Y的情况，则表明需要根据具体医院来定是否必传.
2.2.4.1通用请求报文头参数说明
序号 参数类型 代码标识是否必填1 orgld 参数名 机构ID 参数描述 字符 参数长度 40 N Y 机构代码 备注2 transType 交易类型 字符 40 N Y 接口交易代码3 data 接口请求参数 字符 2048 N Y JSON格式字符串4 extra 扩展参数 字符 2048 N JSON格式字符串
2.2.4.2 通用响应报文头参数说明
序号 参数名 参数描述 参数类型 参数长度 代码标识 是否必填 备注1 orgld 机构ID 字符 40 N Ycode 返回码 数值 Y Y 为交易错误信息，详见表 接口返回值非0时，该出参2 4 A4返回值代码表3 message 返回信息 字符 200 N N code非0时有效4 data 接口响应参数 字符 2048 N Y JSON格式字符串5 extra 扩展参数 字符 2048 N N JSON格式字符串
3动态库调用方法
3.1动态库名称
调用的动态库名称：NationECCode.dl1
3.2交易接口调用函数
函数声明 char* _stdcall NationEcTrans (char* strUrl char* InData char* OutData)返回类型 返回字符串0000为动态库调用成功参数名 参数类型 参数长度 是否允许空 参数说明 备注入参说明 strUrl 字符 2048 N 业务请求地址InData 字符 2048 N 交易请求数据 JSON格式字符串参数名 参数类型 参数长度 是否允许空 参数说明 备注出参说明 OutData 字符 2048 交易返回数据 code为0时，交易成功： 否则返回错误信息说明值 业务含义
