醫(yī)保接口用戶開發(fā)手冊

VI.1.2

浙大網(wǎng)新

聲明：浙大網(wǎng)新版權(quán)所有，未經(jīng)許可，不得以任何方式復(fù)制或抄襲本文

檔的任何部分。版權(quán)所有，侵權(quán)必究。

文檔修改說明頁

修訂文檔修改操作操作備注

版本狀態(tài)作者時(shí)間

1.0創(chuàng)建程成圭2010-2-24創(chuàng)建了醫(yī)保接口文檔

1.0.1修改程成圭1.修改51交易號(hào)，增加了結(jié)束時(shí)間、統(tǒng)籌區(qū)編碼

2.增加統(tǒng)籌區(qū)代碼類型。

1.0.2修改程成圭2012-4-113.修改了41交易明細(xì)查詢，顯示金額、比例、超限

等。

1.0.2修改王鵬2013-3-184.所有交易的傳入?yún)?shù)中，第四個(gè)域統(tǒng)一由原來的

“銀行卡信息”調(diào)整為“卡類型”（1表示新社保

卡，2表示臨時(shí)卡），其中必須讀卡交易（22、30、

31、32、36、37、40、44、64、65號(hào)交易等）中，

該域值不能為空。詳見3.4嵌入模塊'業(yè)務(wù)范圍。

修改王鵬2013-3-185.修改門診、住院相關(guān)業(yè)務(wù)交易的傳入傳出參數(shù)含

義，用于生育費(fèi)用報(bào)銷；

1.0.3修改王鵬2013-03-276.針對居民醫(yī)療參保人暫無社保卡和臨時(shí)卡的情

況，在進(jìn)行22、30、31、32、36、37、40、44、

64、65號(hào)等交易時(shí)，允許無卡交易，即傳入?yún)?shù)

第一個(gè)域“是否讀卡”允許為’0’，此時(shí)，第二

個(gè)域“卡信息”一項(xiàng)上傳就診人員的身份證號(hào)。

本條修改只針對參加“城鎮(zhèn)居民醫(yī)療保險(xiǎn)”的參

保人員，其他險(xiǎn)種的參保人員不允許無卡交易。

1.0.4修改王鵬2013-11-197.增加居民醫(yī)保的人群分類（41:成年人；42：學(xué)生

兒童；43：大學(xué)生）

8.調(diào)整職工醫(yī)保、居民醫(yī)保相關(guān)結(jié)算單據(jù)（單據(jù)模

板）。

9.為適應(yīng)異地就醫(yī)系統(tǒng)升級，定點(diǎn)機(jī)構(gòu)需要保存人

員基本信息中“地區(qū)編碼”參數(shù)，該項(xiàng)中為

“1407**”的，是本地就診，其他為異地就醫(yī)人

員。

10.增加“人員待遇類別”數(shù)據(jù)字典：99異地就醫(yī)人

員。用于識(shí)別外地人員。

11.調(diào)整醫(yī)囑明細(xì)33號(hào)交易的返回值，增加返回“保

存成功項(xiàng)目的自付比例”項(xiàng)。

12.調(diào)整醫(yī)囑明細(xì)29、30號(hào)交易的返回值，修改最后

一個(gè)域值為“明細(xì)報(bào)銷列表

13.調(diào)整住院明細(xì)刪除（42號(hào)）交易，提交該交易后，

系統(tǒng)刪除本次住院的所有醫(yī)囑明細(xì)，不再做部分

刪除處理。

1.0.5修改王^2014-3-114.門診結(jié)算（29、30號(hào)）交易中增加“22.入院前

三天門急診”業(yè)務(wù)類型。

王鵬15.增加新交易“減免起付線登記（59號(hào)）”

1.0.6增加2014-12-3116.調(diào)整醫(yī)預(yù)結(jié)算和結(jié)算（29.30,34,36號(hào)）交易中

的返回參數(shù)，在計(jì)算結(jié)果信息結(jié)構(gòu)體參數(shù)中最后

增加兩字段，即：居民%5大病補(bǔ)助和居民其他大

病補(bǔ)助（此處目前不做修改）此條信息作廢

1.0.7增辛振鋒2015-07-0117.新增61、62號(hào)交易。38號(hào)交易人口參數(shù)15（胎兒

加、數(shù)備注），疾病編號(hào)必填；

修改注意：29號(hào)交易的疾病編號(hào)必填；29、32號(hào)交易的

業(yè)務(wù)類型必須按要求選擇51.生育門診（生育產(chǎn)

前檢查上傳該類型，門診的沒有胎兒數(shù)）52.生育

住院；登記單號(hào)（計(jì)劃生育、生育中心登記備案號(hào)）

生育業(yè)務(wù)時(shí)，該參數(shù)不能為空；

22號(hào)交易出口參數(shù)9生育身份驗(yàn)證結(jié)果可以判斷

該人有沒有做生育備案登記；

廢除1.0.6中新加的“居民%5大病補(bǔ)助和居民其他

大病補(bǔ)助”；

1.0.818.增加離休醫(yī)療險(xiǎn)種及離休人員待遇類別查看險(xiǎn)

種和員待遇類別數(shù)據(jù)字典

1.0.9郭陽煒2017-06-1319.調(diào)整生育登記項(xiàng)目和生育出院疾病，新增了5張

生育相關(guān)報(bào)表

1.1.02017-11-0220.調(diào)整醫(yī)預(yù)結(jié)算和結(jié)算（29.30,34,36號(hào)）交易中

