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