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

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

接口改动记录
改动日期
修改人
修改内容
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
参数名称
类型
长度
参数描述
In/Out
必填
1
inList
char*
2000
传入参数串
In
是
2
outList
char*
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
必填
1
strList
char*
2000
要拆分的串
In
是
2
regex
char*
10
分隔符
In
是
3
param
char*
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
必填
1
cfg
char*
20
配置项名称，ini文件中大标题名称。例如[config]
In
是
2
errorMsg
char *
256
出错信息
Out
否
返回值：
0 － 成功
-1 － 失败
备注：

无

4通用函数列表
² 网络连接测试
函数：netPing
说明：
判断医院-->前置机-->中心数据库的网络是否畅通。
参数：
NO
参数名称
类型
长度
参数描述
必填
串
functionName=netPing
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 参合人员身份验证
函数：getPerson
说明：
返回农合患者的相关信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
18
农合证号
是
2
year
char*
4
参合年
是
串
functionName=getPerson|id=222426080201009909|year=2014
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
personNo
农合证号
3
year
参合年
4
flag
参合标识（0-未参合，1-参合）
5
name
姓名
6
sex
性别
7
birthday
出生日期
8
idCard
身份证号
9
hMaster
与户主关系
10
region
所在地区
11
blackFlag
黑名单标识（0-否，1-是）
12
blackName
黑名单姓名
13
blackIdCard
黑名单身份证
14
repeat
双保双报（0-否，1-是）
15
cheat
伪造违规报销（0-否，1-是）
16
borrow
转借或借用别人参合证件（0-否，1-是）
17
dead
死亡（0-否，1-是）
18
mxbList
慢性病字符串（包括慢性病大类码与名，多条用#分隔）
19
mzMoney
门诊当年已补偿金额
20
cyMoney
其中村医当年已补偿金额
21
mzIsTop
门诊是否封顶（1-未封顶,2-已封顶）
22
mbMoney
慢病当年已补偿金额
23
mbIsTop
慢病是否封顶（1-未封顶,2-已封顶）
24
zyMoney
住院当年已补偿金额
25
zyIsTop
住院是否封顶（1-未封顶,2-已封顶）
26
errorMsg
出错信息

备注：
无

