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