南川区智慧医疗健康平台接口规范.docx
- 文档编号:25743749
- 上传时间:2023-06-12
- 格式:DOCX
- 页数:61
- 大小:86.61KB
南川区智慧医疗健康平台接口规范.docx
《南川区智慧医疗健康平台接口规范.docx》由会员分享,可在线阅读,更多相关《南川区智慧医疗健康平台接口规范.docx(61页珍藏版)》请在冰豆网上搜索。
南川区智慧医疗健康平台接口规范
南川区智慧医疗健康平台接口规范
V1.4.0发布稿
参
考
手
册
南川区卫生和计划生育委员会
二零一八年四月
修改记录
版本号
更改条款及内容
更改日期
V1.1.0
1、服务架构与方案介绍
2、健康扶贫“一站式”结算
3、双向转诊
2018-3-1
V1.1.1
1、健康档案浏览器获取人员信息“ehr.personinfo”方法新增建档人、采集建档机构名称等返回值
2018-3-8
V1.2.0
1、检验接口
2018-3-10
V1.3.0
1、影像接口
2018-3-20
V1.3.1
1、医疗慢病接口
2、健康扶贫救助登记/更新新增“扶贫政策”参数
2018-4-9
V1.4.0
1、“1.3函数说明”新增浏览器调阅函数BLT_NavTo
2、浏览器调阅
2018-4-16
一.服务架构与方案介绍.........................01
1.1适用范围................................01
1.2接口方式................................01
1.3函数说明................................02
1.4JSON数据类型约束.........................03
1.5其他调用说明............................03
二.健康扶贫“一站式”结算......................04
2.1.流程图解................................04
2.2.函数功能说明............................05
2.2.1函数列表............................05
2.2.2基础信息下载........................06
2.2.3获取人员信息(健康档案浏览器)........07
2.2.4健康扶贫救助登记/更新...............09
2.2.5健康扶贫救助登记撤销................11
2.2.6文件上传............................11
2.2.7文件删除............................12
2.2.8健康扶贫补偿试算/正式结算...........13
2.2.9健康扶贫补偿结算撤销................14
2.2.10图像识别...........................15
三.双向转诊.....................................16
3.1.流程图解..................................16
3.2.函数功能说明.............................16
3.2.1函数列表.............................17
3.2.2获取转诊目标医院列表.................17
3.2.3获取转诊目标医院医生列表.............18
3.2.4获取转诊预约类型.....................18
3.2.5获取转诊类别.........................19
3.2.6转诊预约.............................20
3.2.7预约记录查询.........................21
3.2.8转诊申请.............................23
四.检验接口.....................................24
4.1.函数功能说明.............................24
4.1.1函数列表............................24
4.1.2检验信息上传........................25
4.1.3检验报告详情上传....................27
4.1.4细菌培养结果上传....................29
4.1.5细菌培养抗生素上传..................31
4.1.6检验结果撤回........................32
五.影像接口.....................................33
5.1.函数功能说明.............................34
5.1.1函数列表............................34
5.1.2影像设备类型下载....................34
5.1.3影像检查项目对应表下载..............35
5.1.4影像病历信息上传....................35
5.2.影像数据导入............................38
5.2.1术语、定义和缩略语..................38
5.2.1.1术语、定义......................39
5.2.1.2缩略语..........................39
5.2.2DICOM转发..........................39
5.2.2.1DICOMC-StoreSCP接收规则......39
5.2.3DICOM自动查询和获取接口设计........43
5.2.3.1DICOM自动查询和获取(Q/R)接口请求参数........................................43
六.医疗慢病接口................................44
6.1.流程图解.................................44
6.2.函数功能说明..............................44
6.2.1慢病就诊记录.........................44
七.健康档案使用浏览器调阅......................47
7.1.函数功能说明..............................47
7.1.1浏览器调阅健康档案..................47
一.服务架构与方案介绍
1.1适用范围
本文详细描述了中心平台与各医院通讯接口,适用于中心平台和医院的服务端和客户端的开发和使用。
1.2接口方式
统一标准智慧医疗健康平台接口将提供给各医疗机构一个标准的windows系统的动态链接库--bltremotecall.dll。
医疗机构原有HIS系统通过对动态库中的函数调用(COM组件、API),实现平台要求各功能嵌入到自己的系统中。
该动态库支持64位windows操作系统。
从业务处理的角度可以将动态库提供的功能分为业务函数和文件上传功能函数。
业务函数通过调用BLT_RemoteCall函数实现,功能函数通过调用BLT_PostFile函数实现。
平台中心端将以JSON消息返回给客户端。
1.3函数说明
函数名称
BLT_RemoteCall
功能描述:
调用执行各交易,进行各种业务处理。
调用语法:
BSTRBLT_RemoteCall(BSTR*secretKey,BSTR*authKey,BSTR*token,
BSTR*hostName,BSTR*method,BSTR*requestText)
参数解释:
secretKey:
密钥
authKey:
用户认证码
token:
认证HIS商代码
hostName:
服务端IP:
port
Method:
方法名
requestText:
方法名对应的入参信息
备注:
·secretKey、authKey、token由中心根据医疗机构统一提供。
·hostName具体信息待定,请根据实际情况进行设置。
·requestText需要以JSON格式组织相关入参信息。
·函数返回值将以JSON消息返回给客户端。
函数名称
BLT_PostFile
功能描述:
调用进行文件(资料)信息上传。
调用语法:
BSTRBLT_PostFile(BSTR*secretKey,BSTR*authKey,BSTR*token,
BSTR*hostName,BSTR*method,BSTR*absFileName,
BSTR*requestText);
参数解释:
secretKey:
密钥
authKey:
用户认证码
token:
认证HIS商代码
hostName:
服务端IP:
port
Method:
方法名
absFileName:
文件绝对路径
requestText:
方法名对应的入参信息
备注:
·secretKey、authKey、token由中心根据医疗机构统一提供。
·hostName具体信息待定,请根据实际情况进行设置。
·requestText需要以JSON格式组织相关入参信息。
·absFileName例如:
需要需要将本机电脑D盘中“资料”文件夹中的“演示图片.jpg”图片上传到中心,该值传为“d:
/资料/演示图片.jpg”。
·函数返回值将以JSON消息返回给客户端。
·只允许单文件上传,例如:
如果有5份文件需要上传,则需要调用本函数5次
函数名称
BLT_BLT_NavTo
功能描述:
浏览器调阅。
调用语法:
BSTRBLT_BLT_NavTo(BSTR*secretKey,BSTR*authKey,BSTR*token,
BSTR*hostName,BSTR*method,BSTR*requestText);
参数解释:
secretKey:
密钥
authKey:
用户认证码
token:
认证HIS商代码
hostName:
服务端IP:
port
Method:
方法名
requestText:
方法名对应的入参信息
备注:
·secretKey、authKey、token由中心根据医疗机构统一提供。
·hostName具体信息待定,请根据实际情况进行设置。
·requestText需要以JSON格式组织相关入参信息。
·函数返回值将以JSON消息返回给客户端。
1.4JSON数据类型约束
·数据采用字符串类型的基本数据格式,但是会要求不同的数据格式,比如数字、日期、时间等,格式要求如下:
·数字格式:
必须是0-9的数字,可以带小数点.符号字节,如无特别申明一般保留4位小数。
不能使用表达式。
日期格式:
必须是yyyy-MM-dd(年4位,月2位,日2位)。
时间格式:
必须是yyyy-MM-ddHH:
mm:
ss(年4位,月、日、时、分、秒均2位)。
1.5其他调用说明
发起方:
医疗机构
接收方:
南川区智慧医疗健康平台
基本JSON格式:
{"hospCode":
"500119","hospName":
"南川区卫计委","description":
"treatResult"}
具有层次的复杂结构JSON格式:
{"treatResult":
[{"itemId":
"TR01","itemCode":
"1","itemText":
"治愈"},
{"itemId":
"TR02","itemCode":
"2","itemText":
"病情好转"}
]}
错误响应:
JSON格式
{"error”:
”错误提示"}或者{"error”:
”错误提示”,“errorCode”:
”错误提示编码"}
2.健康扶贫“一站式”结算
医疗机构需要根据健康扶贫“一站式”即时结算政策的需要,按照我们提供的接口改造HIS接口,使其HIS系统能够适应健康扶贫“一站式”即时结算的需求。
2.1.流程图解
2.2.方法功能说明
2.2.1方法列表
序号
功能名
方法名
1
基础信息下载
fp.basedata
2
获取人员信息(健康档案浏览器)
器器)
ehr.personinfo
3
健康扶贫救助登记/更新
fp.save.treatment
4
健康扶贫救助登记撤销
fp.cancle.treatment
5
文件上传
fp.resupload
6
文件删除
fp.delete.uploadedfile
7
健康扶贫补偿试算/正式结算
fp.save.balance
8
健康扶贫补偿结算撤销
fp.cancel.balance
10
图像识别
2.2.2基础信息下载
调用函数:
BLT_RemoteCall
方法名:
fp.basedata
·入参
入参
参数
类型
参数名
是否可空
说明
itemType
字符型
获取基础信息类型
N
基础信息类型包括:
treatType:
治疗方式
hospitalType:
医院类型
hospitalLevel:
医院等级
hospitalDepend:
治疗机构属地
treatResult:
治疗结果
disease2:
基本疾病类型
disease1:
基本疾病类型大类
inHospital:
是否住院
门诊就医类别
treatTypePolicy:
救助政策
lastTime
时间格式
最后更新时间
Y
·返回值[数据集合]
节点名称
类型
返回值说明
备注
Id
字符型
基础信息ID
主键
itemCode
字符型
基础信息编码
value
字符型
基础信息名称
description
字符型
基础信息类型名称
itemType
字符型
基础信息类型
parentItem
字符型
上级基础信息ID
在获取"基本疾病类型
"时,将返回该疾病类型所属的"基本疾病类型大类"
2.2.3获取人员信息(健康档案浏览器)
通过此功能调取平台人员健康档案信息,以实现健康档案互联互通。
调用函数:
BLT_RemoteCall
方法名:
ehr.personinfo
入参
入参
参数
类型
参数名
是否可空
说明
name
字符型
姓名
N
idcardNumber
字符型
身份证号码
N
personCode
字符型
居民健康档案编码
Y
fpYear
字符型
年份
N
健康扶贫“一站式”必须传入年份;其他情况可不传入
·返回值[单条数据]
节点名称
类型
返回值说明
备注
id
数字型
人员ID
姓名
字符型
姓名
身份证号
字符型
身份证号码
档案编号
字符型
居民健康档案编码
性别
字符型
性别
出生日期
日期格式
出生日期
年龄
数字格式
年龄
户籍地址
字符型
户籍地址
民族
字符型
民族
个人电话
字符型
本人联系电话
常住类型
字符型
常住类型
血型
字符型
血型
阴性
字符型
RH阴性
文化程度
字符型
文化程度
职业
字符型
职业
婚姻状况
字符型
婚姻状况
联系人
字符型
联系人
联系人电话
字符型
联系人电话
建档人姓名
字符型
建档人姓名
采集建档机构名称
字符型
采集建档机构名称
高
数字格式
是否高血压人员
0:
否
1:
是
糖
数字格式
是否糖尿病人员
0:
否
1:
是
重
数字格式
是否重型精神病人员
0:
否
1:
是
老
数字格式
是否老年人
0:
否
1:
是
儿
数字格式
是否儿童
0:
否
1:
是
肺
数字格式
是否肺结核人员
0:
否
1:
是
孕
数字格式
是否孕产妇
0:
否
1:
是
贫
数字格式
是否贫困人员
0:
否
1:
是
民
数字格式
是否民政人员
0:
否
1:
是
残
数字格式
是否残疾人员
0:
否
1:
是
扶贫年度
字符型
健康扶贫救助年度
保险公司名称
字符型
保险公司名称
致贫类型
字符型
致贫类型
备注:
根据健康扶贫政策“贫困人员”、“民政人员”、“残疾人员”三种类型的人员可以享受健康扶贫救助。
2.2.4健康扶贫救助登记/更新
调用函数:
BLT_RemoteCall
方法名:
fp.save.treatment
·入参
入参
参数
类型
参数名
是否可空
说明
personId
数字型
人员ID
N
name
字符型
姓名
N
idcardNumber
字符型
身份证号码
N
personCode
字符型
居民健康档案编码
N
inHospitalTime
时间格式
入院日期
N
患者就诊的日期
outHospitalTime
时间格式
出院日期
N
diseaseCode1
字符型
一级疾病
N
取值为“基本疾病类型大类”的ID
diseaseCode2
字符型
二级疾病
Y
取值为“基本疾病类型”的ID
treatTypePolicy
字符型
救助政策类型
N
取值为“救助政策”的ID
treatType
字符型
治疗方式
N
取值为“治疗方式”的ID
treatResult
字符型
治疗结果
N
取值为“治疗结果”的ID
inHospital
字符型
是否住院
N
取值为“是否住院”的ID
hospitalLevel
字符型
机构级别
N
取值为“医院等级”的ID
hospitalType
字符型
机构类别
N
取值为“医院类型”的ID
hospitalDepend
字符型
机构属地
N
取值为“治疗机构属地”的ID
ybSerialNumber
字符型
医保结算流水号
N
医保结算后返回的“交易流水号”
treatId
字符型
登记流水号
Y
登记修改(更新)时传入
备注:
当“一级疾病编码”为“4649其他疾病”时,“二级疾病编码”必须传具体的疾病名称。
·返回值[单条数据]
节点名称
类型
返回值说明
备注
treatId
字符型
登记流水号
作为识别本次救助的唯一标识
createdCompanyPartyId
字符型
经办机构ID
createdDate
时间格式
登记时间
createdUserLoginId
字符型
经办用户ID
diseaseCode1
字符型
一级疾病
diseaseCode2
字符型
二级疾病
hospitalLevel
字符型
机构级别
hospitalType
字符型
机构类别
hospitalDepend
字符型
机构属地
inHospital
字符型
是否住院
inHospitalTime
时间格式
入院日期
outHospitalTime
时间格式
出院日期
lastModifyCompanyId
字符型
最后修改机构ID
lastModifyDate
时间格式
最后修改时间
lastModifyUserLoginId
字符型
最后修改用户
personId
数字型
健康扶贫人员编码
treatTypePolicy
字符型
救助政策
treatResult
字符型
治疗结果
treatType
字符型
治疗方式
2.2.5健康扶贫救助登记撤销
调用函数:
BLT_RemoteCall
方法名:
fp.cancle.treatment
·入参
入参
参数
类型
参数名
是否可空
说明
treatId
字符型
登记流水号
N
personId
数字型
健康扶贫人员编码
N
·返回值[单条数据]
节点名称
类型
返回值说明
备注
treatId
字符型
登记流水号
成功中心返回treatId,失败返回错误提示
2.2.6文件上传
调用函数:
BLT_PostFile
方法名:
fp.resupload
·入参
入参
参数
类型
参数名
是否可空
说明
treatId
字符型
登记流水号
N
type
字符型
文件类型
N
类型为:
发票、费用、签字、其他
fileName
字符型
文件名
N
备注:
文件类型“费用”是指费用清单.
·返回值[单条数据]
节点名称
类型
返回值说明
备注
message
字符型
信息提示
fileId
数字型
文件ID
md5
字符型
文件md5
type
字符型
文件类型
fileName
字符型
文件名称
2.2.7文件删除
调用函数:
BLT_RemoteCall
方法名:
fp.delete.uploadedfile
·入参
入参
参数
类型
参数名
是否可空
说明
treatId
字符型
登记流水号
N
fileId
字符型
文件ID
N
·返回值[单条数据]
节点名称
类型
返回值说明
备注
treatId
字符型
登记流水号
fileId
字符型
文件ID
2.2.8健康扶贫补偿试算/正式结算
调用函数:
BLT_RemoteCall
方法名:
fp.save.balance
·入参
入参
参数
类型
参数名
是否可空
说明
treatId
字符型
登记流水号
N
personId
数字型
人员ID
N
costTotal
数字格式
总费用
N
本次结算总发生费用
costMln
数字格式
目录内费用
N
取医保中心返回承认金额
costCxjmbx
数字格式
基本医疗报销
N
取医保中心返回
costDbbx
数字格式
大病保险报销
N
costMzjz
数字格式
民政救助金额
N
costFpjz
数字格式
扶贫救助支付金额
N
costYycd
数字格式
医院承担金额
N
isFormal
字符型
核算类型
N
N:
试算
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 南川 智慧 医疗 健康 平台 接口 规范