吉林省新农合医院接口文件说明

吉林省新农合医院接口文件说明接口改动记录
1通用函数
说明：
返回指定功能的相关信息。

定义：
int funMain (char* inList, char* outList)
参数：
返回：
0 －成功（此0指返回串中的参数returnValue=0）
-1 －失败（此-1指返回串中的参数returnValue=-1，具体错误信息见参数errorMsg）
备注：
A、传入参数串：由HIS开发商组合成串，各参数用|来分隔。

如：我们想要调用“参合人员身份
验证”函数时传入参数串为functionName=getPerson|id=220323010404009901|year=2013，
其中functionName为要调用的函数名，id为农合证号，year为参合年。

[注：分隔符、参数与
等号之间紧密想连，禁止有空格，区分大小写]
B、传出参数串：如returnValue=0|flag=1|year=2013|name=张廷雨|sex=男|errorMsg=成功。

该串可以用getSplitParam函数来解析
举例：String out = getSplitParam (“returnValue=0|flag=1|year=2013|name=张廷雨|sex=男”, “|”, “name”)，则out返回张廷雨
2拆分串
说明：
拆分串，返回串中的参数所对应的值。

定义：
char* getSplitParam (char* strList, char* regex, char* param)
参数：
返回值：
参数所对应的值。

备注：
举例：String out= getSplitParam (“returnValue=0|flag=1|year=2013|name=张廷雨|sex=男”, “|”, “name”)，则out返回张廷雨
3配置文件切换
说明：
针对一家医院对应多医疗机构级别，使用不同配置文件及报销级别及药品目录情况，增加多配置对应不同的机构编码。

定义：
int changeCfg (char* cfg,char* errorMsg)
参数：
返回值：
0 －成功
-1 －失败
备注：
无
4通用函数列表
网络连接测试
函数：netPing
说明：
判断医院-->前置机-->中心数据库的网络是否畅通。

参数：
返回：
备注：
无
参合人员身份验证
函数：getPerson
说明：
返回农合患者的相关信息。

参数：
返回：
备注：
无
读取卡信息
函数：getCard
说明：
读取卡内容，并返回相关信息(可能返回多条)。

参数：
返回：
备注：
无
就诊信息录入
函数：hospitalIn
说明：
录入农合患者就诊时的基本信息。

参数：
返回：
备注：
“门诊住院号（系统唯一）”指门诊/住院/慢性病/单病种/儿童大病直补等它们的号码都不能重复，是主键之一，若有可能有重复的话可自行在后面增加特殊标识区别，如0001MZ，0001ZY。

注1：儿童大病（type＝4）时该串内容为ILLCODE=儿童大病码#MZJZ=1#CHILDNAME=小孩姓名#CHILDSEX=1#CHILDIDCARD=123456789012345678#PHONE=133********
其中儿童大病码为字典中的序号如：ILLCODE=E001001
民政救助MZJZ的值为（0－否，1－是）。

性别：（1－男，2－女，9－其它）
注2：单病种（type＝3）时该串内容为ILLCODE=单病种码
注3：疑难重症（type＝1）时该串内容为ILLCODE=疑难重症码
注4：重大疾病（type＝6）时该串内容为ILLCODE=重大疾病
［备注］该串区分大小写，名=值＃名=值，不能有空格，如名= 值。

✧就诊信息修改
函数：hospitalModify
说明：
修改农合患者就诊时的基本信息。

参数：
返回：
备注：
无
✧疾病信息录入
函数：addDisease
说明：
录入农合患者的ICD疾病相关信息。

参数：
返回：
备注：
疾病信息只保留一条，录入新的疾病信息则删除旧疾病信息。

药品处方录入
函数：addDrug
说明：
录入农合患者的药品处方相关信息。

参数：
返回：
备注：
“流水号（主键）”指因药品与诊疗项目在一张表中，则要保证药品中的流水号与诊疗项目中的流水号没有重复值。

lclj－临床路径（1-路径内，2-路径外）：单病种必录项，路径外为自付部分。

诊疗项目录入
函数：addDiagnosis
说明：
录入农合患者的诊疗项目相关信息。

参数：
返回：
备注：
“流水号（主键）”指因药品与诊疗项目在一张表中，则要保证药品中的流水号与诊疗项目中的流水号没有重复值。

lclj－临床路径（1-路径内，2-路径外）：单病种必录项，路径外为自付部分。

删除上传处方
函数：delRx
说明：
删除上传处方信息。

参数：
返回：
备注：
无。

上传处方汇总
函数：preExpenseBill
说明：
已上传处方相关费用汇总（该费用并非是最后给农民报销的农合补偿费用）。

参数：
返回：
备注：
无
出院登记
函数：hospitalOut
说明：
录入参合人员出院时的信息。

参数：
返回：
备注：
无。

出院结算
函数：expenseBill
说明：
对农合患者住院费用打上结算标识，以便进行农合补偿。

参数：
返回：
备注：
无
出院反结算
函数：unExpenseBill
说明：
农合患者住院费用打上结算标识后发现错误进行反操作，取消本次结算操作。

参数：
备注：
无
删除就诊信息
函数：delInfo
说明：
删除农合患者的所有就诊信息。

参数：
备注：
无
药品字典对照信息上传
函数：drugRelation
说明：
医院可报销药品与省药品目录对照关系上传。

参数：
返回：
备注：
无
药品字典对照信息删除
函数：drugRelationDel
说明：
删除医院可报销药品与省药品目录对照关系。

参数：
返回：
备注：
无
诊疗项目字典对照信息上传
函数：diagnosisRelation
说明：
医院可报销诊疗项目与省诊疗项目目录对照关系上传。

参数：
返回：
备注：
无
诊疗项目字典对照信息删除
函数：diagnosisRelationDel
说明：
删除医院可报销诊疗项目与省诊疗项目目录对照关系。

参数：
返回：
备注：
无
协议医师信息
函数：getDoctor
说明：
返回协议医师相关信息。

参数：
返回：
备注：
无
历史就诊信息
函数：getHisForJz
说明：
返回某年历史就诊相关信息。

参数：
返回：
备注：
该函数只有前置机用户可用（住院）。

儿童大病直补
函数：childIllReimburse
说明：
省农合网上直接进行儿童大病直补。

参数：
返回：
备注：
无
DLL文件说明：
1、DLL文件起名为：XNHinterface.dll。

2、配置文件起名为：XNHinterface.ini。

内容有三，1）医院编码2）前置机或服务器IP地
址3）端口号。

3、DLL文件中各函数的参数值规定：
字符型参数（以就诊信息录入与修改函数中的转诊单号为例）:
1）有具体值：referralCode=201012040001
2）无值：referralCode=
［注意］不要写成referralCode='' 也不要写成referralCode=""
数值型参数（以出院信息录入中的住院天数为例）
1）有具体值：dayNum=10
2）无值：dayNum=0
4、必录参数不允许为空，为空时返回详细错误信息，如：参合人员身份验证函数中的参数参
合人员编码为必录项，不允许为空。

5、各参数长度不允许超过指定长度。

6、参数不能超过系统指定的范围，比如说就诊信息添加/修改函数中的参数类别指定范围为
［0，1，2，3，4］，则HIS开发商传进的参数只能是这几个值中的一个，而不能传入［5］等不在指定范围内的值。

7、各参数之间的有相互关联关系的必须保证关系正确性。

比如说药品录入函数中的参数药品
类别＝3（中草药）时，则参数中草药处方类别必须录入［1或2］，不能为空，并给出详细错误信息提示。