荆门金保医保接口用户参考手册

文件版次：
目录
1引言 (5)
1.1文档编制目的 (5)
1.2背景 (5)
1.3词汇表 (5)
2系统接口设计 (5)
2.1用户接口说明 (5)
2.2用户接口函数 (5)
3接口交易详细设计 (8)
3.1查询类 (8)
3.1.1交易功能 (8)
3.1.2交易设计 (9)
3.1.2.1批量数据查询下载 (9)
3.1.2.2医疗费信息汇总 (17)
3.1.2.3明细对帐请求 (18)
3.1.2.4医疗费信息查询 (18)
3.1.2.5医疗费用明细信息查询 (19)
3.1.2.6医疗待遇封锁信息查询 (21)
3.1.2.7医疗待遇审批信息查询 (22)
3.2认证类 (24)
3.2.1交易功能 (24)
3.2.2交易设计 (24)
3.2.2.1签到 (24)
3.2.2.2签退 (24)
3.2.2.3获取中心系统时间 (24)
3.3业务类 (25)
3.3.1交易功能 (25)
3.3.2交易设计 (25)
3.3.2.1读卡交易 (25)
3.3.2.2居民获取基本信息 (29)
3.3.2.3修改卡密码 (29)
3.3.2.4门诊/住院登记 (29)
3.3.2.5住院登记修改 (30)
3.3.2.6出院登记 (30)
3.3.2.7登记撤销 (31)
3.3.2.8登记（挂号）冲正 (32)
3.3.2.9处方明细上报 (32)
3.3.2.10处方明细撤销 (33)
3.3.2.11处方明细更改......................................................................................... 错误！未定义书签。

3.3.2.12费用预结算 (34)
3.3.2.13费用结算 (35)
3.3.2.14费用结算撤销 (36)
3.3.2.15费用结算冲正 (36)
3.3.2.16结算单信息查询 (36)
3.3.2.17药店收费预结算 (38)
3.3.2.18药店收费结算 (39)
3.3.2.19医院审批信息上报 (40)
3.3.2.20医院审批信息上报撤销 (42)
3.3.2.21医院项目对照上报 (42)
3.3.2.22医院项目对照上报撤销 (43)
1引言
1.1文档编制目的
本报告主要表述了荆门金保项目中医保接口设计方案，内容包含了医保接口的部署方案以及软件接口设计等内容。

本报告的阅读对象包括软件开发人员、软件设计人员、软件实施人员以及与该项目相关的其他人员等。

1.2背景
1.3 词汇表
2系统接口设计
2.1 用户接口说明
动态库返回成功，开发商才能处理his系统的业务，his业务处理失败造成的事务不一致由开发商负责。

如果由于线路等问题，动态库无法接收web应用返回的交易处理结果，则返回失败，由动态库保证中心业务的回退。

2.2 用户接口函数
本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过DLL完成。

程序文件名：SiInterface.dll
对外提供的接口函数：
初始化函数:
int INIT(char * pErrMsg)
功能描述：
检查整个运行环境：包括网络环境、运行所需文件、参数等的检查
返回值：成功：返回0 ；失败：返回 -1
交易函数：
int BUSINESS_HANDLE( char* inputData,
char* outputData)
输入参数：inputData
输出参数：outputData char*
返回值：成功 =0 失败 <0
输入参数是以“^、$、|”分割的字符串
输出也是以“^、$、|”分割的字符串
参数说明：
入参格式: inputData
业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^动态库参数^
出参格式: outputData char*
中心交易流水号^业务周期号^输出参数^
返回值说明 :
0–成功，表示此次交易请求成功，业务处理也正常
<> 0 －错误，包括系统级别错误（网络、主机、数据库）和业务级别错误，系统级别错误由动态库将错误信息写入输出参数，业务级别错误由后台通过输出参数提示错误信息。

错误输出机制说明 :
Web应用返回给动态库的返回参数格式为：中心交易流水号^业务周期号^输出参数^交易相应码^，动态库接收到返回参数后，根据交易相应码判断交易处理成功与否，交易处理成功，则动态库返回值为0，否则，将交易相应码转换为小于0的返回值。

动态库返回给开发商的出参，去掉交易相应码
交易流水号说明：
说明：交易流水号必须是每一次交易的唯一标识，在整个系统中是唯一的，因此开发商应严格按照建议规则生成交易流水号
规则：时间(14)+医院编号(8)+流水号(4)，之间用-分隔
例：20060101083030-10011001-0001
业务周期号说明：
说明：医院编号(8)＋操作员编号(最大8位)＋时间(14)+流水号(4)，之间用-分隔
例：10011001-99999999-20060101083030-0001
注：4位流水号可以循环使用
交易编码说明：
3接口交易详细设计
此部分主要对医保接口交易的各具体业务作详细说明。

3.1查询类
3.1.1交易功能
该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括审批信息、封锁信息等的查询业务。

对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。

