預(yù)約診療系統(tǒng)接口標(biāo)準(zhǔn)

（試行版）

Version:4.0

編制：陳璐

審核：毛云鵬

日期:2015-7-17

文檔修訂歷史紀(jì)錄

日期版本說明編制審核

2013-04-09V1.0創(chuàng)建陳璐毛云鵬

2015-03-28V3.0增加了病床查詢接口陳璐毛云鵬

2015-4-3V3.0增加轉(zhuǎn)診的病床查詢、掛號接口陳璐毛云鵬

2015-7-17V4.0陳璐毛云鵬

目錄

目錄...............................................................2

1.接口概述.......................................................

2.接口定義........................................................2

3.1消息傳輸格式...............................................................2

3.2發(fā)送命令格式...............................................................3

3.3響應(yīng)命令格式...............................................................4

3.4獲取掛號科室...............................................................5

3.5獲取掛號醫(yī)生...............................................................6

3.6獲取醫(yī)生掛號級別信息.......................................................8

3.7獲取普通排班信息...........................................................9

3.8新增患者信息..............................................................11

3.9預(yù)約掛號..................................................................12

3.10預(yù)約掛號確認(rèn)（取號）.....................................................13

3.11預(yù)約掛號撤銷（退號）.....................................................15

3.12獲取掛號信息.............................................................16

3.13機構(gòu)信息.................................................................17

3.14獲取體檢項目.............................................................20

3.15獲取體檢套餐.............................................................21

3.16新增體檢預(yù)約.............................................................22

3.17當(dāng)日排班信息.............................................................23

3.18當(dāng)日掛號.................................................................24

3.19當(dāng)日掛號確認(rèn)（取號）.....................................................26

3.20當(dāng)日掛號撤銷（退號）.....................................................27

3.21獲取醫(yī)生掛號量信息.......................................................28

3.22檢驗結(jié)果查詢.............................................................30

3.23醫(yī)生咨詢.................................................................33

3.24咨詢查詢.................................................................34

3.25門診費用查詢.............................................................35

3.26住院費用查詢.............................................................38

3.27藥品價格查詢.............................................................40

3.28檢查項價格查詢...........................................................41

3.29檢查結(jié)果查詢.............................................................42

3.30叫號查詢.................................................................45

3.31導(dǎo)醫(yī)查詢.................................................................46

3.32醫(yī)囑查詢.................................................................48

3.33醫(yī)院床位查詢.............................................................49

3.34醫(yī)院轉(zhuǎn)診床位查詢.........................................................50

3.35面向公眾即時號源信息.....................................................51

3.36面向醫(yī)療機構(gòu)即時號源信息.................................................52

3.37獲取網(wǎng)上診療排班信息.....................................................53

L接口概述

本接口是預(yù)約診療系統(tǒng)的接口標(biāo)準(zhǔn)的實現(xiàn)。

接口采用http標(biāo)準(zhǔn)的webservice和中間表方式實現(xiàn)接口功能，主要提供幾個

方面功能：

＞掛號科室信息同步

＞掛號醫(yī)生信息同步

＞醫(yī)生排班信息同步

＞新增患者信息

＞預(yù)約掛號

＞預(yù)約掛號確認(rèn)（取號）

＞預(yù)約掛號撤銷（退號）

＞掛號記錄查詢

＞機構(gòu)信息同步（可選）

＞預(yù)約體檢同步

＞檢驗單查詢

＞醫(yī)生咨詢

＞咨詢查詢

＞門診費用查詢

＞住院費用查詢

＞藥品價格查詢

＞檢驗項價格查詢

＞叫號查詢

第1頁共63頁

2.接口定義

3.1消息傳輸格式

消息傳輸格式為XML規(guī)則字符串。

同時，為了傳輸格式的規(guī)范化，以及傳輸?shù)母咝剩覀兌x簡易的XML規(guī)則字

符串，此處對傳輸格式進(jìn)行概念的說明：

