湖南省医院信息系统与新农合省级平台接口调用规范0112.docx
- 文档编号:3877030
- 上传时间:2022-11-26
- 格式:DOCX
- 页数:98
- 大小:261.29KB
湖南省医院信息系统与新农合省级平台接口调用规范0112.docx
《湖南省医院信息系统与新农合省级平台接口调用规范0112.docx》由会员分享,可在线阅读,更多相关《湖南省医院信息系统与新农合省级平台接口调用规范0112.docx(98页珍藏版)》请在冰豆网上搜索。
湖南省医院信息系统与新农合省级平台接口调用规范0112
湖南省医院信息系统与新农合省级平台
数据接口调用规范
目录
第一章:
接口调用规范3
一、前端DLL接口调用规范3
1.前端接口组成说明3
2.接口调用参数说明3
3.入参说明4
4.出参说明5
二、前端WebService调用规范6
1.WebService组成说明6
2.接口调用参数说明6
3.入参说明6
4.出参说明7
三、参数格式规范8
第二章:
医院调用省级平台接口服务说明8
一、诊疗管理服务调用规范(10201)8
1.住院诊疗信息及费用明细上传(H1020151)8
2.查询住院诊疗信息及费用明细(H1020152)15
3.取消住院诊疗信息及费用明细(H1020153)22
4.费用核对(H1020161)23
5.出院申请(H1020171)25
6.取消出院申请(H1020172)26
7.获取补偿信息(H1020181)26
二、字典维护服务调用规范(10802)32
1.字典匹配信息上传(H1080201)32
2.取消上传匹配信息(H1080202)33
3.获取上传匹配信息(H1080203)34
4.药品目录下载(H1080225)37
5.诊疗目录下载(H1080226)39
6.疾病目录下载(H1080227)41
三、农合相关字典(依据08标准制定)43
1.就诊类型S301-0543
2.入院状态S301-0243
3.出院状态S301-0343
4.性别S101-0144
5.补偿账户类型S301-0944
6.补偿类型S301-0644
7.就医机构行政级别S201-0645
第三章:
业务流程说明46
一、业务流程总体介绍46
1.转诊管理流程46
2.诊疗管理流程47
3.补偿管理流程48
4.结算管理流程49
第一章:
接口调用规范
一、前端DLL接口调用规范
1.前端接口组成说明
●开发手册(本文档)
⏹《县外就医管理_接口调用说明》(本文档);
●前端接口DLL:
⏹Cx_Interface.dll文件:
前端接口动态链接库(DLL);
⏹DLL调用例子源代码。
●前端INI文件:
⏹conn.ini里面包含WebServices所在位置,日志记录方式,返回串分隔符等相关信息,示例如下:
[WebServices_hos]
#WSDL所在URL位置
wsdlurl=http:
//127.0.0.1:
8080/hosservice/hosService.ws?
wsdl
#是否需要DLL日志.1:
要,0:
不要
log=1
#返回串分隔符
rtnbetween=||@
[屏幕保护等待时间]
00=10
2.接口调用参数说明
●findService(In_aqyz_XML,In_gnbh,In_jysr_XML,Out_jyfhbz,Out_jylsh,Out_jysc_XML,Out_jyfhxx)
参数名称
参数说明
参数类型
参数类别
In_aqyz_XML
安全认证XML
String
入口参数
In_gnbh
功能编号
String
入口参数
In_jysr_XML
交易输入XML
String
入口参数
Out_jyfhbz
交易返回标志
String
出口参数
Out_jylsh
交易流水号
String
出口参数
Out_jysc_XML
交易输出XML
String
出口参数
Out_jyfhxx
交易返回信息
String
出口参数
3.入参说明
安全认证XML:
采用XML格式的字符串形式,传输安全认证相关的内容。
示例如下:
xmlversion="1.0"encoding="GB2312"?
>
功能编号:
按本规范的功能号填写。
交易输入XML:
交易输入分为控制部分和输入部分,具体格式参照样例。
示例如下:
xmlversion='1.0'encoding="GB2312"?
>
4.出参说明
●DLL返回参数:
⏹通过调用动态链接库Cx_Interface_Cal.DLL提供的功能函数findService,进行调用,输入参数为(安全认证In_aqrz_xml、功能号In_gnbh、输入XML参数In_jysr_xml、输出参数预计空间In_Space)。
返回给前端一个数字,当返回数字为1时,调用正常,返回数字为-1时,调用失败。
返回字符串包含了四个出参,参数之间用配置文件(conn.ini)中指定的“返回串分隔符”分开,格式顺序是:
交易返回标志、交易流水号、交易输出XML、交易返回信息(此处需核对顺序)。
HIS在获取到返回字符串时,先要根据配置文件定义的“返回串分隔符”进行数据分解,再根据分解后的参数进行相应的业务处理。
●交易返回标志
返回的“交易返回标志”为0时,交易成功。
交易输出XML参数返回用XML格式的字符串返回输出结果。
通过在不同功能服务返回的输出XML结果进行解析,获取返回的参数或数据集。
返回的“交易返回标志”为1时,交易失败。
交易输出XML参数为空,“交易返回信息”参数用字符串格式返回错误信息。
●交易流水号
返回平台发生该业务时的流水号,用于前台和中心进行数据核对时使用。
●交易输出XML
交易输出XML参数用XML格式的字符串返回;通过在不同功能服务返回的输出XML结果进行解析,获取返回的参数或数据集。
●交易返回信息
返回的“交易返回标志”为0时,交易成功。
“交易返回信息”为空;
返回的“交易返回标志”为1时,交易失败。
“交易返回信息”参数用字符串格式返回错误信息。
二、前端WebService调用规范
1.WebService组成说明
●开发手册(本文档)
⏹《县外就医管理_接口调用说明》(本文档);
●WSDL所在URL位置
⏹本医疗机构的前置机位置;
2.接口调用参数说明
●List
入口参数描述:
参数名称
参数说明
参数类型
参数类别
In_aqyz_XML
安全认证XML
String
入口参数
In_gnbh
功能编号
String
入口参数
In_jysr_XML
交易输入XML
String
入口参数
返回值List
Out_jyfhbz
交易返回标志
String
出口参数
Out_jylsh
交易流水号
String
出口参数
Out_jysc_XML
交易输出XML
String
出口参数
Out_jyfhxx
交易返回信息
String
出口参数
3.入参说明
●安全认证XML:
采用XML格式的字符串形式,传输安全认证相关的内容。
示例如下:
xmlversion="1.0"encoding="GB2312"?
>
●功能编号:
按本规范的功能号填写。
●交易输入XML:
交易输入分为控制部分和输入部分,具体格式参照样例。
示例如下:
xmlversion='1.0'encoding="GB2312"?
>
4.出参说明
●交易返回标志
返回的“交易返回标志”为0时,交易成功。
交易输出XML参数返回用XML格式的字符串返回输出结果。
通过在不同功能服务返回的输出XML结果进行解析,获取返回的参数或数据集。
返回的“交易返回标志”为1时,交易失败。
交易输出XML参数为空,“交易返回信息”参数用字符串格式返回错误信息。
●交易流水号
返回平台发生该业务时的流水号,用于前台和中心进行数据核对时使用。
●交易输出XML
交易输出XML参数用XML格式的字符串返回;通过在不同功能服务返回的输出XML结果进行解析,获取返回的参数或数据集。
●交易返回信息
返回的“交易返回标志”为0时,交易成功。
“交易返回信息”为空;
返回的“交易返回标志”为1时,交易失败。
“交易返回信息”参数用字符串格式返回错误信息。
三、参数格式规范
●本规范约定,所有入参、出参均为string类型,但是会要求不同的格式,如数字,日期,时间等,格式说明如下:
⏹数字格式:
必须是0-9的数字,可以带+号,-号,小数点.等符号字节,如无特别申明一般保留2位小数。
不能是表达式;
⏹日期格式:
必须是yyyy-mm-dd(年4位,月2位,日2位);
⏹时间格式:
必须是yyyy-mm-ddhh24:
mi:
ss(年4位,月、日、时、分、秒均2位);
⏹字符格式:
指定长度的字符串。
第二章:
医院调用省级平台接口服务说明
一、诊疗管理服务调用规范(10201)
1.住院诊疗信息及费用明细上传(H1020151)
●功能描述:
实现HIS诊疗明细数据的上传服务,每条医嘱一条记录。
在上传过程中,转诊申请单号必须从平台获取并填写,住院就诊流水号是HIS系统内业务唯一键。
●入参:
⏹安全认证XML
序号
入参说明
字段
最大长度
非空
备注
1
就医机构代码
zyorg_code
VARCHAR2(32)
2
就医机构名称
zyorg_name
VARCHAR2(60)
3
就医机构级别
zyorg_level
CHAR
(1)
4
key
key
VARCHAR2(32)
5
密码
password
VARCHAR2(8)
示例(节点与节点之间去掉所有空格且所有的节点名称都为小写):
xmlversion='1.0'encoding='GB2312'?
>
⏹功能编码:
H1020151
⏹交易控制XML(XML节点定义:
head,以下不再描述)
序号
入参说明
字段
最大长度
非空
备注
1
住院就诊流水号
his_link_code
VARCHAR2(256)
Y
HIS系统内业务唯一键
(HIS系统内患者一次住院唯一标识码)
2
转诊申请单号
referral_no
VARCHAR2(20)
Y
通过转诊申请单号,关联农合相关信息
3
就医机构代码
zyorg_code
VARCHAR2(32)
Y
4
实际住院费用合计(元)
total_fee
NUMBER(15,2)
Y
医院系统计算,用于对帐
5
诊疗项目总条数
item_count
NUMBER(15,0)
Y
医院系统计算,用于对帐
⏹交易输入主XML(业务数据体)(XML节点定义:
BASE)
序号
入参说明
字段
最大长度
非空
备注
1
住院就诊流水号
his_link_code
VARCHAR2(256)
Y
HIS系统内业务唯一键
(HIS系统内患者一次住院唯一标识码)
2
住院号
inpat_no
VARCHAR2(32)
Y
3
转诊单号
referral_no
VARCHAR2(20)
Y
省级平台提供的转诊申请唯一单号(编码规则:
农合机构编码+YYYYMMDD+5位流水号),HIS必须先获取转诊单号,才能上传诊疗数据
4
医疗证/卡号
medcard_id
VARCHAR2(32)
Y
农民手持的证卡号码,与农合机构编码、人编码组合后,能确定当前参合年度内唯一参合人员。
5
户内个人编号
p_sn
CHAR
(2)
Y
户内流水号,取值范围01-99
6
患者姓名
name
VARCHAR2(20)
Y
7
患者性别
sex
CHAR
(1)
Y
S101-01性别编码
8
出生日期
birthdate
DATE
Y
9
年龄
age
NUMBER(3)
10
患者身份证号
idcard
VARCHAR2(18)
11
联系电话
phone
VARCHAR2(20)
12
行政区划编码
dist_code
CHAR(6)
Y
国家标准《中华人民共和国行政区划编码》GB/T2260-1999
13
就诊类型
visit_type
CHAR
(1)
S301-05就诊类型编码(默认为2,表示住院)
14
入院时间
adm_date
DATE
Y
15
出院时间
dis_date
DATE
出院时必填
16
实际住院天数
inpat_days
NUMBER(4)
17
就医机构代码
zyorg_code
VARCHAR2(32)
Y
S201-01卫生机构(组织)分类与编码(WS218-2002)
18
就医机构名称
zyorg_name
VARCHAR2(60)
Y
19
就医机构级别
zyorg_level
CHAR
(1)
S201-06医疗机构级别编码
20
入院科室代码
adm_deptcode
VARCHAR2(20)
Y
S201-03诊疗科室编码(详见《2007国家卫生统计调查制度》P386.医疗机构诊疗科目名录)
21
入院科室名称
adm_deptname
VARCHAR2(60)
Y
22
出院科室代码
dis_deptcode
VARCHAR2(20)
S201-03诊疗科室编码(详见《2007国家卫生统计调查制度》P386.医疗机构诊疗科目名录)
23
出院科室名称
dis_deptname
VARCHAR2(60)
24
经治医生
doctor
VARCHAR2(20)
25
入院状态
adm_state
CHAR
(1)
Y
S301-02入院状态编码
26
出院状态
maindiag_state
CHAR
(1)
S301-03出院状态编码
27
疾病代码
maindiag_code
VARCHAR2(32)
Y
S301-01疾病分类代码(ICD-10)
29
疾病名称
maindiag_name
VARCHAR2(100)
30
并发症代码
complication_code
VARCHAR2(32)
S301-01疾病分类编码(ICD-10)
31
并发症名称
complication_name
VARCHAR2(100)
32
手术名称代码
ops_code
VARCHAR2(32)
S301-08手术名称编码(ICD-9CM-3)
33
手术名称
ops_name
VARCHAR2(100)
34
病区号
ward_no
VARCHAR2(20)
35
病区名称
ward_name
VARCHAR2(100)
36
床位号
bed_no
VARCHAR2(20)
37
登记时间
opr_date
DATE
38
转往医院代码
trans_orgcode
VARCHAR2(32)
S201-01卫生机构(组织)分类与编码(卫生行业标准WS218-2002)
39
转往医院名称
trans_orgname
VARCHAR2(60)
40
转往医院级别
trans_orglevel
CHAR
(1)
S201-06医疗机构级别编码
41
民政通知书号
canotice_no
VARCHAR2(20)
42
生育证号
bearcard_no
VARCHAR2(20)
43
出院收据号
dis_recno
VARCHAR2(32)
44
实际住院费用合计(元)
total_fee
NUMBER(15,2)
45
实际住院床位费(元)
bed_fee
NUMBER(15,2)
46
实际住院护理费(元)
nurse_fee
NUMBER(15,2)
47
实际住院西药费(元)
wdrug_fee
NUMBER(15,2)
48
实际住院中药费(元)
cdrug_fee
NUMBER(15,2)
49
实际住院化验费(元)
test_fee
NUMBER(15,2)
50
实际住院诊疗费(元)
treat_fee
NUMBER(15,2)
51
实际住院手术费(元)
ops_fee
NUMBER(15,2)
52
实际住院检查费(元)
check_fee
NUMBER(15,2)
53
实际住院其他费用(元)
other_fee
NUMBER(15,2)
54
报送日期
send_date
DATE
Y
55
报送单位
send_com
VARCHAR2(200)
Y
56
报送人员
opr_code
VARCHAR2(20)
Y
57
患者体重
WEIGHT
NUMBER(8,2)
根据先心病补偿要求新增字段(2010.7.7)
⏹交易输入从XML(业务数据体)(XML节点定义:
ROW)
序号
入参说明
字段
最大长度
非空
注释
1
住院就诊流水号
his_link_code
VARCHAR2(256)
Y
HIS业务唯一键
医院业务系统内当次住院唯一标识码。
2
住院处方流水号
zyitem_link_code
VARCHAR2(256)
Y
一个病人一次住院费用明细流水号。
3
就医机构代码
zyorg_code
VARCHAR2(32)
Y
S201-01卫生机构(组织)分类与编码(WS218-2002)
4
住院号
inpat_no
VARCHAR2(32)
Y
5
开单时间
item_date
DATE
Y
6
项目类别
item_class
CHAR
(1)
Y
S301-041-药品2-医疗服务项目
7
项目省标编码
item_code
VARCHAR2(32)
Y
S501-01基本药品编码
/S301-04医疗服务项目编码
8
项目省标名称
item_name
VARCHAR2(60)
Y
9
项目本院编码
item_lcode
VARCHAR2(32)
Y
10
项目本院名称
item_lname
VARCHAR2(60)
Y
11
规格
specs
VARCHAR2(60)
12
剂型
drugform
VARCHAR2(30)
13
单位
unit
VARCHAR2(20)
14
单价
price
NUMBER(15,4)
Y
15
数量
amount
NUMBER(8,2)
Y
16
付数
count
NUMBER(8,2)
17
金额
money
NUMBER(15,2)
Y
18
医生姓名
doctor_name
VARCHAR2(20)
Y
经治医生
19
医生职务
doctor_title
VARCHAR2(20)
S101-08专业技术职务编码(参照国家标准GB/T8561-1988)
20
报送日期
send_date
DATE
Y
21
报送单位
send_com
VARCHAR2(200)
Y
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 湖南省 医院 信息系统 新农合 省级 平台 接口 调用 规范 0112