的返回參數(shù)，在計(jì)算結(jié)果信息結(jié)構(gòu)體參數(shù)中最后

增加7字段；

32號(hào)交易人口參數(shù)業(yè)務(wù)類型新增“38：重大疾病

住院”，“50：居民生育“，居民生育僅限于自然分

娩

1.1.12018-01-2621.新增6.4.6居民醫(yī)保結(jié)算收據(jù)，及收據(jù)取值說明，

修改計(jì)算結(jié)果信息結(jié)構(gòu)體參數(shù)中的說明部分；

修改數(shù)據(jù)字段人員待遇類別城鄉(xiāng)居民和異地人員

部分；

32號(hào)交易入口參數(shù)業(yè)務(wù)類型新增“50：居民生

育"，居民生育僅限于自然分娩

1.1.22018-03-2622.新增6.3.15重大疾病病種代碼

新增6.4.12山西省統(tǒng)一城鄉(xiāng)居民住院結(jié)算單（原

單據(jù)暫作廢，但本文當(dāng)中暫時(shí)保留）

目錄

文檔修改說明頁...................................................................2

1.概述.........................................................................7

1.1.背景.....................................................................7

1.2.目標(biāo)......................................................................7

1.3.名詞解釋..................................................................8

1.4.文檔安排..................................................................8

2.醫(yī)療機(jī)構(gòu)接入準(zhǔn)備.............................................................9

2.1.硬件要求.................................................................9

2.2.軟件要求..................................................................9

2.3.數(shù)據(jù)要求.................................................................9

2.4.前置機(jī)及三目數(shù)據(jù)獲取...................................................10

2.5.職工生育接口要求........................................................10

2.6.新農(nóng)合接口要求........................................................10

2.7.跨省異地就醫(yī)要求......................................................11

2.8.聯(lián)系方式..............................................................11

3.醫(yī)療機(jī)構(gòu)端嵌入模塊..........................................................11

3.1.嵌入模塊的處理模式....................................................11

3.2.嵌入模塊的文件內(nèi)容....................................................13

3.2.1.配置文件.............................................................14

3.2.2.交易初始化和關(guān)閉函數(shù).................................................15

3.2.3.用戶交易申請函數(shù).....................................................16

3.3.參數(shù)數(shù)據(jù)格式..........................................................16

3.3.1傳入?yún)?shù).................................................................17

3.3.2傳出參數(shù).................................................................17

3.4.嵌入模塊的業(yè)務(wù)范圍（用戶交易）.........................................18

3.4.1.獲取參保人信息（用戶交易22）...............................................................................19

3.4.2.門診/掛號(hào)預(yù)結(jié)算（用戶交易29）..............................................................................23

3.4.3.門診/掛號(hào)結(jié)算（用戶交易30）..................................................................................29

3.4.4.門診退費(fèi)/掛號(hào)退號(hào)（用戶交易31）....................................................................31

3.4.5.住院登記/家庭病床建床（用戶交易32）.................................................................33

3.4.5.1.住院醫(yī)囑錄入及費(fèi)用記帳（用戶交易33）...........................................................35

3.4.6.住院預(yù)結(jié)算（用戶交易34）.......................................................................................38

3.4.7.出院退費(fèi)（用戶交易37）...........................................................................................39

3.4.8.住院信息變動(dòng)（用戶交易38）...................................................................................41

3.4.9.取消住院登記/醫(yī)保轉(zhuǎn)自費(fèi)（用戶交易40）.............................................................43

3.4.10.住院明細(xì)查詢（用戶交易41）...............................................................................44

3.4.11.住院明細(xì)刪除（用戶交易42）................................................................................45

3.4.12.出院結(jié)算（用戶交易36）........................................................................................46

3.4.13.交易結(jié)果查詢交易（用戶交易43）........................................................................48

3.4.14.入院業(yè)務(wù)類型轉(zhuǎn)換登記（用戶交易44）...............................................................50

3.4.15.工傷認(rèn)定結(jié)果查詢（用戶交易45）.......................................................................52

3.4.16.交易確認(rèn)（HIS事務(wù)結(jié)果）（用戶交易49）..........................................................53

3.4.17.結(jié)算數(shù)據(jù)日對帳（用戶交易51）...........................................................................57

3.4.18.匹配目錄上傳（用戶交易52）................................................................................59

3.4.19.匹配目錄審批結(jié)果（用戶交易53）........................................................................61

3.4.20.藥品診療目錄下載（用戶交易54）........................................................................62

3.4.21.交易明細(xì)下載（用戶交易55）................................................................................64

3.4.22.匹配目錄審批結(jié)果批量下載（用戶交易56）.......................................................66

3.4.23.收費(fèi)等級和自負(fù)比例獲?。ㄓ脩艚灰?8）............................................................67

3.4.24.減免起付線登記（用戶交易59）............................................................................68

3.4.25.生育報(bào)銷登記（用戶交易61）................................................................................69

3.4.26.生育待遇登記查詢、撤銷（用戶交易62）............................................................71

3.4.27.門診規(guī)定病或家庭病床申請交易（用戶交易64）................................................72

3.4.28.門診規(guī)定病或家庭病床查詢交易（用戶交易65）................................................73

3.4.29.中心規(guī)定病種下載（用戶交易76）........................................................................75

3.4.30.批量獲取自負(fù)比例（用戶交易79）........................................................................76

4.WEB服務(wù)....................................................................77

5.三大目錄....................................................................77

5.1總體目標(biāo).................................................................77

6.附錄.........................................................................78

