HIS接口解決方案說明

文檔名稱體檢系統(tǒng)與HIS系統(tǒng)接口文檔

版本號VI.1版本日期2022年1月19日

創(chuàng)建者調(diào)鼎項目部創(chuàng)建日期2022年1月19日

?版本修訂歷史

版本號變更時間變更內(nèi)容擬稿人審批人

VI.12022-1-19發(fā)布池巖

目錄

一.概要說明.......................................................4

1.1基礎(chǔ)規(guī)則條件說明...........................................4

二.HIS收費接口流程說明.........................................5

2.1個人體檢收費流程說明：....................................5

2.2個人體檢退費流程說明.....................................18

2.3個人信息變更流程說明.....................................22

2.4團體收費流程說明..........................................24

三.基礎(chǔ)數(shù)據(jù)同步................................................27

3.1收費項目字典同步（診療項目）.............................27

四.雙方接口標(biāo)準(zhǔn)。..............................................29

1、體檢系統(tǒng)與HIS系統(tǒng)互相提供webservice接口，HIS系統(tǒng)在收費時調(diào)

用體檢系統(tǒng)提供的webservice接口傳入人員基礎(chǔ)信息，收費信息完成建

檔、收費等操作。..............................................29

2、公共約定接口遵從webservice設(shè)計，響應(yīng)以Json或Xml格式返回30

五.接口文檔確認(rèn)（請HIS系統(tǒng)補充完善）30

一.概要說明

為滿足院內(nèi)信息化系統(tǒng)互聯(lián)互通，財務(wù)流程管控等需求，需要將體檢系統(tǒng)與HIS系

統(tǒng)數(shù)據(jù)進(jìn)行對接：即由體險系統(tǒng)登記體檢檢查的收費項目，通過雙方協(xié)定方式同步費用

信息至HIS系統(tǒng)，同時完成在HIS建檔、建立醫(yī)囑等操作（具體操作按需定制），由HIS

收費系統(tǒng)完成收費、打印發(fā)票，并將收費狀態(tài)返回體檢系統(tǒng)。同時接口需要能夠處理加

項、減項、折扣、退費、個人基本信息變更等，便于醫(yī)院系統(tǒng)的科室統(tǒng)一核算及數(shù)據(jù)分

析。

1.1基礎(chǔ)規(guī)則條件說明

1）體檢系統(tǒng)的收費項目與HIS系統(tǒng)的診療項目（或稱組合項目、開單項目等）的對應(yīng)

關(guān)系為——對應(yīng)關(guān)系，對應(yīng)代碼由HIS系統(tǒng)提供，體檢系統(tǒng)對照維護，體檢系統(tǒng)的收費

項目與醫(yī)院的價表對應(yīng)關(guān)系不做單獨對應(yīng)（因his內(nèi)全部收費項目過多，但體檢系統(tǒng)使

用項目有限，如全部同步存儲會給體檢工作人員在編輯選項等操作的時候帶來不便），

通過HIS系統(tǒng)中的診療項目與價表項目的對應(yīng)關(guān)系體現(xiàn)（其它情況另行協(xié)調(diào)對應(yīng)規(guī)則）。

如果體檢系統(tǒng)中的收費項目與HIS系統(tǒng)的收費項目沒有對應(yīng)關(guān)系，由體檢中心與院方進(jìn)

行協(xié)調(diào)處理。

涉及折扣，抹零等財務(wù)操作需與院方及HIS負(fù)責(zé)人員共同協(xié)商討論解決方案。

2）首先需要HTS系統(tǒng)支持折扣收費或按照實收金額收費。

3）折扣或抹零只能接受一種方式，不可執(zhí)行折扣+抹零的收費方式，否則財務(wù)信息

將無法對應(yīng)準(zhǔn)確。

一.HIS收費接口流程說明

2.1個人體檢收費流程說明：

1）個檢客戶在體檢系統(tǒng)登記臺登記；

調(diào)用接口：【HIS人員建檔】

2）體檢系統(tǒng)調(diào)用接II程序【收費申請單方法】，把相關(guān)的個人登記信息及體檢項目寫入HIS

提供收費接收容器中（webservice服務(wù)，中間表，業(yè)務(wù)表，存儲過程等）。

調(diào)用接口：【發(fā)送醫(yī)囑/收費申請單】【修改醫(yī)囑/收費申請單】【作廢醫(yī)囑/收費申請單】

3）HIS收費系統(tǒng)通過體檢號讀取相關(guān)的個人基本信息及收費（診療或套餐）項目信息，進(jìn)行

收費，發(fā)票打印等操作；

