地緯定點醫療機構醫保結算系統

核心平臺三版接口服務方案

（1.0.9.8版本）

ShandongDarewayComputerSoftwareCo.,Ltd.

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

Allrightsreserved

所有侵權必究

2012年12月

修改記錄

編號日期描述版本修改人審核人發布日期

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

新增刪除費用憑

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

預結算標志

增加門診預結算功

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

能

增加省異地就醫相

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

關信息

增加電子病歷首頁

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

和醫囑

增加對濰坊、濟寧

62012-8-81.0.5王剛

社保卡消費的支持

72012-12-12增加下載醫師功能1.0.6王加強

增加對兗礦門診結

算住院結算時

mzghzh（門診），

bxIb,qzjbzhzf的

82013-9-171.0.7池振方

接收返回；

增加保存床位的方

法；增加下載

zybrxx服務

住院結算增加新生

92017-9-81.0.9.1閆孟文

兒疾病篩查返回值

1.門診：電子醫保

憑證結算（查詢有

卡人員基本信息

（read_card）增加

二維碼（ewm）和

dzsbkpt（電子社保

卡平臺）的出參（讀

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

器配置），門診初始

化服務（init_mz）,

增加二維碼（ewm）

和dzsbkpt（電子社

保卡平臺）的入參

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仲燕會

的自付比例增加限

價的字段

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

人都無權復制或利用。

目錄

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

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

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

1.3核心平臺三版的技術架構.................................錯誤!未定義書簽。

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

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

2.1接口開發遵循的規范和標準...............................錯誤!未定義書簽。

2.2接口技術架構設計方案...................................錯誤!未定義書簽。

2.2.1原定點結算系統技術框架................................錯誤!未定義書簽。

222接口服務技術框架.......................................錯誤!未定義書簽。

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

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

二、接口環境................................................錯誤!未定義書簽。

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

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

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

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

1、傳入參數的方法.......................................錯誤!未定義書簽。

2、執行服務的方法......................................錯誤!未定義書簽。

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

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

第四章、業務服務應用說明........................................錯誤!未定義書簽。

一、基礎業務相關服務........................................錯誤!未定義書簽。

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

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

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

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

5、打印單據服務.........................................錯誤!未定義書簽。

二、住院業務相關服務........................................錯誤!未定義書簽。

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

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

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

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

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

6、出院結算服務.........................................錯誤!未定義書簽。

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

8、撤銷住院結算服務....................................錯誤!未定義書簽。

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

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

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

三、門診業務相關服務........................................錯誤!未定義書簽。

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

2、門診結算服務.........................................錯誤!未定義書簽。

3、撤銷門診結算服務....................................錯誤!未定義書簽。

四、個賬業務相關服務........................................錯誤!未定義書簽。

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

2、個賬結算服務.........................................錯誤!未定義書簽。

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

五、管理業務相關服務........................................錯誤!未定義書簽。

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

2、下載醫院項目目錄及對應醫保核心端目錄的相關信息服務..錯誤!未定義書簽。

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

4、增加醫院項目服務....................................錯誤!未定義書簽。

5、增加醫師服務.........................................錯誤!未定義書簽。

第五章業務流程構建說明.........................................錯誤!未定義書簽。

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

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

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

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

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

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

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

一、關于科室、醫師相關問題的說明...........................錯誤!未定義書簽。

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

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

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

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

第一章背景介紹

1.1金保工程

進入二十一世紀以來，計算機技術、通信技術和網絡技術的高速發展，加

快了社會經濟的信息化進程，信息化已經成為當今世界經濟和社會發展的大趨

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

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

結勞動保障信息化工作多年經驗的基礎上，按照勞動保障事業發展的總體目標，

以全國電子政務建設規劃為指導，勞動保障部設計編制了金保工程項目建議書，

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

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

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

1.2核心平臺三版（SICP3）

金保工程的主要內容包括兩大系統即社會保險信息系統和勞動力市場信息

