地緯定點醫(yī)療機構(gòu)醫(yī)保結(jié)算系統(tǒng)

核心平臺三版接口服務(wù)方案

（1.0.9.8版本）

ShandongDarewayComputerSoftwareCo.,Ltd.

山東地緯計算機軟件有限公司

Allrightsreserved

所有侵權(quán)必究

2012年12月

修改記錄

編號日期描述版本修改人審核人發(fā)布日期

12010-7-1形成接口服務(wù)文檔1.0.0王剛楊道強2010-8-1

新增刪除費用憑

22010-9-6單，出院結(jié)算新增1.0.1王加強王剛2010-9-6

預(yù)結(jié)算標志

增加門診預(yù)結(jié)算功

32010-9-201.0.2王剛王加強2010-9-20

能

增加省異地就醫(yī)相

42012-3-161.0.3郭偉王剛2012-3-16

關(guān)信息

增加電子病歷首頁

52012-7-271.0.4郭偉王剛2012-7-27

和醫(yī)囑

增加對濰坊、濟寧

62012-8-81.0.5王剛

社保卡消費的支持

72012-12-12增加下載醫(yī)師功能1.0.6王加強

增加對兗礦門診結(jié)

算住院結(jié)算時

mzghzh（門診），

bxIb,qzjbzhzf的

82013-9-171.0.7池振方

接收返回；

增加保存床位的方

法；增加下載

zybrxx服務(wù)

住院結(jié)算增加新生

92017-9-81.0.9.1閆孟文

兒疾病篩查返回值

1.門診：電子醫(yī)保

憑證結(jié)算（查詢有

卡人員基本信息

（read_card）增加

二維碼（ewm）和

dzsbkpt（電子社保

卡平臺）的出參（讀

102019-11-11卡使用特定的讀卡1.0.9.5仲燕會

器配置），門診初始

化服務(wù)（init_mz）,

增加二維碼（ewm）

和dzsbkpt（電子社

?？ㄆ脚_）的入?yún)?/p>

2.住院的不需要改

造，讀卡的時候使

用特定的讀卡器配

置就行

(read_card)增加

二維碼(ewm)的入

112020-07-20參，如果his傳入1.0.9.6仲燕會

ewm,地緯接口不再

彈錄入二維碼的框

(settIe_zy,settI

e_mz)增加

122020-09-271.0.9.7張瑞

pkryzjzje,Idybxj

e

down_mI和

down_mI_with_xz

132021-04-221.0.9.8仲燕會

的自付比例增加限

價的字段

本文檔中所包含的信息屬于機密信息，如無山東地緯計算機軟件有限公司的書面許可，任何

人都無權(quán)復(fù)制或利用。

目錄

第一章背景介紹.................................................錯誤!未定義書簽。

1.1金保工程................................................錯誤!未定義書簽。

1.2核心平臺三版(SICP3)....................................................................錯誤!未定義書簽。

1.3核心平臺三版的技術(shù)架構(gòu).................................錯誤!未定義書簽。

1.4核心平臺三版的技術(shù)路線.................................錯誤!未定義書簽。

第二章接口設(shè)計方案.............................................錯誤!未定義書簽。

2.1接口開發(fā)遵循的規(guī)范和標準...............................錯誤!未定義書簽。

2.2接口技術(shù)架構(gòu)設(shè)計方案...................................錯誤!未定義書簽。

2.2.1原定點結(jié)算系統(tǒng)技術(shù)框架................................錯誤!未定義書簽。

222接口服務(wù)技術(shù)框架.......................................錯誤!未定義書簽。

第三章接口使用說明.............................................錯誤!未定義書簽。

一、接口概述................................................錯誤!未定義書簽。

二、接口環(huán)境................................................錯誤!未定義書簽。

三、接口實例創(chuàng)建、接口示例回收.............................錯誤!未定義書簽。

1、接口實例的創(chuàng)建，創(chuàng)建ole對象........................錯誤!未定義書簽。

2、接口實例的回收：....................................錯誤!未定義書簽。

四、接口方法說明............................................錯誤!未定義書簽。

1、傳入?yún)?shù)的方法.......................................錯誤!未定義書簽。

2、執(zhí)行服務(wù)的方法......................................錯誤!未定義書簽。

2、接受返回值的方法....................................錯誤!未定義書簽。

五、接口服務(wù)概述............................................錯誤!未定義書簽。

第四章、業(yè)務(wù)服務(wù)應(yīng)用說明........................................錯誤!未定義書簽。

一、基礎(chǔ)業(yè)務(wù)相關(guān)服務(wù)........................................錯誤!未定義書簽。

1、接口登陸服務(wù)：.......................................錯誤!未定義書簽。

2、查詢有卡人員基本信息服務(wù)............................錯誤!未定義書簽。

3、查詢無卡人員基本信息服務(wù)............................錯誤!未定義書簽。

4、傳入費用明細等待保存或結(jié)算服務(wù)......................錯誤!未定義書簽。

