江苏省新型农村合作医疗县级统一软件接口规范Word文档格式.docx

江苏省新型农村合作医疗县级统一软件接口规范Word文档格式.docx

《江苏省新型农村合作医疗县级统一软件接口规范Word文档格式.docx》由会员分享，可在线阅读，更多相关《江苏省新型农村合作医疗县级统一软件接口规范Word文档格式.docx（66页珍藏版）》请在冰豆网上搜索。

●修改8号交易，修改入参定义，入参补偿流水号改为登记流水号，参数名为djid。

●修改9号交易，修改入参定义，入参补偿流水号改为登记流水号，参数名为djid，，参数<

expenditure>

中添加了属性处方流水号lsh。

●修改10号交易，修改入参定义，入参补偿流水号改为登记流水号；

添加就诊类型，参数名为jzlx,实际住院天数sjzyts；

返回结果定义中添加补偿单流水号，节点名为bxid。

引言4

一前言4

二规范使用对象4

三参考资料4

四第三方软件实现接口的前提4

五嵌入式接口软件简要说明4

六版权声明5

第一部分嵌入式接口软件流程5

一数据流程5

二业务流程6

第二部分DLL调用说明8

一功能说明8

二服务功能列表8

三XML实体或XML数据样本定义25

四调用服务方法及使用32

第三部分参考资料33

一新农合药品目录33

二新农合诊疗目录33

三ICD10疾病编码字典33

四接口改造说明33

第四部分配置手册34

一医院前置机配置：

34

二HIS客户机配置34

引言

一前言

《江苏省新型农村合作医疗县级统一软件接口规范》是杭州创业软件股份有限公司根据江苏省新型农村合作医疗省级信息平台和县级统一软件项目规定的要求编写而成，用于辅助第三方医院管理信息系统开发商修改现有软件，顺利实现与江苏省新型农村合作医疗县级统一软件（以下简称“新农合”）进行联网运行，此方案交新型农村合作医疗管理办公室确认后实施。

二规范使用对象

●新型农村合作医疗管理办公室及其他相关科室

●医疗机构

●第三方软件开发商及其技术人员

●与接口开发实施工作相关的技术人员

三参考资料

●医院用新农合门诊、住院发票格式

●医院与新农合对帐用报表格式

●新农合药品及诊疗目录

四第三方软件实现接口的前提

●第三方软件必须提供真实有效的数据信息

●拥有足够的技术实力正常调用服务功能

五嵌入式接口软件简要说明

1.运行环境

●工作站操作系统：

WIN2000及以上版本

●前置机操作系统：

2.功能及构成简要说明

接口软件分为两部分：

接口DLL程序、新农合医院服务程序。

●接口DLL程序：

接口DLL程序，主要是为第三方软件提供通讯服务，调用该DLL函数后将返回状态值。

●新农合服务程序

新农合医院服务程序主要用于各种交易的转发，并处理医院前置机的数据，实现上传下载数据功能，确保与合管办中心数据库进行数据交换。

六版权声明

《江苏省新型农村合作医疗县级统一软件接口规范》及提供的服务程序（包括所有动态链接库）仅限于第三方软件开发商内部参考使用，任何情况下都不能以任何方式公开、告知其他任何个人或组织。

第一部分嵌入式接口软件流程

七数据流程

1、流程图

2、数据流程说明

1）发起交易信息：

医院管理信息系统根据自身的业务并按照一定的数据包格式调用DLL动态库，DLL动态库根据参数设置并向设定的前置机的端口发送数据包。

2）医院前置机监视：

医院前置机的服务程序开启后会自动监测设定的端口，一旦收到消息，服务程序将收到的数据包进行解包并根据不同的定义响应不同的处理事件，服务程序通过与新农合数据中心进行数据交换获得处理结果，并返回结果给发起交易信息的用户。

八业务流程

1、医院业务流程图

2、业务流程说明