系統，三級網絡即市、省、中央三級數據庫及其信息交互，四大功能即業務經辦、

公共服務、基金管理和決策支持。

核心平臺三版是以城市級社會保險經辦業務為核心，以實現基本養老保險、

失業保險、基本醫療保險、工傷保險、生育保險主體業務經辦和基金管理過程信

息化為最終目標。支持城市級的業務經辦和基金管理，并通過其統計查詢功能為

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

通過為市、省、中央三級網絡及資源數據庫提供數據源完成三級數據網建設。

1.3核心平臺三版的技術架構

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

業務的技術框架SICP3,其中包括安全、日志、交易、接口等服務。在此技術框

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

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

活，系統易于管理。

1.4核心平臺三版的技術路線

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

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

量。

2.核心平臺三版采用面向對象的分析和設計方法，在對指標體系改動最小

的基礎上，利用面向對象分析設計的優勢，對不同層次采用不同的設計模式進行

設計，即MVC模式。

3.核心平臺三版采用統一的對外接口服務，無論是參保企業、銀行、稅務、

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

的接口設計和開發。

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

應用框架（spring、struts）,實現了適用于社會保險的企業級應用框架（SICP3）。

采用企業架構將業務邏輯處理集中到應用服務器，應用服務器具有良好的可擴展

性，大大提高了系統的并發處理能力。

第二章接口設計方案

定點醫療機構業務是社會保險體系中的重要組成部分，定點醫療機構結算

系統更是核心平臺三版的核心外圍業務系統之一。為了更好的實現定點醫療機構

結算系統與醫院自身信息管理系統的對接，地緯公司研制設計了本接口系統。

“DW定點醫院接口服務系統”是在地緯公司Dweaf快速開發框架的基礎上,

采用面向服務的應用程序開發(Services-orienteddevelopmentof

application,SODA)使定點醫院醫保結算系統轉換到面向服務架構

(service-orientedarchitecture,S0A)。

“DW定點醫院接口服務系統”集成了醫療保險定點醫療機構的所有結算業

務服務(函數)，這些函數供HIS系統調用，并支持重要結算信息的返回。將該

接口嵌入原醫院管理系統后，醫院管理系統可無縫連接到醫療保險網絡信息系

統。

接口完成以后，住院、門診、門診大病等主業務結算流程均完全嵌入醫院

HIS系統，通過DW定點醫院接口，為各定點機構搭建了一個高品質、可管理、

高可用性的信息集成平臺，能夠為HIS系統提供全面高效的服務。

2.1接口開發遵循的規范和標準

地緯公司在“DW定點醫院接口服務系統”開發過程中，完全遵從金保工程

“核心平臺三版”的技術架構、指標體系和業務規范，系統符合《山東省勞動和

社會保障管理信息系統總體方案》和勞動保障部關于核心平臺三版信息系統建設

的有關要求，可以完全實現醫院自身信息管理系統與醫保結算系統的無縫連接。

接口開發采用的產品、網絡體系結構和通信協議采用國家相關標準、部門專業標

準以及國際通用的工業標準，服從國家管理信息系統的規劃和有關規定。

項目開發過程中所遵循的標準規范主要有：

?勞動和社會保險管理信息系統信息結構通則(LB001—2000)

?社會保險管理信息系統指標體系一業務部分(LB101-2000)

?《金保工程勞動力市場信息系統建設指導意見》

?ISO9000397質量管理和質量保證標準

?EJB2.0規范

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

?GB/T17900—1999網絡代理服務器的安全技術要求

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

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

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

?GB/T12504—1990計算機軟件質量保證計劃規范

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

?GB1526-1989信息處理-數據流圖、程序流程圖、系統流程圖、程序

網絡圖和系統資源圖的文件編制符號及約定

?GB/T8567—1988計算機軟件產品開發文件編制指南

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

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

?GB/T10114—1988縣以下行政區代碼編制規則