簡易XML規(guī)則字符串包含三個重要的定義，數(shù)據(jù)集、數(shù)據(jù)表、數(shù)據(jù)字段。

1、數(shù)據(jù)集：我們使用〈ADTECHX/ADTECH〉匹配對來定義數(shù)據(jù)集，每次消息

傳輸，只允許傳一個數(shù)據(jù)集，也就是說在單次數(shù)據(jù)傳輸?shù)倪^程中

<ADTECHX/ADTECH>匹配對只會出現(xiàn)一次；

2、數(shù)據(jù)表：我們使用〈數(shù)據(jù)表名>〈/數(shù)據(jù)表名〉匹配對來定義數(shù)據(jù)表（其中

“數(shù)據(jù)表名”表示要傳的記錄），每次消息傳輸允許傳輸多條記錄；

3、數(shù)據(jù)字段：我們使用〈數(shù)據(jù)字段名〉〈/數(shù)據(jù)字段名〉匹配對來定義數(shù)據(jù)字

段（其中“數(shù)據(jù)字段名”表示要傳的記錄中的字段），每個數(shù)據(jù)表中不允許出現(xiàn)

不同的字段名。

例如，我們現(xiàn)在有個“數(shù)據(jù)表名”叫做“TABLE」”的表記錄需要傳輸，包含了

三個字段分別是“COLUMN」”、“C0LUMN_2”、“COLUMN_3”，另有個“TABLE_2”

表記錄，包含兩個字段分別是“C0LUMN_4"、“COLUMN_5”。現(xiàn)在需要傳輸一條

“TABLE」”記錄和兩條“TABLE_2”記錄，那么XML規(guī)則字符串的應(yīng)該如下所示：

<ADTECH>

<TABLE_1>

〈COLUMN」〉值1</COLUMN_1>

〈COLUMN_2>值2</C0LUMN_2〉

<COLUMN_3><3</COLUMN_3>

</TABLE_l>

<TABLE_2>

<C0LUMN_4>值4</C0LUMN_4>

〈COLUMN_5>值5</COLUMN_5>

第2頁共63頁

</TABLE_2>

<TABLE2>

〈C0LUMN_4>值6</C0LUMN_4>

〈C0LUMN_5〉值7〈/C0LUMN_5〉

</TABLE_2>

</ADTECH>

3.2發(fā)送命令格式

發(fā)送命令形式的XML規(guī)則字符串，后者通過解析收到的XML規(guī)則字符串，執(zhí)

行相應(yīng)的命令以后，將結(jié)果返回給醫(yī)院。

數(shù)據(jù)集內(nèi)容：

數(shù)據(jù)表保留字說明

消息頭<HEADERX/HEADER>包含命令和驗證，單記錄（由接口提供方規(guī)

定）

消息參數(shù)<HEADERX/HEADER>包含執(zhí)行命令的參數(shù)，單記錄

數(shù)據(jù)集格式:

<ADTECH>

<HEADER>

〈TRANSACT〉交易命令〈/TRANSACT〉

〈ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

〈參數(shù)名1>參數(shù)值1</參數(shù)名1>

〈參數(shù)名2>參數(shù)值2〈/參數(shù)名2>

〈參數(shù)名n〉參數(shù)值n〈/參數(shù)名n>

</INPARA>

第3頁共63頁

</ADTECH>

3.3響應(yīng)命令格式

接收到發(fā)送過來的XML規(guī)則字符串，將命令解析，在驗證正確的情況下,

執(zhí)行交易命令，并將結(jié)果返回給第三方。

數(shù)據(jù)集內(nèi)容：

數(shù)據(jù)表保留字說明

消息頭<HEADERX/HEADER>包含命令和驗證，單記錄

消息參數(shù)<RESULTSX/RESULTS>包含執(zhí)行交易命令后的傳出參數(shù)，單記錄

消息體〈結(jié)果表名X/結(jié)果表名〉包含執(zhí)行命令的參數(shù)，多記錄

數(shù)據(jù)集格式:

<ADTECH>

<HEADER>