5、打印單據(jù)服務(wù).........................................錯誤!未定義書簽。

二、住院業(yè)務(wù)相關(guān)服務(wù)........................................錯誤!未定義書簽。

1、普通住院登記服務(wù)....................................錯誤!未定義書簽。

2、住院初始化服務(wù)......................................錯誤!未定義書簽。

3、打印住院告知單服務(wù)..................................錯誤!未定義書簽。

4、保存住院費用憑單服務(wù)................................錯誤!未定義書簽。

5、上傳憑單服務(wù).........................................錯誤!未定義書簽。

6、出院結(jié)算服務(wù).........................................錯誤!未定義書簽。

7、撤銷出院服務(wù).........................................錯誤!未定義書簽。

8、撤銷住院結(jié)算服務(wù)....................................錯誤!未定義書簽。

9、刪除一條費用憑單服務(wù)................................錯誤!未定義書簽。

10、撤銷住院費用服務(wù)...................................錯誤!未定義書簽。

11、撤銷住院登記服務(wù)...................................錯誤!未定義書簽。

三、門診業(yè)務(wù)相關(guān)服務(wù)........................................錯誤!未定義書簽。

1、門診初始化服務(wù)......................................錯誤!未定義書簽。

2、門診結(jié)算服務(wù).........................................錯誤!未定義書簽。

3、撤銷門診結(jié)算服務(wù)....................................錯誤!未定義書簽。

四、個賬業(yè)務(wù)相關(guān)服務(wù)........................................錯誤!未定義書簽。

1、個賬初始化服務(wù)......................................錯誤!未定義書簽。

2、個賬結(jié)算服務(wù).........................................錯誤!未定義書簽。

3、個賬退費服務(wù).........................................錯誤!未定義書簽。

五、管理業(yè)務(wù)相關(guān)服務(wù)........................................錯誤!未定義書簽。

1、獲取自付比例服務(wù)....................................錯誤!未定義書簽。

2、下載醫(yī)院項目目錄及對應(yīng)醫(yī)保核心端目錄的相關(guān)信息服務(wù)..錯誤!未定義書簽。

3、下載核心目錄和自付比例服務(wù)..........................錯誤!未定義書簽。

4、增加醫(yī)院項目服務(wù)....................................錯誤!未定義書簽。

5、增加醫(yī)師服務(wù).........................................錯誤!未定義書簽。

第五章業(yè)務(wù)流程構(gòu)建說明.........................................錯誤!未定義書簽。

一、門診大病結(jié)算流程說明...................................錯誤!未定義書簽。

二、普通門診結(jié)算流程說明...................................錯誤!未定義書簽。

三、急診結(jié)算流程說明........................................錯誤!未定義書簽。

四、普通住院流程說明........................................錯誤!未定義書簽。

五、個人賬戶消費流程說明...................................錯誤!未定義書簽。

六、目錄管理流程說明........................................錯誤!未定義書簽。

第六章關(guān)于其他問題的處理方案..................................錯誤!未定義書簽。

一、關(guān)于科室、醫(yī)師相關(guān)問題的說明...........................錯誤!未定義書簽。

二、關(guān)于操作員相關(guān)問題的說明...............................錯誤!未定義書簽。

第七章用戶收益.................................................錯誤!未定義書簽。

第八章附錄.....................................................錯誤!未定義書簽。

一、部分代碼說明............................................錯誤!未定義書簽。

第一章背景介紹

1.1金保工程

進入二十一世紀以來，計算機技術(shù)、通信技術(shù)和網(wǎng)絡(luò)技術(shù)的高速發(fā)展，加

快了社會經(jīng)濟的信息化進程，信息化已經(jīng)成為當今世界經(jīng)濟和社會發(fā)展的大趨

勢。勞動保障信息化建設(shè)是我國政府信息化建設(shè)的重要組成部分，一直受到黨中

央和各級政府部門的高度重視。根據(jù)中辦發(fā)（2002）17號文件精神，在全面總

結(jié)勞動保障信息化工作多年經(jīng)驗的基礎(chǔ)上，按照勞動保障事業(yè)發(fā)展的總體目標，

以全國電子政務(wù)建設(shè)規(guī)劃為指導(dǎo)，勞動保障部設(shè)計編制了金保工程項目建議書，

于2002年遞交國家發(fā)改委（原國家計委），正式向國家提出立項申請。2003年

8月，經(jīng)國務(wù)院總理辦公會討論通過，金保工程正式獲準國家立項，標志著我國

勞動保障信息化工作進入了一個新的歷史時期。

1.2核心平臺三版（SICP3）

金保工程的主要內(nèi)容包括兩大系統(tǒng)即社會保險信息系統(tǒng)和勞動力市場信息

系統(tǒng)，三級網(wǎng)絡(luò)即市、省、中央三級數(shù)據(jù)庫及其信息交互，四大功能即業(yè)務(wù)經(jīng)辦、

公共服務(wù)、基金管理和決策支持。

