吉林省新农合医院接口文件说明模板.doc

精品文档吉林省新农合医院接口文件说明接口改动记录改动日期修改人修改内容2014-11-19Lag1、【就诊信息录入】函数增加新参数 ：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参数名称类型长度参数描述In/Out必填1inListchar*2000传入参数串In是2outListchar*2000传出参数串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参数名称类型长度参数描述In/Out必填1strListchar*2000要拆分的串In是2regexchar*10分隔符In是3paramchar*20参数In是返回值：参数所对应的值。备注：举例：String out = getSplitParam (“returnValue=0|flag=1|year=2013|name=张廷雨|sex=男”, “|”, “name”)，则out返回 张廷雨3配置文件切换说明：针对一家医院对应多医疗机构级别，使用不同配置文件及报销级别及药品目录情况，增加多配置对应不同的机构编码。定义：int changeCfg (char* cfg, char* errorMsg)参数： NO参数名称类型长度参数描述In/Out必填1cfgchar*20配置项名称，ini文件中大标题名称。例如configIn是2errorMsgchar *256出错信息Out否返回值：0 成功 -1 失败备注： 无4通用函数列表 网络连接测试函数：netPing说明：判断医院-前置机-中心数据库的网络是否畅通。参数：NO参数名称类型长度参数描述必填串functionName=netPing返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 参合人员身份验证函数：getPerson说明：返回农合患者的相关信息。参数：NO参数名称类型长度参数描述必填1idchar*18农合证号是2yearchar*4参合年是串functionName=getPerson|id=222426080201009909|year=2014返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2personNo农合证号3year参合年4flag参合标识（0-未参合，1-参合）5name姓名6sex性别7birthday出生日期8idCard身份证号9hMaster与户主关系10region所在地区11blackFlag黑名单标识（0-否，1-是）12blackName黑名单姓名13blackIdCard黑名单身份证14repeat双保双报（0-否，1-是）15cheat伪造违规报销（0-否，1-是）16borrow转借或借用别人参合证件（0-否，1-是）17dead死亡（0-否，1-是）18mxbList慢性病字符串（包括慢性病大类码与名，多条用#分隔）19mzMoney门诊当年已补偿金额20cyMoney其中村医当年已补偿金额21mzIsTop门诊是否封顶（1-未封顶,2-已封顶）22mbMoney慢病当年已补偿金额23mbIsTop慢病是否封顶（1-未封顶,2-已封顶）24zyMoney住院当年已补偿金额25zyIsTop住院是否封顶（1-未封顶,2-已封顶）26errorMsg出错信息备注：无 读取卡信息函数：getCard说明：读取卡内容，并返回相关信息(可能返回多条)。参数：NO参数名称类型长度参数描述必填1yearchar*4参合年是串functionName=getCard|year=2014返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2rowNum返回的记录数3personNo+记录数农合证号4year+记录数参合年5flag+记录数参合标识（0-未参合，1-参合）6name+记录数姓名7sex+记录数性别8birthday+记录数出生日期9idCard+记录数身份证号10hMaster+记录数与户主关系11region+记录数所在地区12blackFlag+记录数黑名单标识（0-否，1-是）13blackName+记录数黑名单姓名14blackIdCard+记录数黑名单身份证15repeat+记录数双保双报（0-否，1-是）16cheat+记录数伪造违规报销（0-否，1-是）17borrow+记录数转借或借用别人参合证件（0-否，1-是）18dead+记录数死亡（0-否，1-是）19mxbList+记录数慢性病字符串（包括慢性病大类码与名，多条用#分隔）20mzMoney+记录数门诊当年已补偿金额21mzIsTop+记录数门诊是否封顶（1-未封顶,2-已封顶）22mbMoney+记录数慢病当年已补偿金额23mbIsTop+记录数慢病是否封顶（1-未封顶,2-已封顶）24zyMoney+记录数住院当年已补偿金额25zyIsTop+记录数住院是否封顶（1-未封顶,2-已封顶）26errorMsg出错信息例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参数名称类型长度参数描述必填1typechar*1就诊类别（0-门诊，1-普通住院，2-慢性病，3-单病种，4-儿童大病，6-重大疾病，8-外伤）是2idchar*20门诊住院号（系统唯一）是3patientchar*1患者标识（0-正常，1-14周岁及以下儿童，2-母婴同院）否4referralCodechar*20转诊单号否5personNochar*18农合人员编码是6deptIDchar*20农合科室编码（见省字典表）是7inDatechar*8就诊日期（yyyymmdd）是8diagnosechar*100临床诊断否9doctorchar*20经治医生(这里输协议医师身份证号)是10bedNochar*20床位号否11typeExtendchar*256特殊标识串（名=值，用#分隔，详见注1）否12opIDchar*20操作员编码否13opNamechar*20操作员姓名否14opTimechar*20操作时间（yyyymmdd hh:mm:ss）否串functionName=hospitalIn|type=1|.|opTime=20130303 12:12:23返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：“门诊住院号（系统唯一）”指门诊/住院/慢性病/单病种/儿童大病直补等它们的号码都不能重复，是主键之一，若有可能有重复的话可自行在后面增加特殊标识区别，如0001MZ，0001ZY。注1：儿童大病（type4）时该串内容为 ILLCODE=儿童大病码#MZJZ=1#CHILDNAME=小孩姓名#CHILDSEX=1#CHILDIDCARD=123456789012345678#PHONE其中儿童大病码为字典中的序号如：ILLCODE=E001001民政救助MZJZ的值为（0否，1是）。性别：（1男，2女，9其它） 注2：单病种（type3）时该串内容为 ILLCODE=单病种码注3：疑难重症（type1）时该串内容为 ILLCODE=疑难重症码注4：重大疾病（type6）时该串内容为 ILLCODE=重大疾病备注该串区分大小写，名=值名=值，不能有空格，如名 = 值。 就诊信息修改函数：hospitalModify说明：修改农合患者就诊时的基本信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是2deptIDchar*20农合科室编码（见省字典表）否3diagnosechar*100临床诊断否4doctorchar*20经治医生(这里输协议医师身份证号)否5bedNochar*20床位号否串functionName=hospitalModify|id=001|.|bedNo=201-1返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 疾病信息录入函数：addDisease说明：录入农合患者的ICD疾病相关信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是2icdCodechar*20ICD编码是3illMbClasschar*20慢病大类码否/是4opIDchar*20操作员编码否5opNamechar*20操作员姓名否6opTimechar*20操作时间（yyyymmdd hh:mm:ss）否串functionName=addDisease|id=7872015MZ|.|opTime=20130303 12:12:23返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：疾病信息只保留一条，录入新的疾病信息则删除旧疾病信息。 药品处方录入函数：addDrug说明：录入农合患者的药品处方相关信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号（主键）是2xhchar*10流水号（主键）是3typechar*1药品类别（1-西药，2-中成药，3-中草药，4-院内制剂）是4cfDatechar*8处方日期（yyyymmdd）是5cfNOchar*20处方号否6billNOchar*20单据号否7hisNOchar*20医院药品编码是8hisNamechar*100医院药品名称是9hisCdchar*60医院药品产地或厂家否10hisPzwhchar*20医院药品批准文号否11hisJxchar*20医院药品剂型否12hisJlchar*20医院药品剂量否13hisPcchar*40医院药品频次否14hisGechar*20医院药品规格否15hisDwchar*20医院药品单位否16hisBzchar*20医院药品包装否17hisHlchar*20医院药品含量否18hisZxtschar*医院药品执行天数否19hisZycflbchar*1中草药处方类别(1-单味,2-复方)中草药必录否/是20lcljchar*1临床路径（1-路径内，2-路径外）否/是21unitPricechar*单价是22quantitychar*数量是23amountchar*金额是24opIDchar*20操作员编码否25opNamechar*20操作员姓名否26opTimechar*20操作时间（yyyymmdd hh:mm:ss）否串functionName=addDrug|id=7872015MZ|.|opTime=20130303 12:12:23返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2nhNO农合编码3nhName农合名称4nhJx农合剂型5charge收费类别6errFlag错误标识（0-错误,1-正确）7errMsg错误信息8bxbl报销比例（）9kbcje可补偿金额10bkbcje不可补偿金额11errorMsg出错信息备注：“流水号（主键）”指因药品与诊疗项目在一张表中，则要保证药品中的流水号与诊疗项目中的流水号没有重复值。lclj临床路径（1-路径内，2-路径外）：单病种必录项，路径外为自付部分。 诊疗项目录入函数：addDiagnosis说明：录入农合患者的诊疗项目相关信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号（主键）是2xhchar*流水号（主键）是3cfDatechar*8处方日期（yyyymmdd）是4cfNOchar*20处方号否5billNOchar*20单据号否6hisNOchar*20医院诊疗项目编码是7hisNamechar*100医院诊疗项目名称是8lcljchar*1临床路径（1-路径内，2-路径外）否/是9unitPricechar*单价是10quantitychar*数量是11amountchar*金额是12opIDchar*20操作员编码否13opNamechar*20操作员姓名否14opTimechar*20操作时间（yyyymmdd hh:mm:ss）否串functionName=addDiagnosis|id=7872015MZ|.|opTime=20130303 12:12:23返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2nhNO农合编码3nhName农合名称4charge收费类别5limit限价标识（0-限价,1-不限价）6errFlag错误标识（0-错误,1-正确）7errMsg错误信息8bxbl报销比例（）9kbcje可补偿金额10bkbcje不可补偿金额11limitje限价金额12errorMsg出错信息备注：“流水号（主键）”指因药品与诊疗项目在一张表中，则要保证药品中的流水号与诊疗项目中的流水号没有重复值。lclj临床路径（1-路径内，2-路径外）：单病种必录项，路径外为自付部分。 删除上传处方函数：delRx说明：删除上传处方信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是2xhchar*流水号是串functionName=delRx|id=7872015ZY|xh=5返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无。 上传处方汇总函数：preExpenseBill说明：已上传处方相关费用汇总（该费用并非是最后给农民报销的农合补偿费用）。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是串functionName=preExpenseBill|id=7872015ZY返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2recordAll上传处方总记录数3costAll医疗费用总额4costAllDrug其中：药品费用总额5costAllDiagnosis 诊疗项目费用总额6costAllMaterial 其中：卫材费用总额7costAllEnable农合目录内费用总额8costAllDrugEnable其中：药品费用总额9costAllDiagnosisEnable 诊疗项目费用总额10costAllMaterialEnable 其中：卫材费用总额11errorMsg出错信息备注：无 出院登记函数：hospitalOut说明：录入参合人员出院时的信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是2outDatechar*8出院日期（yyyymmdd）是3dayNumchar*住院天数否串functionName=hospitalOut|id=7872015ZY|outDate=20130403|dayNum=5返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无。 出院结算函数：expenseBill说明：对农合患者住院费用打上结算标识，以便进行农合补偿。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是串functionName=expenseBill|id=7872015ZY返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 出院反结算函数：unExpenseBill说明：农合患者住院费用打上结算标识后发现错误进行反操作，取消本次结算操作。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是串functionName=unExpenseBill|id=7872015ZY返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 删除就诊信息函数：delInfo说明：删除农合患者的所有就诊信息。参数：NO参数名称类型长度参数描述必填1idchar*20门诊住院号是串functionName=delInfo|id=7872015ZY返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 药品字典对照信息上传函数：drugRelation说明：医院可报销药品与省药品目录对照关系上传。参数：NO参数名称类型长度参数描述必填1hisNOchar*20医院药品编码是2hisNamechar*100医院药品名称是3hisCdchar*60医院药品产地或厂家否4hisPzwhchar*20医院药品批准文号否5hisJxchar*20医院药品剂型否6hisGgchar*20医院药品规格否7hisDwchar*20医院药品单位否8hisBzchar*20医院药品包装否9hisHlchar*20医院药品含量否10nhNOchar*20农合药品编码是11nhNamechar*100农合药品名称是12nhJxchar*60农合剂型否串functionName=drugRelation|hisNO=10001|.|nhJx=片剂返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 药品字典对照信息删除函数：drugRelationDel说明：删除医院可报销药品与省药品目录对照关系。参数：NO参数名称类型长度参数描述必填1hisNOchar*20医院药品编码是串functionName=drugRelationDel|hisNO=10001返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 诊疗项目字典对照信息上传函数：diagnosisRelation说明：医院可报销诊疗项目与省诊疗项目目录对照关系上传。参数：NO参数名称类型长度参数描述必填1hisNOchar*20医院诊疗项目编码是2hisNamechar*100医院诊疗项目名称是3nhNOchar*20农合诊疗项目编码是4nhNamechar*100农合诊疗项目名称是串functionName=diagnosisRelation|hisNO=10001|.|nhName=X光返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 诊疗项目字典对照信息删除函数：diagnosisRelationDel说明：删除医院可报销诊疗项目与省诊疗项目目录对照关系。参数：NO参数名称类型长度参数描述必填1hisNOchar*20医院诊疗项目编码是串functionName=diagnosisRelationDel|hisNO=10001返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2errorMsg出错信息备注：无 协议医师信息函数：getDoctor说明：返回协议医师相关信息。参数：NO参数名称类型长度参数描述必填1idchar*18身份证号是串functionName=getDoctor|id=123456789012345678返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2name姓名3sex性别4duty专业技术职务资格5jobType执业资格类别6shFlag审核标记（0-未审，1-已审）7status医师状态8beginDate协议起始日期9endDate协议截止日期10blackDateScope黑名单日期范围（多条用#分隔）11errorMsg出错信息备注：无 历史就诊信息函数：getHisForJz说明：返回某年历史就诊相关信息。参数：NO参数名称类型长度参数描述必填1idchar*18农合证号是2yearchar*4就诊年是串functionName=getHisForJz|id=222426080201009909|year=2013返回：NO参数名称参数描述1returnValue返回值（0成功，-1失败）2rowNum返回的记录数3hospital+记录数就诊医院4inDate+记录数入院日期5outDate+记录数出院日期6diagnose+记录数临床诊断7icd+记录数ICD码8icdName+记录数ICD名称9errorMsg出错信息例returnValue=0|rowNum=2|hospital1=就诊医院|inDate1=20130405|outDa