四川省城镇居民基本医疗保险接口规范.docx
《四川省城镇居民基本医疗保险接口规范.docx》由会员分享，可在线阅读，更多相关《四川省城镇居民基本医疗保险接口规范.docx（86页珍藏版）》请在冰豆网上搜索。
四川省城镇居民基本医疗保险接口规范
四川省城镇居民基本医疗保险
定点医疗机构联网结算
接口规范
2009年3月
目录
1概述4
1.1术语及参考资料4
1.2应用模式4
1.3环境要求4
1.4硬件环境4
1.4.1网络环境5
1.4.2系统软件5
2接口描述5
2.1总体描述5
2.2接口COM说明6
3交易类型6
4初始化调用6
5接口升级7
6调用示例7
6.1VB7
6.2PB8
6.3DELPHI9
7交易处理流程10
7.1查询交易、类查询交易、打印交易流程10
7.2处理交易流程11
8处理交易的不同宕机点和相应的处理11
9交易接口描述12
9.1初始化12
9.2正常交易13
9.3确认交易13
9.4取消交易13
10错误信息的处理14
10.1Call方法的错误信息14
10.2Confirm方法的错误信息14
10.3Cancel方法的错误信息：
同Confirm方法14
11业务定义14
11.1卡密码修改（02）14
11.1.1正常交易14
11.1.2确认交易15
11.1.3取消交易15
11.2获取个人基本信息（03）15
11.3门诊（含门诊大病）结算（11）16
11.3.1正常交易16
11.3.2确认交易19
11.3.3取消交易19
11.4门诊（含门诊大病）结算退单（12）19
11.4.1正常交易19
11.4.2确认交易20
11.4.3取消交易20
11.5打印门诊结算单（13）21
11.5.1正常交易21
11.6入院办理（21）21
11.6.1正常交易21
11.6.2确认交易23
11.6.3取消交易23
11.7入院信息修改（22）23
11.7.1正常交易23
11.8入院办理退单（23）24
11.8.1正常交易24
11.9住院消费明细写入（31）25
11.9.1正常交易25
11.10住院费用明细退单（32）27
11.10.1正常交易27
11.11出院结算（41）29
11.11.1正常交易29
11.11.2确认交易30
11.11.3取消交易31
11.12住院结算退单（42）31
11.12.1正常交易31
11.12.2确认交易32
11.12.3取消交易32
11.13打印住院结算单（43）32
11.13.1正常交易32
11.14出院预结算（44）33
11.14.1正常交易33
11.15获取中心目录更新版本（80）34
11.16药品目录增量下载（81）35
11.17诊疗目录增量下载（82）36
11.18下载服务设施目录（83）37
11.19住院单病种目录增量下载（84）38
11.20门诊慢性病增量下载（8539
11.21下载社保经办机构编码（86）40
11.22下载代码值含义（87）41
11.23疾病目录编码（88）42
11.24医疗机构目录比对关系上传（90）43
11.24.1正常交易43
11.25医疗机构目录比对关系审核查询（9144
11.25.1正常交易44
11.26查询病人费用明细（45）44
11.27查询病人就诊信息（46）46
11.28查询接口消息（92）47
11.29查询中心不确定交易（98）48
1概述
1.1术语及参考资料
COM：
CommonObjectModel
HIS：
HospitalInformationSystem
MIS：
ManagementInformationSystem
1.2应用模式
城镇居民基本医疗保险定点医疗机构联网结算支付接口组件库是一组运行在WINDOWS32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。
1.3环境要求
1.4硬件环境
指标
指标值
CPU
≧1.6MHz
Memory
≧256MB
HardDisk
≧100M（free）
NetCard
≧10MB
1.4.1网络环境
指标
指标值
协议
TCP/IP、HTTP/HTTPS
广域网带宽
≧56k
网络连接
客户端直接访问医保中心网络
1.4.2系统软件
指标
指标值
操作系统
WIN98SE、WIN2000及以上WIN系列操作系统
辅助软件
IE6.0
Msxml4.0
2接口描述
2.1总体描述
组件库注册在每一台需要进行城镇居民基本医疗保险联网支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将城镇居民基本医疗保险联网支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；
接口交易组件库提供了六个公共方法（yh_interface_init初始化，yh_interface_destroy资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询），交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。
接口存在多医保经办中心处理，并且各医保经办中心处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。
2.2接口COM说明
组件库提供交易的COM组件属性如下：
属性
值
AppID
TypeLibraryID
ProgramID
YINHAI.SCYBINTERFACE
COMClassName
CoClass_n_yh_interface
COMClassID
InterfaceType
DualInterface
InterfaceName
In_yh_interface
InterfaceID
3交易类型
●查询交易：
只对数据进行查询，不对数据进行处理；不返回交易流水号
●类查询交易：
要对数据进行处理，返回交易流水号；
●打印交易：
只对数据进行查询和展示，不对数据进行处理；不返回交易流水号
●处理交易：
对中心数据进行操作，需要保持中心、HIS的数据一致性。
一次完整的交易可以有三种方式；
1）只有处理流程，符合情况是处理流程执行失败。
接口将会自动取消对医保经办中心数据的操作，不需要HIS再调用取消流程。
2）处理流程＋确认流程，符合情况是处理流程执行成功，HIS处理也成功，调用确认流程
3）处理流程＋取消流程，符合情况是处理流程执行成功，HIS处理失败，调用取消流程
4初始化调用
本接口使用Powerbuilder开发，发布的动态链接库文件注册后以OLE对象为HIS所调用。
该OLE对象名称为【YINHAI.SCYBINTERFACE】。
HIS首先创建与该OLE对象的连接，执行初始化操作。
初始化调用函数为yh_interface_init（本文后面有调用说明）。
初始化只需要在连接OLE对象后调用一次即可。
以下是一个PB调用接口的简单例子：
OleObjectyinhaiobject
Integergi_result,li_appcode
Stringls_appmsg
yinhaiobject=CREATEOleObject
gi_result=yinhaiobject.ConnectToNewObject（"YINHAI.SCYBINTERFACE"）
IFgi_result<>0THEN
//发生错误，关闭对象
yinhaiobject.DisConnectObject（）
RETURN
ENDIF
yinhaiobject.yh_interface_init（REFli_appcode,refls_appmsg）
IFli_appcode<=0THEN
yinhaiobject.DisConnectObject（）
//ls_appmsg里面是错误信息
RETURN
ENDIF
接下来，可以在其他业务中调用接口方法yh_interface_call，yh_interface_confirm，yh_interface_cancel与中心交互了。
5接口升级
由于政策变动、业务调整等原因，接口存在升级的可能，为保证各定点医疗机构前端业务正常开展，新的接口库发布遵循向下兼容原则（即三方接口商在未完成接口改造前，先前接口可以继续使用，只是部门变动业务受限）。
为方便三方接口商接口部署，医保经办中心提供接口库升级平台，实现医院接口库的自动升级更新（医院部署操作参照《接口库自动升级程序部署指南》）。
6调用示例
6.1VB
DimyinhaiobjectAsObject'定义存放引用对象的变量。
Setyinhaiobject=CreateObject（"YINHAI.SCYBINTERFACE"）
'检查连接是否建立
IfyinhaiobjectIsNothingThen
MsgBox"对象为空!
"
EndIf
DimBusinessIDAsString
DimCtrlxmlAsString
DimDataxmlAsString
DimPcbhAsString
DimBusinesssequenceAsString
DimBusinessvalidateAsString
DimOutputxmlAsString
DimAppcodeasLong
DimAppmsgAsString
BusinessID="01"
Ctrlxml=""'组织参数
Dataxml=""'组织参数
yinhaiobject.yh_interface_callBusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg
'判断返回信息
'HIS业务处理
Setyinhaiobject=Nothing'关闭对象
6.2PB
oleobjectyinhaiobject
longresult,Appcode
StringBusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence
StringBusinessvalidate,Outputxml,Appmsg
yinhaiobject=createoleobject
result=yinhaiobject.ConnectToNewObject（"YINHAI.SCYBINTERFACE"）
ifresult<>0then
yinhaiobject.yh_interface_destroy（）
yinhaiobject.disconnectobject（）
messagebox（"error"，"failtoconnect"）
return
endif
BusinessID=”01”
yinhaiobject.yh_interface_call（BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg）
//返回结果判断，HIS内部处理
//关闭对象
yinhaiobject.DisconnectObject（）
destroyyinhaiobject
6.3DELPHI
注意：
delphi调用时先要usesComObj;否则不能引用oleobject。
Var
yinhaiobject:
Variant;//定义存放引用对象的变量。
BusinessID:
String
Ctrlxml:
String
Dataxml:
String
Pcbh:
String
Businesssequence:
String
Businessvalidate:
String
Outputxml:
String
Appcode:
integer
Appmsg:
String;
Begin
try
yinhaiobject:
=CreateOleObject（'YINHAI.SCYBINTERFACE'）;
BusinessID:
='01';
yinhaiobject.yh_interface_call（BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg）
//返回结果判断，HIS内部处理
finally
yinhaiobject:
=Unassigned;//关闭对象
end;
end;
7交易处理流程
7.1
查询交易、类查询交易、打印交易流程
7.2处理交易流程
8处理交易的不同宕机点和相应的处理
1、处理流程处理完毕
2、调用成功
3、HIS处理完毕
4、处理失败
5、处理成功
在上面5个点系统宕机，系统重新启动后，都没有办法直接决定调用【取消流程】还是【确认流程】；对于这种情况，应该查询出没有调用【取消流程】或【确认流程】的交易，再根据这些交易出的相关信息，查询HIS系统的情况，决定调用【取消流程】还是【确认流程】。
不同的交易，判断不同；
比如：
门诊结算
1）如果HIS系统有相应的结算信息，则应该调用确认流程
2）如果HIS系统没有相应的结算信息，则应该调用取消流程
门诊结算回退
1）如果HIS系统有相应的结算信息，或者没有相应的退单信息，则调用取消流程
2）如果HIS系统没有相应的结算信息，或者有相应的退单信息，则调用确认流程
9交易接口描述
9.1初始化
●yh_interface_init（refli_appcode,refls_appmsg）
参数名称
参数说明
参数类型
参数类别
li_appcode
交易标志
Int
出口参数
ls_appmsg
交易信息
String
出口参数
注：
可从本方法返值中取得医疗机构名称，以判断医疗机构配置是否正确。
Ø调用方法：
Stringls_retxml
ls_retxml=yh_interface_init（refli_appcode,refls_appmsg）
Ø返回xml串格式：
xmlversion="1.0"encoding="gb2312"?
standalone="yes"?
>
1
接口初始化成功
医疗机构名称
9.2正常交易
●yh_interface_call（astr_jybh,lstr_jykz_xml,lstr_jysr_xml,reflstr_pcbh,reflstr_jylsh,reflstr_jyyzm,reflstr_jysc_xml,reflint_appcode,reflstr_appmsg）
参数名称
参数说明
参数类型
参数类别
Astr_jybh
交易编号
String
入口参数
Astr_jykz_xml
交易控制xml
String
入口参数
Astr_jysr_xml
交易输入xml
String
入口参数
Lstr_pcbh
批次编号
String
出口参数
lstr_jylsh
交易流水号
String
出口参数
lstr_jyyzm
交易验证码
String
出口参数
lstr_jysc_xml
交易输出xml
String
出口参数
Lint_appcode
交易标志
Int
出口参数
Lstr_appmsg
交易信息
String
出口参数
9.3确认交易
●yh_interface_confirm（lstr_jylsh,lstr_jyyzm,reflint_appcode,reflstr_appmsg）
参数名称
参数说明
参数类型
参数类别
lstr_jylsh
交易流水号
String
入口参数
astr_yke203
交易验证码
String
入口参数
Lint_appcode
交易标志
Int
出口参数
Lstr_appmsg
交易信息
String
出口参数
9.4取消交易
●yh_interface_cancel（lstr_jylsh,reflint_appcode,reflstr_appmsg）
参数名称
参数说明
参数类型
参数类别
Astr_jylsh
交易流水号
String
入口参数
Lint_appcode
交易标志
Int
出口参数
Lstr_appmsg
交易信息
String
出口参数
10错误信息的处理
10.1Call方法的错误信息
可以划分为两种类型的错误
1、系统错误
系统错误主要是网络等的错误，所对应的交易处理状态为：
中心处理失败
将调用取消交易进行后续处理
2、应用错误
应用错误主要是业务办理失败，所对应的交易处理状态为：
中心取消成功
该类型的错误不需要有后续业务进行处理
10.2Confirm方法的错误信息
也可以划分为两种类型的错误，但是不同的是，两种错误的后续处理都相同，一定要处理成功
10.3Cancel方法的错误信息：
同Confirm方法
11业务定义
注意：
标注为本颜色的暂时不使用
11.1卡密码修改（02）
11.1.1正常交易
交易类型
类查询交易
交易说明
1.中心根据卡类读卡或刷卡，参保人员录入原密码、新密码。
2.中心验证卡及密码信息，并根据验证结果确定是否修改密码，
输入参数
交易编号
02
交易控制xml
xmlversion="1.0"encoding="gb2312"?
>
交易输入xml
xmlversion="1.0"encoding="gb2312"?
>
经办人--参数类型:
String（20）NOTNULL
输出参数
交易流水号
返回，标识本次交易
交易验证码
交易输出xml
xmlversion="1.0"encoding="gb2312"standalone="yes"?
>
交易标志
大于0表示成功
交易信息
交易标志小于等于0时返回错误信息
11.1.2确认交易
交易类型
类查询交易
交易说明
类查询交易不需确认
输入参数
交易流水号
本次正常交易产生的流水号
交易验证码
本次正常交易产生的验证码
输出参数
交易标志
大于0表示成功
交易信息
交易标志小于等于0时返回错误信息
11.1.3取消交易
交易类型
处理交易
交易说明
类查询交易不能取消
输入参数
交易流水号
本次正常交易产生的流水号
交易验证码
本次正常交易产生的验证码
11.2获取个人基本信息（03）
交易类型
查询交易
交易说明
1．返回人员基本信息及待遇状态。
输入参数
交易编号
03
交易控制xml
xmlversion="1.0"encoding="gb2312"?
>
交易输入xml
NULL
输出参数
交易流水号
NULL
交易验证码
NULL
交易输出xml
xmlversion="1.0"encoding="gb2312"standalone="yes"?
>
个人编号--参数类型:
String（10）
姓名--参数类型:
String（20）
性别--参数类型:
String（3）（1:
男，2：
女）
出生日期--参数类型:
String（10）格式:
yyyy-mm-dd
单位编码--参数类型：
String（10）
单位名称--参数类型:
String（50）
医保待遇类别--参数类型:
String（3）（代码表）
居民医保人员类型代码 --参数类型：
String（3）
居民医保人员类别代码--参数类型：
String（3）
医疗保险个人账户余额--参数类型：
String（20）
基本医疗统筹基金待遇享受状态--参数类型:
String
（1）（0:
不可享受，1:
可享受）
补充医疗待遇享受状态--参数类型:
String
（1）（0:
不可享受，1:
可享受）
公务员补助享受状态--参数类型:
String
（1）（0:
不可享受，1:
可享受）
医疗保险险种类型--参数类型：
String（3）NOTNULL
医疗保险经办机构编码--参数类型:
String（4）
职工医保医疗照顾人员等级--参数类型:
String（3）
年度统筹住院可报销金额--参数类型:
NUMBER
年度补充医疗住院可报销金额--参数类型:
NUMBER
年度门诊统筹可报销金额--参数类型:
NUMBER
交易标志
大于0表示成功
交易信息
交易标志小于等于0时返回错误信息
11.3门诊（含门诊大病）结算（11）
11.3.1正常交易
交易类型
处理交易
交易说明
1.传入药品、诊疗数据
2.中心计算并返回
升级会员 