² 读取卡信息
函数：getCard
说明：
读取卡内容，并返回相关信息(可能返回多条)。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
year
char*
4
参合年
是
串
functionName=getCard|year=2014
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
rowNum
返回的记录数
3
personNo+记录数
农合证号
4
year+记录数
参合年
5
flag+记录数
参合标识（0-未参合，1-参合）
6
name+记录数
姓名
7
sex+记录数
性别
8
birthday+记录数
出生日期
9
idCard+记录数
身份证号
10
hMaster+记录数
与户主关系
11
region+记录数
所在地区
12
blackFlag+记录数
黑名单标识（0-否，1-是）
13
blackName+记录数
黑名单姓名
14
blackIdCard+记录数
黑名单身份证
15
repeat+记录数
双保双报（0-否，1-是）
16
cheat+记录数
伪造违规报销（0-否，1-是）
17
borrow+记录数
转借或借用别人参合证件（0-否，1-是）
18
dead+记录数
死亡（0-否，1-是）
19
mxbList+记录数
慢性病字符串（包括慢性病大类码与名，多条用#分隔）
20
mzMoney+记录数
门诊当年已补偿金额
21
mzIsTop+记录数
门诊是否封顶（1-未封顶,2-已封顶）
22
mbMoney+记录数
慢病当年已补偿金额
23
mbIsTop+记录数
慢病是否封顶（1-未封顶,2-已封顶）
24
zyMoney+记录数
住院当年已补偿金额
25
zyIsTop+记录数
住院是否封顶（1-未封顶,2-已封顶）
26
errorMsg
出错信息
例
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
参数名称
类型
长度
参数描述
必填
1
type
char*
1
就诊类别（0-门诊，1-普通住院，2-慢性病，3-单病种，4-儿童大病，6-重大疾病，8-外伤）
是
2
id
char*
20
门诊住院号（系统唯一）
是
3
patient
char*
1
患者标识（0->正常，1->14周岁及以下儿童，2->母婴同院）
否
4
referralCode
char*
20
转诊单号
否
5
personNo
char*
18
农合人员编码
是
6
deptID
char*
20
农合科室编码（见省字典表）
是
7
inDate
char*
8
就诊日期（yyyymmdd）
是
8
diagnose
char*
100
临床诊断
否
9
doctor
char*
20
经治医生(这里输协议医师身份证号)
是
10
bedNo
char*
20
床位号
否
11
typeExtend
char*
256
特殊标识串（名=值，用#分隔，详见注1）
否
12
opID
char*
20
操作员编码
否
13
opName
char*
20
操作员姓名
否
14
opTime
char*
20
操作时间（yyyymmdd hh:mm:ss）
否
串
functionName=hospitalIn|type=1|.....|opTime=20130303 12:12:23
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
“门诊住院号（系统唯一）”指门诊/住院/慢性病/单病种/儿童大病直补等它们的号码都不能重复，是主键之一，若有可能有重复的话可自行在后面增加特殊标识区别，如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
id
char*
20
门诊住院号
是
2
deptID
char*
20
农合科室编码（见省字典表）
否
3
diagnose
char*
100
临床诊断
否
4
doctor
char*
20
经治医生(这里输协议医师身份证号)
否
5
bedNo
char*
20
床位号
否
串
functionName=hospitalModify|id=001|.....|bedNo=201-1
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 疾病信息录入
函数：addDisease
说明：
录入农合患者的ICD疾病相关信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
2
icdCode
char*
20
ICD编码
是
3
illMbClass
char*
20
慢病大类码
否/是
4
opID
char*
20
操作员编码
否
5
opName
char*
20
操作员姓名
否
6
opTime
char*
20
操作时间（yyyymmdd hh:mm:ss）
否
串
functionName=addDisease|id=7872015MZ|.....|opTime=20130303 12:12:23
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

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

² 药品处方录入
函数：addDrug
说明：
录入农合患者的药品处方相关信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号（主键）
是
2
xh
char*
10
流水号（主键）
是
3
type
char*
1
药品类别（1-西药，2-中成药，3-中草药，4-院内制剂）
是
4
cfDate
char*
8
处方日期（yyyymmdd）
是
5
cfNO
char*
20
处方号
否
6
billNO
char*
20
单据号
否
7
hisNO
char*
20
医院药品编码
是
8
hisName
char*
100
医院药品名称
是
9
hisCd
char*
60
医院药品产地或厂家
否
10
hisPzwh
char*
20
医院药品批准文号
否
11
hisJx
char*
20
医院药品剂型
否
12
hisJl
char*
20
医院药品剂量
否
13
hisPc
char*
40
医院药品频次
否
14
hisGe
char*
20
医院药品规格
否
15
hisDw
char*
20
医院药品单位
否
16
hisBz
char*
20
医院药品包装
否
17
hisHl
char*
20
医院药品含量
否
18
hisZxts
char*

医院药品执行天数
否
19
hisZycflb
char*
1
中草药处方类别(1-单味,2-复方)［中草药必录］
否/是
20
lclj
char*
1
临床路径（1-路径内，2-路径外）
否/是
21
unitPrice
char*

单价
是
22
quantity
char*

数量
是
23
amount
char*

金额
是
24
opID
char*
20
操作员编码
否
25
opName
char*
20
操作员姓名
否
26
opTime
char*
20
操作时间（yyyymmdd hh:mm:ss）
否
串
functionName=addDrug|id=7872015MZ|.....|opTime=20130303 12:12:23
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
nhNO
农合编码
3
nhName
农合名称
4
nhJx
农合剂型
5
charge
收费类别
6
errFlag
错误标识（0-错误,1-正确）
7
errMsg
错误信息
8
bxbl
报销比例（％）
9
kbcje
可补偿金额
10
bkbcje
不可补偿金额
11
errorMsg
出错信息

