医技接口方案.docx
- 文档编号:7414067
- 上传时间:2023-05-11
- 格式:DOCX
- 页数:15
- 大小:20.34KB
医技接口方案.docx
《医技接口方案.docx》由会员分享,可在线阅读,更多相关《医技接口方案.docx(15页珍藏版)》请在冰点文库上搜索。
医技接口方案
医技接口设计说明书
(V1.0)
万达信息股份有限公司
2015.08
目录
一.概述3
1.信息交互方案概述3
2.技术方向3
二.字典数据订阅查询3
三.医技申请查询5
四.医技完成状态回写9
五.医技报告调阅10
六.注意事项11
七.XML规范说明:
12
接口定义12
数据格式定义12
一.概述
1.信息交互方案概述
本接口主要描述区域基层医疗系统与各个医技厂商之间的接口关系,并对具体的操作给予定义,是双方在接口的开发过程中的依据。
区域基层医疗系统与各个医技厂商制定统一的接口方式,完成全市各个医技厂商与区域基层医疗系统的数据交互。
数据交互的场景共分为字典数据订阅查询,医技申请查询,医技完成状态回写,医技报告调阅四个方面。
2.技术方向
系统间的接口主要体现在数据传递上,采用两种方式来实现接口。
1医技厂商通过WebService获取基层医疗数据,完成字典数据订阅查询,医技申请查询,医技完成状态回写。
2基层医疗通过医技厂商提供的医技报告URL地址获取报告的详细信息。
二.字典数据订阅查询
区域基层医疗系统向医技厂商提供字典数据订阅查询的WebService接口。
通过WebService接口,医技系统可以获取机构需要对照的静态数据。
静态数据包括:
机构信息,本机构科室字典,本机构用户字典,本机构收费类型字典,本机构项目字典。
功能描述
字典获取
服务地址
https:
//ip:
port/harmonyhis/services/His_Service
服务方法
stringStaticDataQuery(inputData:
string)
输入参数
参数名称
数据类型
参数说明
空
inputData
String
XML格式,详见参数说明
否
返回值
数据类型
说明
空
String
XML格式,详见参数说明
否
入参说明:
级别2
级别3
说明
空
ywbh
业务编号,长度3位,
000:
全市机构字典
001:
本机构科室字典
002:
本机构用户字典
003:
本机构收费类型字典
004:
本机构LIS项目字典
005:
本机构DR项目字典
006:
本机构CT项目字典
007:
本机构B超项目字典
008:
本机构心电图项目字典
否
yljgdm
医疗机构代码,
业务000时医疗机构代码传空,其他业务必须传机构代码
是
fqsj
发起时间,时间日期格式A
否
xtbl
保留信息,长度0-100位字符,暂时为空
是
返回值定义:
级别2
级别3
说明
空
fhm
返回码,0:
成功1失败;
否
fhxx
返回信息,长度0-100位字符,消息出错信息填写在该字段
是
clsj
处理时间,时间日期格式A
否
zdxx
字典信息,含子节点(item)
item
dm
代码
否
mc
名称
否
xtbl
保留信息,长度0-100位字符,暂时为空
是
参考xml格式如下:
入参格式:
返回值
……
三.医技申请查询
区域基层医疗系统提供医技申请查询的WebService接口。
通过WebService接口,医技系统传输病历号(门诊通常为发票号,住院通常为住院号)可以获取病人的医技申请信息。
功能描述
医技申请单获取
服务地址
https:
//ip:
port/harmonyhis/services/His_Service
服务方法
stringMedReqQuery(inputData:
string)
输入参数
参数名称
数据类型
参数说明
空
inputData
String
XML格式,详见参数说明
否
返回值
数据类型
说明
空
String
XML格式,详见参数说明
否
入参说明:
级别2
级别3
说明
空
ywbh
业务编号,长度3位,
101:
本机构LIS申请
102:
本机构DR申请
103:
本机构CT申请
104:
本机构B超申请
105:
本机构心电图申请
否
yljgdm
医疗机构代码
否
patno
病历号,医技厂商提供操作员录入的字段,门诊通常为发票号,住院通常为住院号
否
fqsj
发起时间,时间日期格式A
否
xtbl
保留信息,长度0-100位字符,暂时为空
是
返回值定义:
级别2
级别3
说明
空
fhm
返回码,0:
成功1失败;
否
fhxx
返回信息,长度0-100位字符,消息出错信息填写在该字段
是
clsj
处理时间,时间日期格式A
否
patno
病历号,门诊为发票号,住院为住院号
否
patid
病人唯一号,病人的唯一标示
否
cardno
就诊卡号
否
regid
就诊唯一号门诊为就诊序号,住院为住院标识。
医技厂商提供报告时,HIS应该以此字段来获取本次就诊的报告。
否
inpdate
入院日期(针对住院病人)
是
patname
病人姓名
否
patsex
性别
0未知的性别1男,2女,9未说明的性别
否
patbirth
病人出生年月,时间日期格式B
是
patagestr
病人年龄字串如:
1岁,12月23天
是
typecode
就诊类型
1=门诊,2=急诊,3=住院,4=体检,5=义诊9=其他
否
chargetypeno
收费类型代码(字典数据订阅)
否
reqdocno
申请医生代码(字典数据订阅)
否
reqdeptno
所属科室代码(字典数据订阅)
否
reqwardno
病人病区代码(字典数据订阅)
是
reqbedno
病人床号
是
paticd
诊断名称
是
clinsymp
临床症状
是
checkreq
检查要求
是
chiefcomp
主诉
是
medhistory
病史
是
sign
体征
是
note
注意事项
是
pataddress
病人联系地址
是
patnation
病人国籍
是
patidcardno
身份证号
是
patphone
联系电话
是
patheight
病人身高值单位cm,如:
175
是
patweight
病人体重值单位kg,如:
58.5
是
abobldtype
ABO血型A/B/AB/O
是
rhbldtype
RH血型+,-表示阴性、阳性
是
reqno
申请单号
否
performdeptno
执行科室代码(字典数据订阅)
否
reqdt
申请时间,时间日期格式A
否
reqitem
申请信息结构体,含item子节点
否
item
itemcode
申请项目代码
否
item
itemname
申请项目名称
否
item
itemprice
项目价格,数字格式A
否
item
itemqty
数量,数字格式B
否
item
hisrecordid
申请明细记录号
否
item
checkpart
检查部位
是
xtbl
保留信息,长度0-100位字符,暂时为空
是
参考xml格式如下:
入参格式:
返回值
……
四.医技完成状态回写
区域基层医疗系统提供医技完成状态回写的WebService接口。
医技系统完成检查后,通过WebService接口,传输申请单ID,回写区域基层医疗系统医技已完成状态。
功能描述
医技完成状态回写
服务地址
https:
//ip:
port/harmonyhis/services/His_Service
服务方法
stringMedReqReturn(inputData:
string)
输入参数
参数名称
数据类型
参数说明
空
inputData
String
XML格式,详见参数说明
否
返回值
数据类型
说明
空
String
XML格式,详见参数说明
否
入参说明:
级别2
级别3
说明
空
ywbh
业务编号,长度3位,
201:
本机构LIS回写
202:
本机构DR回写
203:
本机构CT回写
204:
本机构B超回写
205:
本机构心电图回写
否
yljgdm
医疗机构代码
否
reqno
申请单号
否
fqsj
发起时间,时间日期格式A
否
xtbl
保留信息,长度0-100位字符,暂时为空
是
返回值定义:
级别2
级别3
说明
空
fhm
返回码,0:
成功1失败;
否
fhxx
返回信息,长度0-100位字符,消息出错信息填写在该字段
是
clsj
处理时间,时间日期格式A
否
xtbl
保留信息,长度0-100位字符,暂时为空
是
参考xml格式如下:
入参格式:
返回值
五.医技报告调阅
医技系统提供调阅报告的URL地址(带参数),区域基层医疗系统调阅URL地址获取报告信息。
调阅病人本次就诊的医技报告参数为regid就诊唯一号
调阅病人历次所有的医技报告参数为patid病人唯一号
六.注意事项
1.xml入参里,不能有多余空格如:
2.xml入参里,属性的值要添加双引号””如:
3.所有方法,入参值不能少,不然会报错。
4.由于返回结果内,xml里,标签元素名大小写没有明确规定,故将其统一为小写。
七.XML规范说明:
接口定义
接口格式
接口采用XML的方式
数据格式定义
时间日期格式A
精确到分钟的时间格式,固定长度14位字符,格式为YYYYMMDDHHNNSS。
例子:
20121015183059
时间日期格式B
精确到日的时间格式,固定长度8位字符,格式为YYYYMMDD。
例子:
20121015
数字格式A
精确到2位小数的金额格式,最大长度12位字符,包含2位小数及小数点,且不能是负数
例子:
7.00123456789.00
数字格式B
整型
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 接口 方案