醫(yī)院信息平臺(tái)接口規(guī)范

新奧博為技術(shù)有限公司

2015-04

更改頁(yè)

序號(hào)版本號(hào)更改內(nèi)容描述更改人更改日期

創(chuàng)建文檔，定義幃交互點(diǎn)，基礎(chǔ)字典同步下載接口

12.0.0李長(zhǎng)松2015-04-21

平臺(tái)服務(wù)部分接口請(qǐng)求參數(shù)結(jié)構(gòu)中添加服務(wù)版本參

22.0.1李長(zhǎng)松2015-05-13

數(shù)

李長(zhǎng)松、

添加AOC、A02.A03、A04部分交換服務(wù)說(shuō)明

32.0.2李崢、王2015-05-19

立新

添加消息發(fā)布HTTP接口方式，修改A0900參數(shù)結(jié)

42.0.3構(gòu)，添加了SERVICE_TYPE參數(shù)李長(zhǎng)松2015-06-25

添加C2406,C2407,C2408及物資申領(lǐng)信息發(fā)布服

52.0.4務(wù)接口說(shuō)明李長(zhǎng)松2015-07-01

表單流程：①項(xiàng)目負(fù)責(zé)人編制f②立項(xiàng)部門審核f③上一級(jí)部門批準(zhǔn)一④研發(fā)中心存檔

本表單為一份，由研發(fā)中心留存

目錄

1文檔說(shuō)明................................................................................5

2引用標(biāo)準(zhǔn).................................................................................5

3接口方式................................................................................5

3.1WS消息方式.....................................................................6

3.2業(yè)務(wù)協(xié)同與數(shù)據(jù)交換流程.........................................................6

3.3安全訪問(wèn)機(jī)制....................................................................7

4平臺(tái)服務(wù)接口............................................................................8

4.1獲取令牌服務(wù)接口................................................................8

4.1.1接口說(shuō)明...................................................................8

4.1.2場(chǎng)景說(shuō)明...................................................................9

4.1.3調(diào)用地址....................................................................9

4.1.4WS接口定義...............................................................9

4.2消息發(fā)布服務(wù)接口...............................................................11

4.2.1接口說(shuō)明..................................................................11

4.2.2場(chǎng)景說(shuō)明..................................................................12

4.2.3調(diào)用地址...................................................................12

4.2.4WS接口定義...............................................................12

4.3業(yè)務(wù)交換服務(wù)接口...............................................................15

4.3.1接口說(shuō)明...................................................................15

4.3.2場(chǎng)景說(shuō)明..................................................................15

4.3.3調(diào)用地址...................................................................15

4.3.4W5接口定義...............................................................16

5業(yè)務(wù)交換服務(wù)...........................................................................18

5.1業(yè)務(wù)交互服務(wù)概述..............................................................18

5.2基礎(chǔ)交換服務(wù)(A)...................................................................................................................19

5.2.1消息訂閱服務(wù)(A00)......................................................................................................19

5.2.2患者服務(wù)(A01)..............................................................................................................20

5.2.3醫(yī)療衛(wèi)生人員服務(wù)(A02)..............................................................................................21

5.2.4醫(yī)療衛(wèi)生機(jī)構(gòu)(科室)服務(wù)(A03)..............................................................................37

5.2.5術(shù)語(yǔ)和字典服務(wù)(A04).................................................................................................43

5.3臨床業(yè)務(wù)交換服務(wù)(B)..........................................................................................................45

5.4醫(yī)院管理交換服務(wù)(C)..........................................................................................................61

6服務(wù)異常編碼...........................................................................69

2文檔說(shuō)明

本文檔定義了醫(yī)院信息平臺(tái)（后續(xù)簡(jiǎn)稱平臺(tái)）和院內(nèi)業(yè)務(wù)系統(tǒng)（HIS、LIS、PACS、EMR）

的接口方式、接口規(guī)范.

3引用標(biāo)準(zhǔn)

/基于電子病歷的醫(yī)院信息平臺(tái)建設(shè)技術(shù)解決方案（1.0版）2011-03；

,河南省數(shù)字化醫(yī)院建設(shè)指南（2014版）2014-05；

/《電子病歷基本架構(gòu)與數(shù)據(jù)標(biāo)準(zhǔn)（試行）》,2009-12；

/《基于電子病歷的醫(yī)院信息平臺(tái)技術(shù)規(guī)范》，2014-10-01

/《電子病歷基本數(shù)據(jù)集》，2014-5-30；

/河南省基于健康檔案的衛(wèi)生信息平臺(tái)接口庫(kù)說(shuō)明（醫(yī)療服務(wù)V1.7.1）試行

/河南省基于健康檔案的衛(wèi)生信息平臺(tái)接口庫(kù)說(shuō)明（衛(wèi)生資源VI.（）1）試行

4接口方式