6.1.醫(yī)院常見業(yè)務(wù)處理流程參考................................................78

6.2.金額小數(shù)位保留方法.....................................................80

6.3.相關(guān)數(shù)據(jù)字典..........................................................80

6.3.1.險(xiǎn)種....................................................................80

6.3.2.人員待遇類別（重要）.....................................................80

6.3.3.收費(fèi)等級...............................................................81

6.3.4.藥品診療類別...........................................................81

6.3.5.醫(yī)療機(jī)構(gòu)等級..........................................................81

6.3.6.醫(yī)療業(yè)務(wù)類別...........................................................81

6.3.7.性別..............................................................82

6.3.8.婚姻狀況...............................................................82

6.3.9.發(fā)票分類...............................................................82

6.3.10.限制分類...............................................................82

6.3.11.審核結(jié)果...............................................................83

6.3.12.職工生育登記項(xiàng)目......................................................83

6.3.13.職工生育出院疾病......................................................83

6.3.14.統(tǒng)籌區(qū)代碼.............................................................85

6.3.15.重大疾病病種代碼......................................................85

6.4.結(jié)算單據(jù)模板.............................................................87

6.4.1.職工支付匯總表（醫(yī)保中心結(jié)算用）.........................................87

6.4.2.居民支付匯總表（醫(yī)保中心結(jié)算用）.........................................88

6.4.3.職工支付匯總表（保險(xiǎn)公司結(jié)算用）.........................................89

6.4.4.居民支付匯總表（保險(xiǎn)公司結(jié)算用）.........................................90

6.4.5.職工醫(yī)保結(jié)算收據(jù)......................................................91

6.4.6.居民醫(yī)保結(jié)算收據(jù)（暫作廢）............................................91

6.4.7.職工生育備案登記表（必做）............................................93

6.4.8.醫(yī)院職工生育備案臺(tái)賬（必做）..........................................95

6.4.9.醫(yī)院生育結(jié)算單（必做）................................................96

6.4.10.醫(yī)院生育結(jié)算匯總表（選做）............................................97

6.4.11.醫(yī)院生育結(jié)算明細(xì)表（選做）............................................99

6.4.12.居民醫(yī)保結(jié)算收據(jù)（山西省城鄉(xiāng)居民基本醫(yī)療保險(xiǎn)住院結(jié)算單）...........100

1.概述

1.1.背景

加快醫(yī)療保險(xiǎn)制度改革，保障職工基本醫(yī)療和居民醫(yī)療保險(xiǎn)，是建立社會(huì)主義市場經(jīng)

濟(jì)體制的客觀要求和重要保障。醫(yī)保接口系統(tǒng)是醫(yī)保中心管理業(yè)務(wù)在定點(diǎn)醫(yī)療機(jī)構(gòu)的體現(xiàn)，

它將醫(yī)保政策體現(xiàn)在具體的醫(yī)療機(jī)構(gòu)中。同時(shí)，它將參保人員在醫(yī)療機(jī)構(gòu)發(fā)生的具體費(fèi)用情

況統(tǒng)計(jì)、采集到醫(yī)保中心，也是醫(yī)保中心管理分析參保人員就醫(yī)情況、基金流動(dòng)情況的必要

手段。

醫(yī)療保險(xiǎn)管理系統(tǒng)要通過與定點(diǎn)醫(yī)療機(jī)構(gòu)、定點(diǎn)零售藥店以及銀行、稅務(wù)等相關(guān)部門

建立網(wǎng)絡(luò)聯(lián)結(jié)，改善醫(yī)療保險(xiǎn)費(fèi)用的監(jiān)控手段，進(jìn)而保障醫(yī)療保險(xiǎn)基金安全運(yùn)行。

目前，國內(nèi)醫(yī)院管理系統(tǒng)軟件眾多，他們采用的數(shù)據(jù)庫平臺(tái)和數(shù)據(jù)庫結(jié)構(gòu)各不相同，且

各公司的軟件都有i批用戶，因?yàn)獒t(yī)院管理系統(tǒng)是一個(gè)比較大也比較復(fù)雜的系統(tǒng)，一旦用戶

已經(jīng)使用，要把它換成另一個(gè)系統(tǒng)是比較困難的；在一個(gè)城市中，也可能存在和各家的醫(yī)院

系統(tǒng)存在數(shù)據(jù)交換。

為了保證醫(yī)療保險(xiǎn)管理系統(tǒng)和醫(yī)院管理信息系統(tǒng)的完整性和獨(dú)立性以及數(shù)據(jù)的同步和

一致性，需要提供一個(gè)標(biāo)準(zhǔn)的數(shù)據(jù)輸入輸出接口，建立一個(gè)公用的數(shù)據(jù)交換標(biāo)準(zhǔn)。因此，開

發(fā)出一套通用的適合于各種類型醫(yī)療管理機(jī)構(gòu)、能嵌入各種管理軟件的接口系統(tǒng)是保證醫(yī)保

順利實(shí)施的關(guān)鍵。

在以下說明中，一般以醫(yī)院作為醫(yī)療機(jī)構(gòu)代表，特殊地方將單獨(dú)注明適用范圍。

1.2.目標(biāo)

醫(yī)保接口系統(tǒng)主要實(shí)現(xiàn)參保病人在醫(yī)療機(jī)構(gòu)就醫(yī)時(shí)數(shù)據(jù)的采集、審核、費(fèi)用的支付、醫(yī)