〈TRANSACT〉交易命令〈/TRANSACT〉

〈ORG_CODE>醫(yī)院代碼</ORG_CODE〉

〈PASSWORD）交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>返回代碼</RET_CODE>

<RET_INFO〉返回結(jié)果描述〈/RET_INFO〉

〈參數(shù)名1〉參數(shù)值1</參數(shù)名1>

〈參數(shù)名2>參數(shù)值2〈/參數(shù)名2>

〈參數(shù)名n〉參數(shù)值n〈/參數(shù)名n>

</RESULTS>

〈結(jié)果表名〉

〈字段名1>字段值1〈/字段名1>

〈字段名2>字段值2〈/字段名2>

第4頁共63頁

〈字段名n〉字段值n〈/字段名n>

〈/結(jié)果表名》

〈結(jié)果表名〉

〈字段名1>字段值1〈/字段名1>

〈字段名2>字段值2〈/字段名2>

〈字段名n>字段值n〈/字段名n>

〈/結(jié)果表名〉

</ADTECH>

3.4獲取掛號科室

說明：通過接口向醫(yī)院請求查詢科室的命令，醫(yī)院通過中間庫返回所有科室信息,

例如專科，內(nèi)科等。

參數(shù)：

返回值：科室列表，RET_CODE為1為成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_DEPT</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD>

</HEADER>

</ADTECH>

A返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_DEPT</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

第5頁共63頁

〈PASSWORD〉交易密碼〈/PASSWORD>

</HEADER>

<RESULTS>

<RET_CODE>信息代碼</RET_CODE>

〈RET」NFO>返回信息描述</RET_INFO>

<LIST>

<DEPT>

<DEPT_TYPE_ID>科室類別ID〈/DEPT_TYPE_ID>

〈ORG_CODE>醫(yī)院編碼</ORG_CODE>

<DEPT_CODE〉科室編碼〈/DEPT_CODE>

〈DEPT_NAME〉科室名稱〈/DEPT_NAME〉

<DEPT_ADDR>科室地址〈/DEPT_ADDR〉

<DEPT_REMARK>科室簡介</DEPT_REMARK>

〈PARENT_ID>上級ID</PARENT_ID>

<IS_LEAF>是否子節(jié)點〈/IS_LEAF>

<NODE_LEVEL>等級〈/NODE_LEVEL>

〈STATUS〉狀態(tài)〈/STATUS〉

<P_CODE>拼音簡碼（/P_CODE>

</DEPT>

</LIST>

</RESULTS>

</ADTECH>

3.5獲取掛號醫(yī)生

說明：通過接口向醫(yī)院請求查詢醫(yī)生的命令，通過中間表返回所有醫(yī)生信息，主

要查詢內(nèi)容有醫(yī)生信息，所屬部門，掛號級別等

參數(shù)：

返回值：醫(yī)生列表。RET/ODE為1為成功，其他失敗

第6頁共63頁

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代碼</RET_CODE>

<RET_INFO>返回信息描述〈/RETJNFO〉

<LIST>

<STAFF>

〈DEPT_CODE〉科室編碼〈/DEPT_CODE>

<STAFF_CODE>醫(yī)生編碼</STAFF_CODE>

<STAFF_NAME>醫(yī)生名稱</STAFF_NAME〉

〈STAFF_REMARK〉醫(yī)生簡介〈/STAFF_REMARK>

<HOME_TEL>電話〈/HOME_TEL〉

〈BIRTH〉生日</BIRTH>

〈SEX>性別〈/SEX>

<E_MAIL>電子郵件〈/E_MAIL>

<ID_CARD〉身份證號碼</ID_CARD〉

〈HOME_ADDR>家庭地址〈/HOME_ADDR>

第7頁共63頁