醫(yī)院信息集成平臺(tái)業(yè)務(wù)協(xié)同與數(shù)據(jù)交換采用SOA架構(gòu)設(shè)計(jì)，需要ESB企業(yè)總線支持

實(shí)現(xiàn)醫(yī)院業(yè)務(wù)系統(tǒng)業(yè)務(wù)協(xié)同和數(shù)據(jù)的交換。數(shù)據(jù)交換總線功能主要包括：

SOA支持，遵循SOA設(shè)計(jì)原則和技術(shù)標(biāo)準(zhǔn)，提供松耦合模式，實(shí)現(xiàn)業(yè)務(wù)邏輯和應(yīng)用

邏輯、數(shù)據(jù)邏輯等分離；

智能路由支持，采用靈活的消息路由方式，支持基于消息內(nèi)容的處理和路由；

XML支持，支持標(biāo)準(zhǔn)XML數(shù)據(jù)的格式轉(zhuǎn)換，可以通過(guò)圖形化映射組件、XSLT、客戶

化Java程序等多種方式實(shí)現(xiàn)轉(zhuǎn)換功能；

4.1消息發(fā)布/訂閱功能，支持隊(duì)列和主題兩種訂閱模式；

4.2WS消息方式

Webservice是一個(gè)跨語(yǔ)言的，松耦合、平臺(tái)獨(dú)立的、基于可編程的web的應(yīng)用程序，可

使用開放的XML標(biāo)準(zhǔn)來(lái)描述、發(fā)布、發(fā)現(xiàn)、協(xié)調(diào)和配置這些應(yīng)用程序，用于開發(fā)分布式的

互操作的應(yīng)用程序。

/醫(yī)院信息平臺(tái)定義的WS消息交換接口滿足SOAP1.1SOAP1.2.WSDL1.1

WSDL2.0標(biāo)準(zhǔn)規(guī)范。WS接口定義說(shuō)明性描述主要由以下兒部分組成：

/接口說(shuō)明：定義和說(shuō)明接口的作用和適用范圍

/場(chǎng)景說(shuō)明：定義和描述WS服務(wù)接口的調(diào)用卻使用場(chǎng)景、說(shuō)明業(yè)務(wù)處理流程；

/服務(wù)地址：描述WS服務(wù)的調(diào)用URL地址；

/請(qǐng)求數(shù)據(jù)結(jié)構(gòu)：定義和描述WS服務(wù)的請(qǐng)求數(shù)據(jù)結(jié)構(gòu)和參數(shù)說(shuō)明；

4.3響應(yīng)數(shù)據(jù)結(jié)構(gòu)：定義和描述WS服務(wù)的響應(yīng)數(shù)據(jù)結(jié)構(gòu)和參數(shù)說(shuō)

明；

4.4業(yè)務(wù)協(xié)同與數(shù)據(jù)交換流程

1、說(shuō)明：

2、業(yè)務(wù)系統(tǒng)A（入LIS）訂閱相關(guān)業(yè)務(wù)消息，醫(yī)院信息平臺(tái)接收消息訂閱，并存儲(chǔ)訂閱

信息；

3、業(yè)務(wù)系統(tǒng)B（如HIS）處理業(yè)務(wù)過(guò)程中生成業(yè)務(wù)關(guān)鍵數(shù)據(jù)（如醫(yī)生工作站生成實(shí)驗(yàn)

室化驗(yàn)申請(qǐng)單），然后業(yè)務(wù)系統(tǒng)B生成業(yè)務(wù)關(guān)鍵數(shù)據(jù)后，把業(yè)務(wù)關(guān)鍵數(shù)據(jù)調(diào)用醫(yī)院

信息平臺(tái)相關(guān)接口發(fā)送到醫(yī)院信息平臺(tái)。

4、醫(yī)院信息平臺(tái)接收業(yè)務(wù)系統(tǒng)B發(fā)送的關(guān)鍵業(yè)務(wù)數(shù)據(jù)（實(shí)驗(yàn)室化驗(yàn)單申請(qǐng)），將數(shù)據(jù)

存儲(chǔ)入醫(yī)院信息平臺(tái)數(shù)據(jù)中心，同時(shí)將新增或更新業(yè)務(wù)關(guān)鍵數(shù)據(jù)的信息生成消息

（實(shí)驗(yàn)室化驗(yàn)申請(qǐng)單消息）通知推送給已經(jīng)訂閱了相關(guān)內(nèi)容消息的業(yè)務(wù)系統(tǒng)A（如

LIS）

5、業(yè)務(wù)系統(tǒng)A（LIS）接收通知消息，消息內(nèi)容中包括消息關(guān)聯(lián)業(yè)務(wù)數(shù)據(jù)ID（實(shí)驗(yàn)室