保ic卡管理、銀行ic卡管理，結(jié)算信息的實(shí)時(shí)上傳以及軟件版本的更新等。根據(jù)業(yè)務(wù)類型，

接口系統(tǒng)分三個(gè)子模塊：醫(yī)保交易平臺(tái)、醫(yī)保服務(wù)平臺(tái)和醫(yī)保前置服務(wù)系統(tǒng)。其中與醫(yī)療機(jī)

構(gòu)相關(guān)的是醫(yī)保前置服務(wù)系統(tǒng)。

對于已經(jīng)使用HIS系統(tǒng)的醫(yī)院，接口系統(tǒng)提供一套Windows標(biāo)準(zhǔn)函數(shù)完成嵌入模塊功能,

只要將其嵌入原醫(yī)院系統(tǒng)既可實(shí)現(xiàn)醫(yī)保病人的就診。

接口開發(fā)遵循簡單高效的原則，針對不同人群，不同險(xiǎn)種，統(tǒng)一采用一套接口系統(tǒng)，每

項(xiàng)業(yè)務(wù)以不同的用戶交易區(qū)分，本接口程序適用于接入晉中市醫(yī)保系統(tǒng)的所有定點(diǎn)機(jī)構(gòu)，包

括但不限于城鎮(zhèn)職工醫(yī)療保險(xiǎn)（包含生育保險(xiǎn)）、城鄉(xiāng)居民醫(yī)療保險(xiǎn)等險(xiǎn)種，覆蓋在職、退

休、靈活就業(yè)、城鄉(xiāng)居民、離退休等多種類型成員。

1.3.名詞解釋

在本用戶手冊內(nèi)，使用部分簡略說明，其含義以本定義為準(zhǔn)。

中心管理系統(tǒng)：醫(yī)保中心內(nèi)部管理系統(tǒng)，包括信息采集、人員登記、參保登記、繳費(fèi)、

費(fèi)用記帳、支付、綜合分析等工作。

前置服務(wù)控制臺(tái)：簡稱前置機(jī),實(shí)現(xiàn)醫(yī)療機(jī)構(gòu)和醫(yī)保中心的銜接。前置服務(wù)器在每個(gè)醫(yī)

療機(jī)構(gòu)至少設(shè)置一臺(tái)，社保中心根據(jù)醫(yī)療機(jī)構(gòu)數(shù)目和業(yè)務(wù)量大小確定前置機(jī)數(shù)量。前置服務(wù)

器僅是邏輯機(jī)器，對于業(yè)務(wù)量很少的藥店、衛(wèi)生所保健站等地方，前置機(jī)也可由普通收費(fèi)終

端擔(dān)任。醫(yī)療機(jī)構(gòu)端前置服務(wù)器完成醫(yī)療機(jī)構(gòu)端數(shù)據(jù)采集、發(fā)送、接收和處理，醫(yī)保中心前

置服務(wù)器既系統(tǒng)中醫(yī)保中心應(yīng)用服務(wù)器，主要完成數(shù)據(jù)接收和發(fā)送及政策處理。

用戶交易：醫(yī)療機(jī)構(gòu)指定業(yè)務(wù)中某一特定動(dòng)作的處理。一般是相對獨(dú)立且業(yè)務(wù)完整的動(dòng)

作集合。

1.4.文檔安排

本文共分7章：

第一章簡單介紹接口系統(tǒng)概念、名詞，并簡單介紹其業(yè)務(wù)范圍。

第二章簡單介紹醫(yī)療機(jī)構(gòu)使用接口系統(tǒng)前期準(zhǔn)備。

第三章詳細(xì)介紹醫(yī)療機(jī)構(gòu)端嵌入模塊內(nèi)容。以及對各種業(yè)務(wù)的實(shí)現(xiàn)方法。

第四章介紹醫(yī)保中心提供的WEB服務(wù)內(nèi)容、下載數(shù)據(jù)及格式。

第五章介紹三大目錄的使用。

第六章介紹醫(yī)療機(jī)構(gòu)系統(tǒng)管理員日常維護(hù)和常見問題處理等。

第七章附錄包括IC卡錯(cuò)誤信息、醫(yī)院常見業(yè)務(wù)流程、常見錯(cuò)誤、數(shù)字字典、更新變動(dòng)

說明等。

2.醫(yī)療機(jī)構(gòu)接入準(zhǔn)備

2.1.硬件要求

引用接口系統(tǒng)嵌入模塊的終端機(jī)器至少要256M內(nèi)存，并有足夠空間安裝支持軟件。

2.2.軟件要求

接口系統(tǒng)目前支持Windows2000/XP/NT系統(tǒng)平臺(tái)下所開發(fā)的應(yīng)用系統(tǒng)，各應(yīng)用系統(tǒng)必

須能正常調(diào)用Windows標(biāo)準(zhǔn)API函數(shù)（例如用PB、Delphi,VB、VC、CB等開發(fā)的軟件都可

以支持）。根據(jù)電腦技術(shù)的發(fā)展形式，嵌入模塊不支持DOS系統(tǒng)下開發(fā)的應(yīng)用軟件。

2.3.數(shù)據(jù)要求

接口系統(tǒng)需要從醫(yī)療機(jī)構(gòu)獲得必要數(shù)據(jù)，為統(tǒng)一編碼，錄入數(shù)據(jù)盡量采用醫(yī)保中心提供

的編碼規(guī)則，醫(yī)療機(jī)構(gòu)需要根據(jù)需要將自身系統(tǒng)的編碼做對照，對照涉及的表結(jié)構(gòu)請參考

