山市三水區居民“一卡通”醫療保險信息系統接口規范
目錄
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
|
|
資源大�。� 