核心平臺三版是以城市級社會保險經(jīng)辦業(yè)務(wù)為核心，以實現(xiàn)基本養(yǎng)老保險、

失業(yè)保險、基本醫(yī)療保險、工傷保險、生育保險主體業(yè)務(wù)經(jīng)辦和基金管理過程信

息化為最終目標。支持城市級的業(yè)務(wù)經(jīng)辦和基金管理，并通過其統(tǒng)計查詢功能為

決策支持提供服務(wù)，通過與勞動保障電話咨詢中心及網(wǎng)站的連接提供公共服務(wù)，

通過為市、省、中央三級網(wǎng)絡(luò)及資源數(shù)據(jù)庫提供數(shù)據(jù)源完成三級數(shù)據(jù)網(wǎng)建設(shè)。

1.3核心平臺三版的技術(shù)架構(gòu)

針對各地社會保險業(yè)務(wù)處理的特殊性，核心平臺三版提供了適合社會保險

業(yè)務(wù)的技術(shù)框架SICP3,其中包括安全、日志、交易、接口等服務(wù)。在此技術(shù)框

架之上，核心平臺三版提供了社會保險業(yè)務(wù)的原子級業(yè)務(wù)處理。

同時，核心平臺三版對于外部系統(tǒng)提供統(tǒng)一的接口方案，使得開發(fā)更加靈

活，系統(tǒng)易于管理。

1.4核心平臺三版的技術(shù)路線

1.核心平臺三版開發(fā)采用SOA體系，利于互聯(lián)互通，按照CMM的要求制定

一系列開發(fā)規(guī)范，并通過質(zhì)量保證小組最大程度地保證了核心平臺三版的總體質(zhì)

量。

2.核心平臺三版采用面向?qū)ο蟮姆治龊驮O(shè)計方法，在對指標體系改動最小

的基礎(chǔ)上，利用面向?qū)ο蠓治鲈O(shè)計的優(yōu)勢，對不同層次采用不同的設(shè)計模式進行

設(shè)計，即MVC模式。

3.核心平臺三版采用統(tǒng)一的對外接口服務(wù)，無論是參保企業(yè)、銀行、稅務(wù)、

勞動力市場還是醫(yī)院、藥店，都可以通過“接口服務(wù)”很快完成與核心平臺三版

的接口設(shè)計和開發(fā)。

4.核心平臺三版采用基于J2EE的雙兼容架構(gòu)，并且參考了當前主流的Web

應(yīng)用框架（spring、struts）,實現(xiàn)了適用于社會保險的企業(yè)級應(yīng)用框架（SICP3）。

采用企業(yè)架構(gòu)將業(yè)務(wù)邏輯處理集中到應(yīng)用服務(wù)器，應(yīng)用服務(wù)器具有良好的可擴展

性，大大提高了系統(tǒng)的并發(fā)處理能力。

第二章接口設(shè)計方案

定點醫(yī)療機構(gòu)業(yè)務(wù)是社會保險體系中的重要組成部分，定點醫(yī)療機構(gòu)結(jié)算

系統(tǒng)更是核心平臺三版的核心外圍業(yè)務(wù)系統(tǒng)之一。為了更好的實現(xiàn)定點醫(yī)療機構(gòu)

結(jié)算系統(tǒng)與醫(yī)院自身信息管理系統(tǒng)的對接，地緯公司研制設(shè)計了本接口系統(tǒng)。

“DW定點醫(yī)院接口服務(wù)系統(tǒng)”是在地緯公司Dweaf快速開發(fā)框架的基礎(chǔ)上,

采用面向服務(wù)的應(yīng)用程序開發(fā)(Services-orienteddevelopmentof

application,SODA)使定點醫(yī)院醫(yī)保結(jié)算系統(tǒng)轉(zhuǎn)換到面向服務(wù)架構(gòu)

(service-orientedarchitecture,S0A)。

“DW定點醫(yī)院接口服務(wù)系統(tǒng)”集成了醫(yī)療保險定點醫(yī)療機構(gòu)的所有結(jié)算業(yè)

務(wù)服務(wù)(函數(shù))，這些函數(shù)供HIS系統(tǒng)調(diào)用，并支持重要結(jié)算信息的返回。將該

接口嵌入原醫(yī)院管理系統(tǒng)后，醫(yī)院管理系統(tǒng)可無縫連接到醫(yī)療保險網(wǎng)絡(luò)信息系

統(tǒng)。

接口完成以后，住院、門診、門診大病等主業(yè)務(wù)結(jié)算流程均完全嵌入醫(yī)院

HIS系統(tǒng)，通過DW定點醫(yī)院接口，為各定點機構(gòu)搭建了一個高品質(zhì)、可管理、

高可用性的信息集成平臺，能夠為HIS系統(tǒng)提供全面高效的服務(wù)。

2.1接口開發(fā)遵循的規(guī)范和標準

地緯公司在“DW定點醫(yī)院接口服務(wù)系統(tǒng)”開發(fā)過程中，完全遵從金保工程