4）HIS收費后，由HIS系統(tǒng)調(diào)用體檢系統(tǒng)提供的方法將相應(yīng)套餐（診療）項目的收費狀態(tài)通

過調(diào)用體檢系統(tǒng)提供的接收方法（webservice）,把收費狀態(tài)更新到體檢系統(tǒng)中；

調(diào)用接口：【收費狀態(tài)回傳】

5）個檢客戶即可去相應(yīng)科室進(jìn)行體檢。

注：請HIS提供撤回方法，在HIS系統(tǒng)沒有收費的情況下體檢系統(tǒng)如果有項目變更會直接調(diào)

用撤回方法整單撤回再重新插入。

接口示例:

【his人員建檔】

接口地址http:〃域名或ip地址/api域ublic/open?wsdl

接口描述新增一條體檢人員信息HIS系統(tǒng)完成人員信息檔案建立

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)登記完畢后調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方{

式傳輸〃chLeck1codJe〃:〃〃,

"Patientnamc**:“李四”，

〃〃〃用〃

sex:為，

"Birth":"1992-09-14”,

C-card:,

id_card:,

phone:,

“Ent_type〃：〃10012”,

"Pay_type":"1001”,

“is_com"：“1"，

“comjame"：“中國移動有限公司”，

“amount":"150〃，

“discount":"8",

"Codjdcp〃：〃000001",

operator：成二,

“create」imc”：”2021-11-1408:00:00”，

}

參數(shù)說明數(shù)據(jù)類型其他說明

checkcode體檢編號（流水號）String必填

Patient_name患者姓名String必填

Sex患者性別String男/女

Birth出生日期String

C_card就診卡號String

Idcard用戶身份證號String

phone用戶手機號String

門診10001,住院

Ent_type就診類型String

10002,體檢10012

現(xiàn)金1001,支付寶

Paytypc支付方式String

1005,微信等1006

Is_com是否單位人員int1單位，2個人

Com_name單位名稱String單位人員必填

cimount總金額String必填

discount折扣率int必填

Code_dep申請科室代碼String固定體檢科代碼

operator操作員String

Create」ime創(chuàng)建時間String

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相關(guān)信息或直接返回體檢號

回rcsultCodc和errorMsg示例：

{

“Patient_id":〃tj”,

}

錯誤返回數(shù)據(jù)格式：

(

“errorMsg”：“醫(yī)院編碼不存在”

}

參數(shù)說明數(shù)據(jù)類型其他

Patient_idHIS唯一編碼String

errorMsg錯誤信息描述String

【收費申請單發(fā)送】

接口地址http:〃域名或ip地址/api/public/open?wsdl

接口描述新增一條體檢記錄HIS系統(tǒng)完成體檢人員醫(yī)囑或收費項目傳輸

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)登記完畢后調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方{

式傳輸

checkcode:,

“name”:〃何東苗〃，

Idcard:,

phone:,

“Is_com"：“1"，

“Comjame"："中國移動有限公司”，

“amount":"150〃，

“discount":"8",

[

(

“HisitcmCodc":"B02",

"His_item_Name〃：〃體檢項目02"

}

(

"His_item_Code":"B05",

"His_item_Name〃：〃尿常規(guī)”

}

(

〃His_item_Code〃：“B08",

"His_item_Name":"CT檢查"

}

]

"Code一dep"：〃()0()0()l",

operator：成二,

“creaiejime"："2()21-11-1408:00:00”，

pay_Type:1

)

參數(shù)說明數(shù)據(jù)類型其他說明

PaticntidHIS唯一編碼String必填

checkcode體檢編號（流水號）String必填

name姓名String必填

Idcard用戶身份證號String必填

phone用戶手機號String必填

Is_com是否單位人員int1單位，2個人

Com_name單位名稱String單位人員必填

amount總金額String必填

discount折扣率int必填

必填，收費項目代碼集

Item_List收費項目列表String

合

HisitemCodeHis收費項目代碼String必填

HisitemNamcHis收費項目名稱String必填

Code_dep申請科室代碼String固定體檢科代碼

operator操作員String

Create，ime創(chuàng)建時間String

付款標(biāo)志，1-已支付2-未必填，個人為2,團體

Pay_Typeint

支付為1

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相關(guān)信息或直接返回體檢號

回resu1tCode和errorMsg示例：

{

"Visit_Number〃："cl()0254”

}

錯誤返回數(shù)據(jù)格式：

(

“errorMsg”:“醫(yī)院編碼不存在”

)

參數(shù)說明數(shù)據(jù)類型其他

His流水號/門診號/醫(yī)囑

VisitNumberString

id

errorMsg錯誤信息描述String

