联德新农合市级统筹系统HIS 接口规范（V1.05）
二O一五年十月二十二日
目录
一、新农合市级统筹系统HIS接口方案设计目的及规则 (1)
二、接口安全方案 (2)
三、接口对接要求 (5)
1、新农合市级统筹系统接口身份验证 (5)
2、接口函数调用要求 (6)
3、新农合市级统筹系统与医院HIS系统需要对照的内容 (6)
4、新农合目录更新 (7)
5、住院处方函数 (8)
6、住院处方删除 (9)
7、医院传输接口 (9)
四、接口对接流程 (10)
1、住院部分 (10)
2、门诊部分 (12)
五、接口函数规范表 (14)
1、住院部分 (14)
2、门诊部分 (39)
六、对照表 (49)
七、接口对接意见反馈表 (53)
一、新农合市级统筹系统HIS接口方案设计目的及规则
目标：联德新型农村合作医疗市级统筹系统与医院端HIS系统接口的应用，可以最大程度的避免新农合市级统筹系统在进行直接补偿结算时，重复录入医院HIS系统已经录入的大量费用信息（诊疗项目、药品等）。接口的实现将大大提高新农合病人在办理出院结算的效率，提高医院工作人员的工作效率，提高医院的整体信息化水平，节约医院的管理成本和人员成本，并实现市级合管中心实时监管各定点医疗机构的医疗收费情况，实现高效、快捷的信息化审核和结算等业务职能。
各市级及市级以下定点医疗机构使用统一的新农合市级统筹系统软件，但是各定点医疗机构所使用的医院HIS管理系统则不尽相同，各新农合定点医疗机构在实施该系统接口时必须严格按统一的标准执行，从全局的要求出发，实现定点医疗机构为参合农民快捷、方便结算的业务要求和卫生行政监管的要求，保障系统正常稳定运行。
规则：新农合平台需要与各级新农合定点医疗机构进行系统对接，充分考虑不同级别的医疗机构的实际情况和需求，所以联德新型农村合作医疗平台提供2种不同接口调用方式：
1.单一B/S模式下的Web Services接口，该模式下，接口部署在新农合平台的服
务器上，提供Web Services服务，医院HIS系统通过调用Web Services接口，
实现定期将数据传输给新农合平台。该模式，对接相对简单，运行的稳定性好，
对HIS系统的改造相对较小，成本较低，可以实现避免新农合处方二次录入，
降低定点医疗机构新农合经办机构的业务，提高工作效率。该模式主要是提供
给一些中小型的新农合定点医疗机构。
2.两层B/S模式Web Services接口共同使用的模式。该模式下，医院HIS端通过
调用前置机上Web Services函数，将数据传输到前置服务器上新农合前置数据
库（SQL Server）中。我们在前置服务器上再安装相应的接口调用程序，调用
远程的Web Services接口将信息发送到新农合平台，这样能够实现定点医疗机
构HIS系统与新农合平台的实时对接。这种模式下，接口前置服务器既连通了
新农合平台，又连通了定点医疗机构HIS服务器，通过制定相应防火墙策略，
可以实现定点医疗机构内部系统的安全。
接口实现方式图：
二、接口安全方案
按医院管理规定，HIS原本都是一个内部封闭的局域网环境，只覆盖医院范围，HIS的建设要与外网隔绝，不能与外界直接进行物理连接。为了接入新农合平台，HIS 系统必须要与外界进行连接。最合理的方式是使用专网接入的方式，但是由于专网费用高，而且覆盖面不广，对与新农合业务覆盖到乡村的平台系统来说，实现专网有很大的困难，根据这种具体的现实情况，我们制定了最佳的安全解决方案。
对于联网安全问题，医院端可以考虑设置硬件防火墙，以防止非法用户威胁或破坏整个信息系统安全。另外，考虑增加一台前置服务器，安装网络防毒软件，加强与外网联通的前置机的安全性。
根据各定点医疗机构的实际需求和对接方式，我们制定了三种安全的方案，前两种方案是单一Web Services接口方式下的安全方案，第三种是两层Web Services接口方式下的安全方案，具体内容如下：
1、无前置服务器情况下
因为定点医疗机构规模问题，有的医院可以不采用前置机的方式进行接口的对接，这种方式下，就采用我们的第一种接口模式，单一的B/S Web Services接口对接。这种方式下因为没有前置机，HIS服务器直接调用接口程序，所以需要通过防火墙加杀毒软件的方式实现接口安全性的问题。在防火墙上配置策略，只允许调用接口的HIS服务器访问新农合平台的IP地址，不允许访问其它IP地址，同时不允许其它机器访问该服务器的地址，接口完全采用被动调用的方式实现，只允许HIS服务器向新农合平台可以发出请求。比如我们新农合平台的外网地址是58.18.111.110，医疗机构的防火墙上配置成除了这个IP以外的所有IP都禁止访问即可，这种方式由各医疗机构网络管理人员进行设置即可。
优点：该模式的对接方式简单，成本较低，HIS系统不用进行修改，减轻了处方二次录入的工作量，提高了定点医疗机构的效率。
缺点：安全性不高。
2、有前置服务器情况下定时接口
有前置服务器的情况下，如果制作定时传输接口，在保证安全的前提下，需采用单一B/S Web Services接口模式进行对接。
HIS供应商需开发一个定时调用系统接口的软件，将该软件部署在前置服务器上，通过连接HIS服务器上的数据库，定时抽取HIS服务器上的新农合数据调用远程Web Services接口，将数据传输给新农合平台。该模式下，前置服务器拨入新农合虚拟专用网后不能断开，保证前置服务器不能访问公网，只能连接新农合平台。
为了进一步保证HIS系统的安全，HIS供应商可以考虑在前置服务器上放一个HIS 数据库的镜像，该镜像存储所有的新农合数据。HIS供应商开发定时调用接口软件仍部
署在前置服务器上，该软件连接镜像数据库，定时提取镜像数据库的数据调用远程Web Services接口，将数据发送到新农合平台。这样可以将前置服务器和与HIS服务器之间设置安全策略，只允许HIS服务器向前置服务器发送数据，不允许前置服务器到HIS 服务器提取数据，更加保证了系统的安全。
优点：HIS软件不用进行如何修改，只需开发单独的接口对接模块，部署在前置服务器上与新农合平台进行交互。如果使用镜像，HIS服务器可以与前置服务器单向隔离，只需定期的将数据同步给镜像数据库，保证系统安全。
缺点：由于接口不是在HIS服务器上直接调用，所以无法实现实时调用接口的方式，不能与新农合平台做到无缝衔接。
3、有前置服务器情况下实时接口
有前置服务器的情况下，我们的接口提供更加安全的双层B/S接口的模式实现新农合平台与医院HIS系统的无缝对接。这种方式下，医院HIS系统直接调用前置服务器上的前置Web Services接口，将数据传输到前置服务器的数据库中，局域网传输数据，保证不影响HIS的使用效率，同时我们在前置服务器上安装定时软件，调用远程Web Services接口，将数据发送到新农合平台，保持数据的一致性。这个模式下，前置服务器允许访问公网，通过VPN拨号的方式，与新农合平台建立虚拟专用网，这个VPN拨号一旦拨通后，就不再断开了，保证实时与新农合平台连接，在连接期间，这台前置服务器就不再处于外网的环境，不能再访问公网。在前置服务器与医院HIS服务器之间通过防火墙进行隔离，只允许HIS服务器访问前置服务器，不允许前置服务器访问HIS 服务器，这样做到防止病毒、木马传染到HIS服务器，保证HIS系统的安全。同时配置防火墙的安全策略，保证这台前置服务器也只能访问新农合平台IP地址，其它地址不允许访问。具体接入方式如下图所示：
优点：该对接方式能够实现HIS系统与新农合系统的实时对接，可以加强对定点医疗机构的监管，并且保证系统的安全性。
缺点：需要对HIS系统进行改造，可以对HIS业务有影响，接口完成后需要运行一段时间才能保证稳定。
附：前置服务器的配置要求
三、接口对接要求
1、新农合市级统筹系统接口身份验证
由联德公司与医院达成协议，医院需遵循关于新农合市级统筹系统HIS接口的
对接的标准规范，双方达成一致，由联德公司提供接口身份验证的资格，并给予医院符合调用规范的医疗机构编码，才可与新农合市级统筹系统进行连接。
2、接口函数调用要求
1)函数名称大小写要保持一致；
2)函数入参和出参数据格式要严格按照规范说明中的要求，并且入参不可为
空；
3)浏览器验证WEB服务的有效性，通过浏览器按如下格式
h ttp://IP地址:端口号/ws_his/XnhForHisInterFace?wsdl，访问后如果浏览器返回
XML格式数据内容，则表示新农合市级统筹系统WEB服务接口已经启动，并且可以正常调用。
3、新农合市级统筹系统与医院HIS系统需要对照的内容
新农合市级统筹系统向医院HIS系统提供的数据字典包括药品目录、诊疗目录、疾病信息编码（使用内蒙古自治区统一的idc编码）、科室信息、费用类型、医疗机构编码和操作人编码。这些信息his系统必须要进行对照。
1）、药品目录、诊疗目录对照：
目录比较多，我们会提供一份系统导出的excel表格，其它对照内容会在本规范中列出，在传送的时候传送新农合系统的对照编码，若是自费药品、诊疗可以对照新农合目录中的自付项目，也可以对照为“Y000000001”（自费药品），“Z000000001”（自费诊疗）。
对于以前跟自治区异地就诊系统对照的医院，对照过的可以不用再对照，但盟市新增加的目录（药品、诊疗）必须进行对照。传输对照后的编码。
2）、疾病目录对照：
原则上使用内蒙古自治区统一的ICD编码，若医院his系统目前使用的是这个目录，则不需要在进行对照，传送时传送icd编码即可，但盟市有新增加的疾病目录信息，需要将新增加部分进行对照。若没有使用内蒙古自治区统一的ICD编码，
必须要进行ICD编码对照。传输ICD编码。
3）、科室信息对照：
具体对照目录参照第六部分。若以前跟自治区异地就诊对接的医院，不许进行对照，但市统筹系统有新增科室，需要将新增的进行对照。否则必须进行科室信息对照。传输对照后编码。
4）、费用类型对照：
具体对照目录参照第六部分。若以前跟自治区异地就诊对接的医院，不许进行对照，但市统筹系统有新增费用类型，需要将新增的进行对照。否则必须进行费用类型对照。传送对照后编码。
5）、医疗机构编码、操作人编码对照：
医疗机构编码：在实施对接前，需要联德公司授权，授权后我们会提供一个医疗机构编码，将此编码作为医疗机构的对照编码并存储到his系统中，在业务函数参数需要时，将此编码作为入参传送。
操作人编码：在门诊业务对接中需要用到操作人编码参数，在授权时，我们会提供一个操作人编码，his系统需要存储此编码，并在业务函数需要此参数时，将其作为入参传输。
6）、床日付费类型编码对照
在接口函数中我们提供了一个查询床日付费类型编码函数ws_crfftpeCode，通过调用该函数可以查询到床日付费类型编码
具体对照目录参照第六部分。
4、新农合目录更新
新农合可报销的目录由自治区卫生厅及各盟市卫生局统一制定，不会轻易进行修改，如果修改，会统一通知各定点医疗机构。我们公司会将自治区卫生厅下发的补充目录统一导入新农合平台中，然后5个工作日内将增加的目录导成excel文件发给各定点医疗机构。
如果各定点医疗机构自己新进一些药品或诊疗项目，可以使用新农合机构级目
录维护功能将新增药品增加到新农合平台中，并使用目录上报功能进行上报，市合管办相关部门负责人审批后可以使用新农合平台提供的导出excel功能，下载这些药品的编码进行对照。也可以通过接口函数ws_selectdrug、ws_selectdiag 查询新增药品、诊疗项目，通过his系统的对照功能进行对照。
新农合市级统筹系统还提供药品和诊疗目录查询功能的接口，随时可以查询新农合目录是否有变化，新进药品是否在新农合可报销目录内。
5、住院处方函数
一方面为了满足患定点医疗机构避免二次录入处方的要求，同时满足卫生部门对新农合定点医疗机构的监管，所以我们提供2个处方传输的功能，一个是准实时处方打包汇总传输，一个是出院前打包汇总处方传输。不同HIS供应商根据不同的需求，调用不同的函数传输相应的数据。
住院处方传输接口分为2个函数：
第一个是随着HIS处方的发生，准实时调用该接口将处方传输给新农合系统，实时传输的目的根据卫生厅要求，为了保证新农合市级统筹系统数据的实时性，方便各级相关管理部门对新农合数据进行监管，准实时接口函数不要再HIS系统开处方时调用，如果出现接口网络问题或接口问题会影响HIS系统的正常运行，实现准实时函数可以单独开发一套接口传输程序，十分钟或半个小时调用一次接口，更要注意的是在调用传处方接口函数时要将处方明细费用打包汇总传输，千万不要频繁调用接口函数一个处方明细一个处方明细的传输，频繁调用接口函数会导致接口崩溃，传输速度慢，处方费用传输不过来等问题；举例：比如到银行自动存款机区存钱，要存1000块钱，正确的方式是你将1000块钱一次性放入存款机内，错误的方式是将1000块钱分10次放入存款机，每次放入100块钱。
第二个函数是结算前传输处方的函数，调用此函数重新将所有的处方拼接成字
符串传输给新农合系统，此函数用来确保结算的费用一定准确，避免因为实时调用的处方出现退药、改方等问题造成结算信息不准确的问题，结算时以此函数传输的处方为准。结算前传输的处方应该汇总传输，按照药品名称或诊疗名称汇总，将同一种类的药品汇总成一条记录进行传输。
6、住院处方删除
保证与处方传输一直的一致性，处方删除接口也分为实时处方删除和结算前处方删除2个：
第一个是删除实时传输的处方，对于HIS系统传输退药或是改方等进行操作。如果HIS系统删除了某一个处方，可以调用处方传输接口，传输一个负数，进行冲账，比如，第一天开了3支葡萄糖，第二天退到一支，就可以先传输3支，然后再掉传输接口，传输-1支，也可以使用传输删除接口，删除之前的3支，重新传输1支。
第二个是用来删除结算前传输的所有处方的，如果结算时传输的所有处方发现存在问题，可以调用该函数，将结算使用的处方进行删除，然后重新传输所有结算的处方进行结算。
医院HIS系统中对录入有问题的处方明细数据进行删除，同时同步删除新农合市级统筹系统中相对应的处方明细数据。保持HIS系统与新农合市级统筹系统数据一致性。
7、医院传输接口
按照卫生厅要求，要对省级定点医疗机构监管医嘱情况，我们系统原有处方实时传输监管的功能，所以对于有医嘱的定点医疗机构，可以直接传输医嘱，不需要再传输实时的处方，没有医嘱的医疗机构传输实时处方以供卫生厅进行监管。医嘱传输按照每天的日期进行传输，每天传输一次，如果一个医嘱传输后被修改或者删除，请再修改的当天再进行一次传输，我们根据医嘱编号替换原有传输的医嘱，保证数据准确性。
例如：1月1号传输了一条长期医嘱，该医嘱在1号晚上进行传输，新农合平台接收到该医嘱后，会自动存储到数据库中，然后该医嘱在2号被修改，那么在2号的晚上，请将该医嘱重新传输，传输的时候我们会根据HIS系统的医嘱编码查询该
医嘱是否存在，如果我们的系统中存在那么就对原医嘱进行修改，如果该医嘱不存在，就新插入一条医嘱信息。如果某一个医嘱要删除，请直接传输删除状态，我们会根据医嘱编码将已传输的医嘱删除。如果一个医嘱的明细进行了修改，请重新传输整个医嘱，我们会将医嘱明细删除，重新插入新传输的医嘱明细。
四、接口对接流程
1、住院部分
接口对接分为2种方式，一种定时方式的对接，一种实时方式的对接。
住院登记需在his系统通过调用住院登记等函数进行登记，住院结算可以选择在his系统中调用接口函数结算，也可以选择在新农合系统中进行结算操作。
具体流程如下：
1)住院登记：在his系统中进行登记。调用方式，his系统实时调用。
●通过调用人员信息查询接口函数（ws_PersonInfo），查询参合人员信息。
●调用判断是否允许住院登记函数（ws_JudInHos），判断参合人员登记
状态是否允许登记。
●调用住院登记函数（ws_Registration），进行住院登记。登记成功后，接
口将返回登记编码，his保存登记编码，以便处方传送和出院结算时使
用。
2)住院登记修改：调用方式，his系统实时调用。
●调用住院登记函数（ws_RegistrationUpdate）进行登记信息修改。
●通过调用登记删除函数（ws_RegistrationDel）删除登记信息，然后调用
住院登记函数（ws_Registration）重新进行住院登记。
3)住院登记删除：调用方式，his系统实时调用。
●通过调用登记删除函数（ws_RegistrationDel）删除登记信息。
4)传输处方信息：调用方式，his系统调用。可实时也可定时传输。
●调用实时处方传输接口函数（ws_rcp_ss），实时传处方信息。具体实现
请参照第五部分。
●调用实时处方删除接口函数（ws_rcp_ss_del），删除处方信息。具体实现
请参照第五部分。
●调用定时处方传输接口函数（ws_rcp），定时传处方信息。具体实现请
参照第五部分。
●调用定时处方删除接口函数（ws_rcp_del），定时删除方信息。具体实现
请参照第五部分。
●调用处方删除接口函数（ws_rcp_del_Reg），按照登记编码删除方信息。
具体实现请参照第五部分。
●对于处方修改或作废时，可以调用处方实时传输接口传输负处方，也可
以先调用处方实时删除接口删除处方，然后重新调用处方实时传输接
口，传输修改后的新处方。
5)传输医嘱信息：调用方式，his系统调用。可实时也可定时
●调用医嘱信息传输接口函数（ws_da），实时传医嘱信息。具体实现请参
照第五部分。
●医嘱修改时，请再次调用医嘱传输接口，传输修改后的医嘱，我们系统
会自动将之前的医嘱删除，重新插入新医嘱。
6)出院结算：调用方式，his系统实时调用。
●可以选择在新农合系统中结算，也可以再his系统中进行结算。
●调用出院结算函数（ws_Settlement）进行出院结算。
7)住院退结算：调用方式，his系统实时调用。
●调用住院退结算函数（ws_SettlementDel）进行住院退结算。
8)结算单打印：
●若在新农合系统中结算，需在新农合系统中进行打印，
●若在his系统中结算的，可以在his系统结算的时候直接打印结算单。
9)试算功能：调用方式，his系统实时调用。
●可以再结算前进行试算（预结算），试算不保存结算信息，只返回结算
报销金额等信息，方便补交住院押金等业务操作。
●调用试算函数（ws_Settlement_Test）进行住院结算前试算。
2、门诊部分
接口对接分为2种方式，一个定时方式的对接，一种实时方式的对接。
门诊登记需在his系统通过调研门诊登记等函数进行登记，门诊结算可以选择在his系统中调研接口函数结算，也可以选择在新农合系统中进行结算操作。
具体流程如下：
1)查询人员信息: 在his系统中进行查询。可实时也可定时调用。
这里接口分成两个, Ws_Cli_peopleinfo接口是通过医疗证号查询出全家所有人的信息，Ws_Cli_peopleinfo_two接口是通过医疗证号和姓名两个条件查询出一个人的信息，在开发过程中，可以按实际需要使用。
●调用接口中Ws_Cli_peopleinfo函数，以医疗证号为条件，查询出该家
庭的所有人员的基本信息（家庭编码|人员编码|行政区划编码|姓名|性
别|年龄|民族|出生日期|身份证号|医疗证号|亲属关系），人和人之间
用“；”间隔，每个人的每项信息用“|”间隔。
●调用接口中Ws_Cli_peopleinfo_two函数，以医疗证号和姓名为条件，
查询出一个人员的基本信息（家庭编码|人员编码|行政区划编码|姓名|
性别|年龄|民族|出生日期|身份证号|医疗证号|亲属关系），每个人的
每项信息用“|”间隔。
2)判断门诊登记：调用方式，his系统实时调用。
●此函数应该是在取得人员信息后，登记前使用，必须判断该人是否可以
登记。从查询的人员信息中，选择出患者的信息，调用
Ws_Cli_Judgmentreg函数，判断患者是否可以登记,可以登记返回“Y”，
不可以登记返回“N”，N后跟不可登记原因。
3)门诊登记：在his系统中进行登记。可实时也可定时调用。
●通过上面的接口，判断出该患者可以登记后，调用Ws_Cli_Registration
函数，将登记信息传送到新农合系统中进行登记，登记信息录入成功返
回门诊登记编码，失败返回N,N后跟失败原因。登记成功返回的编码需
要回存。
4)删除登记：在his系统中进行删除登记。实时调用。
●调用Ws_Cli_DeleteRegistration函数，将回存的登记编码传回给新农
合系统，进行删除操作，删除成功返回“Y”，删除失败返回“N”，N后
跟失败原因。
5)处方传送：在his系统中进行传输。可实时也可定时调用。
●调用Ws_Cli_rcp函数，将登记编码，开方日期等主表信息和项目编码、
数量、单价等处方明细信息传到新农合系统中，本次传送是否成功，成
功则返回该条处方在新农合存储的处方编码;失败则返回N（N后跟失败
原因）。
6)删除处方：在his系统中进行删除处方，实时调用。
●调用Ws_Cli_DeleteRcp_Only函数，将回存的登记编码传回给新农合系
统，进行删除处方操作，本操作是删除本登记编码下所有的处方信息，
删除成功返回“Y”，删除失败返回“N”，N后跟失败原因。
7)门诊试算：实时调用。
●调用Ws_Cli_Settlement_Test函数，将登记编码传送到新农合系统中，
若成功，则返回试算结果，失败则返回N。
8)门诊结算：实时调用。
●调用Ws_Cli_Settlement函数，将登记编码传送到新农合系统中，若成
功则返回结算信息字符串（结算编码|总费用|可补金额|不可补金额|
实补金额|自付金额实），失败则返回N，N后跟失败原因。结算成功后
的结算编码HIS端需要回存。
9)退结算：实时调用。
●调用Ws_Cli_CancelSettlement函数，将结算编码传送到新农合系统
中，若退结算成功则返回Y，失败返回N。
10)结算单打印：
●若在新农合系统中结算，需在新农合系统中进行打印，
若在his系统中结算的，可以在his系统结算的时候直接打印结算单。
五、接口函数规范表
1、住院部分