化驗(yàn)申請(qǐng)單ID）、消息類型（實(shí)驗(yàn)室化驗(yàn)申請(qǐng)單類型消息）、獲取業(yè)務(wù)數(shù)據(jù)所需要的

服務(wù)接口地址、獲取業(yè)務(wù)數(shù)據(jù)所需要的服務(wù)編碼（實(shí)驗(yàn)室化驗(yàn)申請(qǐng)單查詢服務(wù)編碼）;

6、業(yè)務(wù)系統(tǒng)A（LIS）根據(jù)消息內(nèi)容調(diào)用消息中包含的服務(wù)接口地址，調(diào)用相關(guān)接口服

務(wù)（實(shí)驗(yàn)室化驗(yàn)申請(qǐng)單查詢服務(wù)）獲取指定ID業(yè)務(wù)數(shù)據(jù)；

7、醫(yī)院信息平臺(tái)根據(jù)業(yè)務(wù)系統(tǒng)A（LIS）傳遞的服務(wù)編碼和業(yè)務(wù)數(shù)據(jù)ID,從醫(yī)院信息

平臺(tái)數(shù)據(jù)中心獲取指定數(shù)據(jù)；

8、醫(yī)院信息平臺(tái)將查詢到的業(yè)務(wù)數(shù)據(jù)封裝為標(biāo)準(zhǔn)接口數(shù)據(jù)結(jié)構(gòu)（XML）結(jié)構(gòu)數(shù)據(jù)，返

回業(yè)務(wù)系統(tǒng)A（LIS）；

9、業(yè)務(wù)系統(tǒng)A（LIS）獲取指定業(yè)務(wù)數(shù)據(jù)后進(jìn)行后續(xù)業(yè)務(wù)處理“

4.5安全訪問(wèn)機(jī)制

滿足數(shù)字化醫(yī)院信息安全要求，建立健全的信息安全保障體系是保障院內(nèi)系統(tǒng)安全的

基礎(chǔ)。可靠有效的安全訪問(wèn)機(jī)制，是保證醫(yī)院信息平臺(tái)接口庫(kù)和各業(yè)務(wù)系統(tǒng)WS服務(wù)的安

全，通過(guò)身份驗(yàn)證防止非法用戶、匿名用戶和惡意用戶的非法訪問(wèn)。

5WS接口方式安全訪問(wèn)機(jī)制依賴醫(yī)院信息平臺(tái)

的令牌動(dòng)態(tài)口令算法，平臺(tái)定義令牌加密算法,

每次產(chǎn)生的令牌在設(shè)置時(shí)間內(nèi)是有效的，超過(guò)

令牌的有效期這個(gè)令牌就失效了，必須重新產(chǎn)

生一個(gè)令牌。

6平臺(tái)服務(wù)接口

6.1獲取令牌服務(wù)接口

6.1.1接口說(shuō)明

醫(yī)院信息平臺(tái)在每次調(diào)用接口時(shí)需要帶上access'foken參數(shù)，access，1'oken參數(shù)由

systemCode和systemPassword換取。

systemCode是第三方系統(tǒng)編碼，每個(gè)第三方應(yīng)用系統(tǒng)擁有一個(gè)唯一的systemCode,

systemPassword是系統(tǒng)憑證密碼。

醫(yī)院信息平臺(tái)系統(tǒng)管理員可以通過(guò)管理端的權(quán)限分配給第三方系統(tǒng)一個(gè)唯一的

systemPassword。

當(dāng)?shù)谌较到y(tǒng)調(diào)用醫(yī)院信息平臺(tái)接口時(shí)，醫(yī)院信息平臺(tái)會(huì)根據(jù)此次訪問(wèn)的accessToken,

校驗(yàn)訪問(wèn)的合法權(quán)限以返回相應(yīng)的結(jié)果。

6.1.2accessToken令牌有時(shí)效性，醫(yī)院信息平臺(tái)默認(rèn)設(shè)置為7200秒，平

臺(tái)管理員可以通過(guò)系統(tǒng)參數(shù)修改時(shí)效參數(shù)。如果第三方系統(tǒng)調(diào)用本接口

時(shí)accessToken未過(guò)期，醫(yī)院信息平臺(tái)會(huì)自動(dòng)延長(zhǎng)accessToken到期時(shí)

間。如果調(diào)用本接口時(shí)accessToken過(guò)期，則醫(yī)院信息平臺(tái)會(huì)生成新的

accessToken令牌并返回。

6.1.3場(chǎng)景說(shuō)明

6.1.4第三方系統(tǒng)調(diào)用醫(yī)院信息平臺(tái)業(yè)務(wù)交換服務(wù)接口前，先需要通過(guò)

本接口獲取accessToken,然后使用accessToken再調(diào)用平臺(tái)其他業(yè)務(wù)服

務(wù)接口。

6.1.5調(diào)用地址

http://ip:port//hipSenqce/GetTokenPort

