地纬定点医疗机构医保结算系统核心平台三版接口服务方案08版本

地纬定点医疗机构医保结算系统

核心平台三版接口服务方案

（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：