?GB/T4754—1994國民經濟行業分類與代碼

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

2.2接口技術架構設計方案

“DW定點醫院接口服務系統”是嚴格遵守“核心平臺三版”的技術框架，

采用基于Dweaf平臺的多層體系結構模式，以集中式數據資源共享為基礎，采用

先進的0/RMapping映射機制實現了優良的面向對象開發方案，確保了系統具有

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

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

務規范要求，并針對不同地區的業務研究分析后對業務指標體系進行了合理化擴

展，實現了從軟件配置上解決業務需求問題，做到快速開發、高度復用的要求。

2.2.1原定點結算系統技術框架

在實現接口服務前，地緯定點結算系統與醫保核心端應用架構如下:

2.2.2接口服務技術框架

實現接口服務后，醫院端與醫保核心端應用架構如下:

從以上實現接口服務前后的技術框架可以看出，“DW定點醫院接口服務”

替代了原地緯結算系統中的應用服務層。HIS開發商在其HIS系統中只需要將DW

表示層中的相應界面展示完成后，即可實現與醫保結算系統的無縫連接。

第三章接口使用說明

一、接口概述

本接口系統一共包含三個文件，分別為、、。所有服務均集成在動態鏈接庫中，

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

在同一個目錄中。HIS系統只需要調用ProgramID為sei3的組件中的服務就可

以了。

HIS系統完成接口調用開發以后，住院、門診、門診大病等主業務結算流程

均完全嵌入醫院HIS系統，數據傳輸等后臺業務仍需要依靠地緯定點結算系統

來完成。

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

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

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

二、接口環境

在運行結算系統的業務機上需要具備接口環境，具體操作如下：

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

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

3、注冊方法：

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

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

三、接口實例創建、接口示例回收

在登陸HIS系統時需要進行接口實例的創建，創建成功以后，才能正常調用

接口服務。建議在HIS系統登陸的同時，調用接口登陸的服務，同時在退出HIS

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

1、接口實例的創建，創建。加對象

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

自己調用COM組件的方式。HIS開發人員可以根據自己所使用的開發語言來調用

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

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

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

〃創建地緯嵌入式接口對象，調用com組件

intvi

Oleobjectsei

sei=createOleobject〃倉ij建ole對象seiproxy

vi=cttonewobjectCsei35)〃連接com組件

ifvi<>0then

messagebox錯誤'，’創建地緯嵌入式接口sei對象失敗！')

return

endif

2、接口實例的回收：

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

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

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

nnectObject()//DisconnectObject方法為PB語言的系統函數

Destroysei

四、接口方法說明

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

任何一個服務。

表4T接口提供的方法

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

resetvarlong清空上傳參數緩存區

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

傳入參數

putvardeclong向某個服務傳入數字類型的變量

putvardatetimelong向某個服務傳入時間類型的變量

request_servicelong調用接口中的某個服務

執行服務

get_errtextstring獲取服務執行過程中產生的錯誤

getvarstringstring接受服務執行成功后返回的字符串變量

接收返回值getvardecdecimal接受服務執行成功后返回的數字變量

getvardatetimedatetime接受服務執行成功后返回的時間變量

1、傳入參數的方法

⑴方法名稱：resetvar()returnlong

方法作用：清空上傳參數緩存區

參數說明：無

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

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

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

參數說明：name傳入參數的名稱

value傳入參數的值，字符串類型

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

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

方法作用：向某個服務傳入數字類型的變量

參數說明：name傳入參數的名稱

value傳入參數的值，數字類型

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

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

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

參數說明：name傳入參數的名稱

value傳入參數的值，datetime類型

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

2、執行服務的方法

⑴方法名稱：request_service(stringserviceName)returnlong

方法作用：執行接口中的指定的服務

參數說明：serviceName需要執行的服務的名稱

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

⑵方法名稱：get_errtext()returnstring

方法作用：當request_service的返回值不為零的時候，調用該方法，用來獲取服務執行

