江苏省新农合省定点医院转诊接口说明书.docx
《江苏省新农合省定点医院转诊接口说明书.docx》由会员分享,可在线阅读,更多相关《江苏省新农合省定点医院转诊接口说明书.docx(44页珍藏版)》请在冰豆网上搜索。
![江苏省新农合省定点医院转诊接口说明书.docx](https://file1.bdocx.com/fileroot1/2023-1/26/0fd0a5ec-76db-4a90-b3ae-219eeb52e6b8/0fd0a5ec-76db-4a90-b3ae-219eeb52e6b81.gif)
江苏省新农合省定点医院转诊接口说明书
目录
1.引言2
1.1.系统概述2
1.2.文档概述2
1.3.引用文件2
2.接口设计3
2.1.传输协议设计3
2.1.1总体设计3
2.1.2数据传输格式3
2.1.3转诊接口服务分类7
下载转诊单(定点到省)7
转诊接收(定点到省)7
转诊取消接收(定点到省)7
转诊入院(定点到省)7
取消入院(定点到省)7
转诊就诊日报(定点到省)7
下载日报明细(省到定点)7
转诊预结算(定点到省)7
转诊结算(定点到省)7
取消结算(定点到省)7
转诊出院(定点到省)7
取消出院(定点到省)7
3.转诊业务接口名称和数据集合9
3.1下载转诊单(定点医院)9
3.1.1上传数据集合9
3.1.2回应数据集合10
3.2转诊接收(定点医院)11
3.2.1请求数据集合11
3.2.2回应数据集合12
3.3转诊取消接收12
3.3.1请求数据集合12
3.3.2回应数据集合12
3.4转诊入院(定点到省)12
3.4.1上传数据集合13
3.4.2回应数据集合14
3.5取消入院(定点到省)14
3.5.1请求数据集合14
3.5.2回应数据集合14
3.6转诊就诊日报(定点到省)15
3.6.1请求数据集合15
3.6.2回应数据集合16
3.7转诊预结算(定点到省)16
3.7.1请求数据集合16
3.8.2回应数据集合16
3.9转诊结算通知(定点到省)17
3.9.1请求数据集合17
3.9.2回应数据集合18
3.10下载结算明细(定点到省)18
3.10.1请求数据集合18
3.10.2回应数据集合19
3.11取消结算(定点到省)20
3.11.1请求数据集合20
3.11.2回应数据集合20
3.12转诊出院通知(定点到省)20
3.12.1请求数据集合21
3.12.2回应数据集合21
3.13取消出院(定点到省)21
3.13.1请求数据集合22
3.13.2回应数据集合22
1.引言
1.1.系统概述
该接口主要服务江苏省新型农村合作医疗省内转诊业务数据交换。
主要是为了解决,省平台与县平台,省平台与省(市)定点医疗机构的转诊业务的数据传输和交换。
1.2.文档概述
该文档重点描述转诊业务数据集标准。
1.3.引用文件
《招标文件第二分册(修改)2》江苏省卫生厅
《新型农村合作医疗管理信息系统基本规范<3008年修订版>》国家卫生部
《新型农村合作医疗基金财务制度》国家卫生部
《新型农村合作医疗基金会计制度》国家卫生部
《全国新农合基本信息报表补充内容》国家卫生部
《全国新农合统计调查制度》国家卫生部
《新农合基本信息县级调查表》国家卫生部
《新农合基本信息登记表》国家卫生部
《江苏新农合补充内容调查表》江苏省卫生厅
《需求说明书—省级分册V2.1》项目组
《需求说明书—县级分册V1.9》项目组
《计算机软件文档编制规范》(GB/T8567-3006)国家标准化管理委员会
2.接口设计
2.1.传输协议设计
2.1.1总体设计
各个接口之间通过标准的数据格式进行数据交换,包含两种数据类型,一种是请求数据,另外一种是回应数据,两种数据类型都包含两块,一块是该数据格式的基本属性,用来说明传送数据的一些控制信息,接下来一块是业务数据,里面存放着有关业务的信息,回复数据还包含着回复数据块,这块用来存放被请求方处理的请求数据的结果信息。
数据传输格式使用XML。
2.1.2数据传输格式
从目前的发展形势和标准化角度来看,XML是一个最好的选择,它基于标准,扩展极其容易。
因此新农合数据传输的信息格式采用XML作为传输数据格式。
XML传输报文内容全部封装在一个XML报文中,采用GB2312/UTF-8字符集,XML报文分为两部分,XML头部分和业务数据部分,XML报文的root元素为XNHData,如下图所示:
元素说明:
序号
元素
说明
1
XNHData
XML的根元素,表示一个新农合的数据报文。
2
head
用来标识XML报文的基本属性。
类别是HeadType
3
businessData
用来存放具体的数据传输报文。
类别是BusinessDataType
4
respData
用来存放被请求方处理请求的处理结果。
head部分
head部分用来标识XML报文的基本属性,包括版本号、上报机构、目标机构、报文事件描述等内容,其数据结构如下图:
元素说明:
序号
元素
元素类型
说明
1
version
数字型
该数据报文的版本号,两位数字,如1.0、1.1。
2
signature
字符型
校对自增流水号。
3
sendTime
字符型
发送时间,必选字段,格式为yyyy-MM-ddHH:
mm:
ss
业务数据体businessDataType
业务数据体businessDataType部分用来存放具体的数据传输报文,由数据集以及附件集组成,如下图所示:
元素说明:
序号
元素
元素类型
说明
1
dataSet
业务数据集
可选。
2
attachments
AttachmentsType
存放附件,可选。
AttachmentsType数据结构
附件集AttachmentsType用来封装非结构化的数据,如文本、图像、音频、视频文件等。
附件由一个或者多个附件组成,附件的数据结构如下图:
元素说明:
序号
元素
元素类型
说明
1
id
字符串
附件的唯一标识,业务数据集通过IDName来关联该附件,必选字段。
2
displayName
字符串
附件的显示名称,可选字段。
3
description
字符串
附件的描述,可选。
4
type
字符串
附件的类别,可选。
5
content
字符串
附件的内容,如果附件是二进制流,通过base64将二进制转换为文本。
DataSet集合
DataSet存放的数据是3章节之后描述的任何一个或者多个数据集。
RespDataType集合
RespDataType用来封装一个被请求方处理一个请求方请求的处理结果。
RespDataType集合的数据结构如下图:
属性说明:
序号
属性
元素类型
说明
1
time
字符串
发送时间,以yyyy-MM-DDHH:
mm:
ss格式。
元素说明:
序号
元素
元素类型
说明
1
code
整型
一个整数,代表处理结果。
一般来说,0表示处理成功。
必须
2
description
字符型
一个字符串,描述处理结果,必须是人能直接读懂。
XML示例数据:
请求消息:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
13
—type值参见各个“数据类型(type)”,下述数据参见各个数据结构-->
1
2
3
4
5
6
7
8
9
2009-03-27
11
0
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
21
22
回应消息:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
14
00:
14">
0
Successful.
2.1.3转诊接口服务分类
定点医疗机构机构相关业务接口
序号
接口名称
服务名称
相关数据
1
下载转诊单(定点到省)
DownloadZZDInfo
RLT107
2
转诊接收(定点到省)
AcceptZZDInfo
RLT107
3
转诊取消接收(定点到省)
CancelZZDInfo
RLT107
4
转诊入院(定点到省)
AcceptInHospital
RLT107、RLT104
5
取消入院(定点到省)
CancelAcceptInHospital
RLT107
6
转诊就诊日报(定点到省)
ReportDataDaily
RLT107,RLT105
7
下载日报明细(省到定点)
DownloadDataDaily
RLT107
8
转诊预结算(定点到省)
ReferralPreSettlement
RLT104
9
转诊结算(定点到省)
ReferralSettlement
RLT104,RLT106
10
取消结算(定点到省)
CancelReferralSettlement
11
转诊出院(定点到省)
ReferralOutHospital
RLT107,RLT104
12
取消出院(定点到省)
CancelOutHospital
RLT107
图1基本转诊流程
基本转诊流程描述:
1、转诊申请:
县医院或县合管办调用“上报转诊信息”服务接口把转诊病人信息报送到省平台,从而开始数据转诊服务;
2、转诊单下载:
定点医院调用“下载转诊单”服务接口下载对应的已审核的转诊单,
3、转诊接收:
当定点医院决定接收病人,定点医院调用“转诊接收”服务接口上载接收信息,如定点医院决定不接收病人,调用“转诊接收”服务接口上载不接收信息。
4、转诊入院:
当病人到定点医院,办理转诊入院则调用“转诊入院”服务接口;如不办理入院,则由该医院调用“转诊接收”服务接口上载不接收信息。
5、费用上报:
病人住院发生的费用,通过“转诊就诊日报”服务接口报送到省平台。
6、费用预结算:
先由定点医院调用“转诊就诊日报”服务接口把病人相关费用报送到省平台;再由定点医院调用“转诊预结算”服务接口获取预结算结果。
7、费用结算:
定点医院调用调用“转诊结算”接口办理转诊结算。
8、转诊出院:
病人出院:
转诊结算后,通过“转诊出院”接口办理转诊出院手续。
转诊逆流程:
1、取消入院
2、取消出院
3、取消结算
2.2.上传数据要求
在上传数据结合中打红色星号的字段必传输据。
(讨论)
3.转诊业务接口名称和数据集合
3.1下载转诊单(定点医院)
定点医院按照其医疗机构代码来下载转诊单,如果转诊单未被接收则可以一直下载,直到被接收.
系统名称(providerApp):
CENTRAL.PL.1
服务名称(targetServiceId):
DownloadZZDInfo
3.1.1上传数据集合
转诊申请与审核数据RLT107
数据编码
数据名称
数据类型
长度
相关数据代码标准
备注
T107-08*
转入医疗机构代码
字符型
22
S201-01
示例数据:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
14
—这里只要传定点医院的医疗机构代码-->
007
3.1.2回应数据集合
转诊申请与审核数据RLT107
数据编码
数据名称
数据类型
长度
相关数据代码标准
备注
T107-01
个人编码
字符型
50
T107-02
患者姓名
字符型
50
T107-03
诊断ICD码
字符型
9
S301-01(GB/T14396-2001)
T107-04
申请时间
日期型
格式:
YYYY-MM-DD
T107-05
申请说明
字符型
300
T107-06
经办机构
字符型
300
T107-07
转出医疗机构代码
字符型
22
T107-08
转入医疗机构代码
字符型
22
T107-09
审核状态
字符型
1
S301-10
T107-10
审核时间
日期型
格式:
YYYY-MM-DD
T107-11
审核说明
字符型
300
T107-12
审核人
字符型
50
T107-13
报送单位
字符型
300
T107-14
报送日期
日期型
T107-15
报送人
字符型
50
T107-16
申请类型
字符型
1
J101-06
T107-22
病人联系人
字符型
50
T107-23
病人联系人电话
字符型
50
T107-24
转出医疗机构名称
字符型
300
T107-25
转诊单号
字符型
50
T107-26
性别
字符型
1
T107-27
年龄
字符型
3
T107-28
身份证号
字符型
18
T107-29
合作医疗证号
字符型
22
T107-33
申请处理人
字符型
50
T107-34
申请处理人电话
字符型
50
T107-35
审核人电话
字符型
50
DQDM
地区代码
字符型
6
数据编码
数据名称
数据类型
长度
数据代码标准
备注
CODE
状态码
数值型
3
MSG
返回消息
字符型
300
示例数据:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
13
—假如对应定点医院有5张转诊单,则size=”5”-->
007
007
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
007
007
007
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
007
007
007
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
007
007
007
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
007
007
007
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
。
007
00:
13">
0
Successful.
3.2转诊接收(定点医院)
定点医院下载接收转诊单后,确认接收转诊病人,调用此接口上传接收信息至省交换平台。
系统名称(providerApp):
CENTRAL.PL.1
服务名称(targetServiceId):
AcceptZZDInfo
3.2.1请求数据集合
转诊申请与审核数据RLT107
数据编码
数据名称
数据类型
长度
相关数据代码标准
备注
T107-25*
转诊单号#
字符型
50
DQDM*
县的地区代码#
字符
6
T107-08*
转入医疗机构代码
字符型
22
S201-01
T107-17*
接收医疗机构代码
字符型
22
S201-01
T107-18*
接收医疗机构名称
字符型
300
S201-01
T107-19*
接收机构科室代码
字符型
22
S201-03
T107-20*
接收机构科室名称
字符型
300
S201-03
T107-21*
接收机构医生姓名
字符型
50
T107-30*
接收说明
字符型
500
定点医院说明接收病人入院的时间、联系方式
T107-31*
接收机构处理人
字符型
50
T107-32*
接收机构联系电话
字符型
50
T107-36*
接收时间
日期型
10
格式:
YYYY-MM-DD
示例数据:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
14
107-18>
3.2.2回应数据集合
数据编码
数据名称
数据类型
长度
数据代码标准
备注
CODE
状态码
数值型
3
MSG
返回消息
字符型
300
示例数据:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
13
00:
13">
0
Successful.
3.3转诊取消接收
转诊单被接收后,如要取消接收,则定点医院调用此接口,发送取消接收的信息。
要及时把病人取消被接收。
系统名称(providerApp):
CENTRAL.PL.1
服务名称(targetServiceId):
CancelZZDInfo
3.3.1请求数据集合
转诊单信息RLT107
数据编码
数据名称
数据类型
长度
相关数据代码标准
备注
T107-25*
转诊单号
字符型
50
DQDM*
县的地区代码
字符型
6
T107-37*
取消时间
日期型
10
格式:
YYYY-MM-DD
GB
T107-39*
取消原因
字符型
500
定点医院说明取消接收病人的原因
示例数据:
xmlversion="1.0"encoding="gb2312"?
>
2009-12-0809:
00:
14
3.3.2回应数