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

更新时间:2024-05-14 17:47:01 阅读量: 综合文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

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

接口改动记录

改动日期 2014-11-19 修改人 Lag 修改内容 1、【就诊信息录入】函数增加新参数 :patient患者标识,bedNo:床号,去掉flag参数,去掉deptName参数 2、【参合人员身份验证】与【读取卡信息】函数增加新返回参数: mzMoney ->门诊当年已补偿金额 cyMoney->其中村医当年已补偿金额 mzIsTop ->门诊是否封顶(1-未封顶,2-已封顶) mbMoney ->慢病当年已补偿金额 mbIsTop ->慢病是否封顶(1-未封顶,2-已封顶) zyMoney ->住院当年已补偿金额 zyIsTop ->住院是否封顶(1-未封顶,2-已封顶) 3、增加新函数【就诊信息修改】 4、增加新函数【删除上传处方】 5、简化疾病信息录入函数

1通用函数

说明:

返回指定功能的相关信息。

定义:

int funMain (char* inList, char* outList)

参数:

NO 1 2 参数名称 inList outList 类型 char* char* 长度 2000 传入参数串 2000 传出参数串 参数描述 In/Out In Out 必填 是 否 返回:

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)

参数:

NO 1 2 3 参数名称 strList regex param 类型 char* char* char* 长度 参数描述 In/Out In In In 必填 是 是 是 2000 要拆分的串 10 20 分隔符 参数 返回值:

参数所对应的值。

备注:

举例:String out = getSplitParam (“returnValue=0|flag=1|year=2013|name=张廷雨|sex=男”, “|”, “name”),则out返回 张廷雨

3配置文件切换

说明:

针对一家医院对应多医疗机构级别,使用不同配置文件及报销级别及药品目录情况,增加多配置对应不同的机构编码。

定义:

int changeCfg (char* cfg, char* errorMsg)

参数:

NO 1 2 参数名称 cfg errorMsg 类型 char* char * 长度 20 称。例如[config] 256 出错信息 Out 否 参数描述 配置项名称,ini文件中大标题名In 是 In/Out 必填 返回值:

0 - 成功 -1 - 失败

备注:

4通用函数列表

? 网络连接测试

函数:netPing 说明:

判断医院-->前置机-->中心数据库的网络是否畅通。

参数:

NO 参数名称 类型 长度 参数描述 必填 串 functionName=netPing 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 参合人员身份验证

函数:getPerson 说明:

返回农合患者的相关信息。

参数:

NO 1 2 参数名称 id year 类型 char* char* 长度 18 4 农合证号 参合年 参数描述 必填 是 是 串 functionName=getPerson|id=222426080201009909|year=2014 返回:

NO 1 2 3 4 5 6 7 8 9 参数名称 returnValue personNo year flag name sex birthday idCard hMaster 参数描述 返回值(0成功,-1失败) 农合证号 参合年 参合标识(0-未参合,1-参合) 姓名 性别 出生日期 身份证号 与户主关系 所在地区 黑名单标识(0-否,1-是) 黑名单姓名 黑名单身份证 双保双报(0-否,1-是) 伪造违规报销(0-否,1-是) 转借或借用别人参合证件(0-否,1-是) 10 region 11 blackFlag 12 blackName 13 blackIdCard 14 repeat 15 cheat 16 borrow 17 dead 18 mxbList 19 mzMoney 20 cyMoney 21 mzIsTop 22 mbMoney 23 mbIsTop 24 zyMoney 25 zyIsTop 26 errorMsg