备注：
“流水号（主键）”指因药品与诊疗项目在一张表中，则要保证药品中的流水号与诊疗项目中的流水号没有重复值。
lclj－临床路径（1-路径内，2-路径外）：单病种必录项，路径外为自付部分。

² 诊疗项目录入
函数：addDiagnosis
说明：
录入农合患者的诊疗项目相关信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号（主键）
是
2
xh
char*

流水号（主键）
是
3
cfDate
char*
8
处方日期（yyyymmdd）
是
4
cfNO
char*
20
处方号
否
5
billNO
char*
20
单据号
否
6
hisNO
char*
20
医院诊疗项目编码
是
7
hisName
char*
100
医院诊疗项目名称
是
8
lclj
char*
1
临床路径（1-路径内，2-路径外）
否/是
9
unitPrice
char*

单价
是
10
quantity
char*

数量
是
11
amount
char*

金额
是
12
opID
char*
20
操作员编码
否
13
opName
char*
20
操作员姓名
否
14
opTime
char*
20
操作时间（yyyymmdd hh:mm:ss）
否
串
functionName=addDiagnosis|id=7872015MZ|..|opTime=20130303 12:12:23
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
nhNO
农合编码
3
nhName
农合名称
4
charge
收费类别
5
limit
限价标识（0-限价,1-不限价）
6
errFlag
错误标识（0-错误,1-正确）
7
errMsg
错误信息
8
bxbl
报销比例（％）
9
kbcje
可补偿金额
10
bkbcje
不可补偿金额
11
limitje
限价金额
12
errorMsg
出错信息

备注：
“流水号（主键）”指因药品与诊疗项目在一张表中，则要保证药品中的流水号与诊疗项目中的流水号没有重复值。
lclj－临床路径（1-路径内，2-路径外）：单病种必录项，路径外为自付部分。

² 删除上传处方
函数：delRx
说明：
删除上传处方信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
2
xh
char*

流水号
是
串
functionName=delRx|id=7872015ZY|xh=5
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无。

² 上传处方汇总
函数：preExpenseBill
说明：
已上传处方相关费用汇总（该费用并非是最后给农民报销的农合补偿费用）。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
串
functionName=preExpenseBill|id=7872015ZY
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
recordAll
上传处方总记录数
3
costAll
医疗费用总额
4
costAllDrug
其中：药品费用总额
5
costAllDiagnosis
诊疗项目费用总额
6
costAllMaterial
其中：卫材费用总额
7
costAllEnable
农合目录内费用总额
8
costAllDrugEnable
其中：药品费用总额
9
costAllDiagnosisEnable
诊疗项目费用总额
10
costAllMaterialEnable
其中：卫材费用总额
11
errorMsg
出错信息

备注：
无

² 出院登记
函数：hospitalOut
说明：
录入参合人员出院时的信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
2
outDate
char*
8
出院日期（yyyymmdd）
是
3
dayNum
char*

住院天数
否
串
functionName=hospitalOut|id=7872015ZY|outDate=20130403|dayNum=5
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无。

