HIS系统接口的说明3.0.
四川省新型农村合作医疗信息系统医院信息系统 (HIS接口规范
版本号 :3.0
四川省卫生信息中心发布
2013年 5月 15日
目录
第一部分接口介
绍 . ...................................................................................................................... 5第二部分新型农村合作信息系统接口中的住院接口功能介绍 ................................................. 6接口住院工作流程
图 . .............................................................................................................. 6类 (函数的返回值或传入值标准 .. (7)
1、 public class
FalseOrTrue (7)
2、 public class
AccreditCode (7)
3、 public class
RevertHospitalID . (7)
4、 public class
IsPatientClass (8)
5、 public class InfosP (8)
6、 public class
PersonInfo (9)
7、 public class
InfosU . (10)
8、 public class
Users . (10)
9、 public class
InfosM ................................................................................................... 11 10、 public class Med . ..................................................................................................... 11 11、public class InfosSW ............................................................................................... 13 12、public class SW ....................................................................................................... 13 13、public class InfosI ................................................................................................... 14 14、public class Items .................................................................................................... 14 15、public class ValidateInfoClass . .. (16)
16、 public class QDInfoClass (16)
17、 public class QDReturn1 (17)
18、 public class QDReturn2 (17)
19、 public class QDError . ..............................................................................................
18 20、 public class ToCode ................................................................................................
18 21、 public class QueryPatientQD ..................................................................................
19 22、 public class QDInfo.................................................................................................
19 23、 public class QueryHospitalBC ................................................................................
20 24、 public class BCInfo0 ...............................................................................................
21 25、 public class BCInfo1 ...............................................................................................
22 26、 public class InfosI1 .................................................................................................
23 27、 public class InfosM1 ...............................................................................................
24 28、 public class
Med1 . ................................................................................................... 24 29、 public class InfosSW1 . ............................................................................................ 24 30、public class SW1 ..................................................................................................... 25 31、public class Time . . (25)
32、 public class ZY . .......................................................................................................
26 33、 public class JB . ........................................................................................................
26 34、 public class JYMoney ..........................................................................................
26
35、 public class MZInfo .............................................................................................
26 36、 public class FYMX ..............................................................................................
27 37、 public class FUHEReturn . ....................................................................................
27函
数 (27)
1、
CheckDB( (28)
2、 CheckHosAccredit1(string
HACCCODE . (28)
3、 CheckUser(string UID,string
HACCCODE (28)
4、 CheckMed(int MID, decimal MPRICE, int
HID . (29)
5、 CheckSW(int SID, decimalSPRICE, int HID . (29)
6、 CheckItem(int IID, decimalIPRICE, int HID, string
ADDPRICEREASON . (30)
7、 CheckPersonCode (string
PERSONCODE (31)
8、 IsPatient1 (string
PERSONCODE . (31)
9、 QueryPersoninfo (string QUERYCONDITION, string
QUERYKEY .................... 32 10、 QueryMed(string
HACCCODE . ............................................................................ 32 11、 QuerySW(string HACCCODE .............................................................................. 33 12、 QueryItem(string HACCCODE . ............................................................................ 33 13、QueryUsersTable(string HACCCODE .................................................................. 34 14、WriteQD1(ValidateInfoClass vinfo, QDInfoClass[] qdinfo . . (34)
15、 WriteQD2(ValidateInfoClass vinfo, QDInfoClass[] qdinfo . ..................................
35 16、 ModifyQD1(ValidateInfoClass vinfo, QDInfoClass qdinfo ..................................
35 17、 ModifyQD2(int qdid, decimal count, decimal zfund, string DLB, string reason,
int xmid, string doctor, string UID, string HACCCODE ....................................................
36 18、 DeleteQD1 (int hqdid, ValidateInfoClass vinfo .....................................................
37 19、 DeleteQD2(int qdid,string UID, string HACCCODE............................................
37 20、 QueryQD(string HACCCODE, string PERSONCODE ........................................
38 21、 QueryBC(string HACCCODE, DateTime BeginTime, DateTime EndTime,int choose (39)
22、 QueryItem1(string HACCCODE, int pagenum (39)
23、 QueryMed1(string HACCCODE . (40)
24、 QuerySW1(string HACCCODE (40)
25、 ModifyRYTime(ValidateInfoClass vinfo, Time intime (41)
26、 ModifyCYTime (ValidateInfoClass vinfo, Time intime (41)
27、 RYHandle(string HACCCODE, string PERSONCODE, string UID, string ZYCODE, string JZTYPE, string RYKS, string CWCODE, string DOCTORNAME,
string RYSTATUS, string RYOPERATOR, string ERROID, jb[] jbbm (42)
28. CYBL(string HaccCode, string zylshID, string userID, string cyZtbm, string cyKs, string[] jbBm . (43)
29. ModifyRY(string HACCCODE, string ZYID, string UID, string JZTYPE, string ZYCODE, string RYSTATUS, string RYKS, string CWCODE, string DOCTORNAME, string ERROID, jb[] jbbm (43)
30、 IsPatient2 (string PERSONCODE . (44)
31、 DeleteQD3(int[] qdid,string UID, string HACCCODE . (45)
住院接口使用流
程 . ................................................................................................................ 45初始化操作 . .. (47)
对码表维护操
作 . ............................................................................................................ 47入院操
作 . ........................................................................................................................ 48每日清单操作 . ................................................................................................................ 48出院操作 . (50)
统计结算查询 . (50)
其他函数说明:. (50)
第三部分新型农村合作信息系统接口中的门诊统筹接口功能介
绍 ..................................... 52类 (函数的返回值或传入值标
准 (52)
1、 public class
MZTCZInfo . (52)
2、 public class
MZTCZMXInfo (55)
3、 public class
YYKS (57)
4、 public class
InfosKS . (57)
5、 public class JBBM (58)
6、 public class InfosJB (58)
7、 public class
MZQDError . (59)
8、 public class MZQDRetrun { ..................................................................................... 60函
数 .........................................................................................................................................
60
1、
QuerySystemTime( (60)
2、 QueryJBBM(int
pagenum . (61)
3、 QueryYYKS(string
HACCCODE (61)
4、 MZTCZLoginInt(MZTCZ.MZTCZInfo info, int choose, decimal hcmztczID, string personCode, string
HaccCode . (62)
5、 MZTCZSureInt(string HaccCode, decimal mztczID, string
userID (62)
6、 MZTCZDeleteInt(string HaccCode, decimal mztczID, string
userID . (63)
7、 MZTCZHCInt(string HaccCode, decimal mztczID, string userID, string
reason (63)
8、 QueryMZTCInfo1(string personCode, string HaccCode, string status, DateTime beginTime, DateTime endTime (64)
9、 QueryMZTCInfo2(string HaccCode, string status . ..................................................
65 10、 QueryMZTCInfo3(string personCode, string HaccCode, string status..................
65门诊统筹接口使用流
程 . ........................................................................................................ 66第四部分 2.0版本更新介绍和之前版本实施中的问题及解决方案 .. (67)
一、 2.0版本更新介
绍 . (67)
二、之前版本实施中的问题及解决方
案 . (67)
1、 IS 供应商对 webservice 模式不清楚
的 (67)
2、某些平台出现报错(图 . (68)
3、诊疗项目对码表下载失
败 . (68)
的问题 .........
4、中文时比如说传处方医生姓名时传进农合系统变成“ ???????? ”
68
5、负数冲帐的问
题 . (68)
6、安装接口服务器的情
况 . (68)
7、农合对价格控制问
题 . .............................................................................................. 69接口测试网址和技术
人员联系方式:. (69)
第一部分接口介绍
接口主要是为了解四川省新型农村合作医疗信息系统 (简称“新农合信息系统”
决有 HIS 系统的医疗机构在病人入院期间的每日清单录入问题,暂不涉及入院、出院、结算和农合的其他补偿方式 , 因此相关操作仍需要通过新农合系统来进行。对
于上述操作,接口将在今后做进一步完善。新型农村合作医疗信息系统是一套对及
时性要求很高的系统, 故而接口程序要求清单信息及时录入。接口使用 XML 数据格式进行消息传递,采用 Web Services技术, 通过 Encrypt 技术进行身份验证和数据
流加密 (公钥体系 , 远程访问调用 Web Service 中的函数, 通过函数调用 Oracle 存储过程完成相关业务流程操作。为了规范数据返回格式, 在接口中统一采用以对象的
形式返回结果。
新农合信息系统与 HIS 系统因为其业务流程多且复杂, 接口开发是一个长期的
阶段性的过程。本文及相应接口程序只是开始第一阶段, 只要解决最急需的清单重
复问题, 其它功能会在后续开发中逐步完善。请医疗机构 HIS 系统开发商务必以
内嵌模式 (对应外挂模式开发对应接口,以利于后续完善过程。
第二部分新型农村合作信息系统接口中的住院接口功能介绍接口住院工作流
程图
类 (函数的返回值或传入值标准
1、 public class FalseOrTrue
{
public string falsemessage = "";
public string truemessage = "";
}
说明:
其对象作为函数的返回值,当字符型参数 falsemessage 不是空字符串时,说明该函数执行出错, 报错信息在 falsemessage 显示; 当函数执行正确时, falsemessage 为
。
空字符串, 字符型参数 truemessage 返回值“ true ”
2、 public class AccreditCode
{
public string falsemessage = "";
public string accreditcode = "";
}
说明:
其对象作为函数的返回值,当字符型参数 falsemessage 不是空字符串时,说明该函数执行出错, 报错信息在 falsemessage 显示; 当函数执行正确时, falsemessage 为空字符串, 字符型参数 accreditcode 返回值为医疗机构使用接口的授权码。
3、 public class RevertHospitalID
{
public string falsemessage = "";
public int hospitalid = -1;
}
说明:
其对象作为函数的返回值,当字符型参数 falsemessage 不是空字符串时,说明该函数执行出错, 报错信息在 falsemessage 显示; 当函数执行正确时, falsemessage 为空字符串, 整型参数 hospitalid 返回值为医疗机构农合系统 ID 。
4、 public class IsPatientClass
{
public string falsemessage = "";
public int zyid = -1;
}
说明:
其对象作为函数的返回值,当字符型参数 falsemessage 不是空字符串时,说明该函数执行出错, 报错信息在 falsemessage 显示; 当函数执行正确时, falsemessage 为空字符串, 整型参数 zyid 返回值为农合系统单人次住院的流水号。
5、 public class InfosP
{
public string falsemessage = "";
public PersonInfo[] info;
}
说明:
其对象作为函数的返回值,当字符型参数 falsemessage 不是空字符串时,说明该函数执行出错, 报错信息在 falsemessage 显示; 当函数执行正确时, falsemessage 为空字符串,
对象数组型参数 info 返回值为提供个人参合信息,见类 PersonInfo 。
6、 public class PersonInfo
{
public string personcode = "";
public string personname = ""; public string certid = "";
public string sex = "";
public string obd = "";
public string marriagestatus = ""; public string nation = "";
public string health = "";
public string relation = "";
public string workcrop = ""; public string occupation = ""; public string remark = "";
public string wenhuacode = ""; public string perattiribute = ""; public string areaname = "";
}
说明:
7、 public class InfosU
{
public string falsemessage = ""; public Users[] info;
}
说明:
其对象作为函数的返回值, 当字符型参数 falsemessage 不是空字符串时, 说明该函数执行出错,报错信息在 falsemessage 显示;当函数执行正确时, falsemessage 为空字符串, 对象数组型参数 info 返回值为提供医疗机构的用户信息,见类 Users 。
8、 public class Users
{
public string u_id = "";
public string remark = "";
}
说明:
9、 public class InfosM
{
public string falsemessage = "";
public Med[] info;
}
说明:
其对象作为函数的返回值, 当字符型参数 falsemessage 不是空字符串时, 说明该函数执行出错,报错信息在 falsemessage 显示;当函数执行正确时, falsemessage 为空字符串, 对象数组型参数 info 返回值为提供医疗机构的药品信息,见类 Med 。
10、 public class Med
{
public string commodityname = "";
public string medid = "";
public string usualname = "";
public string jixing = "";
public string inprice = ""; public string outprice = ""; public string producer = "";
public string batchnum = ""; public string sellertel = ""; public string remark = ""; public string bl = "";
}
说明:
11、 public class InfosSW
{
public string falsemessage = "";
public SW[] info;
}
说明:
其对象作为函数的返回值, 当字符型参数 falsemessage 不是空字符串时, 说明该函数执行出错,报错信息在 falsemessage 显示;当函数执行正确时, falsemessage 为空字符串, 对象数组型参数 info 返回值为提供医疗机构的卫生材料信息,见类 SW 。
12、 public class SW
{
public string NAME = ""; public string ID = "";
public string mlname = ""; public string dw = ""; public string inprice = ""; public string outprice = ""; public string productor = ""; public string bl = "";
}
说明:
13、 public class InfosI
{
public string falsemessage = "";
public Items[] info;
}
说明:
其对象作为函数的返回值,当字符型参数 falsemessage 不是空字符串时,说明该函数执行出错, 报错信息在 falsemessage 显示; 当函数执行正确时, falsemessage 为
空字符串, 对象数组型参数 info 返回值为提供医疗机构的诊疗项目信息,见类Items 。
14、 public class Items
{
public string xmmc = "";
public string ID = "";
public string codes = "";
public string xmnh = ""; public string cwnr = ""; public string jjdw = ""; public string remark = ""; public string lb = "";
public string price = ""; public string canmodify = ""; public string bl = "";
}
说明:
15、 public class ValidateInfoClass
{
public string HACCCODE;
public string UID;
public string PERSONCODE;
}
说明:
其对象作为函数的参数,包括 HACCCODE医疗机构授权码、 UID 农合系统用户 ID 、 PERSONCODE 农合系统 20位个人编码三个字符型元素,统称为操作清单的验证信息。