“核心平臺三版”的技術(shù)架構(gòu)、指標體系和業(yè)務(wù)規(guī)范，系統(tǒng)符合《山東省勞動和

社會保障管理信息系統(tǒng)總體方案》和勞動保障部關(guān)于核心平臺三版信息系統(tǒng)建設(shè)

的有關(guān)要求，可以完全實現(xiàn)醫(yī)院自身信息管理系統(tǒng)與醫(yī)保結(jié)算系統(tǒng)的無縫連接。

接口開發(fā)采用的產(chǎn)品、網(wǎng)絡(luò)體系結(jié)構(gòu)和通信協(xié)議采用國家相關(guān)標準、部門專業(yè)標

準以及國際通用的工業(yè)標準，服從國家管理信息系統(tǒng)的規(guī)劃和有關(guān)規(guī)定。

項目開發(fā)過程中所遵循的標準規(guī)范主要有：

?勞動和社會保險管理信息系統(tǒng)信息結(jié)構(gòu)通則(LB001—2000)

?社會保險管理信息系統(tǒng)指標體系一業(yè)務(wù)部分(LB101-2000)

?《金保工程勞動力市場信息系統(tǒng)建設(shè)指導(dǎo)意見》

?ISO9000397質(zhì)量管理和質(zhì)量保證標準

?EJB2.0規(guī)范

?GB/T17859—1999計算機信息系統(tǒng)安全保護等級劃分準則

?GB/T17900—1999網(wǎng)絡(luò)代理服務(wù)器的安全技術(shù)要求

?GB/T16680—1996軟件文檔管理指南

?GB/T14079—1993軟件維護指南

?GB/T14394—1993計算機軟件可靠性和可維護性管理

?GB/T12504—1990計算機軟件質(zhì)量保證計劃規(guī)范

?GB/T12505—1990計算機軟件配置管理計劃規(guī)范

?GB1526-1989信息處理-數(shù)據(jù)流圖、程序流程圖、系統(tǒng)流程圖、程序

網(wǎng)絡(luò)圖和系統(tǒng)資源圖的文件編制符號及約定

?GB/T8567—1988計算機軟件產(chǎn)品開發(fā)文件編制指南

?GB/T9385—1988計算機軟件需求說明編制指南

?GB/T9386—1988計算機軟件測試文件編制規(guī)范

?GB/T10114—1988縣以下行政區(qū)代碼編制規(guī)則

?GB/T4754—1994國民經(jīng)濟行業(yè)分類與代碼

?《山東地緯計算機軟件有限公司質(zhì)量體系程序文件》

2.2接口技術(shù)架構(gòu)設(shè)計方案

“DW定點醫(yī)院接口服務(wù)系統(tǒng)”是嚴格遵守“核心平臺三版”的技術(shù)框架，

采用基于Dweaf平臺的多層體系結(jié)構(gòu)模式，以集中式數(shù)據(jù)資源共享為基礎(chǔ)，采用

先進的0/RMapping映射機制實現(xiàn)了優(yōu)良的面向?qū)ο箝_發(fā)方案，確保了系統(tǒng)具有

高度的易用性、良好的擴展性和強大的可移植性。

“DW定點醫(yī)院接口服務(wù)”完全遵守“核心平臺三版”的業(yè)務(wù)指標體系和業(yè)

務(wù)規(guī)范要求，并針對不同地區(qū)的業(yè)務(wù)研究分析后對業(yè)務(wù)指標體系進行了合理化擴

展，實現(xiàn)了從軟件配置上解決業(yè)務(wù)需求問題，做到快速開發(fā)、高度復(fù)用的要求。

2.2.1原定點結(jié)算系統(tǒng)技術(shù)框架

在實現(xiàn)接口服務(wù)前，地緯定點結(jié)算系統(tǒng)與醫(yī)保核心端應(yīng)用架構(gòu)如下:

2.2.2接口服務(wù)技術(shù)框架

實現(xiàn)接口服務(wù)后，醫(yī)院端與醫(yī)保核心端應(yīng)用架構(gòu)如下:

從以上實現(xiàn)接口服務(wù)前后的技術(shù)框架可以看出，“DW定點醫(yī)院接口服務(wù)”

替代了原地緯結(jié)算系統(tǒng)中的應(yīng)用服務(wù)層。HIS開發(fā)商在其HIS系統(tǒng)中只需要將DW

表示層中的相應(yīng)界面展示完成后，即可實現(xiàn)與醫(yī)保結(jié)算系統(tǒng)的無縫連接。

第三章接口使用說明

一、接口概述

本接口系統(tǒng)一共包含三個文件，分別為、、。所有服務(wù)均集成在動態(tài)鏈接庫中，

這個業(yè)文件需要注冊成com組件。和文件，用于接口升級。以上三個文件必須

在同一個目錄中。HIS系統(tǒng)只需要調(diào)用ProgramID為sei3的組件中的服務(wù)就可

以了。

HIS系統(tǒng)完成接口調(diào)用開發(fā)以后，住院、門診、門診大病等主業(yè)務(wù)結(jié)算流程