² 出院结算
函数：expenseBill
说明：
对农合患者住院费用打上结算标识，以便进行农合补偿。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
串
functionName=expenseBill|id=7872015ZY
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 出院反结算
函数：unExpenseBill
说明：
农合患者住院费用打上结算标识后发现错误进行反操作，取消本次结算操作。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
串
functionName=unExpenseBill|id=7872015ZY
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 删除就诊信息
函数：delInfo
说明：
删除农合患者的所有就诊信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
串
functionName=delInfo|id=7872015ZY
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 药品字典对照信息上传
函数：drugRelation
说明：
医院可报销药品与省药品目录对照关系上传。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
hisNO
char*
20
医院药品编码
是
2
hisName
char*
100
医院药品名称
是
3
hisCd
char*
60
医院药品产地或厂家
否
4
hisPzwh
char*
20
医院药品批准文号
否
5
hisJx
char*
20
医院药品剂型
否
6
hisGg
char*
20
医院药品规格
否
7
hisDw
char*
20
医院药品单位
否
8
hisBz
char*
20
医院药品包装
否
9
hisHl
char*
20
医院药品含量
否
10
nhNO
char*
20
农合药品编码
是
11
nhName
char*
100
农合药品名称
是
12
nhJx
char*
60
农合剂型
否
串
functionName=drugRelation|hisNO=10001|...|nhJx=片剂
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 药品字典对照信息删除
函数：drugRelationDel
说明：
删除医院可报销药品与省药品目录对照关系。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
hisNO
char*
20
医院药品编码
是
串
functionName=drugRelationDel|hisNO=10001
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 诊疗项目字典对照信息上传
函数：diagnosisRelation
说明：
医院可报销诊疗项目与省诊疗项目目录对照关系上传。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
hisNO
char*
20
医院诊疗项目编码
是
2
hisName
char*
100
医院诊疗项目名称
是
3
nhNO
char*
20
农合诊疗项目编码
是
4
nhName
char*
100
农合诊疗项目名称
是
串
functionName=diagnosisRelation|hisNO=10001|...|nhName=X光
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 诊疗项目字典对照信息删除
函数：diagnosisRelationDel
说明：
删除医院可报销诊疗项目与省诊疗项目目录对照关系。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
hisNO
char*
20
医院诊疗项目编码
是
串
functionName=diagnosisRelationDel|hisNO=10001
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
errorMsg
出错信息

备注：
无

² 协议医师信息
函数：getDoctor
说明：
返回协议医师相关信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
18
身份证号
是
串
functionName=getDoctor|id=123456789012345678
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
name
姓名
3
sex
性别
4
duty
专业技术职务资格
5
jobType
执业资格类别
6
shFlag
审核标记（0-未审，1-已审）
7
status
医师状态
8
beginDate
协议起始日期
9
endDate
协议截止日期
10
blackDateScope
黑名单日期范围（多条用#分隔）
11
errorMsg
出错信息

备注：
无

² 历史就诊信息
函数：getHisForJz
说明：
返回某年历史就诊相关信息。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
18
农合证号
是
2
year
char*
4
就诊年
是
串
functionName=getHisForJz|id=222426080201009909|year=2013
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
rowNum
返回的记录数
3
hospital+记录数
就诊医院
4
inDate+记录数
入院日期
5
outDate+记录数
出院日期
6
diagnose+记录数
临床诊断
7
icd+记录数
ICD码
8
icdName+记录数
ICD名称
9
errorMsg
出错信息
例
returnValue=0|rowNum=2|hospital1=就诊医院|inDate1=20130405|outDate1=20130602|diagnose1=撞车导致右侧肋骨骨折|icd1=S22.301|icdName1=肋骨骨折|hospital2=……|errorMsg=成功

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

² 儿童大病直补
函数：childIllReimburse
说明：
省农合网上直接进行儿童大病直补。
参数：
NO
参数名称
类型
长度
参数描述
必填
1
id
char*
20
门诊住院号
是
串
functionName=childIllReimburse|id=7872015ZY
返回：
NO
参数名称
参数描述
1
returnValue
返回值（0成功，-1失败）
2
personNo
参合人员编码
3
xh
补偿序号
4
costAll
医疗费用总额
5
costAllDrug
其中：药品费用总额
6
costAllDiagnosis
诊疗项目费用总额
7
costLimit
参考价格
8
costNhBxbl
农合报销比例（％）
9
costNhYbcje
本次农合应补偿金额
10
costNhLjbcje
以前累计农合补偿金额
11
costNhSjbcje
本次农合实际补偿金额
12
costMzjz
民政救助补偿金额
13
costHzzf
患者自费金额
14
costYyzf
医院承担超额费用
11
errorMsg
出错信息

备注：
无

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］，不能为空，并给出详细错误信息提示。