南川區(qū)智慧醫(yī)療健康平臺(tái)接口規(guī)范V1.4.0發(fā)布稿nrt冊(cè)南川區(qū)衛(wèi)生和計(jì)劃生育委員會(huì)

二零一八年四月

修改記錄版本號(hào)更改條款及內(nèi)容更改日期Vl.1.01、服務(wù)架構(gòu)與方案介紹2、健康扶貧“一站式”結(jié)算3、雙向轉(zhuǎn)診2018-3-1Vl.1.11、健康檔案瀏覽器獲取人員信息“ehr.personinfo”方法新增建檔人、采集建檔機(jī)構(gòu)名稱(chēng)等返回值2018-3-8Vl.2.01、檢驗(yàn)接口2018-3-10Vl.3.01、影像接口2018-3-20Vl.3.11、醫(yī)療慢病接口2、健康扶貧救助登記/更新新增“扶貧政策”參數(shù)2018-4-9Vl.4.01、“1.3函數(shù)說(shuō)明”新增瀏覽器調(diào)閱函數(shù)BLT_NavTo2、瀏覽器調(diào)閱2018-4-16目錄TOC\o"1-5"\h\z一?服務(wù)架構(gòu)與方案介紹011?1適用范圍011.2接口方式011?3函數(shù)說(shuō)明021.4JSON數(shù)據(jù)類(lèi)型約束031?5其他調(diào)用說(shuō)明03二.健康扶貧“一站式”結(jié)算042?1?流程圖解04函數(shù)功能說(shuō)明052?2?1函數(shù)列表052?2?2基礎(chǔ)信息下載062.2.3獲取人員信息（健康檔案瀏覽器）072?2?4健康扶貧救助登記/更新092?2?5健康扶貧救助登記撤銷(xiāo)112.2.6文件上傳112.2.7文件刪除122?2?8健康扶貧補(bǔ)償試算/正式結(jié)算132?2?9健康扶貧補(bǔ)償結(jié)算撤銷(xiāo)142?2?10圖像識(shí)別15三?雙向轉(zhuǎn)診?????????????????????????????????????16TOC\o"1-5"\h\z3?1?流程圖解16函數(shù)功能說(shuō)明163.2.1函數(shù)列表173.2.2獲取轉(zhuǎn)診目標(biāo)醫(yī)院列表173.2.3獲取轉(zhuǎn)診目標(biāo)醫(yī)院醫(yī)生列表183.2.4獲取轉(zhuǎn)診預(yù)約類(lèi)型183.2.5獲取轉(zhuǎn)診類(lèi)別193.2.6轉(zhuǎn)診預(yù)約203.2.7預(yù)約記錄查詢(xún)213.2.8轉(zhuǎn)診申請(qǐng)23四?檢驗(yàn)接口24函數(shù)功能說(shuō)明244.1.1函數(shù)列表244.1.2檢驗(yàn)信息上傳254.1.3檢驗(yàn)報(bào)告詳情上傳274.1.4細(xì)菌培養(yǎng)結(jié)果上傳294.1.5細(xì)菌培養(yǎng)抗生素上傳314.1.6檢驗(yàn)結(jié)果撤回32五.影像接口33函數(shù)功能說(shuō)明345.1.1函數(shù)列表345.1.2影像設(shè)備類(lèi)型下載345.1.35.1.3影像檢查項(xiàng)目對(duì)應(yīng)表下載355.1.4影像病歷信息上傳?.?355.2.影像數(shù)據(jù)導(dǎo)入?.?385.2.1術(shù)語(yǔ)、定義和縮略語(yǔ)...BS5.2.1.1術(shù)語(yǔ)、定義,...彳仝5.2.1.2縮略語(yǔ),...彳仝5.2.2DICOM轉(zhuǎn)發(fā)...彳仝5.2.2.1DICOMC-StoreSCP接收規(guī)則..,5.2.3DICOM自動(dòng)杳詢(xún)和獲取接口設(shè)計(jì)...厶彳5.2.3.1DICOM自動(dòng)查詢(xún)和獲?。≦/R）接口請(qǐng)求參數(shù)...厶彳六?醫(yī)療慢病接口???446.1.流程圖解6.2.函數(shù)功能說(shuō)明6.2.1慢病就診記錄...△厶七?健康檔案使用瀏覽器調(diào)閱?.?477.1.函數(shù)功能說(shuō)明7.1.1瀏覽器調(diào)閱健康檔案...厶了第第#頁(yè)一.服務(wù)架構(gòu)與方案介紹適用范圍本文詳細(xì)描述了中心平臺(tái)與各醫(yī)院通訊接口，適用于中心平臺(tái)和醫(yī)院的服務(wù)端和客戶(hù)端的開(kāi)發(fā)和使用。接口方式統(tǒng)一標(biāo)準(zhǔn)智慧醫(yī)療健康平臺(tái)接口將提供給各醫(yī)療機(jī)構(gòu)一個(gè)標(biāo)準(zhǔn)的windows系統(tǒng)的動(dòng)態(tài)鏈接庫(kù)一bitremotecall.dll。醫(yī)療機(jī)構(gòu)原有HIS系統(tǒng)通過(guò)對(duì)動(dòng)態(tài)庫(kù)中的函數(shù)調(diào)用（COM組件、API），實(shí)現(xiàn)平臺(tái)要求各功能嵌入到自己的系統(tǒng)中。該動(dòng)態(tài)庫(kù)支持64位windows操作系統(tǒng)。從業(yè)務(wù)處理的角度可以將動(dòng)態(tài)庫(kù)提供的功能分為業(yè)務(wù)函數(shù)和文件上傳功能函數(shù)。業(yè)務(wù)函數(shù)通過(guò)調(diào)用BLT_RemoteCall函數(shù)實(shí)現(xiàn)，功能函數(shù)通過(guò)調(diào)用BLT_PostFile函數(shù)實(shí)現(xiàn)。平臺(tái)中心端將以JSON消息返回給客戶(hù)端。1.3函數(shù)說(shuō)明函數(shù)名稱(chēng)BLT_RemoteCall功能描述：調(diào)用執(zhí)行各交易，進(jìn)行各種業(yè)務(wù)處理。調(diào)用語(yǔ)法:BSTRBLT_RemoteCall(BSTR*secretKey,BSTR*authKey,BSTR*token,BSTR*hostName,BSTR*method,BSTR*requestText)參數(shù)解釋:secretKey:密鑰authKey:用戶(hù)認(rèn)證碼token:認(rèn)證HIS商代碼hostName:服務(wù)端IP:portMethod:方法名requestText:方法名對(duì)應(yīng)的入?yún)⑿畔渥ⅲ?secretKey、authKey、token由中心根據(jù)醫(yī)療機(jī)構(gòu)統(tǒng)一提供。?hostName具體信息待定，請(qǐng)根據(jù)實(shí)際情況進(jìn)行設(shè)置。?requestText需要以JSON格式組織相關(guān)入?yún)⑿畔ⅰ?函數(shù)返回值將以JSON消息返回給客戶(hù)端。函數(shù)名稱(chēng)BLT_PostFile功能描述：調(diào)用進(jìn)行文件(資料)信息上傳。調(diào)用語(yǔ)法:BSTRBLT_PostFile(BSTR*secretKey,BSTR*authKey,BSTR*token,BSTR*hostName,BSTR*method,BSTR*absF訂eName,BSTR*requestText);參數(shù)解釋:secretKey:密鑰authKey:用戶(hù)認(rèn)證碼token:認(rèn)證HIS商代碼hostName:服務(wù)端IP:portMethod:方法名absF訂eName:文件絕對(duì)路徑requestText:方法名對(duì)應(yīng)的入?yún)⑿畔渥ⅲ簊ecretKey、authKey、token由中心根據(jù)醫(yī)療機(jī)構(gòu)統(tǒng)一提供。hostName具體信息待定，請(qǐng)根據(jù)實(shí)際情況進(jìn)行設(shè)置。?requestText需要以JSON格式組織相關(guān)入?yún)⑿畔ⅰ?absFileName例如:需要需要將本機(jī)電腦D盤(pán)中“資料”文件夾中的“演示圖片.jpg”圖片上傳到中心，該值傳為“d:/資料/演示圖片.jpg”。?函數(shù)返回值將以JSON消息返回給客戶(hù)端。?只允許單文件上傳，例如：如果有5份文件需要上傳，則需要調(diào)用本函數(shù)5次函數(shù)名稱(chēng)BLT_BLT_NavTo功能描述:瀏覽器調(diào)閱。調(diào)用語(yǔ)法:BSTRBLT_BLT_NavTo(BSTR*secretKey,BSTR*authKey,BSTR*token,BSTR*hostName,BSTR*method,BSTR*requestText);參數(shù)解釋:secretKey:密鑰authKey:用戶(hù)認(rèn)證碼token:認(rèn)證HIS商代碼hostName:服務(wù)端IP:portMethod:方法名requestText:方法名對(duì)應(yīng)的入?yún)⑿畔渥ⅲ簊ecretKey、authKey、token由中心根據(jù)醫(yī)療機(jī)構(gòu)統(tǒng)一提供。hostName具體信息待定，請(qǐng)根據(jù)實(shí)際情況進(jìn)行設(shè)置。requestText需要以JSON格式組織相關(guān)入?yún)⑿畔ⅰ?函數(shù)返回值將以JSON消息返回給客戶(hù)端。1.4JSON數(shù)據(jù)類(lèi)型約束?數(shù)據(jù)采用字符串類(lèi)型的基本數(shù)據(jù)格式，但是會(huì)要求不同的數(shù)據(jù)格式，比如數(shù)字、日期、時(shí)間等，格式要求如下：?數(shù)字格式:必須是0-9的數(shù)字，可以帶小數(shù)點(diǎn).符號(hào)字節(jié)，如無(wú)特別申明一般保留4位小數(shù)。不能使用表達(dá)式。日期格式:必須是yyyy-MM-dd（年4位，月2位，日2位）。時(shí)間格式:必須是yyyy-MM-ddHH:mm:ss（年4位，月、日、時(shí)、分、秒均2位）。其他調(diào)用說(shuō)明發(fā)起方:醫(yī)療機(jī)構(gòu)接收方:南川區(qū)智慧醫(yī)療健康平臺(tái)基本JSON格式：{"hospCode":"500119","hospName":"南川區(qū)衛(wèi)計(jì)委","description":"treatResult"}具有層次的復(fù)雜結(jié)構(gòu)JSON格式：{"treatResult":[{"itemId":"TR01","itemCode":"1","itemText":"治愈〃},{〃itemId":"TR02","itemCode":"2","itemText":"病情好轉(zhuǎn)"}]}錯(cuò)誤響應(yīng):JSON格式{"error”:”錯(cuò)誤提示"}或者{"error”:”錯(cuò)誤提示”,“errorCode”:”錯(cuò)誤提示編碼"}健康扶貧“一站式”結(jié)算醫(yī)療機(jī)構(gòu)需要根據(jù)健康扶貧“一站式”即時(shí)結(jié)算政策的需要，按照我們提供的接口改造HIS接口，使其HIS系統(tǒng)能夠適應(yīng)健康扶貧“一站式”即時(shí)結(jié)算的需求。流程圖解