均完全嵌入醫(yī)院HIS系統(tǒng)，數(shù)據(jù)傳輸?shù)群笈_業(yè)務(wù)仍需要依靠地緯定點結(jié)算系統(tǒng)

來完成。

下面將講述接口的具體使用方法及例程。

（注：本文提供的PB示例代碼，作用是更直觀的解釋本方案內(nèi)容，以方便

HIS廠商進行開發(fā)，僅供參考之用。）

二、接口環(huán)境

在運行結(jié)算系統(tǒng)的業(yè)務(wù)機上需要具備接口環(huán)境，具體操作如下：

1、將【接口庫dll】文件夾中所有的dll文件拷入C:\WIND0WS\system32下。

2、注冊文件，為接口的類庫文件，具體注冊方法如下（其它dH無須注冊）：

3、注冊方法：

點擊開始一>運行一>輸入regsvr32回車

如果顯示“中的DLLRegisterServer”成功字樣，說明注冊成功。

三、接口實例創(chuàng)建、接口示例回收

在登陸HIS系統(tǒng)時需要進行接口實例的創(chuàng)建，創(chuàng)建成功以后，才能正常調(diào)用

接口服務(wù)。建議在HIS系統(tǒng)登陸的同時，調(diào)用接口登陸的服務(wù)，同時在退出HIS

系統(tǒng)時，需要進行接口實例的回收，以免造成資源浪費。

1、接口實例的創(chuàng)建，創(chuàng)建。加對象

通過第二步操作，接口dll()已經(jīng)被注冊成了COM組件。每種開發(fā)語言都有

自己調(diào)用COM組件的方式。HIS開發(fā)人員可以根據(jù)自己所使用的開發(fā)語言來調(diào)用

本接口的COM組件，創(chuàng)建接口對象的實例。本接口的Programid為：sei3,Class

id為：E734EBF4-CC87-446A-8497-B792AlBF21BDo

PB示例，各種開發(fā)語言方法不同，下面代碼僅供PB程序員參考:

〃創(chuàng)建地緯嵌入式接口對象，調(diào)用com組件

intvi

Oleobjectsei

sei=createOleobject〃倉ij建ole對象seiproxy

vi=cttonewobjectCsei35)〃連接com組件

ifvi<>0then

messagebox錯誤'，’創(chuàng)建地緯嵌入式接口sei對象失?。?)

return

endif

2、接口實例的回收：

在不使用本接口的時候，需要回收接口實例，以免造成資源浪費。

PB示例，各種開發(fā)語言方法不同，下面代碼僅供PB程序員參考：：

//銷毀地緯嵌入式接口對象

nnectObject()//DisconnectObject方法為PB語言的系統(tǒng)函數(shù)

Destroysei

四、接口方法說明

本接口為您提供9個方法(見表4-1),使用這9個方法可以調(diào)用接口中的

任何一個服務(wù)。

表4T接口提供的方法

方法作用方法名稱返回類型說明

resetvarlong清空上傳參數(shù)緩存區(qū)

putvarstringlong向某個服務(wù)傳入字符串類型的變量

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

putvardeclong向某個服務(wù)傳入數(shù)字類型的變量

putvardatetimelong向某個服務(wù)傳入時間類型的變量

request_servicelong調(diào)用接口中的某個服務(wù)

執(zhí)行服務(wù)

get_errtextstring獲取服務(wù)執(zhí)行過程中產(chǎn)生的錯誤

getvarstringstring接受服務(wù)執(zhí)行成功后返回的字符串變量

接收返回值getvardecdecimal接受服務(wù)執(zhí)行成功后返回的數(shù)字變量

getvardatetimedatetime接受服務(wù)執(zhí)行成功后返回的時間變量

1、傳入?yún)?shù)的方法

⑴方法名稱：resetvar()returnlong

方法作用：清空上傳參數(shù)緩存區(qū)

參數(shù)說明：無

返回值說明：0代表成功，其他代表失敗

⑵方法名稱：putvarstring(stringname,stringvalue)returnlong

方法作用：向某個服務(wù)傳入字符串類型的變量

參數(shù)說明：name傳入?yún)?shù)的名稱

value傳入?yún)?shù)的值，字符串類型

返回值說明：0代表成功，其他代表失敗

⑶方法名稱：putvardec(stringname,decimalvalue)returnlong

方法作用：向某個服務(wù)傳入數(shù)字類型的變量

參數(shù)說明：name傳入?yún)?shù)的名稱

value傳入?yún)?shù)的值，數(shù)字類型

返回值說明：0代表成功，其他代表失敗

⑷方法名稱：putvardatetime(stringname,datetimevalue)returnlong

方法作用：向某個服務(wù)傳入datetime類型的變量

參數(shù)說明：name傳入?yún)?shù)的名稱

value傳入?yún)?shù)的值，datetime類型

返回值說明：0代表成功，其他代表失敗

2、執(zhí)行服務(wù)的方法