4.3.定點(diǎn)機(jī)構(gòu)需要通過54號(hào)、76號(hào)交易下載最新的目錄，并跟本定點(diǎn)機(jī)構(gòu)使用的目錄做匹

配對照.需要對照的內(nèi)容包括：

1）藥品目錄

對于已經(jīng)使用HIS系統(tǒng)的醫(yī)院，需要建立醫(yī)院藥品內(nèi)碼和甲、乙類藥品的對照表，

對于要上傳給醫(yī)保中心的數(shù)據(jù)要統(tǒng)一使用標(biāo)準(zhǔn)的甲、乙類藥品編碼。

2）診療項(xiàng)目和醫(yī)療服務(wù)設(shè)施目錄

以下簡稱診療目錄。對于已經(jīng)使用HIS系統(tǒng)的醫(yī)院，需要建立醫(yī)院收費(fèi)項(xiàng)目和醫(yī)保

中心診療項(xiàng)目的對照表,對于要上傳給醫(yī)保中心的數(shù)據(jù)要統(tǒng)一使用標(biāo)準(zhǔn)的醫(yī)保中心診療

項(xiàng)目編碼。

3）疾病編碼目錄

普通疾病暫不對應(yīng)；24種慢性病、5種門診統(tǒng)籌疾病、多種職工生育疾病需要通過

76號(hào)交易下載。

2.4.前置機(jī)及三目數(shù)據(jù)獲取

?醫(yī)?？刂婆_(tái)3.2版（前置機(jī)）：鏈接：https:〃pan.baidu.eom/s/li4DbJO5密碼：tf8t

（內(nèi)有安裝配置手冊，按照手冊進(jìn)行安裝）

晉中醫(yī)保三目（20171115）下載：鏈接：https醫(yī)pan.baidu.eom/s/lkVvdNFp密碼：a5sy

?晉中醫(yī)保最新目錄請關(guān)注微信公眾號(hào)：晉中的醫(yī)保問題咨詢;關(guān)注后回復(fù)“三目”

可以獲取最新的三目下載地址。

?晉中醫(yī)保目錄是隨著省醫(yī)保目錄變更的，省醫(yī)保目錄發(fā)布地址:

http:〃/download/

2.5.職工生育接口要求

?職工生育業(yè)務(wù)主要增加了生育報(bào)銷登記（用戶交易61）（3.4.25）和生育待遇登記

查詢、撤銷（用戶交易62）（3.4.26）這兩個(gè)交易,同時(shí)采用了專用的數(shù)據(jù)字典生

育登記項(xiàng)目（6.3.12）和生育出院疾病（6.3.13）；

?其他要求：住院登記業(yè)務(wù)（32號(hào)交易）中業(yè)務(wù)類型字段填寫52生育住院；住院信

息變動(dòng)（38號(hào)交易）中出院信息變動(dòng)要填寫胎兒數(shù)和生育（終止妊娠）時(shí)間；

其他業(yè)務(wù)接口與現(xiàn)有的職工居民業(yè)務(wù)接口一致（部分接口參數(shù)值不同，注意區(qū)分）。

2.6.新農(nóng)合接口要求

?從2018年開始，新農(nóng)合險(xiǎn)種與城鎮(zhèn)居民醫(yī)療險(xiǎn)種合并為城鄉(xiāng)居民醫(yī)療保險(xiǎn)，接口

沿用現(xiàn)行的職工和居民接口，只是人員類別有所區(qū)分（參照6.3.2人員待遇類別）;

?建檔立卡人員對于醫(yī)療機(jī)構(gòu)是屏蔽的，也是人員類別有所區(qū)分（參照6.3.2人員

待遇類別）；

2.7.跨省異地就醫(yī)要求

?跨省異地就醫(yī)采用的接口交易同省內(nèi)異地就醫(yī)、本地人員就醫(yī)是一樣的，只是人員

待遇類型有所區(qū)別（參照6.3.2人員待遇類別）;

?跨省異地就醫(yī)需要讀取外省的社?？?，根據(jù)國家異地平臺(tái)要求，需要下載特殊的動(dòng)

卡動(dòng)態(tài)庫，并要求讀卡器終端可以直接訪問到省平臺(tái)持卡庫系統(tǒng)：1

跨省異地就醫(yī)專用讀卡動(dòng)態(tài)庫下載鏈接：https:〃pan.baidu.com/用lo8TwInw密

碼：9sug

?各項(xiàng)交易接口沿用現(xiàn)有接口不變，無需重新開發(fā)；

2.8.聯(lián)系方式

晉中醫(yī)保信息中心/p>

晉中醫(yī)保工程師/p>

網(wǎng)新恩普（醫(yī)保通）客服熱線：400-960-8590

3.醫(yī)療機(jī)構(gòu)端嵌入模塊

醫(yī)療機(jī)構(gòu)端嵌入模塊（以下簡稱嵌入模塊）是整個(gè)接口系統(tǒng)唯一和用戶交互的模塊。對

于醫(yī)療機(jī)構(gòu)，僅調(diào)用此模塊中提供的用戶交易功能既可以完成醫(yī)保病人的業(yè)務(wù)處理。嵌入模

塊包含若干種用戶交易，對醫(yī)療機(jī)構(gòu)來說，用戶交易為其唯一可視交易。

3.1.嵌入模塊的處理模式

嵌入模塊處理模式如下:

嵌入模塊邏輯示意圖

(1)前臺(tái)首先調(diào)用嵌入模塊中交易初始化函數(shù)，連接遠(yuǎn)程的交易處理服務(wù)器，進(jìn)行系統(tǒng)

