| 撰写单位: | 朝阳正鑫招标代理有限公司 | 发布时间: | 2025-05-15 |
项目概况 朝阳市中医院辽宁省医疗领域智慧化管理平台接口采购项目的潜在供应商应在线上获取采购文件,并于2025年05月28日 09时00分(北京时间)前提交响应文件。 一、项目基本情况 项目编号:JH25-211300-00941 项目名称:朝阳市中医院辽宁省医疗领域智慧化管理平台接口 采购方式:竞争性磋商 包组编号:001 预算金额(元):400000 最高限价(元):400000 采购需求: 一、辽宁省医疗领域智慧化管理平台-实时数据采集方案 (详细接口服务说明、值域字典参见接口文件“辽宁省医疗领域智慧化管理平台-实时数据采集方案v1.2”) 第一章概述 一.1.文档说明 本文详细阐述了第三方与监管规则引擎平台对接,进行相关业务数据上传校验的接口规范,调用该服务接口可将监管规则引擎相关数据进行实时/定时上传。 本文档参考自《沈阳市医保接口用户手册V2.15.docx》,旨在沿用医保的出入参规范来支持监管规则引擎的数据上传。其中接口请求的入参基本可以沿用原医保接口请求的入参,在原医保接口基础上进行的调整主要包括: l 部分接口需同时给监管规则引擎上传医院给医保的入参(input)以及医保返回给医院的出参(output)。 l 为兼容自费部分患者数据的上传,本文档对原医保接口部分字段的必填要求以及定义进行了调整。 本文档的监管规则引擎数据上报,各医院可根据实际情况,分两阶段进行实施: l 一阶段完成医保数据的上报。 l 二阶段完成自费数据的上报。 第二章接口报文格式 二.1.接口头文件格式定义 除了【9001A】签到接口,其他业务交易接口均需要添加头文件: 表 2 头文件header | 参数代码 | 参数名称 | 参数类型 | 是否必填 | 说明 | | affair_token | Token | 字符型 | Y | | | app_id | 用户id | 字符型 | Y | | | affairToken | Token | 字符型 | | 由于 nginx 转发默认不转发带下划线的头文件,故扩充 Token 字段可选项。Token 可选affair_token或affairToken | | appId | 用户id | 字符型 | | 由于 nginx 转发默认不转发带下划线的头文件,故扩充用户 id字段可选项。用户 id 可选填 app_id或appId |
二.2.接口输入报文格式定义(与医保一致) 报文采用JSON格式,交易参数定义如下: 表 2 交易输入参数定义 | 序号 | 数据元标识 | 数据元名称 | 类型 | 长度 | 代码标识 | 是否必填 | 备注 | | 1 | infno | 交易编号 | 字符型 | 4 | | Y | 交易编号详见接口列表 | | 2 | msgid | 发送方报文ID | 字符型 | 30 | | Y | 定点医药机构编号(12)+时间(14)+顺序号(4)时间格式:yyyyMMddHHmmss | | 3 | mdtrtarea_admvs | 就医地医保区划 | 字符型 | 6 | | Y | | | 4 | insuplc_admdvs | 参保地医保区划 | 字符型 | 6 | | | 如果交易输入中含有人员编号,此项必填,可通过【1101】人员信息获取交易取得 | | 5 | recer_sys_code | 接收方系统代码 | 字符型 | 10 | | Y | 默认传SY | | 6 | dev_no | 设备编号 | 字符型 | 100 | | | | | 7 | dev_safe_info | 设备安全信息 | 字符型 | 2000 | | | | | 8 | cainfo | 数字签名信息 | 字符型 | 1024 | | | 上传下发的安全管理码。安全管理码每个定点一个,定点从两定门户上获取。 | | 9 | signtype | 签名类型 | 字符型 | 10 | | | 建议使用SM2、SM3 | | 10 | infver | 接口版本号 | 字符型 | 6 | | Y | 默认传V1.0 | | 11 | opter_type | 经办人类别 | | 3 | Y | Y | 1-经办人;2-自助终端;3-移动终端 | | 12 | opter | 经办人 | 字符型 | 30 | | Y | 按地方要求传入经办人/终端编号 | | 13 | opter_name | 经办人姓名 | 字符型 | 50 | | Y | 按地方要求传入经办人姓名/终端名称 | | 14 | inf_time | 交易时间 | 日期时间型 | 19 | | Y | | | 15 | fixmedins_code | 定点医药机构编号 | 字符型 | 12 | | Y | | | 16 | fixmedins_name | 定点医药机构名称 | 字符型 | 20 | | Y | | | 17 | sign_no | 交易签到流水号 | 字符型 | 30 | | | 通过医保签到【9001】交易获取 | | 18 | input | 交易输入 | 字符型 | 40000 | | Y | | | 19 | output | 交易输出 | 字符型 | 40000 | | N | 【2201】门诊挂号、【2401】入院办理接口必填 |
二.3.接口输出报文格式定义(与医保一致) 报文采用JSON格式,交易参数定义如下: 表 3 交易输出参数定义 | 序号 | 数据元标识 | 数据元名称 | 类型 | 长度 | 代码标识 | 是否非空 | 备注 | | 1 | infcode | 交易状态码 | 数值型 | 4 | | Y | 详见下节 | | 2 | inf_refmsgid | 接收方报文ID | 字符型 | 30 | | Y | 接收方返回,接收方医保区划代码(6)+时间(14)+流水号(10)时间格式:yyyyMMddHHmmss | | 3 | refmsg_time | 接收报文时间 | 字符型 | 17 | | | 格式:yyyyMMddHHmmssSSS | | 4 | respond_time | 响应报文时间 | 字符型 | 17 | | | 格式:yyyyMMddHHmmssSSS | | 5 | err_msg | 错误信息 | 字符型 | 200 | | | 交易失败状态下,业务返回的错误信息 | | 6 | output | 交易输出 | 字符型 | 40000 | | | |
二.4.交易状态码说明(与医保一致) 交易状态码(infcode)规格如下: 表 4 报文状态说明 二.5.重点说明(与医保一致) l 调用交易时INPUT、OUTPUT节点应按照接口安全相关要求进行签名。 l 时间格式代码说明:yyyy(年,4位)、MM(月,2位)、dd(日,2位)、HH(24小时制,2位)、mm(分钟,2位)、ss(秒,2位)、SSS(毫秒,3位)。 l 日期时间型的数据元(例如开始时间)格式为:yyyy-MM-dd HH:mm:ss ;日期型的数据元(例如开始日期)格式为:yyyy-MM-dd。 l 查询中输入开始结束时间,格式为yyyy-MM-dd,时间范围默认开始于00:00:00,结束于23:59:59。例如时间2020-01-01~2020-01-02 则匹配时间2020-01-01 00:00:00~2020-01-02 23:59:59 的数据。 l 报文中的输入/输出项的字符型串中的根节点和各个子节点一律小写。 l 类型为数值的参数,如果为空,必须传“0”,其他为空串(“”),TXT文件中空值使用“null”。 l TXT文件使用字符集为UTF-8。 l 接口输入、输出数据元代码标识为“Y”的,字典内容参照文章中字典表部分内容。 l 报文中INPUT/OUTPUT(输入信息/输出信息)要符合JSON格式的约定。 l 如果信息中出现的下列字符,需要进行转义处理: 1、“"” 转义为 “\"” ; 2、“\” 转义为 “\\\\”。 l 本接口所有exp_content扩展格式统一为嵌套json格式,样例如下: "exp_content": { "local_dise": "A001" } l 目录首次下载版本号传0。 l 结算类业务的入参险种类型应该取读卡返回正常参保的主险种。 l 报文头cainfo需要上传下发的安全管理码。不需要对input加密和output解密,采用明文进行交易。 第三章接口服务列表 |