(STATUS〉狀態(tài)〈/STATUS〉

〈SPELLING〉拼音〈/SPELLING〉

〈AVGTIME〉平均看病時間〈/AVGTIME〉

〈STAFF_REGNUM>掛號數(shù)〈/STAFF_REGNUM〉

</STAFF>

</LIST>

</RESULTS>

</ADTECH>

3.6獲取醫(yī)生掛號級別信息

說明：通過接口向醫(yī)院請求查詢掛號級別的命令，醫(yī)院中間表返回所有掛號級別

信息，如副高、正高，專家等

參數(shù)：

返回值：醫(yī)生掛號級別列表，RET/ODE為1為成功，其他失敗

A發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF_TYPE</TRANSACT>

〈ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF_TYPE</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

第8頁共63頁

</HEADER>

<RESULTS>

〈RET_CODE〉信息代碼</RET_CODE〉

<RET」NFO〉返回信息描述</RET」NFO>

<LIST>

<STAFF_TYPE>

<ORG_CODE>醫(yī)院編碼</ORG_CODE>

<STAFF_TYPE_CODE>醫(yī)生級別編碼〈/STAFF_TYPE_CODE〉

〈STAFF_TYPE_NAME〉醫(yī)生級別名稱</STAFF_TYPE_NAME〉

<REGIST_PRICE>掛號費</REGIST_PRICE>

<CLINIC_PRICE>診療費</CLINIC_PRICE>

〈OTHER_PRICE>其他費用</OTHER_PRICE>

</STAFF_TYPE>

</LIST>

</RESULTS>

</ADTECH>

3.7獲取普通排班信息

說明：向醫(yī)院發(fā)出同步排班信息（排班周期一般為一周或根據(jù)醫(yī)院需求）的請求,

醫(yī)院中間表返回未來一段時間的排班信息。

參數(shù)：

返回值：排班信息列表。RET/ODE為1為成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_DUTY</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

第9頁共63頁

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_DUTY</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE>

<RET」NFO>返回信息描述〈/RET_INFO〉

<LIST>

<DUTY>

<UUID>排班ID</UUID>

〈DUTY_DATE〉排班日期〈/DUTY_DATE〉

〈PERIOD〉上下午〈/PERIOD〉

<STAFF_CODE>醫(yī)生編碼</STAFF_CODE〉

<DEPT_CODE>科室編碼</DEPT_CODE〉

<STAFF_TYPE_CODE>醫(yī)生級別編碼〈/STAFF_TYPE_CODE>

〈STATUS〉狀態(tài)〈/STATUS》

〈REG_NUM>可預(yù)約數(shù)</REG_NUM>

</DUTY>

</LIST>

</RESULTS>

</ADTECH>

第10頁共63頁

3.8新增患者信息

說明：向醫(yī)院提交增加患者信息的請求，并傳入患者信息。寫入中間庫或第二階

段通過醫(yī)院接口處理成功后返回患者的編號(USER_CODE)；失敗則返回錯誤

消息。

參數(shù)：患者信息，如患者姓名、性別、年齡等。

返回值：患者CODE或失敗消息，RET/ODE為1為成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_AMS_USER</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<ID_CARD〉身份證號〈/ID_CARD〉

<NAME_CN>中文姓名</NAME_CN>

〈NAME_EN>英文姓名</NAME_EN>

<HOME_TEL>家庭電話〈/HOME_TEL>

〈MOBILE〉移動電話〈/MOBILE>

<BIRTH>生日〈/BIRTH〉

〈SEX>性別〈/SEX>

〈FOLK〉民族〈/FOLK〉

〈WEDLOCK〉婚姻狀態(tài)</WEDLOCK>

<E_MAIL>電子郵件</E_MAIL>

<ID_CARD>身份證〈/ID_CARD>

〈HOME_ADDR>家庭地址〈/HOME_ADDR>

〈CARTEVITALE>醫(yī)保卡號</CARTEVITALE>

</INPARA>

</ADTECH>

第11頁共63頁

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_USER</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE>

<RET」NFO》返回信息描述〈/RET」NFO>

</RESULTS>

</ADTECH>

3.9預(yù)約掛號

說明：向醫(yī)院發(fā)出掛號請求，傳入掛號信息，醫(yī)院處理后返回成功或失敗消息。

第一階段只將掛號數(shù)據(jù)寫入到醫(yī)院前置機中間表。第二階段調(diào)用醫(yī)院提供實時接

口，返回成功信息。

參數(shù)：掛號信息

返回值：預(yù)約成功或失敗消息。RET/ODE為1為成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<UUID>排班ID</UUID>

<USER_ID_CARD>患者身份證號碼</USER」D_CARD〉

〈USER_CARD_NUMBER>患者就診卡號〈/USER_CARD_NUMBER>

第12頁共63頁

〈USER_NAME>患者姓名</USER_NAME>

〈PAY_TYPE〉1-三方支付、2-醫(yī)保〈/PAYJTYPE〉

〈PAY_AMOUNT>支付金額</PAY_AMOUNT〉

〈PAY_NO>支付流水號〈/PAY_NO>

〈PAY_CARD_ID〉支付卡號〈/PAY_CARD」D〉

<IS_PAY>是否支付〈/IS_PAY>

</INPARA>

</ADTECH>

>返回信息格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>信息代碼</RET_CODE〉

〈RETJNFO〉返回信息描述</RET」NFO>

<REG_UUID>本次預(yù)約掛號功成的唯一標(biāo)識〈/REG_UUID》

</RESULTS>

</ADTECH>

3.10預(yù)約掛號確認(rèn)（取號）

患者到醫(yī)院進(jìn)行預(yù)約掛號確認(rèn)后，醫(yī)院向預(yù)約系統(tǒng)更新預(yù)約取號成功的信息。該

方法只需要在中間前置機中將掛號記錄中的is_used修改為1,取號時間修改為

患者取號的時間即可，然后由預(yù)約診療系統(tǒng)通過查詢掛號記錄的狀態(tài)，更新狀態(tài)

到預(yù)約平臺。

說明：向醫(yī)院提交預(yù)約掛號是否取號的請求。

參數(shù)：就診日期

返回值:預(yù)約掛號記錄列表或失敗消息,RET/ODE為1為成功，其他失敗;CONFIRM

第13頁共63頁

為1是已取號，2是未取號，3已退號

察發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_REG_CONFIRM</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<VISIT_DATE>就診日期〈/VISIT_DATE〉

</INPARA>

</ADTECH>

>返回信息格式

<ADTECH>

<HEADER>

<TRANSACT>REG_CONFIRM</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE>

〈RET」NFO》返回信息描述〈/RET」NFO>

<LIST>

<REG>

〈REG_UUID〉預(yù)約掛號功成的唯一標(biāo)識〈/REG_UUID>

〈CONFIRM）是否取號（0-未取，1-已取）</CONFIRM>

</REG>

</LIST>

</RESULTS>

第14頁共63頁

</ADTECH>

3.11預(yù)約掛號撤銷（退號）

說明：患者可在預(yù)約就診前一天通過各個途徑對預(yù)約掛號進(jìn)行撤銷操作，向醫(yī)院

發(fā)送退號請求，醫(yī)院對退號請求處理后返回成功或失敗信息。

參數(shù)：掛號信息，掛號狀態(tài)，退號時間等。

返回值：返回信息描述。RET/ODE為1為成功，其他失敗

A發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>CANCEL_REG</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<REG_UUID〉預(yù)約掛號的UUID</REG_UUID>

</INPARA>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>CANCEL_REG</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE〉

<RET」NFO>返回信息描述</RET」NFO>

</RESULTS>

第15頁共63頁

</ADTECH>

3.12獲取掛號信息

說明：向醫(yī)院發(fā)出獲取掛號信息的請求，醫(yī)院中間表返回一段時間的掛號信息。

參數(shù)：

返回值：掛號信息列表

異發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_REG</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

〈TIMEBEGIN〉創(chuàng)建時間的開始時間</TIMEBEGIN>

〈TIMEEND>創(chuàng)建時間的結(jié)束時間</TIMEEND>

</INPARA>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_REG</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE>

〈RET_INFO>返回信息描述〈/RET_INFO>

第16頁共63頁

<LIST>

<REG>

〈REG_UUID>掛號UUID</REG_UUID>

〈USER_CODE>用戶編碼</USER_CODE>

〈REG_WAY〉掛號途徑〈/REG_WAY>

<STAFF_CODE>醫(yī)生編碼</STAFF_CODE>

<DEPT_CODE>科室編碼</DEPT_CODE〉

〈ORG_CODE>醫(yī)院編碼</ORG_CODE>

〈ORDER」IME〉預(yù)約時間</ORDER_TIME>

〈PERIOD_NAME>時段名稱〈/PERIOD_NAME〉

<PERIOD_DETAIL>時段詳情</PERIOD_DETAIL>

<STAFF_NAME>醫(yī)生名稱〈/STAFF_NAME>

〈DEPT_NAME〉科室名稱〈/DEPT_NAME〉

〈ORG_NAME>醫(yī)院編碼</ORG_NAME>

〈USER_NAME>用戶名稱〈/USER_NAME〉

〈CREATEJHME〉創(chuàng)建掛號時間</CREATE_TIME>

〈REG_NUMBER>就診號〈/REG_NUMBER〉

〈IS_PAY>是否支付</IS_PAY>

<IS_USER〉是否取號〈/IS_USER>

</REG>

</LIST>

</RESULTS>

</ADTECH>

3.13機構(gòu)信息

說明：向醫(yī)院發(fā)送醫(yī)院信息同步請求，醫(yī)院返回本醫(yī)院信息。（本接口所需信息

可以人工到醫(yī)院采集，無須做接口）

參數(shù)：

第17頁共63頁

返回值：機構(gòu)信息列表

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_ORG</TRANSACT>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

</ADTECH>

A返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_ORG</TRANSACT>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE〉信息代碼〈/RET_CODE>

〈RET」NFO>返回信息描述〈/RET_INFO>

<ORG>

〈ORG_CODE>醫(yī)院編碼</ORG_CODE>

〈PARENT_CODE>上級機構(gòu)編碼〈/PARENT_CODE〉

〈ORG_NAME>醫(yī)院名稱</ORG_NAME>

<ORG_DESC>醫(yī)院排序</ORG_DESC〉

(STATUS〉狀態(tài)〈/STATUS>

〈ORG_REMARK>醫(yī)院簡介</ORG_REMARK〉

<CONTACT_PHONE>聯(lián)系電話</CONTACT_PHONE>

<IS_PAY>支付提供支付</IS_PAY>

〈SPELLING》拼音編碼〈/SPELLING〉

<ISNEED_CARD〉是否需要就診卡</ISNEED_CARD>

</ORG>

</RESULTS>

第18頁共63頁

</ADTECH>

3.14就診卡驗證

說明：如果醫(yī)院需要掛號必須要就診卡需要添加此接口，通過用戶姓名，身份證

號和就診卡號調(diào)用醫(yī)院接口判斷就診卡是否真實。

返回值：RET_CODE為1為成功，其他失敗

A發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>CHECK_USER_INFO</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD》交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<ID_CARD〉身份證號</ID_CARD>

<USER_NAME>用戶姓名</USER_NAME>

<HOSPITAL_CARD〉醫(yī)院就診卡號</HOSPITAL_CARD>

</INPARA>

</ADTECH>

》返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_REG_NUMBER</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD》

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE>

〈RET」NFO》信息描述〈/RET_INFO>

</RESULTS>

</ADTECH>

第19頁共63頁

3.15獲取體檢項目

說明：通過接口向醫(yī)院請求查詢體檢項目的命令。

參數(shù)：

返回值：項目列表RET_CODE為1成功，其他失敗

》發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_PRODUCT</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD》

</HEADER>

</ADTECH>

A返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_PRODUCT</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>信息代碼〈/RET_CODE>

〈RET」NFO〉返回信息描述</RET」NFO>

<MCPRODUCT>

〈PRODUCT_CODE〉體檢項目編碼</PRODUCT_CODE〉

<PRODUCT_NAME>體檢項目名稱〈/PRODUCT_NAME〉

〈EXPLAIN〉值〈/EXPLAIN)

<PRODUCT_TYPE>體檢類別〈/PRODUCT_TYPE〉

〈STATUS〉狀態(tài)〈/STATUS〉

第20頁共63頁

〈PRICEAMOUNT〉價格〈/PRICEAMOUNT〉

〈ORG_CODE>醫(yī)院編碼</ORGJXDE〉

</MCPRODUCT>

</RESULTS>

</ADTECH>

3.16獲取體檢套餐

說明：通過接口向醫(yī)院請求查詢體檢套餐的命令。

參數(shù)：

返回值：套餐列表RET_CODE為1成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_PRODUCT_COMPOSITION</TRANSACT>

〈ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

</ADTECH>

》返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_PRODUCT_COMPOSITION</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD》

</HEADER>

<RESULTS>

<RET_CODE>信息代碼〈/RET_CODE>

〈RET」NFO>返回信息描述〈/RET_INFO>

<MCPRODUCT>

第21頁共63頁

<COMPOSITION_CODE>體檢套餐編碼（/COMPOSITION_CODE>

〈PRDUCTJODE〉體檢項目編碼〈/PRDUCT_CODE〉

〈ORG_CODE>醫(yī)院編碼</ORG_CODE〉

<IS_MUST>是否必選項〈/IS_MUST>

〈STATUS〉狀態(tài)〈/STATUS〉

〈PRICEAMOUNT〉價格〈/PRICEAMOUNT〉

</MCPRODUCT>

</RESULTS>

</ADTECH>

3.17體檢預(yù)約

說明：通過接口向醫(yī)院新增預(yù)約體檢。

參數(shù)：

返回值：是否成功RET/ODE為1成功，其他失敗

%發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_CHECKUP</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD）交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<C0MP0Sm0N_C0DE>套餐編碼</COMPOSITION_CODE〉

<USER_ID_CARD>客戶身份證號碼〈/USER_ID_CARD〉

<USER_NAME〉客戶姓名</USER_NAME>

<PAY_TYPE>1-三方支付、2-醫(yī)保〈/PAY_TYPE>

〈PAY_AMOUNT>支付金額</PAY_AMOUNT>

<PAY_NO>支付流水號</PAY_NO>

<PAY_CARD_ID>支付卡號〈/PAY_CARD_ID〉

第22頁共63頁

<IS_PAY〉是否支付</IS_PAY>

</INPARA>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_CHECKUP</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD》

</HEADER>

<RESULTS>

<RET_CODE〉信息代碼</RET_CODE>

<RET」NFO》返回信息描述〈/RET」NFO>

</RESULTS>

</ADTECH>

3.18當(dāng)日排班信息

說明：通過接口獲取醫(yī)院的當(dāng)日排班信息

返回值：排班信息列表。RET_CODE為1為成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_DUTY_NOW</TRANSACT>

〈ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

第23頁共63頁

<HEADER>

<TRANSACT>GET_MC_DUTY_NOW</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE〉

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>信息代碼〈/RET_CODE>

<RET」NFO>返回信息描述〈/RET_INFO>

<LIST>

<DUTY>

〈UUID〉編碼</UUID>

〈ORG_ID>醫(yī)院編碼</ORG_ID>

<DUTY_DATE>排班日期</DUTY_DATE〉

〈PERIOD〉上下午〈/PERIOD>

<STAFF_CODE>醫(yī)生編碼〈/STAFF_CODE>

(STAFF_NAME〉醫(yī)生姓名〈/STAFF_NAME〉

<DEPT_NAME〉科室名稱〈/DEPT_NAME>

〈DEPT_CODE〉科室編碼〈/DEPTJXDE〉

〈STAFF_TYPE_CODE>醫(yī)生級別編碼〈/STAFF_TYPE_CODE>

〈STATUS〉狀態(tài)〈/STATUS〉

<REG_NUM>可掛號數(shù)</REG_NUM〉

</DUTY>

</LIST>

</RESULTS>

</ADTECH>

319當(dāng)日掛號

說明：向醫(yī)院發(fā)出掛號請求，傳入掛號信息，醫(yī)院處理后返回成功或失敗消息。

第24頁共63頁

調(diào)用醫(yī)院掛號的實時接口，實現(xiàn)當(dāng)日掛號的實時性。

參數(shù)：掛號信息

返回值：掛號成功或失敗消息。RET/ODE為1為成功，其他失敗

>發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG_NOW</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

〈UUID〉排班ID</UUID>

〈USER_ID_CARD>患者身份證號碼〈/USER_ID_CARD>

〈USER_CARD_NUMBER>患者就診卡號〈/USER_CARD_NUMBER>

<USER_NAME>患者姓名</USER_NAME>

<PAY_TYPE>1-三方支付、2-醫(yī)保</PAY_TYPE〉

〈PAY_AMOUNT>支付金額</PAY_AMOUNT〉

<PAY_NO>支付流水號</PAY_NO>

<PAY_CARD_ID>支付卡號</PAY_CARD_ID〉

<IS_PAY>是否支付（/IS_PAY>

</INPARA>

</ADTECH>

>返回］n、格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG_NOW</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

第25頁共63頁

〈RET_CODE>信息代碼</RET_CODE>

<RET」NFO>返回信息描述〈/RET」NFO>

〈REG_UUID〉本次預(yù)約掛號功成的唯一標(biāo)識</REG_UUID〉

</RESULTS>

</ADTECH>

3.20當(dāng)日掛號確認(rèn)（取號）

說明：患者到醫(yī)院進(jìn)行掛號確認(rèn)后，醫(yī)院向預(yù)約系統(tǒng)更新預(yù)約取號成功的信息。

該方法只需要在中間前置機中將掛號記錄中的is_used修改為1,取號時間修改

為患者取號的時間即可，然后由預(yù)約診療系統(tǒng)通過查詢掛號記錄的狀態(tài)，更新狀

態(tài)到預(yù)約平臺。

說明：向醫(yī)院提交掛號是否取號的請求。

參數(shù)：就診日期

返回值:預(yù)約掛號記錄列表或失敗消息,RET/0DE為1為成功，其他失敗;CONFIRM

為1是已取號，2是未取號，3已退號

A發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_REG_CONFIRM</TRANSACT>

<ORG_CODE>醫(yī)院代碼</ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<INPARA>

<VISIT_DATE>就診日期〈/VISIT_DATE>

</INPARA>

</ADTECH>

>返回信息格式

<ADTECH>

<HEADER>

第26頁共63頁

<TRANSACT>REG_CONFIRM</TRANSACT>

<ORG_CODE>醫(yī)院代碼〈/ORG_CODE>

〈PASSWORD〉交易密碼〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE〉信息代碼〈/RET_CODE>

〈RET」NFO>返回信息描述</RET_INFO>

<LIST>

<REG>

〈REG_UUID>掛號功成的唯一標(biāo)識〈/REG_UUID〉

〈CONFIRM〉是否取號（0-未取，1-已取）</CONFIRM>

</REG>

</LIST>

</RESULTS>

</ADTECH>

3.21當(dāng)日掛號撤銷（退號）

說明：患者可在未在醫(yī)院取號時，通過各個途徑對當(dāng)日掛號進(jìn)行撤銷操作，向醫(yī)

院發(fā)送退號請求，醫(yī)院對退號請求處理后返回成功或失敗信息。當(dāng)患者進(jìn)行了退

號操作后，調(diào)用醫(yī)院的退號接口，進(jìn)行實時退號

參數(shù)：掛號信息，掛號狀態(tài)，退號時間等。

返回值：返回信息描述。RET/ODE為1為成功，其他失敗

A發(fā)送命令格式

<ADTECH>

<HEADER>

<TRANSACT>CANCEL_REG_NOW</TRANSACT>

<ORG_CODE>