⑴方法名稱：request_service(stringserviceName)returnlong

方法作用：執(zhí)行接口中的指定的服務(wù)

參數(shù)說明：serviceName需要執(zhí)行的服務(wù)的名稱

返回值說明：0代表成功，其他代表失敗

⑵方法名稱：get_errtext()returnstring

方法作用：當request_service的返回值不為零的時候，調(diào)用該方法，用來獲取服務(wù)執(zhí)行

過程中的錯誤信息

參數(shù)說明：無

返回值說明：執(zhí)行服務(wù)中產(chǎn)生的錯誤信息

2、接受返回值的方法

⑴方法名稱：getvarstring(stringname)returnstring

方法作用：接受服務(wù)執(zhí)行成功后返回的字符串類型變量

參數(shù)說明：name要接受的變量的名稱

返回值說明：傳入的參數(shù)名稱對應(yīng)的參數(shù)值

⑵方法名稱：getvardec(stringname)returndecimal

方法作用：接受服務(wù)執(zhí)行成功后返回的數(shù)字類型變量

參數(shù)說明：name要接受的變量的名稱

返回值說明：傳入的參數(shù)名稱對應(yīng)的參數(shù)值

⑶方法名稱：getvardatetime(stringname)returndatetime

方法作用：接受服務(wù)執(zhí)行成功后返回的時間類型變量

參數(shù)說明：name要接受的變量的名稱

返回值說明：傳入的參數(shù)名稱對應(yīng)的參數(shù)值

五、接口服務(wù)概述

通過調(diào)用本接口提供的相關(guān)服務(wù)，可以實現(xiàn)系統(tǒng)的登錄初始化，獲取參保人

信息，進行住院相關(guān)業(yè)務(wù)，門診的相關(guān)業(yè)務(wù)，個賬消費的相關(guān)業(yè)務(wù)。下圖為本接

口提供的部分服務(wù)的流程概括圖。

接口登陸初始化

init

init_gzinitmzsavezyq/*住院登記*/

循

循

init_zy產(chǎn)住院初始化*/

環(huán)

環(huán)

調(diào)

調(diào)

用

用產(chǎn)打印住院告知單（可選）*/

保

保put_fymcput_fymcpnnt^gzd

存

存

循

憑

憑

環(huán)

單

單

調(diào)

用

/*個賬結(jié)算*/產(chǎn)門診結(jié)算可

put_fymc

settle^gzsettle_mz

/*打印發(fā)票*//*打印發(fā)票*/

pnnt_djprint__dj/*保存費用憑單*/

save_zy_scnpt

/*上傳憑單至醫(yī)保*/

trans_zy_scnpt

/*出院結(jié)算*/

settle__zy

可丁印發(fā)票*/

print_dj

業(yè)務(wù)撤銷流程

/*撤銷住外流程*/

init_zy

/*撤銷出院*/一

destroy_cy

/*撤銷住院結(jié)算3

destroy_zyjs

/嘴銷住院費用*/

destroy_all_fypd

/嘴銷住院登記才

destroy_zydj

1、每次調(diào)用住院相關(guān)的服務(wù)之前(除了住院登記save_zydj)都必須首先調(diào)用住

院初始化服務(wù)(init_zy)。

2、每次調(diào)用門診結(jié)算相關(guān)的服務(wù)之前都必須首先調(diào)用門診初始化初始化服務(wù)

(init_mz)。

3、每次調(diào)用個人賬戶消費流程之前都必須首先調(diào)用住院初始化服務(wù)

(init_gz)o

4、每次調(diào)用撤銷住院相關(guān)的服務(wù)之前都必須首先調(diào)用住院初始化服務(wù)

(init_zy)。

第四章、業(yè)務(wù)服務(wù)應(yīng)用說明

一、基礎(chǔ)業(yè)務(wù)相關(guān)服務(wù)

1、接口登陸服務(wù)：

服務(wù)名稱：init

服務(wù)作用：用于登陸地緯定點醫(yī)療機構(gòu)結(jié)算系統(tǒng)。

服務(wù)返回值：

返回值說明

0代表成功登錄地緯定點醫(yī)療機構(gòu)結(jié)算系統(tǒng)。

-800代表接口需要升級，請退出系統(tǒng)重新登錄，重新登錄之后會系統(tǒng)會自

動升級

其他代表登陸地緯定點醫(yī)療機構(gòu)結(jié)算系統(tǒng)失?。ㄊ≡蚩梢酝ㄟ^方法

get_errtext（）獲?。?/p>

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

參數(shù)名稱類型中文名稱說明

yybmstring醫(yī)院編碼登錄地緯系統(tǒng)的醫(yī)院的編碼

gzrybhstring工作人員編號醫(yī)院的工作人員的編號（4位）

pwdstring工作人員密碼用于登錄地緯系統(tǒng)的密碼

其中標注*的為必傳參數(shù)禁止為空

服務(wù)說明：

如果在調(diào)用init服務(wù)之前沒有傳入?yún)?shù)yybm（醫(yī)院編碼），gzrybh