【收費申請單撤回】

接口地址http:〃域名或ip地址/api域ub或c/open?wsdl

接口描述撤回尚未收費的申請單,整單撤回或作廢

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)調(diào)整未收費人員信息及項目時調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方(

式傳輸"VisitNumber":"cl00254”,

"Codc_dcp〃：〃000001",

operator：張二,

“create'ime"：”2021-11-1408:00:00",

}

參數(shù)說明數(shù)據(jù)類型其他說明

His流水號/門診號/醫(yī)囑

Visit_NumberString必填

id

Code_dcp申請科室代碼String固定體檢科代碼

operator操作員String

Create」ime操作時間String

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相關(guān)信息或直接返回體檢號

回resultCode和errorMsg示例：

{

"Visit_Number":"c100254"

}

錯誤返回數(shù)據(jù)格式：

（

“errorMsg”：“醫(yī)院編碼不存在”

）

參數(shù)說明數(shù)據(jù)類型其他

His流水號/門診號/醫(yī)囑

Visit_NumberString

id

errorMsg錯誤信息描述String

【收費狀態(tài)回傳】

接口地址http:〃域名或ip地址/api域ublic/open?wsdl

接口描述體檢系統(tǒng)發(fā)起退費操作，發(fā)送退費信息至HIS系統(tǒng)用于退費操作

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)退項操作時調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方{

式傳輸checkcode:,

“Refundamount":"80",

[

(

“HisitemCode":"B02”,

"His_item_Name〃：〃體檢項目02"

“Charge」ype〃:T

}

(

"His_item_Code":"B05",

〃His_ilem_Name":"尿常規(guī)〃

“Chargjtypc”:T'

}

(

"His_item_Code〃：〃B08”,

〃His_itcm_Namc〃:"CT檢查”

〃Charge_type〃:〃l”

}

]

"Code_dep〃："0000()1",

"operator"："J虛U-二"，

“create,imc”：”2021-11-1408:00:00”，

)

參數(shù)說明數(shù)據(jù)類型其他說明

checkcode體檢編號(流水號)String必填

Refund_amount退費金額String必填

必填，退費項目代碼集

Item_List退費項目列表String

合

His_item_CodeHis收費項目代碼String必填

HisitemNamcHis收費項目名稱String必填

必填，1已收費，未收

Charge_type收費狀態(tài)String

費

Code_dep申請科室代碼String固定體檢科代碼

operator操作員String

Create，ime創(chuàng)建時間String

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相應(yīng)信息或直接返回體檢號

回resultCode和errorMsg示例：

(

checkCode:

)

錯誤返回數(shù)據(jù)格式：

{

“errorMsg”：“醫(yī)院編碼不存在”

)

參數(shù)說明數(shù)據(jù)類型其他

chcckCode體檢號String

errorMsg錯誤信息描述String

2.2個人體檢退費流程說明

1)退費需注意是“收費前退費”還是“收費后退費".

收費前退費：調(diào)用【收費申請單撤回】即可。

收費后退費：按照HIS退費相關(guān)步驟確定。

接口示例:

【退費申請】

接口地址http:〃域名或ip地址/api域ublic/open?wsdl

接口描述體檢系統(tǒng)發(fā)起退費操作，發(fā)送退費信息至HIS系統(tǒng)用于退費操作

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)退項操作時調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方(

式傳輸"Visit_Number":"cl2054”,

“Refund_amount":"80",

“ItemJList”:

[

(

，，His_item_Code*:"B02",

"His_item_Name":"體檢項目02”

)

(

“His_item_Code":"B05",

"His_item_Name":"尿常規(guī)"

}

(

"His_item_Code":"B08”,

"HisitemName":"CT檢查"

)

]

"Code_dep〃："000001”,

operator：很二,

“create_time"：“2021-11-1408:00:00",

)

參數(shù)說明數(shù)據(jù)類型其他說明

His流水號/門診號/醫(yī)囑

Visit_NumberString必填

id

Refundamount退費總金額String必填

必填，退費項Fl代碼集

Item_List退費項目列表

合

His_item_CodeHis收費項目代碼String必填

His_item_NameHis收費項目名稱String必填

Code_dep申請科室代碼String固定體檢科代碼

operator操作員String

Create，ime創(chuàng)建時間String

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相應(yīng)信息或直接返回體檢號

回resultCode和errorMsg示例：

{

“VisitNumbcr":"c12346”

)

錯誤返回數(shù)據(jù)格式：

{

“errorMsg”:“醫(yī)院編碼不存在”

}

參數(shù)說明數(shù)據(jù)類型其他

Visit_NumberHis流水號/門診號/醫(yī)囑String

