基于医共体解决方案的产品升级改造-详细设计说明书-3分级诊疗-分级诊疗接口文档.doc

分级诊疗平台对外接口服务规范说明创业慧康科技股份有限公司分级诊疗平台分级诊疗平台对外接口服务规范对外接口服务规范 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 2 of 49声明声明本文档所有权和解释权归属创业慧康科技股份有限公司所有，未经书面许可，不得复制或向第三方公开 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 3 of 49目录1.1.文档介绍文档介绍.6 61.1.系统概述 .61.2.文档目的 .61.3.文档范围 .71.4.读者对象 .71.5.术语与缩写解释 .72.2.接口要求接口要求.8 82.1.框架要求 .82.2.数据类型 .82.3.接口格式 .82.3.1.调用参数格式.92.3.2.返回数据格式.92.4.接口请求格式 .102.4.1wsdl 地址.103.3.转诊服务部分转诊服务部分.10103.1.上转转诊申请 .103.1.1.参数说明.103.1.2.接口示例.123.2.上转转诊撤销申请 .143.2.1.参数说明.143.2.2.接口示例.143.3.上转转诊确认到诊 .153.3.1.参数说明.153.3.2.接口示例.163.4.上转转诊审核 .173.4.1.参数说明.173.4.2.接口示例.183.5.上转转诊申请单查询 .193.5.1.参数说明.193.5.2.接口示例.223.6.下转转诊申请 .253.6.1.参数说明.253.6.2.接口示例.273.7.下转转诊撤销申请 .293.7.1.参数说明.293.7.2.接口示例.303.8.下转转诊审核 .30 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 4 of 493.8.1.参数说明.303.8.2.接口示例.313.9.下转转诊确认到诊 .323.9.1.参数说明.323.9.2.接口示例.333.10.下转转诊申请单查询 .343.10.1.参数说明.343.10.2.接口示例.373.11.转诊单信息接收 .413.11.1.参数说明.413.11.2.接口示例.434.4.协同门诊协同门诊.43434.1.协同门诊申请 .434.1.1.参数说明.434.1.2.接口示例.454.2.协同门诊查询 .464.2.1.参数说明.464.2.2.接口示例.495.5.URLURL 接口调用接口调用.52525.1.权限获取 .525.1.1.webservice 调用说明 .525.2.参数加密 .535.2.1.webservice 调用说明 .535.3.会诊申请 .545.4.会诊列表 .555.5.会诊申请审核列表 .555.6.会诊受邀审核列表 .555.7.会诊诊后管理列表 .565.8.上转转诊管理列表 .565.9.上转转诊申请 .575.10.下转申请 .585.11.下转管理列表 .596.6.字典字典.60606.1.证件类型（CV02.01.101） .606.2.性别代码（GB_T2261_1） .606.3.血型代码（CV04_50_005） .616.4.婚姻状况（GB_T2261_2） .616.5.民族代码（GB_T3304） .616.6.年龄单位 .63 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 5 of 496.7.转诊类型 .636.8.转诊状态 .636.9.会诊类型 .636.10.会诊方式 .646.11.会诊状态 .646.12.门诊住院标识 .64 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 6 of 491.1. 文档介绍文档介绍1.1. 系统概述系统概述为引导优质医疗资源下沉，形成科学合理就医秩序，逐步建立符合国情的分级诊疗制度，切实促进基本医疗卫生服务的公平性、可及性。

国务院办公厅发布关于推进分级诊疗制度建设的指导意见，提出到 2017 年，基层医疗卫生机构诊疗量占总诊疗量比例明显提升，就医秩序更加合理规范到 2020 年，“基层首诊、双向转诊、急慢分治、上下联动”的分级诊疗模式逐步形成创业分级诊疗平台系统 BS-HMS2.1（hierarchical medical system），主要业务由三部分组成：1.分级诊疗平台管理层；2.WEB 应用；3.桌面端应用分级诊疗平台整体业务规划图分级诊疗平台整体业务规划图1.2. 文档目的文档目的编制本文档的目的是为了明确分级诊疗平台（BS-HMS2.1）项目在系统上线实施过程中与基层医疗机构、上级医疗结构及其他机构在转诊、会诊等业务时，各方所需要的接口服务，便于系统对接的开发与测试 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 7 of 491.3. 文档范围文档范围根据接入机构及开展的业务范围不同，本文档的对外接口服务可分为三个部分，基础服务接口、转诊服务接口、会诊服务接口三个方面组成1.4. 读者对象读者对象分级诊疗平台管理相关人员；基层医疗机构相关开发人员；上级医疗机构相关开发人员；其他相关人员；1.5. 术语与缩写解释术语与缩写解释术语缩写词说明HMSHMS（hierarchical medical system）分级诊疗平台系统软件。