方法功能說(shuō)明方法列表序號(hào)功能名方法名1基礎(chǔ)信息下載fp.basedata2獲取人員信息（健康檔案瀏覽器）ehr.personinfo3健康扶貧救助登記/更新fp.save.treatment4健康扶貧救助登記撤銷(xiāo)fp.cancle.treatment5文件上傳fp.resupload6文件刪除fp.delete.uploadedfile7健康扶貧補(bǔ)償試算/正式結(jié)算fp.save.balance8健康扶貧補(bǔ)償結(jié)算撤銷(xiāo)fp.cancel.balance10圖像識(shí)別基礎(chǔ)信息下載調(diào)用函數(shù)：BLT_RemoteCall方法名：fp.basedata?入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明

itemType字符型獲取基礎(chǔ)信息類(lèi)型N基礎(chǔ)信息類(lèi)型包括：treatType：治療方式hospitalType：醫(yī)院類(lèi)型hospitalLevel:醫(yī)院寺級(jí)hospitalDepend：治療機(jī)構(gòu)屬地treatResult：治療結(jié)果disease2：基本疾病類(lèi)型diseasei:基本疾病類(lèi)型大類(lèi)inHospital:是否住院門(mén)診就醫(yī)類(lèi)別treatTypePolicy:救助政策lastTime時(shí)間格式最后更新時(shí)間Y返回值［數(shù)據(jù)集合］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注Id字符型基礎(chǔ)信息ID主鍵itemCode字符型基礎(chǔ)信息編碼value字符型基礎(chǔ)信息名稱(chēng)description字符型基礎(chǔ)信息類(lèi)型名稱(chēng)itemType字符型基礎(chǔ)信息類(lèi)型parentltem字符型上級(jí)基礎(chǔ)信息ID在獲取〃基本疾病類(lèi)型〃時(shí)，將返回該疾病類(lèi)型所屬的〃基本疾病類(lèi)型大類(lèi)〃獲取人員信息（健康檔案瀏覽器）通過(guò)此功能調(diào)取平臺(tái)人員健康檔案信息，以實(shí)現(xiàn)健康檔案互聯(lián)互通。