6.1.6WS接口定義

WSDL文檔：

<?xmlvcrsion=T.O"cncoding="UTF-8”?>

<wsdl:definitionsxmlns:wsdl=，，http://schemas,xmlsoap,org/wsdl/"

xm1ns:soap=whttp://schemas,xmlsoap.org/wsdl/soap/z，

xmlns:http=whttp://schemas,xmlsoap,org/wsdl/http/^

xmlns:xs="http:〃www.w3.org/2001/XMLSchema"

xmlns:soapenc=*http://schemas,xmlsoap,org/soap/encoding//，

xmlns:mime=Ahttp://schemas.xmlsoap,org/wsdl/mime/^

xmlns:xsi=/，http://www.w3.org/2001/XMl.Schema-instance，/xmlns:tns=*http:/\vww.xinbohi:com”

targetNamespace="，http:/ww.xinbohit.com”>

<wsdl:types>

<xs:schematargetNamespace=//http://wwx.xinbohi:.com"elementForniDefault=/zqualified*/>

</wsdl:types>

<wsdl:messagename="GetTokenRequest”>

<wsd1:partname=，，rcquestld/，type="xs:string”/〉

<wsdl:partname="requestIP"type=，xs:string，z/>

<wsdl:partname="systemCode“type="xs:string'/〉

<wsdl:parlname="syslemPassword"lype="xs:string”/〉

</wsdl:message>

<wsdl:messagename=，/GctTokonResponsc，/>

<wsdl:partname="requestld“type="xs:string'/)

<wsdl:partname="msgCode"type=，，xs:string，7>

<wsdl:partname="msgDesc"type="xs:string”/)

<wsdl:partname=，，accessToken，/type="xs:string”/)

</wsdl:message〉

<wsdl:portTypename=/，GetTokenPortTypew>

<wsdl:operationnan,o=，/getToken

<wsd1:inputmessage=*tns:GetTokenRequest，//>

<wsdl:outputmessage=，/tns:GetTokcnRcsponse，7>

</wsdl:operation>

</wsdl:portType>

<wsd1:bindingname="GeLTokenBinding“type="ins:GetTokenPortType”>

<soap:bindingstyle=，，document，ztransport=//http://schemas,xmlsoap.org/soap/httpv/>

<wsdl:operationnan,e=，/getToken"?

<soap:operationsoapAction="http:〃www.xinoohit.com/services^style="document”/〉

<wsdl:input>

<soap:bodyuse="1iteral'/〉

</wsdl:input>

<wsdl:output)

<soap:bodyuse="literal”/〉

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

<wsdl:servicename="GetTokenService”>

<wsdl:portname=/，GGtTokenPort，/binding="，tns:Ge:TokenBinding，，>

<soap:addresslocation="http://ip:port/hipService/GetTokenServicez，/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

參數(shù)說(shuō)明

請(qǐng)求參數(shù)

是否

(GetTokenRequest):數(shù)據(jù)類型說(shuō)明

必須

參數(shù)

requestld字符串是UUID

requestIP字符串是第三方系統(tǒng)所在服務(wù)器的IP地址

systemCode字符串是第三方系統(tǒng)編碼

systemPassword字符串是第三方系統(tǒng)請(qǐng)求密碼

響應(yīng)參數(shù)

是否

(GetTokenResponse):數(shù)據(jù)類型說(shuō)明

必須

參數(shù)

requestld字符串是請(qǐng)求是攜帶的參數(shù)requestld

msgCode字符串是請(qǐng)求消息編碼（0000為請(qǐng)求正常，其他為處理異常，具

體異常編碼參考平臺(tái)服務(wù)消息編碼部分）

msgDesc字符串是請(qǐng)求消息描述

accessToken字符串是返回的第三方系統(tǒng)調(diào)用接口令牌

6.2消息發(fā)布服務(wù)接口

6.2.1接口說(shuō)明

本接口主要提供消息通知服務(wù)，當(dāng)醫(yī)院信息平臺(tái)數(shù)據(jù)中心相關(guān)業(yè)務(wù)數(shù)據(jù)發(fā)生變化，本

接口會(huì)生成相關(guān)消息，然后推送到已經(jīng)訂閱了本消息的二方系統(tǒng)°

本接口推送消息如果失敗，醫(yī)院信息平臺(tái)5分鐘第二次推送消息，如果第二次推送消

息失敗，在過(guò)30分鐘第三次推送消息，如果第三次掛送消息失敗，再過(guò)90分鐘第四次推

送消息，依次類推。醫(yī)院信息平臺(tái)在七次推送消息都失敗后，平臺(tái)停止消息推送。平臺(tái)管理

員可以設(shè)置每次消息推送失敗間隔時(shí)間。

七次推送失敗的消息醫(yī)院信息平臺(tái)提供推送消息失敗n志查詢。

