東華醫(yī)院信息平臺(tái)解決方案-藥房流程接口

1、藥房流程接口文檔1.概述該文檔定義了 DIH 藥房流程與醫(yī)院 HIS 系統(tǒng)或其他系統(tǒng)之間的數(shù)據(jù)交互內(nèi)容及通訊方式，需要與 DIH 藥房流程進(jìn)行連接的系統(tǒng)可參考此文檔實(shí)現(xiàn)各自的接口定義和開發(fā)。2.接口方式說明DIH 藥房流程現(xiàn)在支持的接口方式有：視圖：由數(shù)據(jù)提供方提供數(shù)據(jù)內(nèi)容，并視圖內(nèi)容的即時(shí)過濾（只包含特定時(shí)間段內(nèi)的數(shù)據(jù)），對(duì)雙方系統(tǒng)程序改動(dòng)最小，容易實(shí)現(xiàn)，犧牲一些實(shí)時(shí)性的要求；中間表：由數(shù)據(jù)提供方即時(shí)向中間表是要犧牲一些實(shí)時(shí)性的要求；數(shù)據(jù)，由數(shù)據(jù)接收方中間表數(shù)據(jù)總量（刪除數(shù)據(jù)），雙方系統(tǒng)程序改動(dòng)較小，也WebService：通過標(biāo)準(zhǔn)的 WebService 接口即時(shí)傳遞數(shù)據(jù)，雙方系統(tǒng)程序都要

2、做較大改動(dòng)，需要一些對(duì)接調(diào)試時(shí)間，需要注意異構(gòu)系統(tǒng)之間的差異，實(shí)時(shí)性好；在實(shí)際應(yīng)用中可根據(jù)實(shí)際情況采用其中一種接口方式，或幾種方式混合使用，具體的使用原則是：對(duì)實(shí)時(shí)性要求比較高的接口盡量采用 Webservice，如：門診處方數(shù)據(jù)接口，如果 HIS 需要 DIH 分配取藥窗口并要求 DIH返回窗給 HIS，這個(gè)就要求接口即時(shí)返回，實(shí)時(shí)要求高，最好采用 Webservice 接口調(diào)用。調(diào)用更新數(shù)據(jù)的接口盡量不要使用視圖方式?；A(chǔ)字典數(shù)據(jù)完全由數(shù)據(jù)提供方提供數(shù)據(jù)，接收方不會(huì)做如何改動(dòng)，采用視圖方式比較合適，DIH 流程的定時(shí)同步服務(wù)會(huì)定時(shí)將數(shù)據(jù)同步到 DIH中，必要時(shí) DIH 流程可以手動(dòng)觸發(fā)同步