過程中的錯誤信息

參數說明：無

返回值說明：執行服務中產生的錯誤信息

2、接受返回值的方法

⑴方法名稱：getvarstring(stringname)returnstring

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

參數說明：name要接受的變量的名稱

返回值說明：傳入的參數名稱對應的參數值

⑵方法名稱：getvardec(stringname)returndecimal

方法作用：接受服務執行成功后返回的數字類型變量

參數說明：name要接受的變量的名稱

返回值說明：傳入的參數名稱對應的參數值

⑶方法名稱：getvardatetime(stringname)returndatetime

方法作用：接受服務執行成功后返回的時間類型變量

參數說明：name要接受的變量的名稱

返回值說明：傳入的參數名稱對應的參數值

五、接口服務概述

通過調用本接口提供的相關服務，可以實現系統的登錄初始化，獲取參保人

信息，進行住院相關業務，門診的相關業務，個賬消費的相關業務。下圖為本接

口提供的部分服務的流程概括圖。

接口登陸初始化

init

init_gzinitmzsavezyq/*住院登記*/

循

循

init_zy產住院初始化*/

環

環

調

調

用

用產打印住院告知單（可選）*/

保

保put_fymcput_fymcpnnt^gzd

存

存

循

憑

憑

環

單

單

調

用

/*個賬結算*/產門診結算可

put_fymc

settle^gzsettle_mz

/*打印發票*//*打印發票*/

pnnt_djprint__dj/*保存費用憑單*/

save_zy_scnpt

/*上傳憑單至醫保*/

trans_zy_scnpt

/*出院結算*/

settle__zy

可丁印發票*/

print_dj

業務撤銷流程

/*撤銷住外流程*/

init_zy

/*撤銷出院*/一

destroy_cy

/*撤銷住院結算3

destroy_zyjs

/嘴銷住院費用*/

destroy_all_fypd

/嘴銷住院登記才

destroy_zydj

1、每次調用住院相關的服務之前(除了住院登記save_zydj)都必須首先調用住

院初始化服務(init_zy)。

2、每次調用門診結算相關的服務之前都必須首先調用門診初始化初始化服務

(init_mz)。

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

(init_gz)o

4、每次調用撤銷住院相關的服務之前都必須首先調用住院初始化服務

(init_zy)。

第四章、業務服務應用說明

一、基礎業務相關服務

1、接口登陸服務：

服務名稱：init

服務作用：用于登陸地緯定點醫療機構結算系統。

服務返回值：

返回值說明

0代表成功登錄地緯定點醫療機構結算系統。

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

動升級

其他代表登陸地緯定點醫療機構結算系統失敗（失敗原因可以通過方法

get_errtext（）獲取）

傳入參數:

參數名稱類型中文名稱說明

yybmstring醫院編碼登錄地緯系統的醫院的編碼

gzrybhstring工作人員編號醫院的工作人員的編號（4位）

pwdstring工作人員密碼用于登錄地緯系統的密碼

其中標注*的為必傳參數禁止為空

服務說明：

如果在調用init服務之前沒有傳入參數yybm（醫院編碼），gzrybh

（工作人員），pwd（密碼），本接口程序會彈出結算系統的登陸界面，

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

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

在調用其他服務之前必須先調用一下該服務，用于登陸地緯醫保結算

系統數據庫，如果登陸失敗，所有業務均無法正常運行。

PB示例代碼:

〃登陸地緯醫療機構結算系統

var()

「string("yybnT,“370101")

rstring(^gzrybh^,〃0001〃)

rstring(〃pwd〃,〃1234〃)

vi=st_service(〃init〃)

ifvi=-800then

〃表示接口需要升級，此時應該關閉HIS程序，重新啟動HIS程序后接口會自動升級

haltclose

endif

ifvi<>0then

errtext=_errtext（）

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

return

endif

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

2、查詢有卡人員基本信息服務