id

errorMsg錯誤信息描述String

2.3個人信息變更流程說明

1）信息變更需注意“基礎(chǔ)信息”及“折扣”變更。

基礎(chǔ)信息變更：姓名，性別，年齡等信息變更可根據(jù)實際情況直接同步兩端數(shù)據(jù)。

折扣變更：按照HIS相關(guān)步驟確定。

2）加項收費流程同2.1收費流程。

【個人信息變更】

接口地址http:〃域名或ip地址/api/p名或c/open?wsdl

接口描述個人基礎(chǔ)信息變更時調(diào)用用于更新基礎(chǔ)信息內(nèi)容

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)修改個人基礎(chǔ)信息完畢后調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方{

式傳輸checkcode:,

“name":"何東苗”，

idcard:,

phone:,

“is_com"：“1"，

“Com_name"："中國移動有限公司”，

"Code_dep"："000001〃，

“operator"："張三"，

“create」ime“：”2021-11-1408:00:00",

)

參數(shù)說明數(shù)據(jù)類型其他說明

checkcode體檢編號（流水號）String必填

name姓名String必填

Id_card用戶身份證號String必填

phone用戶手機號String必填

is_com是否單位人員int1單位，2個人

Com_name單位名稱String單位人員必填

Code_dep申請科室代碼String固定體檢科代碼

operator操作員String

create_time創(chuàng)建時間String

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相關(guān)信息或直接返回體檢號

回resultCode和errorMsg示例：

(

checkCode:

)

錯誤返回數(shù)據(jù)格式：

{

“errorMsg”：“醫(yī)院編碼不存在”

)

參數(shù)說明數(shù)據(jù)類型其他

chockCode體檢號String

errorMsg錯誤信息描述String

2.4團體收費流程說明

1)體檢系統(tǒng)可按照單位批次或整體單位一次或多次收費。

每次收費累計所有費用生成一條費用記錄。

流程同個人收費，把單位作為一個個人信息同步給HIS系統(tǒng)，HIS完成收費。

2）團體體檢為預(yù)收費無需同步收費狀態(tài)到體檢系統(tǒng)。

接口程序模塊

2.發(fā)送單位費用

1體檢系統(tǒng)單位結(jié)算信到HIS系第.

【團體收費結(jié)算】

接口地址http:〃域名或ip地址/api域ub或c/open?wsdl

體檢系統(tǒng)發(fā)起團體收費結(jié)算時用于發(fā)送團體收費信息給his系統(tǒng)，團體可

接口描述

能會多次結(jié)算

服務(wù)方His系統(tǒng)

調(diào)用方體檢系統(tǒng)

調(diào)用時機及說明體檢系統(tǒng)團體收費結(jié)算時調(diào)用

發(fā)送信息:

說明示例

發(fā)送參數(shù)以Body的方{

式傳輸Com_code:,

“Comjame":“中國移動有限公司”,

“comamount":"150000”,

“discount":"8",

count:50,

"Code_dep"："000001”,

〃operator〃："7張1lx—二,“，

"create_time”："2021-11-1408:00:00”，

)

參數(shù)說明數(shù)據(jù)類型其他說明

Com_code單位訂單編號String必填

Com_name單位名稱String必填

Com_amount本次單位結(jié)算金額String必填

count本次結(jié)算人數(shù)int必填

Code_dep申請科室代碼String固定體檢科代碼

operator操作員String

Create_timc創(chuàng)建時間String

返回信息:

說明示例

若接口請求正確則不返調(diào)用成功返回HIS相應(yīng)信息或直接返回體檢號

回resu1tCode和errorMsg示例：

{

〃八1〃〃〃

Com_co(le:

}

錯誤返回數(shù)據(jù)格式：

(

“errorMsg":""

)

參數(shù)說明數(shù)據(jù)類型其他

checkCode體檢號String

errorMsg錯誤信息描述String

三.基礎(chǔ)數(shù)據(jù)同步

3.1收費項目字典同步(診療項目)

1)為保障體檢系統(tǒng)與HIS系統(tǒng)之間物價信息?致，避免出現(xiàn)因HIS物價修改體檢系統(tǒng)未同步

導(dǎo)致的物價不一致問題，需建立兩個系統(tǒng)之間物價同步接口。HIS系統(tǒng)調(diào)整，增加I,作廢相關(guān)診療

項目時需調(diào)用體檢系統(tǒng)提供的物價同步接口，同步更新體檢系統(tǒng)相關(guān)信息。

【收費項目同步】

接口地址http:〃域名或ip地址/api/public/opcn?wsdl

接口描述用于his系統(tǒng)