死亡(0-否,1-是) 慢性病字符串(包括慢性病大类码与名,多条用#分隔) 门诊当年已补偿金额 其中村医当年已补偿金额 门诊是否封顶(1-未封顶,2-已封顶) 慢病当年已补偿金额 慢病是否封顶(1-未封顶,2-已封顶) 住院当年已补偿金额 住院是否封顶(1-未封顶,2-已封顶) 出错信息 备注:

? 读取卡信息

函数:getCard 说明:

读取卡内容,并返回相关信息(可能返回多条)。

参数:

NO 1 参数名称 year 类型 char* 长度 4 参合年 参数描述 必填 是 串 functionName=getCard|year=2014 返回:

NO 1 2 3 4 5 6 7 8 9 参数名称 returnValue rowNum personNo+记录数 year+记录数 flag+记录数 name+记录数 sex+记录数 birthday+记录数 idCard+记录数 参数描述 返回值(0成功,-1失败) 返回的记录数 农合证号 参合年 参合标识(0-未参合,1-参合) 姓名 性别 出生日期 身份证号 与户主关系 所在地区 黑名单标识(0-否,1-是) 黑名单姓名 黑名单身份证 双保双报(0-否,1-是) 伪造违规报销(0-否,1-是) 10 hMaster+记录数 11 region+记录数 12 blackFlag+记录数 13 blackName+记录数 14 blackIdCard+记录数 15 repeat+记录数 16 cheat+记录数 17 borrow+记录数 18 dead+记录数 19 mxbList+记录数 转借或借用别人参合证件(0-否,1-是) 死亡(0-否,1-是) 慢性病字符串(包括慢性病大类码与名,多条用#分隔) 20 mzMoney+记录数 21 mzIsTop+记录数 22 mbMoney+记录数 23 mbIsTop+记录数 24 zyMoney+记录数 25 zyIsTop+记录数 26 errorMsg 门诊当年已补偿金额 门诊是否封顶(1-未封顶,2-已封顶) 慢病当年已补偿金额 慢病是否封顶(1-未封顶,2-已封顶) 住院当年已补偿金额 住院是否封顶(1-未封顶,2-已封顶) 出错信息 returnValue=0|rowNum=2|personNo1=222426080201009909|year1=2014|flag1=1|name1=姓名|sex1=男|birthday1=19611220|idCard1=123456789101213141|hMaster1=本人或例 户主|region1=伊通满族自治县|blackFlag1=1|blackName1=黑名单姓名|blackIdCard1=|repeat1=1|cheat1=1|borrow1=0|dead1=0|mxbList1=M000001-高血压(Ⅱ、Ⅲ期)#T000004-白血病|personNo2=.....|errorMsg=成功

备注:

? 就诊信息录入

函数:hospitalIn 说明:

录入农合患者就诊时的基本信息。

参数:

NO 参数名称 类型 长度 参数描述 就诊类别(0-门诊,1-普通住院,2-慢性病,1 type char* 1 3-单病种,4-儿童大病,6-重大疾病,8-外伤) 2 3 4 5 6 7 8 9 id patient char* char* 20 1 2->母婴同院) referralCode char* personNo deptID inDate diagnose doctor char* char* char* char* char* char* char* char* char* char* 20 18 20 8 转诊单号 农合人员编码 农合科室编码(见省字典表) 就诊日期(yyyymmdd) 否 是 是 是 否 是 否 否 否 否 否 门诊住院号(系统唯一) 患者标识(0->正常,1->14周岁及以下儿童,否 是 是 必填 100 临床诊断 20 20 经治医生(这里输协议医师身份证号) 床位号 10 bedNo 11 typeExtend 12 opID 13 opName 14 opTime 256 特殊标识串(名=值,用#分隔,详见注1) 20 20 20 操作员编码 操作员姓名 操作时间(yyyymmdd hh:mm:ss) 串 functionName=hospitalIn|type=1|.....|opTime=20130303 12:12:23 返回:

NO 参数名称 参数描述

1 2

returnValue errorMsg 返回值(0成功,-1失败) 出错信息 备注:

“门诊住院号(系统唯一)”指门诊/住院/慢性病/单病种/儿童大病直补等它们的号码都不能重复,是主键之一,若有可能有重复的话可自行在后面增加特殊标识区别,如0001MZ,0001ZY。 注1:儿童大病(type=4)时该串内容为 ILLCODE=儿童大病码#MZJZ=1#CHILDNAME=小孩姓名#CHILDSEX=1#CHILDIDCARD=123456789012345678#PHONE=13309880101 其中儿童大病码为字典中的序号如:ILLCODE=E001001

民政救助MZJZ的值为(0-否,1-是)。 性别:(1-男,2-女,9-其它)

注2:单病种(type=3)时该串内容为 ILLCODE=单病种码 注3:疑难重症(type=1)时该串内容为 ILLCODE=疑难重症码 注4:重大疾病(type=6)时该串内容为 ILLCODE=重大疾病

[备注]该串区分大小写,名=值#名=值,不能有空格,如名 = 值。

? 就诊信息修改

函数:hospitalModify 说明:

修改农合患者就诊时的基本信息。

参数:

NO 1 2 3 4 5 参数名称 id deptID diagnose doctor bedNo 类型 char* char* char* char* char* 长度 20 20 门诊住院号 农合科室编码(见省字典表) 参数描述 必填 是 否 否 否 否 100 临床诊断 20 20 经治医生(这里输协议医师身份证号) 床位号 串 functionName=hospitalModify|id=001|.....|bedNo=201-1 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 疾病信息录入

函数:addDisease 说明:

录入农合患者的ICD疾病相关信息。

参数:

NO 1 2 3 4 5 6 id icdCode illMbClass opID opName opTime 参数名称 类型 char* char* char* char* char* char* 长度 20 20 20 20 20 20 门诊住院号 ICD编码 慢病大类码 操作员编码 操作员姓名 操作时间(yyyymmdd hh:mm:ss) 参数描述 必填 是 是 否/是 否 否 否 串 functionName=addDisease|id=7872015MZ|.....|opTime=20130303 12:12:23 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

疾病信息只保留一条,录入新的疾病信息则删除旧疾病信息。

? 药品处方录入

函数:addDrug 说明:

录入农合患者的药品处方相关信息。

参数:

NO 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 id 参数名称 类型 char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* char* 长度 20 10 1 参数描述 门诊住院号(主键) 流水号(主键) 药品类别(1-西药,2-中成药,3-必填 是 是 是 xh type cfDate cfNO billNO hisNO hisName hisCd hisPzwh hisJx hisJl hisPc hisGe hisDw hisBz hisHl hisZxts hisZycflb lclj unitPrice quantity amount opID opName opTime 中草药,4-院内制剂) 8 20 20 20 100 60 20 20 20 40 20 20 20 20 1 [中草药必录] 1 20 20 20 临床路径(1-路径内,2-路径外) 单价 数量 金额 操作员编码 操作员姓名 操作时间(yyyymmdd hh:mm:ss) 否/是 是 是 是 否 否 否 处方日期(yyyymmdd) 处方号 单据号 医院药品编码 医院药品名称 医院药品产地或厂家 医院药品批准文号 医院药品剂型 医院药品剂量 医院药品频次 医院药品规格 医院药品单位 医院药品包装 医院药品含量 医院药品执行天数 中草药处方类别(1-单味,2-复方)否/是 是 否 否 是 是 否 否 否 否 否 否 否 否 否 否 串 functionName=addDrug|id=7872015MZ|.....|opTime=20130303 12:12:23 返回:

NO 1 2 3 4 5 6 7 8 9 参数名称 returnValue nhNO nhName nhJx charge errFlag errMsg bxbl kbcje 参数描述 返回值(0成功,-1失败) 农合编码 农合名称 农合剂型 收费类别 错误标识(0-错误,1-正确) 错误信息 报销比例(%) 可补偿金额 不可补偿金额 出错信息 10 bkbcje 11 errorMsg

备注:

“流水号(主键)”指因药品与诊疗项目在一张表中,则要保证药品中的流水号与诊疗项目中的流水号没有重复值。

lclj-临床路径(1-路径内,2-路径外):单病种必录项,路径外为自付部分。

? 诊疗项目录入

函数:addDiagnosis 说明:

录入农合患者的诊疗项目相关信息。

参数:

NO 1 2 3 4 5 6 7 8 9 10 11 12 13 14 id 参数名称 类型 char* char* char* char* char* char* char* char* char* char* char* char* char* char* 长度 20 8 20 20 20 100 1 20 20 20 参数描述 门诊住院号(主键) 流水号(主键) 处方日期(yyyymmdd) 处方号 单据号 医院诊疗项目编码 医院诊疗项目名称 临床路径(1-路径内,2-路径外) 单价 数量 金额 操作员编码 操作员姓名 操作时间(yyyymmdd hh:mm:ss) 必填 是 是 是 否 否 是 是 否/是 是 是 是 否 否 否 xh cfDate cfNO billNO hisNO hisName lclj unitPrice quantity amount opID opName opTime 串 functionName=addDiagnosis|id=7872015MZ|..|opTime=20130303 12:12:23 返回:

NO 1 2 3 4 5 6 7 8 9 参数名称 returnValue nhNO nhName charge limit errFlag errMsg bxbl kbcje 参数描述 返回值(0成功,-1失败) 农合编码 农合名称 收费类别 限价标识(0-限价,1-不限价) 错误标识(0-错误,1-正确) 错误信息 报销比例(%) 可补偿金额 不可补偿金额 限价金额 10 bkbcje 11 limitje 12 errorMsg

出错信息 备注:

“流水号(主键)”指因药品与诊疗项目在一张表中,则要保证药品中的流水号与诊疗项目中的流水号没有重复值。

lclj-临床路径(1-路径内,2-路径外):单病种必录项,路径外为自付部分。

? 删除上传处方

函数:delRx 说明:

删除上传处方信息。

参数:

NO 1 2 id xh 参数名称 类型 char* char* 长度 20 门诊住院号 流水号 参数描述 必填 是 是 串 functionName=delRx|id=7872015ZY|xh=5 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

无。

? 上传处方汇总

函数:preExpenseBill 说明:

已上传处方相关费用汇总(该费用并非是最后给农民报销的农合补偿费用)。

参数:

NO 1 参数名称 id 类型 char* 长度 20 门诊住院号 参数描述 必填 是 串 functionName=preExpenseBill|id=7872015ZY 返回:

NO 1 2 3 4 5 6 7 8 9 参数名称 returnValue recordAll costAll costAllDrug costAllDiagnosis costAllMaterial costAllEnable costAllDrugEnable costAllDiagnosisEnable 参数描述 返回值(0成功,-1失败) 上传处方总记录数 医疗费用总额 其中:药品费用总额 诊疗项目费用总额 其中:卫材费用总额 农合目录内费用总额 其中:药品费用总额 诊疗项目费用总额 其中:卫材费用总额 出错信息 10 costAllMaterialEnable 11 errorMsg

备注:

? 出院登记

函数:hospitalOut 说明:

录入参合人员出院时的信息。

参数:

NO 1 2 3 id 参数名称 类型 char* char* char* 长度 20 8 门诊住院号 参数描述 必填 是 是 否 outDate dayNum 出院日期(yyyymmdd) 住院天数 串 functionName=hospitalOut|id=7872015ZY|outDate=20130403|dayNum=5 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

无。

? 出院结算

函数:expenseBill 说明:

对农合患者住院费用打上结算标识,以便进行农合补偿。

参数:

NO 1 参数名称 id 类型 char* 长度 20 门诊住院号 参数描述 必填 是

串 functionName=expenseBill|id=7872015ZY 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 出院反结算

函数:unExpenseBill 说明:

农合患者住院费用打上结算标识后发现错误进行反操作,取消本次结算操作。

参数:

NO 1 参数名称 id 类型 char* 长度 20 门诊住院号 参数描述 必填 是 串 functionName=unExpenseBill|id=7872015ZY 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 删除就诊信息

函数:delInfo 说明:

删除农合患者的所有就诊信息。

参数:

NO 1 参数名称 id 类型 char* 长度 20 门诊住院号 参数描述 必填 是 串 functionName=delInfo|id=7872015ZY 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 药品字典对照信息上传

函数:drugRelation 说明:

医院可报销药品与省药品目录对照关系上传。

参数:

NO 1 2 参数名称 hisNO hisName 类型 char* char* 长度 20 100 参数描述 医院药品编码 医院药品名称 必填 是 是 3 4 5 6 7 8 9 10 11 12 hisCd hisPzwh hisJx hisGg hisDw hisBz hisHl nhNO nhName nhJx char* char* char* char* char* char* char* char* char* char* 60 20 20 20 20 20 20 20 100 60 医院药品产地或厂家 医院药品批准文号 医院药品剂型 医院药品规格 医院药品单位 医院药品包装 医院药品含量 农合药品编码 农合药品名称 农合剂型 否 否 否 否 否 否 否 是 是 否 串 functionName=drugRelation|hisNO=10001|...|nhJx=片剂 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 药品字典对照信息删除

函数:drugRelationDel 说明:

删除医院可报销药品与省药品目录对照关系。

参数:

NO 1 参数名称 hisNO 类型 char* 长度 20 参数描述 医院药品编码 必填 是 串 functionName=drugRelationDel|hisNO=10001 返回:

NO 1 2

参数名称 returnValue errorMsg 参数描述 返回值(0成功,-1失败) 出错信息 备注:

? 诊疗项目字典对照信息上传

函数:diagnosisRelation 说明:

医院可报销诊疗项目与省诊疗项目目录对照关系上传。

参数:

NO 参数名称 类型 长度 参数描述 必填

2)无值:dayNum=0 4、必录参数不允许为空,为空时返回详细错误信息,如:参合人员身份验证 函数中的参数 参

合人员编码 为必录项,不允许为空。 5、各参数长度不允许超过指定长度。

6、参数不能超过系统指定的范围,比如说就诊信息添加/修改函数中的参数类别指定范围为

[0,1,2,3,4],则HIS开发商传进的参数只能是这几个值中的一个,而不能传入[5]等不在指定范围内的值。

7、各参数之间的有相互关联关系的必须保证关系正确性。比如说药品录入函数中的参数药品

类别=3(中草药)时,则参数中草药处方类别必须录入[1或2],不能为空,并给出详细错误信息提示。

本文来源:https://www.bwwdw.com/article/11z7.html

Top