远程会诊远程会诊（remote consultation），医疗机构之间利用远程医疗信息系统平台，采用离线或交互方式，对患者及其病史、检查等进行分析，完成病情诊断，确定进一步诊疗方案的医疗行为，包括远程专家会诊、远程心电诊断、远程影像诊断、远程病理诊断、远程重症监护等医疗服务双向转诊医务人员根据患者病情治疗的需要，在上级和下级医疗机构之间实现转院的过程，基层医疗机构不具备患者病情治疗所需的技术和设备时，可以通过远程医疗信息会诊系统向上级医疗机构提出转院申请；上级医疗机构根据患者病情的治疗进展，认为无需在上级医疗机构继续治疗，可以将患者转到患者所在基层医疗机构继续治疗远程预约通过远程会诊系统远程预约功能，基层医疗机构的工作人员 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 8 of 49向上级医疗机构专家成员提出预约申请，上级医疗机构处理预约申请，确定会诊时间的过程视频会议两个或两个以上医疗机构，通过远程医疗信息系统的音视频传输和交互功能，达到即时且互动的沟通，以完成会议目的行为信息安全信息网络的硬件、软件及其系统中的数据受到保护，不受偶然的或者恶意的原因而遭到破坏、更改、泄露，系统连续可靠正常地运行，信息服务不中断。

电子健康档案电子健康档案（EHR），是人们在健康相关活动中形成的具有保存备查价值的电子化历史记录它是存储于计算机系统之中、面向个人提供服务、具有安全保密性能的终身个人健康档案家医家庭医生，即私人医生，是对服务对象实行全面的、连续的、有效的、及时的和个性化医疗保健服务和照顾的新型医生2.2. 接口要求接口要求2.1. 框架要求框架要求为降低系统间的依赖性，降低系统耦合，采用 SOA 架构，系统提供两种接口方式：Web Service ，HTTP2.2. 数据类型数据类型采用 XML 传递参数和返回结果，数据类型：序号序号数据类型数据类型说明说明1String字符、数字，不包含汉字2NString汉字、字符、数字，utf-8 编码3Number只能是数字 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 9 of 492.3. 接口格式接口格式所有 web service 的接口采用统一格式：1) 参数要求：有且只有一个字符串类型的参数且有固定格式；2) 返回值要求：必须为字符串类型且有固定格式2.3.1.2.3.1. 调用参数格式调用参数格式2.3.1.1.参数格式举例参数格式举例 PHIS 3 3.0接口调用时参数需被接口调用时参数需被包裹即包裹即!CDATA!CDATA 2.3.2.2.3.2. 返回数据格式返回数据格式2.3.2.1.返回格式举例返回格式举例 WHIS 3 3.0 200 Success 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 10 of 492.4. 接口请求格式接口请求格式2.4.12.4.1wsdlwsdl 地址地址http:/ip:port/hms/服务地址?wsdl 3.3. 转诊服务部分转诊服务部分wsdl 地址：http:/ip:port/hms/DrWsService?wsdl3.1. 转诊申请转诊申请3.1.1.3.1.1. 参数说明参数说明接口接口编编号号DR1001接口名称接口名称exchangeApply提供方提供方协同平台调用方调用方PHIS、WHIS 等接口描述接口描述转诊申请调用说明调用说明参数参数说说明明参数名称参数名称类类型型长长度度必填必填说说明明 PHIS String20是系统发送方系统 Id(例如：WHIS，PHIS 等) String20是消息类型 3.0String50是消息版本转诊申请单信息String36是业务系统患者档案 IDString2是转诊类型:1:上转；2：下转String50否业务系统患者档案类型 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 11 of 49String20否建档机构代码String30否居民健康卡号String20是患者姓名String20是性别代码Date否出生日期String20是号码String2是转诊方式String2是转诊类型String2是证件类型String20是证件号码String30否接诊医生代码String32否就诊流水号String1否就诊机构代码String1否患者类型代码String50否门（急）诊号String50否住院号String50否就诊日期时间String200否过敏史String200是疾病史（含外伤）String19否手术史Date19是转诊（院）日期String30是转诊医师签名String200是转诊原因String500否转诊记录String20否疾病诊断编码String20是疾病诊断名称String36否诊断日期String200否诊断机构名称String200否相关症状String200否主要治疗措施String300否辅助检查结果String20否手术及操作编码String200否手术及操作名称Datetime否手术及操作开始日期时间String否治疗方案String200否处置计划String200否健康问题评估String200否康复措施指导String20否转入医疗机构名称String20是转入医疗机构代码String20否转入医疗机构科室名称String20否转出医疗机构名称String20是转出医疗机构代码 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 12 of 49String20否转出医疗机构科室名称String20是转出医疗机构科室代码返回数据返回数据参数名称参数名称类型类型长度长度必填必填说明说明 PHIS String20是系统发送方系统 Id(例如：WHIS，PHIS 等) String20是消息类型 3.0String50是消息版本Int5是状态码String200是状态信息String36是转诊单号3.1.2.3.1.2. 接口示例接口示例参参数数值值 HIS ODS_1001 3.0 1 8b4a7d06f4f54d048c71bfc836d965c2 2019-10-20 11 1 1 222 11 222 01 110101199003077336 11 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 13 of 49 11 1 3dd 1 11 11 11 8b4a7d06f4f54d048c71bfc836d965c2 22 22 22 11 - - 1 1 11 1 1 1 1 1 10011 1 1 10011 1 1 返返回回值值 WHIS 3 3.0 200 创业慧康科技股份有限公司创业慧康科技股份有限公司Page 14 of 49 Success 20。