6.2.2場(chǎng)景說(shuō)明

6.2.3當(dāng)醫(yī)院信息平臺(tái)數(shù)據(jù)中心相應(yīng)業(yè)務(wù)數(shù)據(jù)發(fā)生變化時(shí)，通過(guò)本接口

發(fā)布給已經(jīng)訂閱了相關(guān)消息的第三方系統(tǒng)。

6.2.4調(diào)用地址

業(yè)務(wù)系統(tǒng)提供

6.2.5接口定義

WebService接口方式

說(shuō)明

WebService方式指業(yè)務(wù)系統(tǒng)作為WebService服務(wù)端，醫(yī)院平臺(tái)作為WebService客戶端，業(yè)務(wù)系統(tǒng)在消

息訂閱時(shí)提供服務(wù)端調(diào)用地址（參見(jiàn)A0000服務(wù)的RECEIVE_URL參數(shù)說(shuō)明）。當(dāng)有消息需要發(fā)布時(shí)，醫(yī)

院平臺(tái)根據(jù)訂閱信息，將信息數(shù)據(jù)通過(guò)消息發(fā)布接口推送至業(yè)務(wù)系統(tǒng)。

WSDL定義

WSDL文檔：

<?xmlversion=*l.0*encoding="UTF-8”?》

<!一被20120使用XMLSpyv編輯的(http://www.altova.ccm)by->

<wsdl:definitionsxmlns:wsdl=/，http://schemas,xmlsoap.org/wsdl//z

xmlns:soap=z/http://schemas,xmlsoap.org/wsdl/soap/z，

xm1ns:http=，zhttp://schemas,xmlsoap,org/wsdl/http/*

xmlns:xs=，，http://www.w3.org/2001/XMLSchema"

xmIns:soapenc=//http://schemas,xmlsoap,org/soap/encoding/"

xmlns:mime=whttp://schemas,xmlsoap.org/wsdl/mime/w

xm1ns:xsi=/，h11p://www.w3.org/2001/XMLSchcina-instancewxmlns:tns=，zhttp://www.xinbohit.com”

targetNamespace=/，http://www.xinbohit.com”>

<wsdl:types>

<xs:schematargetNamespace=//http://new.webservice,namespace”

elementFormDefau1t=，，qualifiad”/>

</wsdl:types>

<wsdl:messagename=，，NotifyRequest，z>

<wsdl:parlname="nclifyCode“type="xs:siring”/〉

<wsdl:partname=/，calIBackServiceVersion/ztype="xs:string"〉

<wsdl:partname=，，callBackServiceCode，/type=wxs:string，V>

<wsdl:partname=/，calIBacUWsUrKtype="xs:string”/)

<wsdl:partname="data"typc="xs:string”/)

<wsdl:partname="pubCQunt"type="xs:

</wsdl:message>

<wsdl:porlTypename=，/NotifyPorlType/，>

<wsdl:operationnaire="Notify”>

<\vsdl:inputmessagc=，/tns:NotifyRcquest/，/>

</wsdl:operation>

</wsdl:portType>

<wsdl:bind!ngname=，，NotifyBinding，ztype="tns:NotifyPortType”〉

<soap:bindingstyle="document“transport=whttp://schemas.xmlsoap.org/soap/http，7>

<wsdl:operationnan.e=zNotify*>

<soap:operationsoapAction="http:〃/services“style=，，document，V>

<wsdl:input>

<soap:bodyuse=*literal*/>

</wsdl:input>

</wsdl:operation>

</wsdl:binding)

<wsdl:servicename=，?NotifyServicez，>

<wsdl:portname=wNctifyPort，rbinding="ztns:Noti:yBindingw>

<soap:addresslocalion=/，http://localhost/hipService"/>

</wsdl:port>

</wsdl:scrvice>

</wsdl:definitions>

參數(shù)說(shuō)明

請(qǐng)求參數(shù)：是否

數(shù)據(jù)類型說(shuō)明

參數(shù)必須

notifyCode字符串是消息編碼，具體編碼參考各個(gè)信息發(fā)布

接口定義

callBackServiceVersion字符串是回調(diào)服務(wù)版本號(hào)

calIBackScrvicoCode字符串是回調(diào)服務(wù)編碼，具體編碼參考業(yè)務(wù)交換

服務(wù)編碼定義

callBackWsUrl字符串是回調(diào)服務(wù)地址

data字符串是消息附帶業(yè)務(wù)數(shù)據(jù)，多個(gè)數(shù)據(jù)用人"分

隔,例如：abcAAA123456AAAadmin

pubCount整型是消息推送次數(shù)

響應(yīng)參數(shù)：

6.252無(wú)響應(yīng)參數(shù)，消息發(fā)布服務(wù)接口負(fù)責(zé)發(fā)布相關(guān)業(yè)務(wù)數(shù)據(jù)新增、更新消