3.1.2交易设计
3.1.2.1批量数据查询下载
交易说明：批量下载中心目录等基础数据，然后对中心的药品目录和诊疗项目目录在his系统进行对照，
输入参数：
说明：
下载文件的路径为：当前文件绝对路径\YBDLOAD\文件名.txt；文件名的命名规则为：
01：YPML_下载数据开始日期；
02：ZLXM_下载数据开始日期；
03：FWSS_下载数据开始日期；
04：SFXMBM_下载数据开始日期；
05：BZML_下载数据开始日期；
06：SPXX_下载数据开始日期；
08：BZDE_下载数据开始时间；
药品目录：
诊疗项目目录：
服务设施目录：
⏹费用类别信息：
⏹病种目录：
3.1.2.2医疗费信息汇总
说明：该请求返回医疗费总额和各项费用合计，HIS系统中要进行对帐，先医疗费信息汇总请求，当返回的费用合计与HIS系统中不符时，才有必要发送医疗费用信息查询交易。

输入参数：
3.1.2.3明细对帐请求
输入参数：
3.1.2.4医疗费信息查询（荆门不用）
说明：当汇总医疗费用信息查询结果与HIS不同时，发起该交易，由HIS提供程序进行对帐。

下载文件的路径为：当前文件绝对路径\YBDLOAD\ YLFY_下载数据开始日期.txt
输入参数：
3.1.2.5医疗费用明细信息查询（荆门不用）
当明细对帐结果与HIS不同时，发起该交易，由HIS提供程序进行对帐。

下载文件的路径为：当前文件绝对路径\YBDLOAD\ FYMX_住院流水号.txt。

输入参数：
3.1.2.6医疗待遇封锁信息查询输入参数：
锁，2表示部分封锁，3表示卡封锁。

备注：该交易不需要开发商
3.1.2.7医疗待遇审批信息查询
输入参数：
3.1.2.8住院登记信息查询输入参数：
3.1.2.9身份证号查询
输入参数：
3.1.2.10当天帐户消费查询输入参数：
输出参数：
3.2认证类
3.2.1交易功能
签入签出是为了验证客户端为合法的用户，一台客户端可以正常进行交易处理，必须要签入，不签入不允许交易。

3.2.2交易设计
3.2.2.1签到
输入参数：
无
输出参数:
无
3.2.2.2签退
输入参数：
无
输出参数:
无
3.2.2.3获取中心系统时间
输入参数：
无
输出参数:
中心服务器系统时间，格式为YYYYMMDDHH24MISS。

3.3业务类
3.3.1交易功能
该类交易主要完成参保患者挂号登记、处方上报、结算及撤销结算等的各项业务处理。

3.3.2交易设计
3.3.2.1读卡交易
输入参数：
无。

3.3.2.2居民获取基本信息
备注：
输出参数:同读卡
3.3.2.3修改卡密码
输入参数：
无
备注：新旧密码都由动态库获取，收费端不需要传入参数。

输出参数:
3.3.2.4门诊/住院登记
输入参数：
无
3.3.2.5住院登记修改输入参数：
输出参数:
无
3.3.2.6出院登记
出院登记时需要读卡。

输入参数：
输出参数:
无
3.3.2.7登记撤销输入参数：
无
3.3.2.8登记（挂号）冲正
输入参数：
无
3.3.2.9处方明细上报
说明1：可以同时上传多条处方明细，多条处方间以$分隔。

说明2：门诊随时上传处方，住院可以在摆药时上传，也可以每天晚上自动上传。

3.3.2.10处方明细撤销
说明：不允许开发商为了方便，而在每次上传处方前，先撤销原来的处方，然后重新上传所有的处方。

因为那样中心会产生非常多的垃圾数据。

输出参数:
无
3.3.2.11处方明细删除
说明：。

被撤销交易流水号为空则全部处方删除，否则删除部分处方
输出参数:
无
3.3.2.12处方明细更改
说明：开发商调用前要判断是否已经结算或者是不是甲乙类处方。

输出参数:
无
3.3.2.13费用预结算
说明：费用预结算时，不需要读卡
输入参数：
输出参数:
3.3.2.14费用结算
说明：费用结算时，需要读卡
输出参数:
同预结算
3.3.2.15费用结算撤销
输出参数:无
3.3.2.16费用结算冲正
输出参数:无
3.3.2.17结算单信息查询（荆门不用）
备注：该交易用于查询生成结算单结算明细的信息。

输入参数：
3.3.2.18药店收费预结算（荆门不用）输入参数：
3.3.2.19药店收费结算（荆门不用）输入参数：
输出参数:
同药店收费预结算
3.3.2.20医院审批信息上报
备注：如下述参数中没有相应的审批类别要求则可以添入空值。

输出参数:
无。

3.3.2.21医院审批信息上报撤销
输出参数:
无。

3.3.2.22医院项目对照上报
输出参数:
无。

3.3.2.23医院项目对照上报撤销
输出参数:
无。