（工作人員），pwd（密碼），本接口程序會彈出結(jié)算系統(tǒng)的登陸界面，

讓操作員輸入編號和密碼進行登陸。如果傳入了上面的三個變量，并且工

作人員編號和密碼都正確，接口程序不會彈出登錄界面，接口會自動登錄。

在調(diào)用其他服務(wù)之前必須先調(diào)用一下該服務(wù)，用于登陸地緯醫(yī)保結(jié)算

系統(tǒng)數(shù)據(jù)庫，如果登陸失敗，所有業(yè)務(wù)均無法正常運行。

PB示例代碼:

〃登陸地緯醫(yī)療機構(gòu)結(jié)算系統(tǒng)

var()

「string("yybnT,“370101")

rstring(^gzrybh^,〃0001〃)

rstring(〃pwd〃,〃1234〃)

vi=st_service(〃init〃)

ifvi=-800then

〃表示接口需要升級，此時應(yīng)該關(guān)閉HIS程序，重新啟動HIS程序后接口會自動升級

haltclose

endif

ifvi<>0then

errtext=_errtext（）

messagebox（'登陸失敗錯誤號：'+string（vi）+'錯誤信息:'+errtext)

return

endif

messagebox（〃信息〃，〃地緯接口登陸成功！〃）

2、查詢有卡人員基本信息服務(wù)

服務(wù)名稱：read_card

服務(wù)作用：讀取卡片信息，取得人員相關(guān)信息。

服務(wù)返回值：

返回值說明

0代表成功

其他代表失敗，請使用get_errtext（）方法獲取錯誤信息

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

參數(shù)名稱類型中文名稱說明

yltclbstring*醫(yī)療統(tǒng)籌類別0為取卡片基本信息，1為住院，4為門診大

?。ㄌ夭。?，6為普通門診

jymmbzstring校驗密碼標志'1'代表校驗密碼，'0'代表不校驗密碼，

（可選參數(shù)）

readertypestring讀卡器類型（可選參數(shù)）

ewmstring二維碼（可選參數(shù)），如果做電子醫(yī)保憑證結(jié)算傳入

讀卡的時候不再彈錄入二維碼的框，his不

傳就會彈出錄入二維碼的框

其中標注*的為必傳參數(shù)禁止為空

返回結(jié)果集：

標識名中文名稱類型長度說明

sbjgbh*社保機構(gòu)編號string20獲取持卡人所在的社保機構(gòu)編號

rqlb*人群類別string3獲取人群類別（A：職工，B：居民）

kh*卡號string30獲取持卡人的卡號

grbh*個人編號string18獲取持卡人的個人編號

xm*姓名string50獲取持卡人的姓名

xb性別string31:男2女9不確定

ye賬戶余額decimal16獲取持卡人的賬戶余額

zfbz*灰名單標志string30代表灰名單,1代表白名單

zfsm灰名單原因string無如果是白名單該值為空

dwmc單位名稱string無獲取持卡人所屬單位名稱

ylrylb醫(yī)療人員類別string20獲取持卡人的醫(yī)療人員類別（內(nèi)容為

漢字）

ydbz異地標志string31代表是異地，0代表不是異地

mzdbjbs疾病編碼string無獲取門診大病的疾病編碼

zhzybz住院記錄string3有無15（醫(yī)保參數(shù)制）天內(nèi)的住院記錄1

為有,0為無

zhzysm住院記錄說明string無15（醫(yī)保參數(shù)控制）天內(nèi)的住院記錄說

明

zcyymc轉(zhuǎn)出醫(yī)院名稱string無本結(jié)果如果不為空字符串即''

和'*',則表示本次住院是從市內(nèi)轉(zhuǎn)

院來的

zccyrq轉(zhuǎn)院出院日期string無獲取轉(zhuǎn)出醫(yī)院的出院日期

sfzhm身份證號碼string18獲取持卡人的身份證號碼

csrq出生日期string8獲取持卡人的出生日期（格式：

yyyymmdd）

ptmztcbz普通門診統(tǒng)籌備stirng無普通門診統(tǒng)籌的地方可以接受這個變

注量。如果沒有普通門診統(tǒng)籌，該變量

返回空

sfxsptmz是否享受普通門string無說明該參保人是否享受普通門診統(tǒng)

tc診統(tǒng)籌籌。只有普通門診統(tǒng)籌的地方才能用

至IJ。沒有普通門診統(tǒng)籌該變量返回空

mzdbbz門診大病備注string無門診大病備注信息，主要顯示參保人

還差多少錢到限額。在yltclb=4的時候

可以接一下這個變量，其他情況該變

量為空。

Cbdsbh參保地市編號String無省異地結(jié)算標示異地人員信息

Cbjgmc參保機構(gòu)名稱String無省異地結(jié)算標示異地人員信息

ffdbm發(fā)放點編碼String卡片發(fā)放點編碼

yhkkh銀行卡卡號String銀行卡號

