国家医疗保障局医疗保障信息平台建设工程
医疗保障信息平台
（刷脸一码付）
(V1.0)
目录
第1章范围第2章规范性引用文件.第3章接口报文格式.3.1接口输人报文格式定义3.2接口输出报文格式定义. ..23.3交易状态码说明. 23.4重点说明. 3第4章业务流程.4.1一码付“先医保后自费”支付业务流程图 .54.2一码付退费流程64.3一码付对账流程 7第5章接口说明. 85.1医保支付... 85.1.1一码付 .8第6章接口调用示例代码 116.1B.1报文输人示例-人员信息获取 116.2B.2报文输出示例-人员信息获取， 12
本标准按照GB/T1.1-2009给出的规则起草.请注意本文件的某些内容可能涉及专利，本文件的发布机构不承担识别这些专利的责任.
医疗保障信息平台定点医药机构接口规范
第1章范围
本规范规适用于医疗保障信息平台定点医药机构接口基线版的说明，
第2章规范性引用文件
下列文件对于本文件的应用是必不可少的，凡是注日期的引用文件，仅所注日期的版本适用于本文件，凡是不注日期的引用文件，其最新版本（包括的修改单）适用于本文件，
XJ-K01-2020医疗保障信息平台定点医药机构接口规范.
第3章接口报文格式
3.1接口输人报文格式定义
报文采用JSON格式，交易参数定义如下：
表3交易输人参数定义
代码是否必序号 数据元标识 数据元名称 类型 长度 标识 填 备注1 infno 交易编号 字符型 4 Y 交易编号详见接口列表定点医药机构编号（12)时间(14）2 msgid 发送方报文ID字符型 30 顺序号（4)mdtrtarea_adms 就医地医保区划字符型 9 Y 时间格式：yMMddHHmmss如果交易输入中含有人员编号，此4 insuplc_admdvs 参保地医保区划字符型 6 项必填，可通过【1101】人员信息获取交易取得5 apoo"s(s"Jaoa1 接收方系统代码 字符型 10 用于多套系统接入，区分不同系统 使用6 ou".ap 设备编号 字符型 1007 oju-ajes"aap 设备安全信息 字符型 20008 signtype cainfo 数字签名信息 签名类型 字符型 字符型 1024 10 建议使用SM2、SM39 例如： “V1.0，服本号由医保下10 infver 接口版本号 字符型 9 A 发通知.11 optertype 经办人类别 3 Y Y 1-经办人：2-自助终竭：3-移动终
序号 数据元标识 数据元名称 类型 长度 代码是否必 标识 备注12 opter 经办人 字符型 30 填 Y 按地方要求传人经办人/终端编号经办人姓名 按地方要求传人经办人姓名/终端13 opter_name 字符型 50 Y 名称14 inf_time 交易时间 日期时 19 Y定点医药机构编 间型15 fixmedins_code 号 字符型 14 Y16 fixmedins_name 定点医药机构名 字符型 200 Y交易签到流水号字符型 称17 18 sign_no app_id 渠道id 字符型 30 32 通过签到【9001】交易获取19 enc_type 加密方式 字符型 6 不加密传空，加密传SM420 input 交易输人 字符型|40000 Y21 pwecToken 电子凭证密码核 狼tokon 字符型 50 用于调用电子凭证相应交易保存token 使用
3.2接口输出报文格式定义
报文采用JSON格式，交易参数定义如下：
表4交易输出参数定义
序 代码是否号 数据元标识 数据元名称 类型 长度 标识 非空 备注1 infoode 交易状态码 数值型 4 Y 详见下节p(8sujarju! 接收方报文ID 字符型 30 Y 接收方返回，接收方医保区划代码 （6)时间(14)流水号（10)2 时间格式：yyyMMddHHmmss3 refmsg_time 接收报文时间 17 格式：yMMddHmmssSS4 respod_time 响应报文时间 字符型 17 交易失败状态下，业务返回的错误信 格式：yMddHHmmssSS5 ssw.a 错误信息 字符型 200 息6 signtype 签名方式 字符型 6 SM27 cainfo 数字签名信息 字符型 10248 app_id 集道id 字符型 3210 9 cnc_type output 加密方式 交易输出 字符型 字符型 40000 6 不加密传空，加密传SM4
3.3交易状态码说明
交易状态码（infcode）规格如下：
序号 STATUS值 值说明 备注1 0 -1 成功 失败2
3.4重点说明
调用交易时INPUT、OUTPUT节点应按照接口安全相关要求进行签名.
时间格式代码说明：yyyy（年，4位）、MM（月，2位）、dd（日，2位）、HH（24小时制，2位）、mm（分钟，2位）、ss（秒，2位）、SSS（毫秒，3位），
日期时间型的数据元（例如开始时间）格式为：yyy-MM-ddHH:mm:ss：日期型的数据元（例如开始日期）格式为：yyy-MM-dd.
●查询中输入开始结束时间，格式为yyy-MM-dd，时间范围默认开始于00:00:00结束于23:59:59.例如时间2020-01-01～2020-01-02则匹配时间2020-01-0100:00:00 ~ 2020-01-02 23:59:59 的数据.
报文中的输人/输出项的字符型申中的根节点和各个子节点一律小写.
类型为数值的参数，如果为空，必须传“0”，其他为空串（“"），TXT文件中空值使用“null，
TXT文件使用字符集为UTF-8.
接口说明中声明的输人为输人报文中INPUT属性内容，输出为输出报文中OUTPUT属性内容，除文件上传下载交易（【9101】、【9102】）外，交易都应该有输入输出报文，文件上传下载交易对应文件以流式数据传输.
接口输人、输出数据元代码标识为“Y”的，字典内容参照文章中字典表部分内容.
报文中INPUT/OUTPUT（输人信息/输出信息）要符合JSON格式的约定.
如果信息中出现的下列字符，需要进行转义处理：
2、“”转义为“".
1、*转义为“：
将报文剔除cainf、input后，按照数据元标识的ASCII码递增排序（字母升序排序），将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串，将待签名字符串SM2运算，即是数字签名信息（cainfo）的值.