息，消息發(fā)布未返回異常醫(yī)院信息平臺(tái)即認(rèn)為消息發(fā)送成功

6.2.53HTTP接口方式

說(shuō)明

HTTP方式指業(yè)務(wù)系統(tǒng)作為服務(wù)端提供HTTP服務(wù)，醫(yī)院平臺(tái)作為調(diào)用HTTP服務(wù)的客戶端，業(yè)務(wù)系統(tǒng)在

消息訂閱時(shí)提供服務(wù)端調(diào)用地址（參見(jiàn)A0000服務(wù)的RECEIVE_URL參數(shù)說(shuō)明）。當(dāng)有消息需要發(fā)布時(shí),

醫(yī)院平臺(tái)根據(jù)訂閱信息，將信息數(shù)據(jù)通過(guò)消息發(fā)布接口推送至業(yè)務(wù)系統(tǒng)。參數(shù)以POST方式作為HTTP請(qǐng)

求參數(shù)傳遞到服務(wù)端。

參數(shù)說(shuō)明

請(qǐng)求參數(shù)：是否

數(shù)據(jù)類型說(shuō)明

參數(shù)必須

notifyCodc字符串是消息編碼，具體編碼參考各個(gè)信息發(fā)布

接口定義

calIBackServiceVersion字符串是回調(diào)服務(wù)版本號(hào)

callBackServiceCode字符串是回調(diào)服務(wù)編碼，具體編碼參考業(yè)務(wù)交換

服務(wù)編碼定義

calIBackWslrl字符串是回調(diào)服務(wù)地址

data字符串是消息附帶業(yè)務(wù)數(shù)據(jù)，多個(gè)數(shù)據(jù)用人”分

隔，例如：abcAAA123456AAAadmin

pubCount整型是消息推送次數(shù)

響應(yīng)參數(shù):

6.3無(wú)響應(yīng)參數(shù)，消息發(fā)布服務(wù)接口負(fù)責(zé)發(fā)布相關(guān)業(yè)務(wù)數(shù)據(jù)新增、更

新消息，消息發(fā)布未返回異常醫(yī)院信息平臺(tái)即認(rèn)為消息發(fā)送成

功

6.4業(yè)務(wù)交換服務(wù)接口

6.4.1接口說(shuō)明

6.4.2業(yè)務(wù)交換服務(wù)接口主要完成各類業(yè)務(wù)交換過(guò)程中的功能接口，每

個(gè)不同的業(yè)務(wù)功能由服務(wù)編碼區(qū)分（具體編碼見(jiàn)業(yè)務(wù)交換服務(wù)部分的服

務(wù)編碼說(shuō)明）。

6.4.3場(chǎng)景說(shuō)明

6.4.4當(dāng)業(yè)務(wù)系統(tǒng)需要進(jìn)行數(shù)據(jù)交換時(shí)，首先需要獲取令牌，然后使用令

牌調(diào)用本接口調(diào)用指定服務(wù)編碼服務(wù)，完成數(shù)據(jù)交換過(guò)程。

6.4.5調(diào)用地址

http://ip:port//hipService/ConnnonPort

6.4.6WS接口定義

WSDL文檔：

<?xmlversion=*l.0*encoding="UTF-8”?》

<!一被2012()使用XYLSpyv編輯的(http://www.a11ova.ccm)by—>

<wsd1:definitionsxmlns:wsdl=/，http://schemas,xmlsoap,org/wsdl/"

xm1ns:soap=，/http://schemas,xmlsoap.org/wsdl/soap/z，

xmlns:http=*http://schemas,xmlsoap.org/wsdl/http///

xmlns:xs="http:〃www.w3.org/2001/XMLSchema"

xm1ns:soapenc="zhttp://schemas,xmlsoap,org/soap/encoding//'

xmlns:mime=/xhttp://schemas,xmlsoap.org/wsdl/mime//，

xm1ns:xsi=/，http://www.w3.org/2001/XMLSchcma-instance，/xmlns:tns=，zhttp://www.xinbohit.com”

targetNamespace="http:〃www.xinbohit.com”>

<wsdl:types>

<xsi:schemaxmlns:xsi="http:〃www.w3.org/2001/XMLSchemaz，

targetNamespace=，，http://w\nv.xinbohit.com"elementFormDefault="qualified'7>

</wsdl:types>

<wsdl:messagename=，zComnionRequest//>

<wsdl:partname=zzrcqucstld//typo=/，xs:stringz7>

<wsdl:partname="accessToken”type="xs:string”/)

<wsdl:partname=//requestIP/ztypc="xs:string”/)

<wsdl:partname="requestUserAccount“type="xs:string”/〉

<wsdl:partname=wscrviceVersion/ztype="xs:stringz7>

<wsdl:partname="serviceCode"type="xs:siring”/)