調(diào)用函數(shù)：BLT_RemoteCall方法名：ehr.personinfo入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明name字符型姓名NidcardNumber字符型身份證號(hào)碼NpersonCode字符型居民健康檔案編碼YfpYear字符型年份N健康扶貧“一站式”必須傳入年份；其他情況可不傳入返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注id數(shù)字型人員ID姓名字符型姓名身份證號(hào)字符型身份證號(hào)碼檔案編號(hào)字符型居民健康檔案編碼性別字符型性別出生日期日期格式出生日期年齡數(shù)字格式年齡戶(hù)籍地址字符型戶(hù)籍地址民族字符型民族個(gè)人電話字符型本人聯(lián)系電話常住類(lèi)型字符型常住類(lèi)型血型字符型血型陰性字符型RH陰性文化程度字符型文化程度職業(yè)字符型職業(yè)婚姻狀況字符型婚姻狀況

聯(lián)系人字符型聯(lián)系人聯(lián)系人電話字符型聯(lián)系人電話建檔人姓名字符型建檔人姓名采集建檔機(jī)構(gòu)名稱(chēng)字符型采集建檔機(jī)構(gòu)名稱(chēng)高數(shù)字格式是否咼血壓人員01否是糖數(shù)字格式是否糖尿病人員01否是重?cái)?shù)字格式是否重型精神病人員01否是老數(shù)字格式是否老年人01否是兒數(shù)字格式是否兒童01否是肺數(shù)字格式是否肺結(jié)核人員01否是孕數(shù)字格式是否孕產(chǎn)婦01否是貧數(shù)字格式是否貧困人員01否是民數(shù)字格式是否民政人員01否是殘數(shù)字格式是否殘疾人員01否是扶貧年度字符型健康扶貧救助年度保險(xiǎn)公司名稱(chēng)字符型保險(xiǎn)公司名稱(chēng)致貧類(lèi)型字符型致貧類(lèi)型備注：根據(jù)健康扶貧政策“貧困人員”、“民政人員”、“殘疾人員”三種類(lèi)型的人員可以享受健康扶貧救助。健康扶貧救助登記/更新調(diào)用函數(shù)：BLT_RemoteCall方法名：fp.save.treatment?入?yún)?/p>