ffdmc銀行名稱String開戶銀行名稱

kyhzh社保卡賬戶String社保卡賬戶

sbm識別碼String識別碼（全國異地使用）

ewm二維碼string電子社?？ɑ螂娮俞t(yī)保憑證的二維碼

（門診初始化的時候使用）

注意：讀卡的時候需要選擇電子社保

卡的讀卡器配置才能返回二維碼

dzsbkpt電子社?？ㄆ脚_string區(qū)分電子社?？ê碗娮俞t(yī)保憑證（門診

初始化的時候使用）

中文名稱前標注*的為HIS必須接收的結(jié)果集。

服務(wù)說明:

如果讀卡僅僅是為了獲取個人基本信息，如姓名、性別、醫(yī)?？ㄌ柕?

yltclb請傳遞為'0';住院登記讀卡時請傳遞yltclb='1';門診大病讀

卡時請傳遞yltclb='4';普通門診讀卡時請傳遞yltclb='6'。

關(guān)于疾病編碼的特別說明：由于門診大病備案時可能備多個病種,所

以讀卡返回的結(jié)果疾病編碼(mzdbjbs)格式是：疾病病種的名稱1

+'+疾病病種編碼1+'/'+疾病病種的名稱2+，+疾病病

種編碼2+'/，+……，在此格式的基礎(chǔ)上，請開發(fā)人員自行解析其中的

編碼和名稱,并展示在功能界面上供操作人員選擇。(每次結(jié)算操作員只能

選擇一種疾病病種)

PB示例代碼：

〃讀卡取參保人的基本信息

var()

rstring(，yltclb，,’1')

ifst_service(*read_card，)<>0then

messagebox('調(diào)用讀卡服務(wù)失敗'，"錯誤信息："+_errtext())

return

endif

〃獲取服務(wù)執(zhí)行成功后的返回值

vsbjgbh=rstringC*sbjgbh，)

vrqlb=「string('rqlb')

vkh=「string('kh')

vgrbh=「string('grbh')

vxm=rstringC*xm，)

vzfbz=rstring(，zfbz，)

vmzdbjbs=「string('mzdbjbs')〃獲取門診大病登記的疾病編碼

vye=rdec('ye')〃獲取數(shù)字類型的返回值

3、查詢無卡人員基本信息服務(wù)

服務(wù)名稱：query_person_info

服務(wù)作用：

查詢參保人員就醫(yī)的基本信息，根據(jù)傳入的yltclb來取參保人員在

社保中心的相關(guān)信息。

服務(wù)返回值:

返回值說明

0代表成功

其他代表失敗，請使用get_errtext（）方法獲取錯誤信息

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

參數(shù)名稱類型中文名稱說明

grbhstring*個人編號參保人的個人編號或者身份證號碼

xmstring*姓名傳入的姓名必須和醫(yī)保數(shù)據(jù)庫中一致

yltclbstring*醫(yī)療統(tǒng)籌類別傳入1或4或6。1：住院，4：門診大病,6：

普通門診。系統(tǒng)會根據(jù)此參數(shù)從社保中心取

不同的信息

sbjgbhstring*社保機構(gòu)編號參保人所屬的社保機構(gòu)編號

xzbzstring險種標志醫(yī)療：C,工傷：D,生育：E

其中標注*的為必傳參數(shù)禁止為空

返回結(jié)果集：

標識名中文名稱類型長度說明

grbh*個人編號string18獲取參保人的個人編號

sfzhm*身份證號碼string18獲取參保人的身份證號碼

xm*姓名string50獲取參保人的姓名

csrq出生日期string8獲取出生日期（格式：yyyymmdd）

xb性別string31:男2女9不確定

zfbz*灰名單標志string30代表灰名單,1代表白名單

zfsm灰名單原因string無如果是白名單該值為空

dwmc單位名稱string無獲取持卡人所屬單位名稱

ylrylb醫(yī)療人員類別string無獲取持卡人的醫(yī)療人員類別（內(nèi)容為漢

字）

ydbz異地標志string31代表是異地，0代表不是異地

mzdbjbs疾病編碼string無獲取門診大病的疾病編碼（說明同上）

zhzybz住院記錄string3有無15（醫(yī)保參數(shù)制）天內(nèi)的住院記錄1

為有，0為無

zhzysm住院記錄說明string無15（醫(yī)保參數(shù)控制）天內(nèi)的住院記錄說明

zcyymc轉(zhuǎn)出醫(yī)院名稱string100本結(jié)果如果不為空字符串即和'*’,

則表示本次住院是從市內(nèi)轉(zhuǎn)院來的

zccyrq轉(zhuǎn)院出院日期string無獲取轉(zhuǎn)出醫(yī)院的出院日期

yfdxbz優(yōu)撫對象標志stirng31代表是優(yōu)撫對象，0代表不是優(yōu)撫對象

yfdxlb優(yōu)撫對象類別string3優(yōu)撫對象類別

rqlb*人群類別string3獲取人群類別（A：職工，B：