運(yùn)行必要的初始化處理(參考3.2.2)。交易初始化函數(shù)調(diào)用失敗則無法進(jìn)行醫(yī)保其

他交易調(diào)用.

(2)前臺(tái)根據(jù)具體業(yè)務(wù)要求調(diào)用對應(yīng)交易，調(diào)用時(shí)需提供用戶交易類型號(hào)和交易數(shù)據(jù)

包。用戶交易類型號(hào)必須是接口系統(tǒng)定義的有效號(hào)碼(參考3.4嵌入模塊的業(yè)務(wù)范

圍)，交易數(shù)據(jù)包按照具體打包規(guī)則生成(參考3.3參數(shù)數(shù)據(jù)格式)。

(3)調(diào)用用戶交易申請,并等待返回結(jié)果.

(4)醫(yī)療機(jī)構(gòu)系統(tǒng)保存醫(yī)保返回交易結(jié)果，并根據(jù)交易結(jié)果對自身數(shù)據(jù)進(jìn)行處理。部分

交易并不是由單一的交易存在.完成一次業(yè)務(wù)需要多個(gè)交易聯(lián)合完成.如結(jié)算交易

成功后需要調(diào)用49號(hào)交易進(jìn)行確認(rèn)等.

(5)交易結(jié)束并返回結(jié)果后，如果交易涉及帳戶扣款等業(yè)務(wù)一般不可以回退，如果由于

意外原因造成HIS端失敗，需要通過對醫(yī)保獨(dú)立的退費(fèi)交易回退接口正確的交易。

(6)醫(yī)院對醫(yī)療業(yè)務(wù)的接入以及對嵌入模塊的調(diào)用可參考如下模式:

嵌入模塊處理流程圖

3.2.嵌入模塊的文件內(nèi)容

嵌入模塊主文件為BargaingApplyV3_0600LDLL,其他為配套的支持文件。嵌入模塊根

據(jù)配置文件內(nèi)容獲取運(yùn)行參數(shù)，接收用戶交易并將處理結(jié)果返回給用戶。

BargaingApp1yV3_06001提供外部調(diào)用的函數(shù)主要包括交易申請函數(shù)

f_UserBargaingApply＞交易初始化函數(shù)f.UserBargainglnit和交易關(guān)閉函數(shù)

f_UserBargaingCloseo

3.2.1.配置文件

文件名：TradeCfgV306001.ini

說明：須與BargaingApplyV3_06001.DLL在同一目錄下，帶下劃線的需要醫(yī)院自行配置,

其他由接口統(tǒng)一定義統(tǒng)一提供。

文件內(nèi)容（帶下劃線部分需要各醫(yī)院配置）：

[Hardware]〃本機(jī)硬件設(shè)置（根據(jù)采用的卡做相應(yīng)配置）

COM〃:IC卡串口位置（0表示無IC卡，1：coml,2：com2,5:USB）

ReadType〃讀卡器類型，統(tǒng)一配置

CardType〃卡類型，統(tǒng)一配置

baud=l15200〃波特率

0pType=0//0普通1發(fā)卡

KBDType〃小鍵盤類型

NeedUseKdb=O

KdbCom=

KdbBaud=

HostOutTime=

CardTimeOut=

[TRADEMANAGE]

CurrentTrade=l11111111111111

TradeTime=

Max0utTime=50〃交易的最大超時(shí)時(shí)間（手工配置）

[SYSTEM]

LocalIP=〃醫(yī)保收費(fèi)終端ip

HospID=〃醫(yī)院編號(hào)（保留為空）

SysHaveInit=2006-2-23

AccBench=

TermLog=y〃表示終端是否記錄日志，'y'表示寫日志，句或空表示不寫

NativeAddress=//前置機(jī)服務(wù)器IP地址

NativeServer=HosTransmit.RModule0221〃不要改變

AREAID=06001〃地區(qū)號(hào)，不要改變

[TUXEDO]

[DATABASE]

[VERSION]〃產(chǎn)品更新信息設(shè)定

產(chǎn)品號(hào)=產(chǎn)品號(hào)，產(chǎn)品名稱，產(chǎn)品的當(dāng)前使用版本號(hào)，產(chǎn)品所在的路徑

如嵌入模塊更新信息格式：1050=1050,嵌入模塊,02.21.04003.00.1050,D:\ehis。這里

需要注意的是兩個(gè)問題，一個(gè)是產(chǎn)品號(hào)不能設(shè)置錯(cuò)誤，否則會(huì)找不到要更新的產(chǎn)品，另外一

個(gè)是產(chǎn)品路徑不要設(shè)置錯(cuò)誤，否則更新的內(nèi)容無法自動(dòng)正確更新。

一般情況下，客戶端自動(dòng)更新配置項(xiàng)只有一個(gè)1050(嵌入模塊)，當(dāng)醫(yī)療機(jī)構(gòu)軟件調(diào)用

版本更新函數(shù)時(shí)能自動(dòng)更新軟件。如果需要更新已經(jīng)運(yùn)行的軟件，只能退出HIS軟件再更新

才能成功。關(guān)于軟件的更新，詳細(xì)請參考文檔22章節(jié)：軟件手工更新和自動(dòng)更新。

3.2.2.交易初始化和關(guān)閉函數(shù)

醫(yī)療機(jī)構(gòu)軟件每次啟動(dòng)時(shí)，需要調(diào)用接口系統(tǒng)中用戶交易初始化函數(shù)，初始化接口并獲