服務名稱：read_card

服務作用：讀取卡片信息，取得人員相關信息。

服務返回值：

返回值說明

0代表成功

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

傳入參數:

參數名稱類型中文名稱說明

yltclbstring*醫療統籌類別0為取卡片基本信息，1為住院，4為門診大

病（特病），6為普通門診

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

（可選參數）

readertypestring讀卡器類型（可選參數）

ewmstring二維碼（可選參數），如果做電子醫保憑證結算傳入

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

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

其中標注*的為必傳參數禁止為空

返回結果集：

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

sbjgbh*社保機構編號string20獲取持卡人所在的社保機構編號

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

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

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

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

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

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

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

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

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

ylrylb醫療人員類別string20獲取持卡人的醫療人員類別（內容為

漢字）

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

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

zhzybz住院記錄string3有無15（醫保參數制）天內的住院記錄1

為有,0為無

zhzysm住院記錄說明string無15（醫保參數控制）天內的住院記錄說

明

zcyymc轉出醫院名稱string無本結果如果不為空字符串即''

和'*',則表示本次住院是從市內轉

院來的

zccyrq轉院出院日期string無獲取轉出醫院的出院日期

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

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

yyyymmdd）

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

注量。如果沒有普通門診統籌，該變量

返回空

sfxsptmz是否享受普通門string無說明該參保人是否享受普通門診統

tc診統籌籌。只有普通門診統籌的地方才能用

至IJ。沒有普通門診統籌該變量返回空

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

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

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

量為空。

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

Cbjgmc參保機構名稱String無省異地結算標示異地人員信息

ffdbm發放點編碼String卡片發放點編碼

yhkkh銀行卡卡號String銀行卡號

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

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

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

ewm二維碼string電子社保卡或電子醫保憑證的二維碼

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

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

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

dzsbkpt電子社保卡平臺string區分電子社保卡和電子醫保憑證（門診

初始化的時候使用）

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

服務說明:

如果讀卡僅僅是為了獲取個人基本信息，如姓名、性別、醫保卡號等,

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

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

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

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

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

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

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

選擇一種疾病病種)

PB示例代碼：

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

var()

rstring(，yltclb，,’1')

ifst_service(*read_card，)<>0then

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

return

endif

〃獲取服務執行成功后的返回值

vsbjgbh=rstringC*sbjgbh，)

vrqlb=「string('rqlb')

vkh=「string('kh')

vgrbh=「string('grbh')

vxm=rstringC*xm，)

vzfbz=rstring(，zfbz，)

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

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

3、查詢無卡人員基本信息服務

服務名稱：query_person_info

服務作用：

查詢參保人員就醫的基本信息，根據傳入的yltclb來取參保人員在

社保中心的相關信息。

服務返回值:

返回值說明

0代表成功

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

傳入參數:

參數名稱類型中文名稱說明

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

xmstring*姓名傳入的姓名必須和醫保數據庫中一致

yltclbstring*醫療統籌類別傳入1或4或6。1：住院，4：門診大病,6：

普通門診。系統會根據此參數從社保中心取

不同的信息

sbjgbhstring*社保機構編號參保人所屬的社保機構編號

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

其中標注*的為必傳參數禁止為空

返回結果集：

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

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

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

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

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

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

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

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

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

ylrylb醫療人員類別string無獲取持卡人的醫療人員類別（內容為漢

字）

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

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

zhzybz住院記錄string3有無15（醫保參數制）天內的住院記錄1

為有，0為無

zhzysm住院記錄說明string無15（醫保參數控制）天內的住院記錄說明

zcyymc轉出醫院名稱string100本結果如果不為空字符串即和'*’,

則表示本次住院是從市內轉院來的

zccyrq轉院出院日期string無獲取轉出醫院的出院日期

yfdxbz優撫對象標志stirng31代表是優撫對象，0代表不是優撫對象

yfdxlb優撫對象類別string3優撫對象類別

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