<wsdl:partname="requestData"type="xs:string”/)

</wsdl:message)

<wsdl:messagename="ConuionResponse”>

<wsdl:partname=//rcquestId/，typc="xs:string”/)

<wsdl:partname="msgCode“type="xs:string”/》

<wsdl:partname=，，msgDesc，ztype="xs:string”/)

<wsdl:partname="responseDala“l(fā)ype="xs:slring"/〉

</wsdl:message>

<wsdl:portTypename="CommonPortType”〉

<wsdl:operationnaire="Common”〉

<wsd1:inputmessage="ins:CommonRequest/'/)

<wsd1:outputmessage=wtns:CommonResponse/z/>

</wsdl:operation>

</wsdl:portType>

<wsdl:bindingname=，/CoimionBinding，/type=/，tns:CommonPortType，，>

<soap:bindingsty1G=/document，/transport=*http://schemas,xmlsoap,org/soap/ht

<wsd1:operationnane="Common”〉

<soap:operationsoapAction=*http://www.xinjohiI.com/services*slyle="document/7>

<wsdl:input>

<soap:bodyusc="literal”/)

</wsdl:input>

<wsdl:output>

<soap:bodyuse=z，literal*/>

</wsdl:output>

</wsd1:operation>

</wsdl:binding>

<wsdl:servicename=，/ConinonServiceA，>

<wsd1:portname="CcmmonPort“binding=z，tns:CommonBindingw>

<soap:addresslocation=z，http://localhost/HipScrvicc，，/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

參數(shù)說(shuō)明

請(qǐng)求參數(shù)

是否

參數(shù)數(shù)據(jù)類型說(shuō)明

必須

roqucstld字符串是UUID

accessToken字符串是第三方系統(tǒng)調(diào)用接口令牌，參考獲取令牌服務(wù)接口定義

requestIP字符串是第三方系統(tǒng)中相應(yīng)用戶所在客戶端的IP地址

requestUserAccount字符串是第三方系統(tǒng)中相應(yīng)用戶賬戶

serviceVersion字符串是調(diào)用的服務(wù)版本號(hào)

serviceCode字符串是調(diào)用的服務(wù)編碼，具體編碼參考業(yè)務(wù)交換服務(wù)中的定義

requestData字符串是調(diào)用服務(wù)需要的請(qǐng)求數(shù)據(jù)，具體定義參考相應(yīng)服務(wù)定義

響應(yīng)參數(shù)

參數(shù)數(shù)據(jù)據(jù)類類型型|是否否|說(shuō)明

必須

requestId字符串是消息編碼，具體編碼參考各個(gè)信息發(fā)布接口定義

msgCode字符串是請(qǐng)求消息編碼（0000為請(qǐng)求正常，其他為處理異常，具體異常

編碼參考平臺(tái)服務(wù)消息編碼部分）

msgDesc字符串是請(qǐng)求消息描述

rosponsoData字符串否服務(wù)返回的響應(yīng)數(shù)據(jù)，具體定義參考相應(yīng)服務(wù)定義

7業(yè)務(wù)交換服務(wù)

7.1業(yè)務(wù)交互服務(wù)概述

,約定：

/所有日期時(shí)間轉(zhuǎn)成字符串

/請(qǐng)求和返回的xml信息的標(biāo)簽均為大寫

7.2基礎(chǔ)交換服務(wù)（A）

7.2.1消息訂閱服務(wù)（A00）

721.1訂閱消息服務(wù)（A0000）

＞服務(wù)編碼

＞服務(wù)編碼:A0000

＞服務(wù)說(shuō)明

＞本服務(wù)提供業(yè)務(wù)系統(tǒng)訂閱平臺(tái)各種消息通知，訂閱消息通知后，平臺(tái)根據(jù)

訂閱主題會(huì)推送相關(guān)消息到訂閱制定通知地址

＞請(qǐng)求參數(shù)

RequestType

…-RECEIVE_URL：

1_____________1

段次汽電URLI

_______________________________________I

參數(shù)說(shuō)明

序號(hào)參數(shù)名稱參數(shù)類型是否參數(shù)說(shuō)明

必需

10PERAT10N_TYPEInt是操作類型0-訂閱消息「取消訂閱

2TOPICSString是消息主題序列，多個(gè)消息主題需要用半

角逗號(hào)分隔。

3SERVICE_TYPEInt否接口服務(wù)方式OTVS方式1-HTTP方式

4RECE1VE_URLString否接收消息URL,如果OPERATION_TYPE為

0,則此參數(shù)必需，此URL提供的接收消

息的服務(wù)方式，具體定義參照本文檔

【4.2消息發(fā)布服務(wù)接口】定義。

XML示例:

〈REQUEST〉

<OPERATION_TYPE>O</OPERATION_TYPE>

