山市三水區(qū)居民“一卡通”醫(yī)療保險信息系統(tǒng)接口規(guī)范
目錄
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 接口調(diào)用 5
2.5 相關約定 6
3. 數(shù)據(jù)采集接口規(guī)范 6
3.1 門診結算 6
3.1.1 門診資格確認接口 6
3.1.2 門診結算接口 11
3.1.3 門診結算取消接口 19
3.1.4 門診上傳發(fā)票號接口 23
3.1.5 個人相片上傳 27
3.2 目錄管理 27
3.2.1 新增項目申報接口 27
3.3 醫(yī)生管理 31
3.3.1 醫(yī)生信息上傳接口 31
4. 附件 34
4.1 請求文件 34
4.2 回復文件 35
1. 前言
1.1 概述
接口實現(xiàn)的功能為門診結算。采用WebService進行信息交換，每個業(yè)務接口主要步驟均為：醫(yī)院程序通過接口提交一個請求，社保系統(tǒng)收到請求后進行業(yè)務的處理并返回處理的結果，醫(yī)院程序收到結果后根據(jù)結果進行業(yè)務的處理。
1.2 適用范圍
本接口規(guī)范的閱讀對象為實現(xiàn)與佛山市三水區(qū)居民“一卡通”醫(yī)療保險信息系統(tǒng)進行醫(yī)保結算進行程序開發(fā)的相關人員包括但不限于各醫(yī)療機構的技術人員。
1.3 參考文檔
《眾意科技數(shù)據(jù)交換平臺技術方案.doc》
1.4 術語說明
XML：是eXtensible Markup Language的縮寫。擴展標記語言XML是一種簡單的數(shù)據(jù)存儲語言，使用一系列簡單的標記描述數(shù)據(jù)。
Web Service：是一個應用程序，它向外界暴露出一個能夠通過Web進行調(diào)用的API，這就是說，能夠用編程的方法通過Web來調(diào)用這個應用程序。
2. 接口技術說明
2.1 概述
本聯(lián)網(wǎng)結算接口是通過眾意科技數(shù)據(jù)交換平臺來完成的，眾意科技數(shù)據(jù)交換平臺是用于不同業(yè)務系統(tǒng)之間進行數(shù)據(jù)交換的技術組件，實現(xiàn)在各種業(yè)務系統(tǒng)之間進行數(shù)據(jù)采集、數(shù)據(jù)共享和業(yè)務協(xié)同服務，眾意科技數(shù)據(jù)交換平臺是采用XML作為數(shù)據(jù)傳輸標準，通過Web Service/SOAP服務請求和調(diào)用來實現(xiàn)業(yè)務系統(tǒng)間數(shù)據(jù)傳輸、交換和共享的。
眾意科技數(shù)據(jù)交換平臺提供了一個統(tǒng)一的標準的數(shù)據(jù)傳輸接口，該接口是一個WebService服務接口。每一項業(yè)務活動的數(shù)據(jù)采集只需要將該項業(yè)務活動產(chǎn)生的數(shù)據(jù)形成對應的數(shù)據(jù)采集接口規(guī)范定義的XML數(shù)據(jù)格式，就可以通過眾意科技數(shù)據(jù)交換平臺提供的統(tǒng)一傳輸接口實現(xiàn)數(shù)據(jù)的采集，具體調(diào)用步驟是：各類醫(yī)療衛(wèi)生機構業(yè)務系統(tǒng)通過眾意科技數(shù)據(jù)交換平臺提供的統(tǒng)一傳輸接口提交一個請求，將業(yè)務數(shù)據(jù)發(fā)送給社區(qū)衛(wèi)生服務平臺，社區(qū)衛(wèi)生服務平臺收到業(yè)務數(shù)據(jù)后進行相應數(shù)據(jù)加工處理后并返回處理結果，各類醫(yī)療衛(wèi)生機構業(yè)務系統(tǒng)收到處理結果后應該根據(jù)處理結果進行相應的處理，若處理結果是成功，則需要記錄成功標志，以免重復發(fā)送，相反，則需要記錄傳輸失敗標志，如下圖所示：
2.2 WSDL文件地址
電信網(wǎng)絡：
正式：待定
測試：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)
入?yún)ⅲ?br />
askCommand: 請求命令
askId: 請求編號（注：固定為0）。
askFile: 請求文件（注：請求文件格式請參考4.1請求文件）
sourceId: 發(fā)送端編號，系統(tǒng)統(tǒng)一編號，具有唯一性。
destinationId：接收端編號（注：固定為”001”）。
authType:（注：固定為1）
userName, password: 當用戶認證方式為用戶名/密碼方式時有效，分別表示請求的用戶名和密碼，由數(shù)據(jù)交換平臺統(tǒng)一分配
certProvider：（注：固定為空）
securityData ：表示對askFile的MD5摘要值的BASE64編碼，要求使用微軟的“CAPICOM”控件進行MD5摘要計算。
返回值：
replyFile：回復文件（注：回復文件格式請參考4.2回復文件）
2.4 接口調(diào)用
在各種開發(fā)環(huán)境中均可按照WebService的標準方式進行調(diào)用。這里以Delphi為例：
使用SOAP和CAPICOM相關控件
2.5 相關約定
本文按照JAVA語言格式描述相關定義與調(diào)用。所有參數(shù)項和返回值全部為字符串。
數(shù)字證書指“廣東省電子政務數(shù)字證書認證中心”和“廣東省電子商務數(shù)字證書認證中心”簽發(fā)的數(shù)字證書，分別簡寫為GDCA和NETCA。（可選）
醫(yī)院聯(lián)網(wǎng)結算系統(tǒng)分接口、網(wǎng)報兩種方式，且可以兩種方式并用。即兩種方式可以任意交叉使用，如用接口進行自動結算，用網(wǎng)報手動結算，用網(wǎng)報進行統(tǒng)計查詢等。
業(yè)務參數(shù)askFile和返回值replyFile都采用標準的XML1.0格式，字符集為“GB18030”，并使用中文標簽，具體按各章中的約定。
在askFile參數(shù)中，“社會保障卡號”和“公民身份號碼”兩個域可以只填一個域（或兩個域都填），不填的域補空串，但“姓名”域必須填。只有當所提供的域（含姓名域）與參保人完全相符時才返回正確結果。
在retXML中，請求結果域0表示成功；1表示異常；2表示重復請求）
所有的參數(shù)不能以換行符或空格結尾。
3. 數(shù)據(jù)采集接口規(guī)范
3.1 門診結算
3.1.1 門診資格確認接口
3.1.1.1.1 接口參數(shù)
參數(shù)名稱 參數(shù)說明 約定 備注
askCommand 請求命令 MzAccountConfirm
askId 請求編號 固定為“0”
askFile 請求文件 見“請求文件定義”
sourceId 發(fā)送端編號 由系統(tǒng)約定分配
destinationId 接收端編號 固定為”001”
authType 用戶認證方式 固定為“1”
userName 用戶名 由系統(tǒng)約定分配
password 密碼
certProvider 發(fā)送端數(shù)字證書提供商 固定為“” 目前暫不使用數(shù)字證書
securityData 校驗碼 對請求文件的MD5摘要值的BASE64編碼，要求使用微軟的“CAPICOM”控件進行MD5摘要計算。
3.1.1.1.2 請求文件定義
Header部分
標簽 約定 備注
askcommand 請求命令（注：與接口對應參數(shù)必須保持相同）
askid 請求編號（注：與接口對應參數(shù)必須保持相同）
sourceid 發(fā)送端編號（注：與接口對應參數(shù)必須保持相同）
destinationid 接收端編號（注：與接口對應參數(shù)必須保持相同）
authtype 用戶認證方式（注：與接口對應參數(shù)必須保持相同）
username 用戶名（注：與接口對應參數(shù)必須保持相同）
password 密碼（注：與接口對應參數(shù)必須保持相同）
certprovider 發(fā)送端數(shù)字證書提供商（注：與接口對應參數(shù)必須保持相同）
asktime 請求時間（YYYY-MM-DD HH:MM:SS 注：指發(fā)送端發(fā)出請求的本地時間）
version 數(shù)據(jù)交換版本編號（注：目前固定為1.0）
remark 備注信息
Body部分
標簽 約定 備注
證件類別 1位，不能為空 1為身份證，2為社保卡
證件號碼 不能為空 對應的證件號碼
業(yè)務數(shù)據(jù)：
<門診資格確認>
<證件類別>
<證件號碼>
Footer部分
標簽 約定 備注
signdata 固定為空 目前暫不用
hashvalue 固定為空 目前暫不用
signcert 固定為空 目前暫不用
示例：
MzAccountConfirm
0
010
001
1
zhangsheng
12345678
2010-01-12 09:03:01
1.0
<門診資格確認>
<證件類別>1
<證件號碼>123
|
|
資源大�。� 
