当前位置:文档之家› 一站式平台接口规范(通用版)

一站式平台接口规范(通用版)

版本变更
目录
版本变更 (2)
第一章、接口概述 (4)
第二章、WebService调用说明 (4)
1、webservice请求调用XML格式 (4)
2、webservice服务返回XML格式 (5)
第三章、WebService交易失败处理 (6)
第四章、平台接口 (7)
1、门诊预收费(F01.00.00.01) (7)
2、门诊收费(F01.00.00.02) (8)
3、门诊收费冲销(F01.00.01.01) (10)
4、住院登记(F02.00.00.01) (10)
5、住院登记撤销(F02.00.00.02) (11)
6、住院明细上传(F02.00.01.01) (12)
7、住院未结算明细清除(F02.00.01.02) (13)
8、住院预结算(F02.00.03.01) (13)
9、住院结算(F02.00.03.02) (14)
10、住院结算撤销(F02.00.03.03) (15)
11、个人信息查询(F00.00.00.01) (16)
12、门诊结算信息查询(F00.00.00.02) (17)
13、住院结算信息查询(F00.00.00.03) (18)
附件一 (19)
代码字典 (19)
部分参数说明 (27)
附件二 (27)
第一章、接口概述
为了更好的实现吕梁市政府提出的一站式结算系统功能需求,真正实现人民群众一站式处理医院、多种医疗保险和商业保险之间的统一结算。

考虑到数据的准确性、可控性、可维护性和安全性,结合HIS厂家以及各个医疗保险机构改造系统的困难等多方面的考虑,在对原有系统的改造的过程中,我们准备提供WebService以供访问来解决。

第二章、WebService调用说明
1、webservice请求调用XML格式
<?xml version="1.0" encoding="UTF-8"?>
<service>
<head>
<!--安全校验-->
<security>
<username>ceshiyy</username><!--平台访问用户名-->
<password>123456</password><!--平台访问用户密码-->
<entryType>农合</entryType><!--平台访问入口(农合、医保)--> </security>
<serviceId>F01.00.00.02</serviceId><!--方法名-->
<businessId>201701040000001</ businessId ><!--唯一交易号--> </head>
<!-- 请求参数-->
<request>
< akc190>201612001</ akc190>
< aac001>368512</ aac001>
< aac191>10002</ aac191>
<results name='list01'>
<result>
< zkc301>1001</ zkc301>
< zkc302>阿莫西林胶囊</ zkc302>
</result>
<zkc301>1002</ zkc301>
<zkc302>灰黄霉素片</ zkc302>
</result>
</results>
</request>
</service>
2、webservice服务返回XML格式
<?xml version="1.0" encoding="UTF-8"?>
<service>
<head>
<serviceId>F01.00.00.02</serviceId>
< businessId >201701040000001</ businessId >
<sign>1</ sign ><!--服务成功标志(1、成功,0、失败) -->
<message>ok</ message ><!--提示信息-->
</head>
<!--返回参数-->
<response>
< zkc502>200</ zkc502>
< akc260>100</ akc260>
<!--结果集list01-->
<results name='list01'>
<result>
<aka063>1</aka063>
<aka064>床位费</ aka064>
<akc240>30.00</ akc240>
</result>
<result>
< aka063>2</ aka063>
< aka064>西药费</ aka064>
< akc240>30.00</ akc240>
</result>
</results>
<!--结果集list02-->
<results name='list02'>
<result>
< bkc101>医保统筹支付</ bkc101>
< bkc102>20.00</ bkc102>
</result>
<result>
< bkc101>公务员补助支付</ bkc101>
< bkc102>10.00</ bkc102>
</results>
</response>
</service>
第三章、WebService交易失败处理
在医院调用webservice接口进行日常业务操作中碰到网络中断等无法接收平台返回的交易结果数据时,可根据唯一交易号进行交易结果查询操作。

唯一交易号是每个医院定点必须唯一的30位的字符串,支持字母和数字交易查询操作的方法ID为F00.00.00.00 交易号为交易失败的交易号。

交易结果查询支持下列平台接口
门诊预收费(F01.00.00.02)
门诊收费冲销(F01.00.01.01)
住院登记(F02.00.00.01)
住院登记撤销(F02.00.00.02)
住院明细上传(F02.00.01.01)
住院未结算明细清除(F02.00.01.02)
住院结算(F02.00.03.02)
住院结算撤销(F02.00.03.03)
返回结果见各方法的出参
流程图如下
正常的业务调用
在有中断的业务调用中,第一次业务调用中医院未接收到平台返回的的交易结果可根据交易号查询交易结果,如果业务调用请求未到达平台即中断则医院应再次发送交易请求,若交易查询发生网络问题中断则需等待网络恢复后再进行交易查询交易结果。

第四章、平台接口
1、门诊预收费(F01.00.00.01)
2、门诊收费(F01.00.00.02) 入参
3、门诊收费冲销(F01.00.01.01)
出参
4、住院登记(F02.00.00.01)
5、住院登记撤销(F02.00.00.02) 入参
出参
6、住院明细上传(F02.00.01.01) 入参
7、住院未结算明细清除(F02.00.01.02) 入参
8、住院预结算(F02.00.03.01)
9、住院结算(F02.00.03.02) 入参
出参
10、住院结算撤销(F02.00.03.03) 入参
11、个人信息查询(F00.00.00.01)
12、门诊结算信息查询(F00.00.00.02)
出参
13、住院结算信息查询(F00.00.00.03)
入参
14、检查患者能否先治疗后付费(F03.00.00.01) 入参
出参
附件一代码字典
科室代码字典
部分参数说明
1、收费结果公式:医疗费总额=医保统筹支付+个人账户支付+其他医保支付+个人支付金额
2、日期格式统一为:YYYY-MM-DD HH:mm:ss
附件二
参见《药品诊疗项目字典》和《疾病字典》。

相关主题