得交易參數(shù)。如果用戶終端需要長期運(yùn)行，在跨日操作時(shí)，也需要重新調(diào)用交易初始化函數(shù)

更新接口初始化數(shù)據(jù)。

同樣，應(yīng)用軟件退出時(shí)調(diào)用用戶交易關(guān)閉函數(shù)釋放系統(tǒng)資源。

>函數(shù)原型：intf_UserBargaing!nit(constchar*Datal,char*retMsg,char*Data2)

功能：系統(tǒng)應(yīng)用前初始化數(shù)據(jù)準(zhǔn)備

參數(shù)說明：

傳入?yún)?shù)：Datal------不需要傳遞數(shù)據(jù)

Data2------傳遞醫(yī)療機(jī)構(gòu)編號(hào)

retMsg——返回的信息，數(shù)據(jù)包格式參考3.3

返回值：=0-----------成功，沒有任何警告，返回信息在retMsg

>0-----------成功，但是有警告信息，警告信息在retMsg

<0-----------失敗，錯(cuò)誤信息在retMsg中

PowerBuilder中函數(shù)定義：FUNCTIONintegerf_UserBargaingInit(stringIpDatal,

refstringIpMessage,stringlpData2)libraryz/BargaingApplyV3_06001/z

>函數(shù)原形：intf_UserBargaingClose(constchar*Data,char*retMsg,char*Data2)

功能：退出系統(tǒng)前釋放資源

參數(shù)說明：同于f_UserBargaingInit交易。

PowerBuilder中函數(shù)定義：FUNCTIONintegerf_UserBargaingClose(stringIpDatal,

refstringIpMessage,stringlpData2)library/zBargaingApp1yV3_06001

>調(diào)用實(shí)例(其中方框內(nèi)為交易返回參數(shù)，用戶傳遞進(jìn)入時(shí)為"$$3000個(gè)空格$$”)

fJJserBargainglnit(”$$$$”，”|$$0~~$$|”,”醫(yī)院編碼”)

f_UserBargaingClose(”$$$$"，"$$0~~$$"，”醫(yī)院編碼”)

3.2.3.用戶交易申請函數(shù)

?函數(shù)原型：intf_UserBargaingApply（intCode,doubleNo,constchar*Data,char*

retMsg,char*Data2）

功能：實(shí)現(xiàn)具體的業(yè)務(wù)，醫(yī)療機(jī)構(gòu)通過調(diào)用該函數(shù)申請相關(guān)用戶交易并獲取交易結(jié)果。

參數(shù)說明：

傳入?yún)?shù)：Code-----用戶交易類型號(hào)碼（2位）

No-------交易流水號(hào)（<=14位）（目前傳0）

Data-----傳入?yún)?shù)1,格式參考3.3參數(shù)數(shù)據(jù)格式

retMsg——交易返回的傳出參數(shù)，格式參考3.3參數(shù)數(shù)據(jù)格式

Data2——傳遞醫(yī)療機(jī)構(gòu)編號(hào)

返回值：=0-----------成功，沒有任何警告，返回信息在retMsg

>0-----------成功，但是有警告信息，警告信息在retMsg

<0-----------失敗，錯(cuò)誤信息在retMsg中

詳細(xì)格式參考3.3參數(shù)數(shù)據(jù)格式

注：pb調(diào)用的時(shí)候一定要用Space函數(shù)為傳出參數(shù)分配足夠空間

PowerBuilder中函數(shù)定義：FUNCTIONintegerf_UserBargaingApply(integer

nTradeTypelD,doubleTradelD,stringIpDatal,refstringIpMessage,stringlpData2)

1ibrary"BargaingApplyV3_06001z/

3.3.參數(shù)數(shù)據(jù)格式

傳遞的參數(shù)使用了幾個(gè)特殊符號(hào)作為分割符，因此，用戶提供的參數(shù)數(shù)據(jù)中不能包含這

些固定的分割符號(hào)，由于這些符號(hào)只可能出現(xiàn)在“名稱”等固定字符串中，因此用戶應(yīng)在組

裝參數(shù)前過濾掉數(shù)據(jù)包中的可能出現(xiàn)的控制字符，否則交易會(huì)出現(xiàn)意外錯(cuò)誤。目前系統(tǒng)保留

的參數(shù)保留字包括以下兒個(gè):

字符字符說明類型說明

$$雙美元符號(hào)分隔符，分隔交易數(shù)據(jù)包

?

單波浪線分隔交易包中不同域

%%雙百分比符號(hào)分隔交易包不同域間元素

單引號(hào)系統(tǒng)字符串分隔符，不可使用

%百分比符號(hào)避免分割時(shí)候出現(xiàn)錯(cuò)誤

提供給調(diào)用接口的開發(fā)商或用戶使用的接口數(shù)據(jù)格式，以$$做為交換數(shù)據(jù)包的開頭和結(jié)

束符。交易體中若有多個(gè)域，各域之間用“分隔。例如:

$$11廣22222$$,表示交易體中有兩個(gè)域，第一個(gè)域111,第二個(gè)域22222。

$$111'$$,表示交易體中有兩個(gè)域，第一個(gè)域111,第二個(gè)域?yàn)榭铡?/p>

$$111$$,表示交易體中有一個(gè)域，第一個(gè)域111。

$$$$或$$$$（中間空格可多個(gè)），表示交易體中只有一個(gè)域，該域?yàn)榭铡?/p>

$$~$$,表示交易體有二個(gè)域，兩個(gè)域都是空。