医院管理信息系统读卡后，将得到的合作医疗卡号及相关交易所需信息按照本规范规定的格式打包，通过调用DLL动态库将打包的数据发送到医院前置机，医院前置机收到数据包后会根据收到的数据包的意义进行相应的业务处理并返回结果给医院管理信息系统，医院管理信息系统再根据返回的结果进行相关的医院业务操作。

第二部分DLL调用说明

一功能说明

新农合接口DLL名称为HCN.dll，通过调用DLL，可以向服务端发送新农合规定的交易，并可根据返回的结果进行相应的业务处理。

二服务功能列表

序

功能说明

服务编号

1

获取合作医疗基本药品目录

GetYpml

2

获取合作医疗诊疗项目目录

GetZlml

3

获取合作医疗诊疗系统使用的ICD10疾病编码库

GetJbcode

4

获取单病种结算使用的ICD10疾病编码库（保留）

GetJbcode_Drgs

5

验证个人帐户是否有效

CheckGrzh

6

住院登记信息

Zydj

7

住院取消登记

CancleZydj

8

门诊登记信息

Mzdj

9

费用登记

Fydj

10

费用预结算

FybxYjs

11

费用结算

FybxJs

12

退费处理

ReSaveFybx

13

出院登记

Cydj

14

补偿费用单病种预结算（保留）

FybxYjs_Drgs

15

补偿费用单病种结算（保留）

FybxJs_Drgs

16

补偿费用单病种退费处理（保留）

ReSaveFybx_Drgs

17

每日明细对账

MrdzMx

18

滚动筹资登记

Gdczdj

19

上传对照后的药品，诊疗目录

UploadDzml

20

获取对照后的药品，诊疗目录

GetDzmlByItem

21

获取体检人员名单（可选）

GetTjryinfo

22

上传体检人员体检结果（可选）

UploadTjjg

提示：

Ø

XML结构字符串中的各节点的data属性指的是实际的数值，文档中使用"

"

来表示

XML结构字符串中的---指的是：

省略号（---）上面的节点可能有多个兄弟节点。

时间类型的格式:

1998-01-01，时间类型必须使用该格式。

1.获取合作医疗基本药品目录

功能号：

功能描述：

获取合作医疗基本药品目录.

上传药品费用信息时，药品编号必须使用本目录内的药品编号。

调用说明：

序号

入参

入参说明

长度

可空

类型

operator

当前操作员ID

N

字符

yybh

医院编号

row

下载目录的行数

row=0将下载所有药品目录

数值

返回结果定义：

出参

出参说明

code

状态码：

1,执行成功-1,执行失败

msg

返回消息

100

<

结果

XML字符串

出参<

的XML数据格式

XML数据（药品目录）

row>

<

YPXHdata="

/>

YPMCdata="

YPLXdata="

YPDWdata="

YPGGdata="

YPSXdata="

ZFBLdata="

MZZFBLdata="

PYDMdata="

/row>

…

/result>

行与行之间用<

分隔

节点

说明

YPXH

编号

YPMC

药品名称

YPLX

3西药4中成药（包含草药）

YPDW

单位

YPGG

药品规格

YPSX

剂型

ZFBL

住院自费比例

MZZFBL

门诊自费比例

PYDM

拼音代码

2.获取合作医疗诊疗项目目录

获取合作医疗诊疗项目。

上传诊疗费用信息时，费用编号必须使用本目录内的诊疗项目目录。

row=0将下载所有诊疗目录

Y

Code：

的XML数据格式：

XM数据（诊疗目录）

FYXHdata="

FYMCdata="

FYDWdata="

XETYPEdata="

XEdata="

FYDJdata="

FYXH

FYMC

费用名称

FYDW

XETYPE

限额类型

0不限1单价2总价

XE

限额

FYDJ

费用单价

3.获取合作医疗诊疗系统使用的ICD10疾病编码库

上传疾病编码时，疾病编码必须使用本目录内的疾病编码目录。

row1

查询行数：

开始行

row2

结束行

XML数据

XM数据（疾病编码库）

CODEdata="

ICD10data="

NAMEdata="

CODE

代码序号

ICD