湖南省医院信息系统与新农合省级平台接口调用规范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"?
>
H1020101
0103G0041741912A100
4310240
V1.0
0103G0041741912A100
4310240
4310241405070003
张山
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.接口调用参数说明
●ListfindService（StringIn_aqyz_XML,StringIn_gnbh,StringIn_jysr_XM）
入口参数描述:
参数名称
参数说明
参数类型
参数类别
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"?
>
H1020101
0103G0041741912A100
4310240
V1.0
0103G0041741912A100
4310240
4310241405070003
张山
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'?
>
填写7位的农合机构编码（必填项目）
农合机构名称
填写相应的key
填写相应的密码
⏹功能编码：
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
升级会员 