根據(jù)數(shù)據(jù)交換的特點(diǎn)，數(shù)據(jù)包包括用戶系統(tǒng)向接口系統(tǒng)提出的交易申請和接口系統(tǒng)反饋

給外部用戶系統(tǒng)的交易處理結(jié)果，不同種類的業(yè)務(wù)交易體中域的個(gè)數(shù)和含義均有所差異。

3.3.1傳入?yún)?shù)

傳入?yún)?shù)格式為：$$交易體$$，用戶提出交易申請時(shí)，通過外部傳入數(shù)據(jù)包提供參數(shù)。

交易體前4個(gè)域固定，某些交易沒有相關(guān)數(shù)據(jù)域信息時(shí)相應(yīng)值填寫空（域依然保留）：

序號(hào)域名說明

1是否有醫(yī)?？?：無醫(yī)?？↙醫(yī)保卡2：社會(huì)保障卡

2IC信息無醫(yī)?？〞r(shí)：與個(gè)人無關(guān)的交易傳空

醫(yī)保卡、社會(huì)保障卡時(shí)：22號(hào)交易傳空；非22號(hào)交易傳

IC卡號(hào)信息（參考3.4.1個(gè)人基本信息的第1個(gè)數(shù)據(jù)，22

號(hào)交易時(shí)獲得）；

3現(xiàn)金支付方式1現(xiàn)金2電子錢包

3銀行卡其它值默認(rèn)為1

4銀行卡信息預(yù)留傳空即可

3.3.2傳出參數(shù)

傳出參數(shù)的格式為：$$交易體$$,其中交易體中前5個(gè)域固定，相應(yīng)域信息沒有時(shí)該

域內(nèi)容為空，但域依然保留，前面5個(gè)固定域?yàn)椋?/p>

序號(hào)域名說明

1交易狀態(tài)0：成功<0：失敗

2錯(cuò)誤信息交易狀態(tài)=0：該域?yàn)榭?/p>

交易狀態(tài)＜0：該域返回詳細(xì)出錯(cuò)信息

交易狀態(tài)＞0：該域返回警告信息供HIS程序顯示警告

3寫醫(yī)?？ńY(jié)果0：表示寫醫(yī)?？ǔ晒蛘卟粚懣ㄆ渌罕硎静僮骺ㄊ?/p>

4扣銀行卡結(jié)果0：表示寫銀行卡成功或者不寫卡其他：表示操作卡失敗

5更新后IC卡數(shù)據(jù)預(yù)留，返回空

說明：交易狀態(tài)代碼表如下:

錯(cuò)誤代碼錯(cuò)誤類別錯(cuò)誤信息

0交易成功無錯(cuò)誤信息

-1系統(tǒng)錯(cuò)誤（包括通訊錯(cuò)誤）有錯(cuò)誤信息

-200未知錯(cuò)誤有錯(cuò)誤信息

-300報(bào)文合法性錯(cuò)誤有錯(cuò)誤信息

-400業(yè)務(wù)錯(cuò)誤（不可執(zhí)行的錯(cuò)有錯(cuò)誤信息

誤，碰到錯(cuò)誤后立即退出程

序）

-500業(yè)務(wù)錯(cuò)誤（可執(zhí)行的錯(cuò)誤，無錯(cuò)誤信息，一

程序運(yùn)行完，最后返回相應(yīng)般以交易結(jié)果

的信息）信息返回

錯(cuò)誤信息外部格式為：“錯(cuò)誤原因%%函數(shù)名概詳細(xì)錯(cuò)誤信息”。

例1：$$-400~該卡處于掛失狀態(tài)不能消費(fèi)嬲Orap32%%“$$

例2：$$0~~交易結(jié)果信息$$

一般交易失敗時(shí)，需要醫(yī)院系統(tǒng)將錯(cuò)誤原因顯示給操作用戶，供其查找錯(cuò)誤原因，如果

需要將錯(cuò)誤信息提供給接口開發(fā)者查找原因，則需要提供完整地返回參數(shù)。

3.4.嵌入模塊的業(yè)務(wù)范圍（用戶交易）

嵌入模塊包含醫(yī)保病人在醫(yī)療單位所要進(jìn)行的與醫(yī)保相關(guān)的所有操作。目前，根據(jù)醫(yī)

保政策，其業(yè)務(wù)范圍主要包括以下幾個(gè)部分，具體交易類型如下：

申請退費(fèi)43交49要

類型功能簡介備注

交易號(hào)交易易查確認(rèn)

22獲取參保人員信息----

29門診（掛號(hào)）預(yù)結(jié)算----僅返回結(jié)果供顯示使用

30門診（掛號(hào)）結(jié)算-31可是

31門診掛號(hào)/收費(fèi)退費(fèi)-/可-交易30的反交易，實(shí)時(shí)執(zhí)行

32住院登記-40可-

33住院費(fèi)用記帳----

34住院預(yù)結(jié)算----僅返回結(jié)果，不做處理

36出院結(jié)算-37可是

37出院退費(fèi)--可-交易36的反交易，實(shí)時(shí)執(zhí)行

38住院信息變動(dòng)--可-住院信息的變動(dòng)，出院后不可修改

40取消住院登記交易——可-交易32的取消交易，將刪除住院中

所有發(fā)生數(shù)據(jù)并不可恢復(fù)

41住院明細(xì)查詢----查詢已經(jīng)提交到中心的明細(xì)數(shù)據(jù)

42住院明細(xì)退費(fèi)