3、過程。3. 接口內(nèi)容DIH 流程定義的接口包含以下幾部分內(nèi)容，各接口的詳細(xì)說明和數(shù)據(jù)結(jié)構(gòu)內(nèi)容定義請(qǐng)參見后面的附件一、附件二中的具體描述。3.1.基礎(chǔ)字典數(shù)據(jù)藥品字典藥房字典科室字典病區(qū)字典3.2.處方業(yè)務(wù)數(shù)據(jù)門診處方門診配藥完成通知門診患者取藥通知門診發(fā)藥完成通知門診發(fā)藥窗口狀態(tài)變更通知附件一. 視圖/中間表1. 概述基礎(chǔ)字典數(shù)據(jù)建議使用視圖實(shí)現(xiàn)，業(yè)務(wù)數(shù)據(jù)建議使用中間表，可以創(chuàng)建在 DIH庫、HIS 數(shù)據(jù)庫，或其他中間數(shù)據(jù)庫中?；A(chǔ)數(shù)據(jù)接口定義藥品字典create table dictDrug (drugCodevarchar(40)not null-藥品代碼(最好唯一，如不唯一，請(qǐng)標(biāo)明哪幾個(gè)

4、字段可以確定唯一藥品)charge_code 和 serial 共同確定一個(gè)藥,drugName miniSpec miniUnit miniDose doseUnit packageSpec packageUnit packageRatio drugClass drugForm drugAttribute drugProperty drugRefrigerated drugControlled firmNamePYCodevarchar(80) varchar(40) varchar(20) double varchar(20) varchar(40) varchar(20) double

5、varchar(20) varchar(20) varchar(20) varchar(20) char(1) char(1) varchar(100) varchar(80) varchar(50) varchar(30)not not notnull null null-藥品名稱最小不可拆分包裝規(guī)格：ml、mg 等最小不可拆分包裝：片、粒、支等null default null1最小包裝規(guī)格所含劑量最小包裝規(guī)格所含劑量零售包裝規(guī)格：2mg x 100、1mg/板 xnot not notnull null null2 等零售包裝：盒、瓶等default1零售包裝拆零為最小包裝的轉(zhuǎn)換系數(shù)藥品

6、類別: 西藥、中藥、草藥等藥品劑型：片劑、針劑、膠囊等藥品屬性：普通、麻醉、精神等藥品性質(zhì)：口服、外用、注射等冷藏藥品標(biāo)志藥品標(biāo)志廠家藥品查詢碼null null null null null nulldefault defaultNNnot null not null null null null null nullsupervi barcode sizeL sizeW sizeHCode藥品碼藥品條碼尺寸：長(zhǎng)尺寸：寬尺寸：高,weight isEnabled updatedDT primary key(float char(1) datetimedrugCode )null-重量有效標(biāo)志修

7、改時(shí)間根據(jù) HIS 藥品字典實(shí)際情況創(chuàng)建主鍵not notnull nulldefaultY);2.2. 藥房字典create table dictPharmacy (pharmacyCode pharmacyName PYCode isEnabled updatedDT primary key(varchar(20) varchar(60) varchar(60) char(1) datetimenot not not not notnull null null null null-藥房代碼藥房名稱拼音代碼有效標(biāo)志修改時(shí)間,defaultYpharmacyCode);2.3. 科室字典cre

8、ate table dictDeptdeptCode(varchar(20) varchar(60) varchar(60) char(1) datetimedeptCode )not not not not notnull null null null null-科室代碼科室名稱拼音代碼有效標(biāo)志修改時(shí)間,deptName PYCode isEnabled updatedDT primary key(defaultY);2.4. 病區(qū)字典create table dictWardwardCode(varchar(20) varchar(60) varchar(60) char(1) datet

9、imewardCode )not not not not notnull null null null null-病區(qū)代碼病區(qū)名稱拼音代碼有效標(biāo)志修改時(shí)間,wardName PYCode isEnabled updatedDT primary key(default Y);處方業(yè)務(wù)接口定義門診處方數(shù)據(jù)：由 HIS 向該表中處方數(shù)據(jù)，DIH 只做操作。createtable outpOrder_his (orderNo orderType windowNo outpNo visitNo groupNo patientID patientName patientPYName patientGend

10、er patientAge identity insuranceType chargeType deptCode deptName doctCode doctNamediagnosisvarchar(40) varchar(10)not null-門診處方處方類型:取藥窗,null null null null nulldefaultMM-門診, J-, O-其他（由 DIH 分配窗口時(shí)置 0）varchar(30) varchar(30) varchar(30) varchar(30) varchar(40) varchar(40) varchar(10)門診就診號(hào)患者配藥（報(bào)到）組號(hào)唯一編

11、碼not null not null null null null null null null null null null nullnull拼音碼varchar(30) varchar(40) varchar(30) varchar(20) varchar(40) varchar(20) varchar(40)varchar(200)醫(yī)保類型類別就診科室代碼就診科室名稱就診醫(yī)生代碼就診醫(yī)生名稱臨床,drugCode drugName drugSpec firmName amount takeUnit takeMethod takeType takeNote orderSort pharma

12、cyCodepaymentIPvarchar(36) varchar(80) varchar(40) varchar(100)not not not not not notnull null null null null null-藥品代碼藥品名稱藥品規(guī)格廠家藥品數(shù)量發(fā)藥服用方法服用類型服用備注說明處理順序藥房代碼電腦 IP(適用于醫(yī)院有多個(gè)繳費(fèi)處，且分布不同樓層，varchar(20) varchar(40) varchar(40) varchar(100)null null nullnot notnull nullvarchar(20) varchar(20)null但在同一藥房取藥，需要

13、根據(jù)繳費(fèi)處位置增加處方分配延遲時(shí)間),paymentDT createdDT primary key(datetime datetimeorderNo, drugCode,nullnot null orderSort)-計(jì)費(fèi)時(shí)間創(chuàng)建日期（時(shí)間戳）);3.2. 門診配藥完成通知：由 DIH 在處方配藥完成時(shí)寫入，叫號(hào)系統(tǒng)create table outpOrderReadyNotify (該信息實(shí)現(xiàn)叫號(hào)、上屏操作。windowNo patientID groupNo completedDT createdDT orderType primary key(varchar(10) varchar(3

14、0) varchar(30) datetime datetime varchar(30)not not notnull null null-窗患者唯一 ID患者配藥組號(hào)配藥完成時(shí)間創(chuàng)建日期（時(shí)間戳）,nullnot null nullwindowNo, patientID, groupNo);3.3. 門診患者取藥通知：在患者前來取藥時(shí)由 HIS create table outpOrderTakeNotify (，DIH該信息后提示引導(dǎo)發(fā)藥藥師查找患者藥籃。windowNovarchar(10)not null-窗-HIS 建中間表存患者 ID，處方號(hào)，窗,patientID groupNo

15、 createdDT orderType completedS primary key(varchar(30) varchar(30) datetime varchar(30)not null nullnot null nullnull default-患者唯一 ID患者配藥組號(hào)創(chuàng)建日期（時(shí)間戳）-處方類型，門診-M；-完成狀態(tài)，默認(rèn) 0-J；其他-Ous0windowNo, patientID, groupNo);3.4. 門診患者發(fā)藥完成通知：由 HIS 在完成患者發(fā)藥操作后作。，DIH該信息完成發(fā)藥后的；叫號(hào)系統(tǒng)該信息完成患者下屏操create tablepletionNotify va

16、rchar(30) varchar(30) datetime(,patientID groupNo createdDT completedS primary key(not null nullnot null null default-患者唯一 ID患者配藥組號(hào)創(chuàng)建日期（時(shí)間戳）uspatientID, groupNo)0- 完成狀態(tài)默認(rèn)零);3.5. 門診發(fā)藥窗口狀態(tài)變更通知：由 HIS 系統(tǒng)在發(fā)藥窗口發(fā)生狀態(tài)變更時(shí)create table outpWindowNotify (，DIH該信息調(diào)整配藥分配路徑。windowIP windowNo windowSvarchar(20) varch

17、ar(10) varchar(10) varchar(10)varchar(10) datetimenot null not null null null-窗口 ip 地址窗窗口狀態(tài)：open-打開、close-關(guān)閉、pause-暫停窗口工作類型：direct-直發(fā)；indirect-預(yù)配；all-混合,uswindowType, completedS, createdDT, primary key(usnulldefault0- 完成狀態(tài)默認(rèn)零not null-創(chuàng)建日期（時(shí)間戳）windowIP );附件二. Webservice1. 概述此接口定義只包含處方業(yè)務(wù)數(shù)據(jù)部分 DIH 藥房流程議

18、采用中間視圖的形式。與醫(yī)院 HIS 或其他系統(tǒng)之間的數(shù)據(jù)交互、傳遞，基礎(chǔ)字典數(shù)據(jù)的接口依然建接口定義門診處方數(shù)據(jù)接口描述：由 HIS 在適當(dāng)?shù)臅r(shí)機(jī)（繳費(fèi)時(shí)、藥房報(bào)到時(shí)）將患者待取藥的處方給 DIH 藥房流程，并等待 DIH返回處方接收結(jié)果。如果取藥窗口由 HIS 分配，請(qǐng)將窗隨處方一并發(fā)給 DIH 藥房流程；如果由 DIH 分配取藥窗口，返回的結(jié)果中會(huì)包含已分配的取藥窗提供方：DIH調(diào)用方：HIS。方法：String outpOrderDispense(String xml);參數(shù)：xml 門診處方 xml 字符串返回：xml 字符串-code：非零為錯(cuò)誤接口返回結(jié)果內(nèi)容取藥窗，message

19、：結(jié)果描述22患者配藥（報(bào)到）組號(hào)門診處方 xml 字符串結(jié)構(gòu)式樣:自動(dòng)創(chuàng)建）-患者信息取藥窗（只在由 HIS 分配窗時(shí)有，且不能為 0）患者配藥（報(bào)到）組號(hào)（只在報(bào)到機(jī)制時(shí)有用，如 HIS 沒有定義，DIH 會(huì)-患者唯一 ID醫(yī)保類型類別-處方處方，no：處方唯一，type：M-門診，J-，O-其他，繳費(fèi)時(shí)間：yyyy-MM-ddHH:mm:ss-號(hào) 就診就診科室編碼就診科室名稱就診醫(yī)生編碼就診醫(yī)生臨床電腦 IP繳費(fèi)時(shí)間：yyyy-MM-dd處方中藥品HH:mm:ss-藥品編碼名稱規(guī)格廠家-藥品數(shù)量（浮點(diǎn)數(shù)值）發(fā)藥服用方法服用類型備注說明藥房編碼在處方中的藥品順序號(hào)（整數(shù)值）2.2. 門診處

20、方繳費(fèi)接口描述：該接口適用于在繳費(fèi)前患者處方信息已經(jīng)發(fā)給 DIH藥房流程的場(chǎng)景，由 HIS 在適當(dāng)?shù)臅r(shí)機(jī)（繳費(fèi)時(shí)、藥房報(bào)到時(shí)）將患者待取藥的處方 ID并發(fā)給 DIH 藥房流程提供方：DIH調(diào)用方：HIS方法：String outpOrd給 DIH 藥房流程，并等待 DIH返回處方接收結(jié)果。如果取藥窗口由 HIS 分配，請(qǐng)將窗隨處方一；如果由 DIH 分配取藥窗口，返回的結(jié)果中會(huì)包含已分配的取藥窗。ayment(String xml);參數(shù)：xml 門診處方繳費(fèi) xml 字符串返回：xml 字符串-code：非零為錯(cuò)誤接口返回結(jié)果內(nèi)容取藥窗，message：結(jié)果描述22門診處方繳費(fèi) xml 字符

21、串結(jié)構(gòu)式樣:患者配藥（報(bào)到）組號(hào)- 患者信息自動(dòng)創(chuàng)建）prescription no= type=間：yyyy-MM-dd HH:mm:ss-取藥窗（只在由 HIS 分配窗時(shí)有，且不能為 0）患者配藥（報(bào)到）組號(hào)（只在報(bào)到機(jī)制時(shí)有用，如 HIS 沒有定義，DIH 會(huì)-患者唯一 ID-paymentDT=/處方- 處方，no：處方唯一，type：M-門診，J-，O-其他，繳費(fèi)時(shí)2.3. 門診配藥完成通知接口描述：當(dāng)配藥師完成患者的所有處方藥品調(diào)配，將藥籃放到正確的發(fā)藥窗口時(shí)，由 DIH以開始叫號(hào)或等待患者前來取藥。提供方：HIS調(diào)用方：DIH向 HIS 發(fā)送配藥完成通知，告知 HIS 可方法：o

22、utpOrderReadyNotify(Stringxml);參數(shù)：配藥完成 xml 字符串返回：0-成功，1-失敗配藥完成 xml 字符串結(jié)構(gòu)式樣：-窗患者唯一 ID患者配藥組號(hào)-配藥處方，id：處方2.4. 門診患者取藥通知接口描述：患者來到發(fā)藥窗口，刷卡或掃描處方時(shí)，由 HIS 向 DIH 流程直發(fā)設(shè)備出藥。提供方：DIH調(diào)用方：HIS方法：String outpOrderTakeNotify(String xml);參數(shù)：取藥通知 xml 字符串返回：xml 字符串發(fā)送患者取藥通知，引導(dǎo)發(fā)藥藥師拿取該患者藥籃，或等待-code：非零為錯(cuò)誤 接口返回結(jié)果內(nèi)容 是否有直發(fā)處方標(biāo)志已配好藥籃數(shù)，message：結(jié)果描述false1取藥通知 xml 字符串結(jié)構(gòu)式樣：-窗患者唯一 ID患者配藥組號(hào)2.5.門診患者發(fā)藥完成通知接口描述：HIS 完成發(fā)藥確認(rèn)時(shí)，向 DIH提供方：DIH調(diào)用方：