入?yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明personld數(shù)字型人員IDNname字符型姓名NidcardNumber字符型身份證號(hào)碼NpersonCode字符型居民健康檔案編碼NinHospitalTime時(shí)間格式入院日期N患者就診的日期outHospitalTime時(shí)間格式出院日期NdiseaseCode1字符型—級(jí)疾病N取值為“基本疾病類(lèi)型大類(lèi)”的IDdiseaseCode2字符型二級(jí)疾病Y取值為“基本疾病類(lèi)型”的IDtreatTypePolicy字符型救助政策類(lèi)型N取值為“救助政策”的IDtreatType字符型治療方式N取值為“治療方式”的IDtreatResult字符型治療結(jié)果N取值為“治療結(jié)果”的IDinHospital字符型是否住院N取值為“是否住院”的IDhospitalLevel字符型機(jī)構(gòu)級(jí)別N取值為“醫(yī)院等級(jí)”的IDhospitalType字符型機(jī)構(gòu)類(lèi)別N取值為“醫(yī)院類(lèi)型”的IDhospitalDepend字符型機(jī)構(gòu)屬地N取值為“治療機(jī)構(gòu)屬地”的IDybSerialNumber字符型醫(yī)保結(jié)算流水號(hào)N醫(yī)保結(jié)算后返回的“交易流水號(hào)”treatId字符型登記流水號(hào)Y登記修改（更新）時(shí)傳入備注：當(dāng)“一級(jí)疾病編碼”為“4649其他疾病”時(shí)，“二級(jí)疾病編碼”必須傳具體的疾病名稱(chēng)。?返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注treatld字符型登記流水號(hào)作為識(shí)別本次救助的唯一標(biāo)識(shí)createdCompanyPartyld字符型經(jīng)辦機(jī)構(gòu)IDcreatedDate時(shí)間格式登記時(shí)間createdUserLoginld字符型經(jīng)辦用戶(hù)IDdiseaseCodel字符型—級(jí)疾病diseaseCode2字符型二級(jí)疾病hospitalLevel字符型機(jī)構(gòu)級(jí)別hospitalType字符型機(jī)構(gòu)類(lèi)別hospitalDepend字符型機(jī)構(gòu)屬地inHospital字符型是否住院inHospitalTime時(shí)間格式入院日期outHospitalTime時(shí)間格式出院日期lastModifyCompanyld字符型最后修改機(jī)構(gòu)IDlastModifyDate時(shí)間格式最后修改時(shí)間lastModifyUserLoginld字符型最后修改用戶(hù)personld數(shù)字型健康扶貧人員編碼treatTypePolicy字符型救助政策treatResult字符型治療結(jié)果treatType字符型治療方式調(diào)用函數(shù)：BLT_RemoteCall方法名：fp.cancle.treatment?入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明treatld字符型登記流水號(hào)N

