山市三水区居民“一卡通”医疗保险信息系统接口规范
目录
1. 前言 4
1.1 概述 4
1.2 适用范围 4
1.3 参考文档 4
1.4 术语说明 4
2. 接口技术说明 4
2.1 概述 4
2.2 WSDL文件地址 5
2.3 接口定义 5
2.4 接口调用 5
2.5 相关约定 6
3. 数据采集接口规范 6
3.1 门诊结算 6
3.1.1 门诊资格确认接口 6
3.1.2 门诊结算接口 11
3.1.3 门诊结算取消接口 19
3.1.4 门诊上传发票号接口 23
3.1.5 个人相片上传 27
3.2 目录管理 27
3.2.1 新增项目申报接口 27
3.3 医生管理 31
3.3.1 医生信息上传接口 31
4. 附件 34
4.1 请求文件 34
4.2 回复文件 35
1. 前言
1.1 概述
接口实现的功能为门诊结算。采用WebService进行信息交换，每个业务接口主要步骤均为：医院程序通过接口提交一个请求，社保系统收到请求后进行业务的处理并返回处理的结果，医院程序收到结果后根据结果进行业务的处理。
1.2 适用范围
本接口规范的阅读对象为实现与佛山市三水区居民“一卡通”医疗保险信息系统进行医保结算进行程序开发的相关人员包括但不限于各医疗机构的技术人员。
1.3 参考文档
《众意科技数据交换平台技术方案.doc》
1.4 术语说明
XML：是eXtensible Markup Language的缩写。扩展标记语言XML是一种简单的数据存储语言，使用一系列简单的标记描述数据。
Web Service：是一个应用程序，它向外界暴露出一个能够通过Web进行调用的API，这就是说，能够用编程的方法通过Web来调用这个应用程序。
2. 接口技术说明
2.1 概述
本联网结算接口是通过众意科技数据交换平台来完成的，众意科技数据交换平台是用于不同业务系统之间进行数据交换的技术组件，实现在各种业务系统之间进行数据采集、数据共享和业务协同服务，众意科技数据交换平台是采用XML作为数据传输标准，通过Web Service/SOAP服务请求和调用来实现业务系统间数据传输、交换和共享的。
众意科技数据交换平台提供了一个统一的标准的数据传输接口，该接口是一个WebService服务接口。每一项业务活动的数据采集只需要将该项业务活动产生的数据形成对应的数据采集接口规范定义的XML数据格式，就可以通过众意科技数据交换平台提供的统一传输接口实现数据的采集，具体调用步骤是：各类医疗卫生机构业务系统通过众意科技数据交换平台提供的统一传输接口提交一个请求，将业务数据发送给社区卫生服务平台，社区卫生服务平台收到业务数据后进行相应数据加工处理后并返回处理结果，各类医疗卫生机构业务系统收到处理结果后应该根据处理结果进行相应的处理，若处理结果是成功，则需要记录成功标志，以免重复发送，相反，则需要记录传输失败标志，如下图所示：
2.2 WSDL文件地址
电信网络：
正式：待定
测试：http://128.1.2.30:9080/wsdl/DxAskService.wsdl
2.3 接口定义
String replyFile = dxAsk(String askCommand, String askId, String askFile, String sourceId, String destinationId, String authType, String userName, String password, String certProvider, String securityData)
入参：
askCommand: 请求命令
askId: 请求编号（注：固定为0）。
askFile: 请求文件（注：请求文件格式请参考4.1请求文件）
sourceId: 发送端编号，系统统一编号，具有唯一性。
destinationId：接收端编号（注：固定为”001”）。
authType:（注：固定为1）
userName, password: 当用户认证方式为用户名/密码方式时有效，分别表示请求的用户名和密码，由数据交换平台统一分配
certProvider：（注：固定为空）
securityData ：表示对askFile的MD5摘要值的BASE64编码，要求使用微软的“CAPICOM”控件进行MD5摘要计算。
返回值：
replyFile：回复文件（注：回复文件格式请参考4.2回复文件）
2.4 接口调用
在各种开发环境中均可按照WebService的标准方式进行调用。这里以Delphi为例：
使用SOAP和CAPICOM相关控件
2.5 相关约定
本文按照JAVA语言格式描述相关定义与调用。所有参数项和返回值全部为字符串。
数字证书指“广东省电子政务数字证书认证中心”和“广东省电子商务数字证书认证中心”签发的数字证书，分别简写为GDCA和NETCA。（可选）
医院联网结算系统分接口、网报两种方式，且可以两种方式并用。即两种方式可以任意交叉使用，如用接口进行自动结算，用网报手动结算，用网报进行统计查询等。
业务参数askFile和返回值replyFile都采用标准的XML1.0格式，字符集为“GB18030”，并使用中文标签，具体按各章中的约定。
在askFile参数中，“社会保障卡号”和“公民身份号码”两个域可以只填一个域（或两个域都填），不填的域补空串，但“姓名”域必须填。只有当所提供的域（含姓名域）与参保人完全相符时才返回正确结果。
在retXML中，请求结果域0表示成功；1表示异常；2表示重复请求）
所有的参数不能以换行符或空格结尾。
3. 数据采集接口规范
3.1 门诊结算
3.1.1 门诊资格确认接口
3.1.1.1.1 接口参数
参数名称 参数说明 约定 备注
askCommand 请求命令 MzAccountConfirm
askId 请求编号 固定为“0”
askFile 请求文件 见“请求文件定义”
sourceId 发送端编号 由系统约定分配
destinationId 接收端编号 固定为”001”
authType 用户认证方式 固定为“1”
userName 用户名 由系统约定分配
password 密码
certProvider 发送端数字证书提供商 固定为“” 目前暂不使用数字证书
securityData 校验码 对请求文件的MD5摘要值的BASE64编码，要求使用微软的“CAPICOM”控件进行MD5摘要计算。
3.1.1.1.2 请求文件定义
Header部分
标签 约定 备注
askcommand 请求命令（注：与接口对应参数必须保持相同）
askid 请求编号（注：与接口对应参数必须保持相同）
sourceid 发送端编号（注：与接口对应参数必须保持相同）
destinationid 接收端编号（注：与接口对应参数必须保持相同）
authtype 用户认证方式（注：与接口对应参数必须保持相同）
username 用户名（注：与接口对应参数必须保持相同）
password 密码（注：与接口对应参数必须保持相同）
certprovider 发送端数字证书提供商（注：与接口对应参数必须保持相同）
asktime 请求时间（YYYY-MM-DD HH:MM:SS 注：指发送端发出请求的本地时间）
version 数据交换版本编号（注：目前固定为1.0）
remark 备注信息
Body部分
标签 约定 备注
证件类别 1位，不能为空 1为身份证，2为社保卡
证件号码 不能为空 对应的证件号码
业务数据：
<门诊资格确认>
<证件类别>
<证件号码>
Footer部分
标签 约定 备注
signdata 固定为空 目前暂不用
hashvalue 固定为空 目前暂不用
signcert 固定为空 目前暂不用
示例：
MzAccountConfirm
0
010
001
1
zhangsheng
12345678
2010-01-12 09:03:01
1.0
<门诊资格确认>
<证件类别>1
<证件号码>123
|
|
资源大小： 
