1、河南省居民系统两定单位接入 开发手册文档编号 版本号 13分册名称 河南省居民系统两定单位接入开发手册 第 1册/共 1册总页数 正文 附录编制 张宏林 审批 生效日期东软集团股份有限公司河南省两定单位接入开发手册 东软集团股份有限公司修改记录版本号 变更控制报告编号 更改条款及内容 更改人 审批人 更改日期1.0 建立文档 张宏林 201508311.1 费用预结算 2420交易出参增加 44-48共 5个参数 张宏林 201509251.1 修改统筹区代码 张宏林 201509291.1 增加 2411无卡结算交易 张宏林 201509291.1 1300批量数据查询交易，药品目录增加出参
2、：儿童用药标识、国药准字 张宏林 201510011.1 1300批量数据查询交易，病种目录增加出参：疾病分类 张宏林 201510011.11300批量数据查询交易，目录政策参数信息增加出参：省级限价、市级限价、县级限价、县级以下限价张宏林 201510011.2 1300批量数据查询交易，病种编码信息增加出参：病种报销标志 张宏林 201510051.2 1300批量数据查询交易，病种编码信息出参专科疾病标志改为备用 张宏林 201510051.3处方明细上报 2310及药店收费预结算交易入参中的收费项目中心编码参数改为可空，并增加说明张宏林 201510081.4 增加无卡登记 2211
3、交易 张宏林 201510261.4 增加无卡结算撤销 2431交易 张宏林 201510261.4 附件中，统筹区兰考县的代码调整为 410225 张宏林 201510261.4 附件中，审批类别代码增加 06和 07 张宏林 201510261.4医院审批申报 3110交易：1、修改说明增加允许上传特检特制审批;2、交易入参增加收费项目种类、药品/项目中心编码、数量三个参数张宏林 201510261.5 新增医院医护人员信息上报 3220交易 贾思含 201602201.6就诊登记 2210交易：新增新生儿随父母就医标志、新生儿身份证号及新生儿姓名三个入参；贾思含 201608101.6
4、增加新生儿随父母就医标志二级代码； 贾思含 201608101.7 费用预结算 2420交易出参增加 49-52共 4个参数 贾思含 201608311.7 新增人脸识别模拟读卡 2150交易 宫鹤航 201612191.8 新增查询审核扣款明细信息功能 周木子 201701171.9 结算、预结算增加定点承担金额出参 贾思含 201702092.0修改查询审核扣款明细信息为查询下载审核扣款明细信息，修改输出参数为文件路径及文件名称周木子 20170224河南省两定单位接入开发手册 东软集团股份有限公司2.1读卡 2100交易交易增加三个出参（28、本年进入大病补充累计 29、本年大病补充支付
5、累计 30、困难群众标志） （个人基本信息及账户信息查询 1400交易和人脸识别模拟读卡 2150交易也同步增加这三个出参）宫鹤航 20170329河南省两定单位接入开发手册 东软集团股份有限公司目 录1 引言 .61.1 文档编制目的 .61.2 背景 .61.3 词汇表 .61.4 参考资料 .72 接口流程设计 .72.1 医院就医流程设计 .72.2 药店购药流程 .83 系统接口设计 .83.1 用户接口函数 .83.2 交易编码说明 .113.3 医院端调用接口交易序列图 .134 接口交易详细设计 .144.1 查询类 .144.1.1 交易功能 .144.1.2 交易设计 .1
6、44.1.2.1 医疗费用信息查询(1100) .144.1.2.2 结算信息查询(1101) .154.1.2.3 个人医疗费信息查询(1220) .154.1.2.4 个人就诊登记信息查询(1103) .164.1.2.5 目录对照信息查询(1105) .164.1.2.6 医疗费用信息查询 (1106) .184.1.2.7 总额对账(1120) .184.1.2.8 明细对账 (1130) .194.1.2.9 医疗费用明细信息查询(1200) .204.1.2.10 批量数据查询下载(1300) .214.1.2.11 个人基本信息及账户信息查询(1400) .274.1.2.12
7、医疗待遇封锁信息查询(1500) .274.1.2.13 医疗待遇审批信息查询(1600) .284.1.2.14 中心通知信息查询(1731) .294.1.2.15 获取中心端时间(1800) .304.1.2.16 查询下载审核扣款明细信息功能(1900) .304.2 认证类 .314.2.1 交易功能 .314.2.2 交易设计 .314.2.2.1 签到(9100) .314.2.2.2 签退(9110) .324.3 业务类 .324.3.1 交易功能 .32河南省两定单位接入开发手册 东软集团股份有限公司4.3.2 交易设计 .324.3.2.1 读卡交易(2100) .324
8、.3.2.2 修改卡密码(2110) .334.3.2.3 门诊/住院登记(2210) .344.3.2.4 无卡登记(2211) .354.3.2.5 住院登记信息修改(2230) .354.3.2.6 门诊/住院登记撤销(2240) .364.3.2.7 364.3.2.8 处方明细上报(2310) .364.3.2.9 处方明细撤销(2320) .384.3.2.10 费用预结算(2420) .394.3.2.11 费用结算(2410) .424.3.2.12 无卡结算(2411) .424.3.2.13 费用结算撤销(2430) .424.3.2.14 无卡结算撤销(2431) .43
9、4.3.2.15 药店收费预结算(2610) .434.3.2.16 药店收费结算(2620) .454.3.2.17 冲正交易(2421) .454.3.2.18 人脸识别模拟读卡交易(2150) .454.4 数据上传类 .464.4.1.1 基本医疗审批申报(3110) .464.4.1.2 审批申报撤销(3120) .474.4.1.3 对照信息申报(3300) .474.4.1.4 医院医护人员信息上报(3220) .485 数据结构与数据库设计 .496 尚需解决的问题 .497 附件 .49河南省两定单位接入开发手册 东软集团股份有限公司1 引言1.1 文档编制目的两定单位接入开
10、发手册主要表述了医保接口设计方案和对外交易描述。两定单位接入开发手册的阅读对象主要包括用户方相关人员、定点医疗机构软件开发人员及相关的其他人员等。1.2 背景本接口设计报告在核心平台三版医保接口设计的基础上，基于河南省居民项目设计。医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，除要满足河南省居民项目的医疗待遇算法和医院端需求外，还需要考虑医院端的连接方式、对定点医疗机构用户数目的限制以及中心和医院的对帐方式。基于河南省居民项目的建设背景，医保接口采用了联机模式。1.3 词汇表词汇名称 词汇含义 备注交易 医保接口客户端向接口发出的一种请求消息，接口需要作出应答医保接口 医保中心向定点医
11、疗机构公开的服务，是架在医保中心和定点医疗机构之间的一个接口系统，完成两者之间的信息传递，使定点医疗机构具备医保患者业务处理功能联机模式 患者在定点医疗机构享受医保待遇时，医保接口由中心直接提供服务，又称实时系统。HIS 系统 包括定点医疗机构的医院管理信息系统和收费端两种系统，这两种情况都需要调用医保接口动态库完成定点医疗机构的医保收费。本文档中提到的开发商也是指 HIS 系统的软件开发商河南省两定单位接入开发手册 东软集团股份有限公司1.4 参考资料编号 参考资料 备注2 接口流程设计2.1 医院就医流程设计开 始门 诊 挂 号费 用 明 细 上 报费 用 预 结 算费 用 明 细 撤 销
12、费 用 明 细 对 帐中 心 端 与 医 院 端数 据 一 致Y费 用 明 细 查 询N费 用 结 算 结 束读 卡 人 员 封 锁 信 息查 询 医 疗 待 遇 审 批信 息 查 询上 报 明 细 是 否 正确费 用 结 算 撤 销 结 算 正 确 YesNo无 费 退 号是 否 发 生 费 用 NYNY说明：上图以门诊为例说明医院就医的业务流程，住院业务与门诊业务的区别是，在就诊登记后，费用结算前，任何一个环节，都可以选择进行住院登记信息修改。河南省两定单位接入开发手册 东软集团股份有限公司2.2 药店购药流程开 始结 束读 卡(from State/Activity Model). 人
13、员 封 锁 信 息 查 询(from State/Activity Model).医 疗 待 遇 审 批 信 息 查 询(from State/Activity Model).药 店 预 结 算药 店 结 算是 否 退 药是 否 购 药N费 用 结 算 撤 销(from State/Activity Model).N Y说明：药店购药也可使用普通门诊结算流程3 系统接口设计3.1 用户接口函数本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过 DLL完成。程序文件名：SiInterface.dll对外提供的接口函数： 初始化函数:int INIT(char * pErrMsg)参数
14、说明：pErrMsg：动态库初始化错误信息。河南省两定单位接入开发手册 东软集团股份有限公司功能描述：检查整个运行环境：包括网络环境、运行所需文件、参数等的检查本地临时文件的清除，比如获取照片信息交易所生成的本地 jpg文件。返回值： 成功：返回 0 ； 失败：返回 -1 交易函数：int BUSINESS_HANDLE( char* inputData,char* outputData)功能描述：HIS 系统开发商需要向医保中心发送业务请求的通用函数输入参数：inputData 输出参数：outputData char* 返回值：成功：返回 0 ； 失败：返回 0输入输出参数是以“、$、|”
15、分割的字符串参数说明：入参格式: inputData业务编号医疗机构编号操作员编号业务周期号医院交易流水号中心编码入参联机标志名称 意义 备注业务编号(4 位) 宏定义, 分别对应后台的一项业务操作 非空定点医疗机构编号(20)非空操作员编号(10 位) 医院分配给操作员的唯一标识 非空业务周期号(最大 36位)操作员签到时，中心返回给 HIS的业务周期号。在进行业务类交易和签退交易时,必须带上这个业务周期号，该业务周期号必须使用中心返还的数据，开发商自己不能随意生成，否则对账会受影响，造成月结算数据不准。签到交易为空,其它交易为必录项医院交易流水号(发送方交易流水号)(最大 50位)建议规则
16、：时间(14)+医院编号+流水号(4)例：20120101083030-10011001-0001非空河南省两定单位接入开发手册 东软集团股份有限公司中心编码对只有一个中心系统的定点医疗机构和药店，默认传0000即可；如果定点医疗机构对应多个不同的医保中心，比如同时是省直和市医保的定点，需要根据具体的业务传正确的中心编码。非空业务入参详见每个交易的参数表, 分项之间使用管道分割符|分割，最后必须要以管道分割符号|结尾，不以|开始。如果入参为多条记录，记录之间以$分割，不以$结尾说明：中心修改参数的原则：只增不减，增加的参数加在参数列表的最后，不在中间插入参数。说明：入参为多条记录时，数据长度不
17、能超过 4000字节参考具体交易的参数说明联机标志 固定传 1:联机。 非空出参格式: outputData char*中心交易流水号联脱机标志输出参数警告信息中心交易流水号 中心交易流水号(最大 50位)中心返回联脱机标志 本项目是联机项目，所以该字段不用。输出参数该参数为输出参数，客户程序必须在调用本函数之前分配足够长 的空间，其最小值为 1024字节，如果未给本参数分配空间或分配的空间长度小于实际返回的长度，客户程序将会出现内存保护错误输出参数的规则同入参格式中的输入参数说明如果只有一个输出参数，则也遵循以|结尾，不以|开始原则。警告信息 预留，目前两定单位不做判断返回值说明 :0 成功，表示此次交易请求成功，业务处理也正常 0 错误，包括系统级别错误 (网络、主机、数据库 )和业务级别错误，系统级别错误由动态库将错误信息写入输出参数，业务级别错误由后台通过输出参数提示错误信息。其中：-1系统级别错误，HIS 系统提示错误信息后，需要进行冲正等后续业务操作处理；-2业务处理错误，HIS 系统直接将输出参数的错误信息提示给操作员即可。