personld數(shù)字型健康扶貧人員編碼N返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注treatld字符型登記流水號(hào)成功中心返回treatld，失敗返回錯(cuò)誤提示文件上傳調(diào)用函數(shù)：BLT_PostFile方法名：fp.resupload入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明treatId字符型登記流水號(hào)Ntype字符型文件類(lèi)型N類(lèi)型為：發(fā)票、費(fèi)用、簽字、其他fileName字符型文件名N備注：文件類(lèi)型“費(fèi)用”是指費(fèi)用清單.返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注message字符型信息提示fileId數(shù)字型文件IDmd5字符型文件md5

type字符型文件類(lèi)型fileName字符型文件名稱(chēng)文件刪除調(diào)用函數(shù)：BLT_RemoteCall方法名：fp.delete.uploadedfile?入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明treatId字符型登記流水號(hào)Nfileld字符型文件IDN返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注treatId字符型登記流水號(hào)fileId字符型文件ID健康扶貧補(bǔ)償試算/正式結(jié)算調(diào)用函數(shù)：BLT_RemoteCall方法名：fp.save.balance?入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明treatId字符型登記流水號(hào)N

personld數(shù)字型人員IDNcostTotal數(shù)字格式總費(fèi)用N本次結(jié)算總發(fā)生費(fèi)用costMln數(shù)字格式目錄內(nèi)費(fèi)用N取醫(yī)保中心返回承認(rèn)金額costCxjmbx數(shù)字格式基本醫(yī)療報(bào)銷(xiāo)N取醫(yī)保中心返回costDbbx數(shù)字格式大病保險(xiǎn)報(bào)銷(xiāo)NcostMzjz數(shù)字格式民政救助金額NcostFpjz數(shù)字格式扶貧救助支付金額NcostYycd數(shù)字格式醫(yī)院承擔(dān)金額NisFormal字符型核算類(lèi)型NN:試算;Y:正式結(jié)算返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注balanceld字符型健康扶貧保險(xiǎn)賠付流水號(hào)當(dāng)核算類(lèi)型為“試算”時(shí)不返回costBxpf數(shù)字格式健康扶貧保險(xiǎn)賠付金額costTotal數(shù)字格式總費(fèi)用costMln數(shù)字格式目錄內(nèi)費(fèi)用costCxjmbx數(shù)字格式基本醫(yī)療報(bào)銷(xiāo)入?yún)⒂袀魅?，返回值才有返回costDbbx數(shù)字格式大病保險(xiǎn)報(bào)銷(xiāo)costMzjz數(shù)字格式民政救助金額costFpjz數(shù)字格式扶貧救助支付金額costYycd數(shù)字格式醫(yī)院承擔(dān)金額createDate時(shí)間格式賠付時(shí)間createdCompanyPartyld字符型經(jīng)辦機(jī)構(gòu)IDcreatedUserLoginld字符型經(jīng)辦人員ID丨astModifyCompanyld字符型最后修改機(jī)構(gòu)ID