<TOPICS>String</TOPICS>

<SERVICE_TYPE>O</SERVICE^TYPE>

<RECEIVE_URL>String</RECEIVE_URL>

〈/REQUEST)

>響應(yīng)參數(shù)

無(wú)

7.2.2患者服務(wù)（AOI）

暫未定

7.2.3醫(yī)療衛(wèi)生人員服務(wù)（A02）

醫(yī)護(hù)人員業(yè)務(wù)系統(tǒng)編碼上傳（A0201）

＞服務(wù)編碼

＞服務(wù)編碼:A0201

＞服務(wù)說(shuō)明

＞本服務(wù)主要實(shí)現(xiàn)各個(gè)業(yè)務(wù)系統(tǒng)對(duì)醫(yī)療服務(wù)人員進(jìn)行自定義編碼后，將自定

義編碼上傳平臺(tái)，平臺(tái)對(duì)醫(yī)療服務(wù)人員在不同業(yè)務(wù)系統(tǒng)的編碼形成對(duì)照索引O

＞請(qǐng)求參數(shù)

XML示例:

<REQUEST>

<HIP_STAFF_CODE>String</HIP_STAFF_CODE>

〈OPERATIONSTAFFCODE>String</OPERATIONSTAFFCODE)

</REQUEST>

A響應(yīng)參數(shù)

723.2參數(shù)說(shuō)明：無(wú)

7.23.3醫(yī)護(hù)人員信息查詢（A0202）

A服務(wù)編碼

>服務(wù)編碼：A0202

>服務(wù)說(shuō)明

本服務(wù)主要實(shí)現(xiàn)對(duì)平臺(tái)中維護(hù)的醫(yī)療服務(wù)人員信息的查詢功能。

>請(qǐng)求參數(shù)

|RequestType

r-<KIP_DEPT_CODES;

；平三片己屋克

r--：HHIP_STAFF_CODES;

:平占醫(yī)笊妾?jiǎng)?wù)，.員:H子丸

REQUEST中---1-H+-<OPERATIOH_DEPT_CODES]

A0202話二參會(huì)|：業(yè)務(wù)系獲?？速e亞序列

；--：HOPERATIOH_STAFF_CODES：

業(yè)務(wù)票找醫(yī)療履務(wù)人員"碼序列

!--<MAME_KEI：

醫(yī)療抬務(wù)人至走名關(guān)M字

參數(shù)參數(shù)名稱參數(shù)類型是否取值參數(shù)說(shuō)明

說(shuō)必需范圍

明：

序號(hào)

1HIP_DEPT_CODESString否平臺(tái)科室編碼序列，多個(gè)科室編

碼之間用半角逗號(hào)分隔。

2HTP_STAFF_CODESString否平臺(tái)醫(yī)療服務(wù)人員編他序列，多

個(gè)醫(yī)療服務(wù)人員編碼之間用半角

逗號(hào)分隔。

3OPERATION_DEPT_CODESString否業(yè)務(wù)系統(tǒng)科室編碼序列，多個(gè)科

室編碼之間用半角逗號(hào)分隔。

4OPERAT1ON_STAEE_CODESString否業(yè)務(wù)系統(tǒng)醫(yī)療服務(wù)人員編碼序列，

多個(gè)醫(yī)療服務(wù)人員編碼之間用半

角逗號(hào)分隔。

5NAME_KEYString否醫(yī)療服務(wù)人員姓名關(guān)鍵字

注意：5個(gè)參數(shù)中，在一次請(qǐng)求中只能包含一個(gè)參數(shù)，如果有多個(gè)參數(shù)，則以第一個(gè)參數(shù)為準(zhǔn)進(jìn)行醫(yī)療

服務(wù)人員相關(guān)信息查詢。

XML示例：

〈REQUEST)

<H1PDEPT_CODES>String</HIPDEPTCODES>

<HIP_STAFF_CODES>String</HIP_STAFF_CODES>

〈OPERATIONDEPTCODES>String</OPERATIONDEPTCODES)

<OPERATION_STAFF_CODES>String</OPERATION^STAFFCODES>

<NAME_KEY>String</NAME_KEY>

〈/REQUEST〉

>響應(yīng)參數(shù)

「ResponxeTjrpe

IRecordType

11

1T=m_STUP_CODE|

1，幺至工啤需

1?1STAFFJIAM：

1縣工量名

1■:“GEHDER:

1工制

11--rUJGIOMIKj

1

1.*A」Dj|

1CAW］杼媒

1

1■■?CEmFICATE_BO:

?——?????—????a1

1A你名9

'1

1-rBRITKBATI■

1

1e?=?yyvv-MM-dd

1-rHATIOIALS?

1

；

1riMMOSPITAL_DATE

1關(guān)決門閨yyvy-MM-dd

1?產(chǎn)STAFFSORT：

1?........................................

1