admin 管理员组文章数量: 1086019
2024年4月18日发(作者:时空instrumental是什么歌曲)
附件3
全国医院数据上报管理方案
接口技术规范
(试行)
国家卫生健康委规划发展与信息化司
国家卫生健康委统计信息中心
前言
为满足国家卫生健康委对医院宏观管理、政策制定、资
源配置、绩效评价以及重点专科建设管理等方面的信息需求,
国家卫生健康委在前期工作的基础上,按照《全国医院信息
化建设标准与规范》要求,制定了《全国医院数据上报管理
方案-接口技术规范(试行)》。
本方案是在国家卫生健康委医院信息服务与监管系统
(1.0版)的基础上,汇总、整合国家卫生健康委相关司局
管理与决策需求,分析医院信息化建设进展以及数据条件,
充分考虑系统性、科学性和可行性的基础上制定的。
本系统的建设目标是通过与医院的互联互通,形成稳定
的数据报送、分析、反馈机制,有力支撑国家卫生健康委管
理与决策,服务医院的科学管理。同时,规范数据报送渠道
与口径,避免重复报送,实现“一次采集,多次应用”。
《全国医院数据上报管理方案-接口技术规范(试行)》
主要包括数据采集介绍、数据采集接入流程、服务规范说明
等4个部分内容。为保证数据报送的一致性和标准化,应用
国家、行业标准,供医院开展数据采集和上报。
本数据接口技术规范自发布之日起生效。此后,将按照
国家卫生健康委管理、决策的需求以及医院集成信息平台建
设的进展对方案进行适当调整和修订。
目 录
一、引言 ......................................................................................... 1
(一)
编写目的 .................................... 1
(二)
术语和定义 .................................. 1
(三)
交换报文结构说明 ............................ 3
1. 请求报文结构 .................................. 4
2. 响应报文结构 .................................. 9
二、数据采集介绍 ................................... 13
(一)
采集步骤介绍 ............................... 13
(二)
网络联调 ................................... 14
1. VPN联通 ...................................... 14
2. 前置机与网络端口 ............................. 15
(三)
数据标准要求 ............................... 15
(四)
接口程序要求 ............................... 16
三、数据采集接入流程 ............................... 16
(一)
接入前期准备 ............................... 16
(二)
开发数据上传接口程序 ....................... 17
(三)
联调阶段 ................................... 17
(四)
字段填写要求 ............................... 17
(五)
历史数据上传阶段 ........................... 18
(六)
增量数据上传阶段 ........................... 18
四、服务规范说明 ................................... 19
(一)
数据采集上传服务 ........................... 19
1. XML入参说明 .................................. 19
1.1 通用节点填写说明............................. 19
1
2. XML出参说明 .................................. 26
3. 管理字段填写说明 ............................. 28
(二)
数据采集结果接收服务 ....................... 30
1. XML入参说明 .................................. 31
2. XML出参说明 .................................. 36
(三)
数据对账接收服务 ........................... 38
1. XML入参说明 ..................................
2. XML出参说明 ..................................
2
38
48
一、引言
(一)编写目的
本文档用于描述国家卫生健康委为建立数据中心,完成
数据采集汇聚工作,对各业务系统,即数据上传方,开发数
据上传接口的工作规范约束。重点围绕相关各方职责及数据
上传厂商的开发工作进行约束说明。
(二)术语和定义
以下对本文所提及相关术语及定义进行阐述说明:
平台
代指国家卫生健康委医院信息服务与监管系统中的数
据采集平台,它分为医院端和国家卫生健康委中心端,文档
中所说“上传至平台”是指上传至国家卫生健康委中心数据
库。
数据中心
指的是国家卫生健康委医院信息服务与监管系统的中
心数据库,位于国家卫生健康委中心数据机房内。
数据采集上传服务
平台提供的用于接收XML数据的webService服务。医
院通过将数据生成要求格式的XML文件后,调用XML数据采
集服务将数据传输至国家卫生健康委中心数据库。
数据采集结果接收服务
数据上传方提供的用于接收平台处理数据结果的
webService服务。
前置机、前置库
前置机:安装在医院内部的用于数据上传的一台物理服
务器的简称,用于解决网络问题。在前置机上安装了相关的
1
软件,向平台数据中心上传数据。
前置库:前置mysql数据库,用于缓冲上传的数据。
交换标准
服务交互的统一的交换报文结构,即用于规定数据上传
时所遵循的统一的XML格式及内容。 由平台统一标准管理
系统统一发布。
数据字典
在数据转换过程中需要医院进行对照的数据编码,有时
也被称作值域字典,它包括名称和代码两个部分,本规范中
所使用的数据字典主要由3个部分组成,分别是国家标准
(WS/GB等)、行业标准、自定义扩展标准。例如患者性别,
使用《个人基本信息分类与代码 第1部分:人的性别代码》,
字典名称分别为:未知的性别、男性、女性、未说明的性别,
字典值分别为:0、1、2、9;是否代码为自定义扩展标准 1
是 2 否;国家标准和行业标准在一般情况下不做修改,自
定义扩展标准可以根据情况进行增补修改。
校验报告
平台对于医院所上传的数据进行审核验证后所出具的
是否符合规范标准的说明报告。主要校验内容为值域、格式、
必填等,所有校验的结果将生成一个可直观展现的HTML,作
为校验报告返回给医院。
数据对账
医院除上传数据采集XML数据外,需要记录每次上传数
据的相关信息,通过调用数据对账接收服务用于与平台进行
账目核对,以追踪确认双方数据的差异性。
数据对账包括业务量对账、数据量对账。
2
数据标准类术语
以下对数据采集平台数据标准中自定义字段进行列举
说明:
LOCAL_ID 患者唯一标识:在业务系统中唯一标识一个
患者的ID,与PID保持一致。
BUSINESS_ID 业务流水号:业务系统中针对不同业务具
体的流水号字段,其值能在业务系统中唯一标识一次业务数
据。
BUSINESS_TYPE 业务活动类型:用来标识患者的一次业
务活动类型。
DOMAIN_CODE 系统节点编码:由平台统一分配的系统接
入节点编码。
BASIC_ACTIVE_ID 基本活动流水号:针对同一次业务中,
包含有主从关系的,使用此字段与主表进行明细数据关联。
DATAGENERATE_DATE 业务发生日期:本次业务实际发生
日期,用于标识实际发生业务的时间,如挂号日期
以上字段存在于医疗服务相关数据接口表中,用于数据
的识别、关联,是必填字段。
(三)交换报文结构说明
平台接口服务统一的交换报文格式,其基本如下:
3
交换报文格式为典型的XML格式,它使用messages节
点作为根节点,在根节点下包含heartbeat节点,switchset
节点,business节点和extendset节点:
heartbeat节点检测服务认证信息;
switchset节点用于承载与服务相关的安全、配置和路
由信息等;
business节点承载与服务相关的标准信息和业务数据
等;
extendset节点用于特定需求及未来扩展;
根据服务请求和响应动作的不同,交换报文结构又分为
请求类交换报文结构和响应类交换报文结构,分别对应服务
的入参封装格式和出参封装格式即请求报文结构和响应报
文结构,具体如下:
1.请求报文结构
入参节点说明
必
字段名称 填写方
填
用于检测服务活性,整型,可选值为0(非服
heartbeat节点 务活性检测),1(服务活性检测),默认值为
0
switchset节点下的authority节点 用于消息交换的定义
用于定义消息交换的安全配置类型,整
服务调用
authoritytype
方
是
用用户名/密码),2(使用授权码),
3(使用数字证书),9(其他安全配置),
4
字段描述
型,可取值为0(无安全配置),1(使
必
字段名称 填写方
填
默认值为0
服务调用
username
方
服务调用
userpwd
方
服务调用
license
方
switchset节点下的visitor节点
服务调用
sourceorgan
方
服务调用
sourcedomain
方
是
统编码,字符串
是
符串
用于存储服务消费方所使用的接入系
否
符串
用于存储服务消费方信息
用于存储服务消费方所在机构编码,字
否
对应的密码,字符串
用于存储服务提供方要求的授权码,字
否
符串
用于存储服务提供方要求的与用户名
用于存储服务提供方要求的用户名,字
字段描述
switchset节点下的serviceinf节点 用于存储请求的服务信息
用于存储请求的服务在服务注册中心
的唯一服务编码。servicecode在以下
三种情况下取值不同,具体如下:
1. 第一种情况:服务提供方在开发服
务时,取值为“服务编码”,即
服务调用
servicecode
方
2. 第二种情况:服务调用方在使用服
务时,通过卫生服务总线进行服务调
用,取值为“场景编码:服务标识”,
格式为scenecode:serviceename;
3. 第三种情况:服务调用方在使用服
5
否 servicecode;
必
字段名称 填写方
填
务时,直接调用服务(即不通过卫生服
务总线进行服务调用),取值为“服务
编码”,即servicecode。
以上描述中的“场景编码”、“服务标
识”、“服务编码”由卫生服务总线管
理员分配。
switchset节点下的provider节点
服务调用
targetorgan
方
服务调用
targetdomain
方
switchset节点下
用于记录服务路由信息,字符串,其格
式为:(1)按服务编码路由:
服务调用
route
方
否
(2)按机构编码路由:scenecode。其
中,scenecode,serviceename由卫生
服务总线管理员分配。
服务调用
process
方
business节点下
服务调用
standardcode
方
即具体上传的业务数据所确定的交换
6
字段描述
用于存储服务提供方的信息
用于存储服务提供方所在的机构编码,
否
字符串
用于存储服务提供方所在的接入系统
是
编码,字符串
scenecode:serviceename [/route]
用于记录服务流程编排相关信息,字符
否
串
用于装载服务提供者需要的入参数据
用于设置服务提供者入参数据所依赖
是 的交换标准在标准管理系统中的编码,
必
字段名称 填写方
填
标准编码,参见交换标准列表
用于定义数据请求时数据查询条件和返回数
business节点下的requestset节点
据的分页设置参数
服务调用
reqcondition/condition
方
服务调用
reqpaging
方
默认值为0
用于定义返回分页数据时返回的页索
服务调用
reqpageindex
方
-1
用于定义返回分页数据时页的数据行
服务调用
reqpageset
方
0
business节点下
用于定义服务提供方要求的入参业务
服务调用
datacompress
方
(压缩),默认值为0
服务调用
daqtaskid
方
business节点下的businessdata节
用于装载服务提供方所要求的入参业务数据
点
extendset 暂不填写 否 用于标准扩展或特殊业务需求
是 用于设置采集任务的标识号
是 数据是否进行压缩,0(不压缩),1
是 数,整型,必须大于等于0,默认值为
是 引,整型,必须大于等于-1,默认值为
是 理,整型,0(不分页),1(分页),
否
条数据查询条件
用于定义返回数据时是否进行分页处
用于记录用于数据查询的条件/用于单
字段描述
入参节点数据封装格式样例如下
7
8
2.响应报文结构
出参节点说明
字段名称 填写方 必填 字段描述
switchset节点下的visitor节点
sourceorgan
sourcedomain
服务提供方
服务提供方
是
是
码,字符串
switchset节点下的serviceinf节点
用于存储请求的服务在服务注册中心的唯
servicecode 服务提供方 否
一服务编码,字符串
switchset节点下的provider节点
用于存储服务提供方所在的机构编码,字符
targetorgan 服务提供方 否
串
9
用于存储服务消费方所在机构编码,字符串
用于存储服务消费方所使用的接入系统编
字段名称
targetdomain
填写方
服务提供方
必填
否
字符串
字段描述
用于存储服务提供方所在的接入系统编码,
switchset节点下
route
process
服务提供方
服务提供方
否
否
用于记录服务路由信息,字符串
用于记录服务流程编排相关信息,字符串
switchset节点下的
用于装载交换消息定义
switchmessage节点
messagecode
messagetext
business节点下
用于设置服务提供者入参数据所依赖的交
standardcode 服务提供方 是
换标准在标准管理系统中的编码,字符串
business节点下的
用于装载服务提供方返回的业务相关消息
returnmessage节点
用于装载服务提供方返回的业务相关消息
retcode 服务提供方 是
的编码,字符串
用于装载服务提供方返回的业务相关消息
rettext 服务提供方 是
文本,字符串
business节点下的returnset
用于装载服务提供方返回的业务数据描述信息
节点
用于装载服务提供方返回的业务数据总量
rettotal 服务提供方 否
信息,整型,必须大于等于0
用于装载服务提供方返回的业务数据是否
retpaging 服务提供方 是
分页,整型,可选值0(不分页),1(分
10
总线方
总线方
否
否
用于装载交换消息的编码,-1:失败;
用于装载交换消息的文本,字符串
字段名称 填写方 必填 字段描述
页),默认值为0
用于装载服务提供方返回的业务数据的页
retpageindex 服务提供方 否
索引,整型,应大于或等于-1,默认值为-1
用于装载服务提供方返回的业务数据的页
retpageset 服务提供方 否 容纳的数据行数,整型,应大于或等于0,
默认值为0
business节点下
用于定义服务提供方要求的入参业务数据
datacompress 服务提供方 是 是否进行压缩,0(不压缩),1(压缩),
默认值为0
business节点下的
用于装载服务提供方返回的业务数据
businessdata节点
extendset 暂不填写 N 用于标准扩展或特殊业务需求
出参节点数据封装格式样例如下
11
12
提示:由于服务请求报文结构与服务响应报文结构在
switchset节点的信息内容是一致的,因此服务开发可以通
过获取解析请求报文结构来给响应报文结构中相关的节点
赋值。
二、数据采集介绍
本章节主要整体介绍数据采集上传、处理等相关步骤,
并重点说明数据上传方需遵循的要求。
(一)采集步骤介绍
XML数据采集方式的数据采集,数据上传方需要了解平
台数据交换标准,并按照数据交换标准将业务生产库中的业
务数据进行清洗转换后,调用XML采集服务,将数据生成的
XML上传给区域卫生信息平台。平台接收XML并解析写入到
前置库,基于前置库的数据进行验证,验证后将正确的数据
采集走,错误的数据留给上传方,并将校验报告通过回调采
集结果接收服务反馈给数据上传方。
数据上传方需要记录每次上传数据的相关信息,并定时
上传给平台用于双方数据对账,明确数据在合环节造成差异
性。
13
数据上传方
调用XML上传服务
组装XML数据
数据清洗转换
业务库
数据上传平台
前置库
数据校验
解析XML并写入平台前置库
数据搬运
业务库
接收处理结果并处理数据调用对方结果接收服务
采集流程处理步骤:
医院调用平台提供的【XML数据采集上传服务】上传XML
数据;
平台接收到XML数据,解析主要信息后同步返回消息通
知接收成功;
平台对XML数据进行校验、去重、搬运、生成索引等若
干步骤处理后调用医院提供的【数据采集结果接收服务】回
传数据采集结果。
(二)网络联调
联通
(1) 建议医院使用硬件VPN,采用IPsec方式进行VPN
联调。
(2) 使用软VPN的医院请确保前置机操作系统为
WIN2012。
14
2.前置机与网络端口
(1) 院内前置机由医院准备委端使用,操作系统推荐
为WIN2012、CPU:2-4颗;
(2) 内存:32G以上、硬盘:500G以上空间;
(3) 保证院内服务器与院内前置机的TCP:8889和
TCP:3306端口的双向联通;
(4) 保证前置机与委端数据中心的TCP(8884-8889、
8100-8105、8300、3306、3389)的双向联通。
(三)数据标准要求
医院开发的接口对实际业务数据清洗转换时,需满足如
下规范要求:
(1) 数据格式必须遵循交换标准;
(2) LOCAL_ID为业务系统内对患者的唯一标识,即
同一个人进行多次业务活动对应的LOCAL_ID应该相同;
(3) 交换标准中值域字段,必须按照标准要求进行值
域转换,且有值域名称匹配的必须值域代码与值域名称字段
匹配;值域为多选的情况需要以^^^分隔;
(4) 数据转换清洗必须满足各业务的交换标准接口
文档对数据内容的详细规则要求;
(5) 必填的字段必须按照标准要求填写,非必填字段,
也需按照业务数据情况完成填写,不可全部不填;
(6) 所有中文内容请统一采用UTF-8编码格式,否则
会解析乱码;
(7) 生成的XML文件请使用无BOM的UTF-8的文件格
式上传;
(8) 医疗服务价格取2007或2012版其一进行对照,
15
不可两个版本穿插使用;
(9) 病案号:病案号字段要求按照住院号+住院次数
规则上传,如不是此规则的按照原病案号+住院次数上传;
(10) 病案首页诊断记录至少上传两条记录,一条为主
要诊断,一条为病理诊断。
(四)接口程序要求
对于数据上传方的接口有如下几点重点要求:
(1) 数据上传接口能够指定上传指定业务的数据,例
如单次只上传门诊诊疗信息中某一张或几张表的数据;
(2) 数据上传接口能够指定上传指定时间段的数据,
例如单次只上传2017.5.1-2017.5.31日期间的门诊诊疗信
息的全部数据;
(3) 数据上传接口能够完成手动及自动定时上传;
(4) 数据上传接口能够满足3小时内完成增量数据
上传的效率;
(5) 开发结果接收服务,能够解析结果,获取数据处
理情况及总体数据校验报告;
(6) 记录每次数据上传结果,能够定时上传每日对账
信息;
(7) 数据上传采用单/少批次大数据量方式进行上传,
建议每批次可控制在1万条数据量;
三、数据采集接入流程
(一)接入前期准备
(1) 由项目组与项目承建方统一制定采集交换标准、
数据校验规则;
(2) 由项目承建方统一向接入医疗机构下发交换标
16
准接口文档、 数据采集接口文档;
(3) 明确医疗机构数据采集所对应的前置设备环境
并部署前置端采集组件;
(4) 统一为接入医疗机构注册接入系统编码、采集资
源信息;
(二)开发数据上传接口程序
(1) 需满足章节2.3数据标准要求;
(2) 需满足章节2.4接口程序要求;
(3) 利用联调工具进行接口程序自测,并根据反馈结
果进行修改,直至校验报告无问题或与项目承建方确认某些
校验规则可暂不满足;
(三)联调阶段
(1) 通过数据采集上传服务进行实际交换标准数据
采集,验证数据准确性;
医院按照数据标准转换清洗业务数据,并通过自检工具,
检查抽取的数据格式等是否符合平台标准要求
(2) 连续上传一段时间数据验证数据准确性,至少上
传1个月的数据量;
(3) 通过数据质量控制系统、数据对账功能验证数据
上传质量;
(4) 由数据利用方确认数据是有缺失项,是否可利用;
(四)字段填写要求
(1) 完整性:
要求保证上传数据的完整性,各标识必填的管理字段和
业务字段必须按照规则填写完整;
(2) 规范性:
17
即填写内容在字段允许范围内。包括:生成规则,日期、
整型、字符型、浮点型、数值等数据型的格式要求,值域代
码是否在取值范围内等。
(a) 字段类型和格式要求
业务系统上传字段需要符合数据采集平台规定的字段
类型和格式要求。
例如,数据采集平台规定的日期字段格式包括两种:8位
日期(YYYYMMDD)、14位日期时间(YYYYMMDDHH24MISS)。邮件、
手机号码、邮政编码等也要符合各自的格式要求。
(b) 有关值域的对照转换
业务系统内各表字段使用值域时,如果数据采集平台对
应的字段也使用值域,业务系统需要按照数据采集平台提供
的值域代码上传数据;如果数据采集平台对应字段没有使用
值域,业务系统只需要将值域代码对应的文字描述传给数据
采集平台对应的字段。如果业务系统内某个字段没有使用值
域,而数据采集平台对应字段使用值域,业务系统可将字段
的值传给数据采集平台相应的文字描述字段。
(五)历史数据上传阶段
(1) 上传接口验证无问题后,根据项目承建方要求上
传历史阶段数据;
(2) 由于历史数据量大,建议采用分批次控制上传;
不要一次性上传大数据量;
(3) 建议每批次数据量可控制在10万左右,并尽量
避免不同类型的业务同时操作;减轻服务器瞬间并发压力;
(六)增量数据上传阶段
(1) 每日定时上传前一天业务数据(T+2);
18
(2) 根据项目实际情况规划每日开发商上传时间段;
(3) 监控开发商每日上传情况,持续跟踪错误数据,
逐步提高数据质量
(4) 数据上传时间及频率:医疗数据上报频率为以日
为单位,运营数据上报频率为以月单位,每日固定时间上传
前一天(T+2)的医疗数据,每月15日上报上月的运营数据
四、服务规范说明
(一)数据采集上传服务
服务类型 Webservice 服务标识
服务调用方
医院业务平台 服务提供方 平台
功能描述
基本
医院服务平台调用此接口,上传本方按发布标准汇总的采集数据
127.0.0.1:8130/si/webservice/carryXmlToDbService?wsdl
服务
WSDL
HSB
请以项目实际发布地址为准
发布
命名空间
方法名称
/
handle
入参类型
出参类型
String
String
入参 XMLData
参数
出参 XMLData
入参说明
1.1通用节点填写说明
入参switchset、business节点说明
字段名称 填写方 必填 填写说明
switchset节点下的visitor节点
sourceorgan 服务调用方 是 服务请求方的22位机构编码(如果上传
19
字段名称 填写方 必填 填写说明
业务系统包含多个医疗机构,任取其一;
如社区系统,取其中一家社区机构编码填
写)。由平台统一分配。
服务请求方的10位接入系统编码。由平
sourcedomain 服务调用方 是
台统一分配。
switchset节点下的serviceinf节点
servicecode 服务调用方 否 hsb发布服务标识:
switchset节点下的provider节点
targetorgan
targetdomain
business节点下
上传业务数据对应的交换标准编码,参见
standardcode 服务调用方 是
【交换标准列表】章节
business节点下的requestset节点
reqpaging
reqpageindex
reqpageset
business节点下
datacompress
daqtaskid
服务调用方
服务调用方
是
是
压缩标识:填写固定值:1(压缩)
任务编号:17位当前时间
服务调用方
服务调用方
服务调用方
是
是
是
填写默认值:0
填写默认值:-1
填写默认值:0
服务调用方
服务调用方
否
是
准)
填写默认值:22位项目机构编码
填写默认值:NRHPT00002(以实际项目为
businesss节点下的businessdata节点
businessdata节点装载具体需要上传的业务数据,要求内容为压缩格式,采用gzip
压缩后转为base64码
20
1.2 businessdata节点填写说明
入参businessdata节点说明(压缩前格式)
字段名称
businessdata
dmp
datasets
服务调用方
服务调用方
是
是
点
数据集编码,即一张表所对应的数据集编
setcode 服务调用方 是
码,参见交换标准列表
数据类型,非必须填写,1代表结构化数
settype 服务调用方 否
据,2代表非结构化数据,默认值为1
数据承载节点,一条数据一个setdetails
setdetails 服务调用方 是 节点,节点下数据项具体内容参见每个业
务的交换标准说明文档。
装载压缩数据的总节点
装载一个数据集,装载单张表数据的总节
填写方 必填 填写说明
入参businessdata节点数据封装格式样例如下
21
同时也能够体现出主从关系
【YYYYMMDDHH24MISS】
...省略其余业务字段...
22
同时也能够体现出主从关系
【YYYYMMDDHH24MISS】
...省略其余业务字段...
23
1.3重点说明
(1) 数据采集XML中businessdata节点内容必须以
压缩方式上传。压缩方式为:
(a) String转换为GZIPOutputStream;
(b) GZIPOutputStream
Base64String;
(2) 由于采集后续环节处理步骤多,存量大,为提高
采集效率,要求开发商以单(少)批次大数据量方式上传,
禁止以多批次少数据量方式上传。
建议:每批次可控制在1万条记录数。
(3) 同一数据集下不同记录之间需保证所有节点名
称、顺序、个数一致。
1.4入参完整样例
24
转换为
H4sIAAAAAAAAAO1WXU8aQRR9tr+C/gBcpL602ZBs2Y1sKkvDYpv2ZWMKD03a1ERe+gbqYlsB
25
sVWplqpYraZVwPi1suKfcT6WJ/9C7+4suEJN2nd5YebOuWfOnblzsnzy7UTo3gCfHE+PT6bS
kzAe4O/7/cjcto5nSLN0mSm1y7sks23VP1lHZ3Rx9zKzgIwLdDH3COd1XPqNjC1k/CJLDVKo
tb/lrs5XIaGLRoZpVSEn6w2Sr0Vq5nx+f3e75hYpbJKNWTybY6x0dYbu7SEj4+Wm58t0I+um
gdxX75KpUP9uDMZzHYSLTr+fSHGdSTKVHn/9xqnXUeCDipExh3M6rp0ho0lrVVrK4f0yqR27
Qgd4VYrLwqgyFtVkkQv5nFhCUJ/A1NeZPxYS4YgGmG5kNBYWRgESwot1KAiqtOo5Vhk+0Elj
gSNTP6yMDiXLYkd7N8llHVNlRVJVO9L+/AHXQWMBl/LIWMWfqlg/Ra0vkE+Os6RxhOdPmXC4
C/xzqnsj3VWe8/J1dKtyWBPCCfmZZEet6Rau7DJ+emhSc93md24CjhgZ+95q8GzTHn+vWrUG
bi1dnedBGymfoLN1m2dr3ZZXbDgwE5lFrB8CJ8jo2ZRJEYWEMCIpUlxISBpMpBCp7DElTACu
rbVXdNTcoYuOqvJJu3wEnfoCftGoKEYiweGorKrQqjzXz8Z2icVHBEV+KSTkmKKFYyLs4pCT
jxl8sIbzJl0uk0qTrM3AFsEgahXcmXtD/fl/4VWEqK3ezsOlAt1p9OQ5627VsaggM6ZO54Tj
Ukc0xzpw7Kl4HWEgIR6O2MfnjcWlcCwuwolKCndri7u943ZK3qqfAoAdLZ5fwMb0jVd5nWV2
38NzNRDUAkNa4MFDLRAYCtHiHNnUea43fhM8HIC/UMADYxEbNTg4SCtZurSN9RPUWvFKhCX7
7XI3H6/3LYNhBP2K3YUeM2Ad2ZPGcx7D6ze/29yomf8vN2I2d+dGd25050Z3bvRvbgRj+CL7
A5Yn+V2XCQAA
出参说明
2.1通用节点填写说明
出参switchset、business节点说明
字段名称 填写方 必填 填写说明
switchset节点下的switchmessage节点
messagecode 服务接收方
messagetext 服务接收方
business下的节点
datacompress 服务接收方 是 压缩标识,固定值:0 非压缩
否
否
-1:失败
hsb服务处理异常,详见hsb异常代码
26
business下的returnmessage节点
retcode
rettext
服务接收方
服务接收方
是
是
结果代码,-1接收失败 ;1 接收成功
结果描述
解析顺序
优先解析switchset->messagecode节点;
节点值为-1时,记录hsb处理异常原因,无需解析后续节
点;
节点值为空时,解析business->returnmessage->retcode
节点。
2.2出参完整样例
27
3.管理字段填写说明
每一个用于数据汇聚的交换标准,其businessdata下
的详细业务数据均包括业务字段与管理字段的组合,业务字
段随着每个业务内容的不同而不同,管理字段共同如下:
28
序号
1
2
3
字段
SERIALNUM_ID
TASK_ID
BATCH_NUM
字段类型
VARCHAR2(32)
VARCHAR2(2)
VARCHAR2(32)
描述
数据主键
任务号
分组号
人员唯一标
填写
预留
预留
预留
备注
管理字段必填,与
填写
PID保持一致
业务系统中针对不
同业务具体的流水
号字段,其值能在业
务系统中唯一标识
4 LOCAL_ID VARCHAR2(50)
识
★5 BUSINESS_ID VARCHAR2(100) 业务流水号 填写 一次业务数据。例
如:门诊业务此处为
“门诊号”;住院业
务此处则为“住院
号”
参考【CT01.00.001
6 BUSINESS_TYPE VARCHAR2(2) 就诊类型 填写
业务活动类别代码】
业务系统中数据表
的逻辑主键或联合
主键,其值能在业务
基本活动流
7 BASIC_ACTIVE_ID VARCHAR2(100)
水号
一标识出一条记录,
同时也能够体现出
主从关系
DATAGENERATE_DA
★8
TE
DATE(14)
生时间
29
业务数据产
填写
生的时间即数据在
本业务数据实际产
填写 系统的数据表中唯
医院系统中的实际
产生时间。格式为:
【YYYYMMDDHH24MIS
S】14位日期时间
数据所属医疗机构
ORGANIZATION_CO
9
DE
VARCHAR2(22)
码
(CT08.10.001)
ORGANIZATION_NA
10
ME
VARCHAR2(64)
称
组织机构名
填写
的组织机构名称
填写由统一分配的
★11 DOMAIN_CODE VARCHAR2(12) 系统编码 填写
节点系统编码
12
13
CREATE_DATE
UPDATE_DATE
DATE(14)
DATE(14)
新建时间
更新时间
归档日期时
14 ARCHIVE_DATE DATE(14)
间
15 RECORD_IDEN VARCHAR2(1) 记录标识 预留
在业务系统中唯一
16 PID VARCHAR2(50) 患者ID 填写 标识一个居民/患者
的ID
预留
预留
预留
数据所属医疗机构
组织机构代
填写 的组织机构代码
注:表格中序号标★的字段为查重索引字段。
(二)数据采集结果接收服务
服务类型
服务提供方
功能描述
Webservice
医院业务平台
服务标识 无
服务调用方 平台
接收上传数据的异步返回结果,包含采集结果及校验报告
30
WSDL地址
命名空间
方法名称
入参
参数
出参
无要求
无要求
无要求
采集结果XML
采集结果XML
入参类型
出参类型
String
String
入参说明
1.1通用节点填写说明
入参switchset、business节点说明
字段名称 填写方 必填 填写说明
switchset节点下的visitor节点
sourceorgan
sourcedomain
服务调用方
服务调用方
是
是
准)
switchset节点下的serviceinf节点
servicecode 服务调用方 否 hsb发布服务标识:
填写默认值:22位项目机构编码
填写默认值:NRHPT00001(以实际项目为
switchset节点下的provider节点
targetorgan
targetdomain
business节点下
standardcode 服务调用方 否 空
服务调用方
服务调用方
否
是
台统一分配)
空
医院业务平台10位接入系统编码(由平
business节点下的requestset节点
reqpaging 服务调用方
是
填写默认值:0
31
字段名称
reqpageindex
reqpageset
business节点下
datacompress
daqtaskid
填写方
服务调用方
服务调用方
必填
是
是
填写说明
填写默认值:-1
填写默认值:0
服务调用方
服务调用方
是
否
压缩标识:默认值0
空
1.2 businessdata节点填写说明
字段名称 填写方 必填 填写说明
businessdata下的result节点
任务编号,与数据上传时填写的任务编号
taskid
domaincode
domainname
resourcecode
resourcename
uploadtime
resultcode
resultdesc
tableinfo
report
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
是
相同
是 数据上传时填写的接入系统编码
是 接入系统编码对应的名称
交换标准编码,与数据上传时填写的
是
standardcode相同
是 交换标准编码对应的名称
上传时间,数据采集服务接收数据上传的
是
时间
是 结果编码,-1 失败 ;1 成功
是 结果描述
装载一个表校验结果的总节点,下面有子
是
节点
是 数据校验报告,格式HTML报告
tableinfo下的tables节点
32
字段名称
tablename
tabledesc
setcode
setname
recordcount
填写方
服务调用方
服务调用方
服务调用方
服务调用方
服务调用方
必填 填写说明
是 数据集所对应的表名称
是 数据集所对应的表名称描述
是 数据集编码对应
是 数据集编码对应的名称
数据量,数据上传时对应数据集下的数据
是
量
错误数据量,经过数据校验判断存在错误
errorrecordcount 服务调用方
rulecount
errorcount
服务调用方
服务调用方
是
的数据量
是 规则数,总校验经过的规则数量
错误数,规则数与每一个规则对应错误数
是
据量的乘积
1.3重点说明
(1) 校验回调服务针对一次数据上传进行结果汇总,
以【资源编码+任务编码】进行唯一数据上传定位。
(2) 资源包含多个数据集时,会存在多个【tableinfo】
节点。
(3) 【report】节点内容直接保存成.html文件即为
校验报告,根据规则多少,文档内容大小不一。
(4) 校验报告中只记录每个错误规则下的三条错误
信息,并未记录所有错误,以防文件内容过大,开发商需要
根据规则错误进行规则排查。
1.4入参完整样例
33
34
35
tableinfo节点
看]]>
出参说明
2.1通用节点填写说明
出参switchset、business节点说明
字段名称 填写方 必填 填写说明
switchset节点下的switchmessage节点
messagecode
messagetext
Hsb平台
Hsb平台
否
否
代码
business节点下的returnmessag节点
retcode
rettext
服务接收方
服务接收方
是
是
况填写
0:失败;1:成功
服务接收方根据数据处理实际情
-1:失败
hsb服务处理异常,详见hsb异常
2.2出参完整样例
36
37
(三)数据对账接收服务
服务类型
服务提供方
功能描述
平台进行数据对账
基本服ID:端口
WSDL
务 /dqc/webservice/receiveRDDataService?wsdl
Webservice
平台
服务标识
服务调用方 医院业务平台
医院业务平台定时上传本方统计的数据量、业务量信息,用于
HSB发布 请以项目实际发布地址为准
命名空间
方法名称
入参
参数
出参 XMLData 出参类型 String
/
handle
XMLData 入参类型 String
入参说明
1.1通用节点填写说明
入参switchset、business节点说明
字段名称 填写方 必填 填写说明
switchset节点下的visitor节点
服务请求方的22位机构编码(如果上传
sourceorgan 服务调用方 是 业务系统包含多个医疗机构,任取其一;
如社区系统,取其中一家社区机构编码填
38
字段名称 填写方 必填 填写说明
写)。由平台统一分配。
服务请求方的10位接入系统编码。由平
sourcedomain 服务调用方 是
台统一分配。
switchset节点下的serviceinf节点
servicecode 服务调用方 否 hsb发布服务标识:
switchset节点下的provider节点
targetorgan
targetdomain
business节点下
standardcode 服务调用方 是 填写默认值:REQ.F0101.0910.001
服务调用方
服务调用方
是
是
准)
填写默认值:22位项目机构编码
填写默认值:NRHPT00002(以实际项目为
business节点下的requestset节点
reqpaging
reqpageindex
reqpageset
business节点下
否
datacompress
daqtaskid
服务调用方
格式)
服务调用方
是
任务编号:17位当前时间
压缩标识:不填;默认值0(不支持压缩
服务调用方
服务调用方
服务调用方
是
是
是
填写默认值:0
填写默认值:-1
填写默认值:0
businesss节点下的businessdata节点
业务量对账:F0101.0910.001
setcode 服务调用方 是
数据量对账:F0101.0910.002
1.2业务量对账节点
入参businessdata节点说明-业务量对账
39
(F0101.0910.001)
字段名称
WS06_00_918_05
WS99_00_963_01
WS99_00_964_01
WS99_00_965_01
WS08_10_918_02
WS08_10_052_31
WS06_00_994_02
WS99_00_966_01
字段描述
业务日期
对账场景
数据角色
业务指标编码
接入系统编码
机构编码
统计时间
统计结果
长度 必填
8
1
1
50
10
22
14
10
是
是
是
是
是
否
是
是
其他说明
8位业务日期
默认值:1-数据采集
默认值:1-数据生产方
详见指标列表文档
对账统计的接入系统
对账统计数据的机构编码
统计业务量时间
统计结果(数值)
入参businessdata节点数据封装格式样例如下
40
1.3数据量对账节点
入参businessdata节点说明-数据量对账
(F0101.0910.002)
字段名称
WS99_00_916_02
WS99_00_963_01
WS99_00_964_01
WS99_00_967_01
WS99_00_967_02
字段描述
交易任务ID
对账场景
数据角色
交换标准编码
数据集编码
长度
17
1
1
50
50
必填
是
是
是
是
否
其他说明
数据上传的daqtaskid值
默认值:1-数据采集
默认值:1-数据生产方
数据上传的standardcode值
数据上传的setcode值,建议填写
数据上传任务中包含数据的起始
WS06_00_940_07 数据起始时间 14 否
时间
数据上传任务中包含数据的结束
WS06_00_940_08 数据结束时间 14
41
否
时间
WS08_10_918_02
WS08_10_052_31
WS99_00_966_01
WS07_00_920_02
WS07_00_920_03
WS06_00_918_05
接入系统编码
机构编码
统计结果
交易状态
交易描述
采集日期
10
22
10
2
500
8
是
否
是
是
是
是
对账统计的接入系统
对账统计的机构编码
统计结果,数值
-1异常;1正常
交易状态描述
8位交易当前日期
入参businessdata节点数据封装格式样例如下
42
1.4重点说明
(1)可单独上传业务量、数据量对账信息;
(2)可同时上传业务量、数据量对账信息;
(3)建议每天定时批量上传前一天统计的业务量、对账信
息
1.5入参完整样例
43
44
45
息......
46
息......
47
出参说明
2.1通用节点填写说明
出参switchset、business节点说明
字段名称 填写方 必填 填写说明
switchset节点下的switchmessage节点
messagecode
messagetext
服务接收方
服务接收方
否
否
-1:失败
hsb服务处理异常,详见hsb异常代码
business节点下的returnmessag节点
retcode 服务接收方 否 -1:失败;1:成功
服务接收方根据数据处理实际情况填
rettext 服务接收方 否
写
解析顺序
优先解析switchset->messagecode节点:
节点值为-1时,记录hsb处理异常原因,无需解析后续
节点;
节点值为空时,解析
business->returnmessage->retcode节点。
2.2出参完整样例
48
49
50
版权声明:本文标题:全国医院数据上报管理方案-接口技术规范(试行) 内容由网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:http://www.roclinux.cn/p/1713383800a631902.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论