lastModifyDate時(shí)間格式最后修改時(shí)間lastModifyUserLoginld字符型最后修改人員IDtreatId字符型登記流水號(hào)status字符型狀態(tài)0：正常1：作廢personld數(shù)字格式健康扶貧人員編碼健康扶貧補(bǔ)償結(jié)算撤銷(xiāo)調(diào)用函數(shù)：BLT_RemoteCall方法名：fp.cancel.balance?入?yún)⑷雲(yún)?shù)類(lèi)型參數(shù)名是否可空說(shuō)明personld數(shù)字型人員IDNtreatId字符型登記流水號(hào)Nbalanceld字符型健康扶貧保險(xiǎn)賠付流水號(hào)N返回值［單條數(shù)據(jù)］節(jié)點(diǎn)名稱(chēng)類(lèi)型返回值說(shuō)明備注personld數(shù)字型人員IDtreatId字符型登記流水號(hào)accountld字符型健康扶貧保險(xiǎn)賠付流水號(hào)與入?yún)ⅰ眀alanceld”相同canceledld字符型撤銷(xiāo)賠付流水號(hào)中心端負(fù)數(shù)據(jù)的流水號(hào)圖像識(shí)別功能說(shuō)明：通過(guò)人臉識(shí)別獲取健康扶貧人員信息。待定雙向轉(zhuǎn)診患者在基層醫(yī)院診治有困難，比如不能準(zhǔn)確診斷疾病、診療條件欠缺、技術(shù)水平不夠等，可以由基層醫(yī)院填寫(xiě)轉(zhuǎn)診單，轉(zhuǎn)到上級(jí)醫(yī)院或?qū)？漆t(yī)院診治，待病情穩(wěn)定時(shí)再轉(zhuǎn)回基層醫(yī)院繼續(xù)治療。雙向轉(zhuǎn)診是根據(jù)病情需要而進(jìn)行的上下級(jí)醫(yī)院間、專(zhuān)科醫(yī)院間或綜合醫(yī)院與專(zhuān)科醫(yī)院間的轉(zhuǎn)院診治的過(guò)程。

流程圖解否是否冃標(biāo)醫(yī)險(xiǎn)就診錢(qián)謗中請(qǐng)否是否冃標(biāo)醫(yī)險(xiǎn)就診錢(qián)謗中請(qǐng)函數(shù)功能說(shuō)明函數(shù)列表序