四川省医疗保障信息系统两定接口规范-扩展交易20231109.docx

四川省医疗保障信息系统两定接入医保支付接口编程接口规范-扩展交易
2021年05月
文件更改记录
变更说明
20210817 变更[Z1101] 城乡两病申请新增认定机构编码参数；
20210819 新增[S3902] 阳光救助信息上传，调整住院流程，为精神病阳光救助住院时，不在通过就医人员特殊属性上传阳光救助信息.通过此交易上传；
20210907 [S3901] 返出参数变更， [S5901]输入参数变更，安全控件input新增输入参数；
20211014 [S3903] 新增， [S3701][S5201]参数变更，新增规格参数，安全控件新增打印函数，详情请阅读第四章4.7内容；
20211022 新增6.4约束说明；
20211027 扩展字段入院办理新增参数ipt_psn_sp_type；
20211207 新增[S3501]异地结算费用对账交易，新增[S3203]异地清算申请交易，新增[S3204]异地清算申请撤销交易；
20220302 新增[S2101]共济账户下账，新增[S2102]共济账户下账撤销交易；
20220412 新增电子认证章节，必须安装最新的安全控件；
20220803 新增[S3701]门慢门特处方上传A，新增[S5201A]门慢门特处方查询A交易；
20220829 新增特药经办管理
20221015 新增电子凭证管理，包含[S3401]线上密码核验认证通知[S3402]线上密码核验认证查询
20221124 调整第7章exp_content参数内容，新增参数mdtrt_grp_type就医人群类，涉及交易[2401] [2403] [2206] [2206A] [2207] [2207A]；新增参数otp_er_refl_flag 门诊急诊转诊标志，涉及交易[2206] [2206A] [2207] [2207A]
20230217 新增[2401] [2403]扩展参数内容，新增参数rel_ttp_flag涉及第三方标志
20230222 新增[S5902]家庭成员个账共济绑定信息查询交易
20230315 yh_CHS_call input参数内容调整，新增参数opter opter_name office office_name business_type使用医保电子凭证时必填
20230427 yh_CHS_call input参数内容调整，新增参数device_type参数自助机使用医保电子凭证时必填，用码业务类型码值新增码值123 特殊门诊
20230529 yh_CHS_call input参数内容调整，用码业务类型码值新增码值306 诊间核验身份 124 药师审核处方
20230724 yh_CHS_call input参数内容调整，新增参数dev_sn设备sn编码，使用iot人脸识别设备时必填；
20230804 新增第9章重要业务说明章节，并添加电子结算凭证业务说明，新增[4901]约束说明
概述
《四川省医疗保障信息系统两定接入医保支付接口编程接口规范-扩展交易》（以下简称支付接口规范）的使用对象为定点医疗机构（HIS）供应商或其它应用软件供应商.
支付接口规范包括实现医疗保障信息平台定点基线版医药机构接口规范与四川省医疗保障信息系统两定接入医保支付接口编程接口规范-扩展交易接口交易服务，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法.（本规范 ，不含对全省医保政策和支付流程的介绍.）
接口调用实现方式
网络协议方式
服务地址
地址：咨询当地医保局
安全控件说明
术语及参考资料
COM： Common Object Model
HIS：Hospital Information System
MIS：Management Information System
接口调用实现方式
接口COM方式
应用模式
支付组件库是一组运行在WINDOWS环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它.
环境要求
硬件环境
网络环境
系统软件
接口描述
总体描述
组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；
接口交易组件库提供了三个公共方法(yh_CHS_init 初始化，yh_CHS_destroy 资源释放，yh_CHS_call业务方法调用)，交易参数组织采用JSON（医保经办机构交易调用及交易参数统一），差别处理对于HIS透明.
接口COM说明
组件库提供交易的COM组件属性如下：
交易接口函数描述
yh_CHS_init
原型定义：
yh_CHS_init(
ref long aint_appcode
ref string astr_appmsg)
yh_CHS_destroy
原型定义：
yh_CHS_destroy()
函数说明：
资源释放函数，在HIS应用退出时调用.
yh_CHS_call
原型定义：
yh_CHS_call（
string infno
string input
ref string output)
input、output参数均按照交易说明里参数组合，顺序无关.接口调用示例：
调用示例
VB调用
Dim yinhaiobject As Object '定义存放引用对象的变量.
Set yinhaiobject = CreateObject("YinHai.CHS.InterfaceSCS")
'检查连接是否建立
If yinhaiobject Is Nothing Then
MsgBox "对象为空!"
End If
Dim infno As String
Dim input As String
Dim output As String
infno ="1101"
input ="" '组织参数
yinhaiobject.yh_CHS_call infno input output
'判断返回信息
'HIS业务处理
Set yinhaiobject = Nothing '关闭对象
delphi调用
注意：delphi调用时先要 uses ComObj;否则不能引用oleobject.
Var
yinhaiobject: Variant; //定义存放引用对象的变量.
infno: String
input: String
output: String
Begin
try
yinhaiobject := CreateOleObject('YinHai.CHS.InterfaceSCS');
infno ='1101';
input ='' ;组织参数
yinhaiobject.yh_CHS_call(infno input output)
//返回结果判断，HIS内部处理
finally
yinhaiobject:=Unassigned;// 关闭对象
end;
End;
pb调用
oleobject yinhaiobject
long result infcode
String infno input output
yinhaiobject=create oleobject
result=yinhaiobject.ConnectToNewObject("YinHai.CHS.InterfaceSCS")
if result0 then
messagebox("error"，"fail to connect")
return
end if
infno ="1101"
input ="" '组织参数
yinhaiobject.yh_CHS_call(infno input output)
// 返回结果判断，HIS内部处理
// 关闭对象
yinhaiobject.DisconnectObject ( )
destroy yinhaiobject
input
表格 1
输入参数示例：
{
"tran_no":"1101"
"tran_time":"20210602122345"
"data":{
"fixmedins_code":"P51030200074"
"psn_no":""
}
}
output
表格 1
输出参数参考：
{
"code":"1"
"message":""
"data":{
"card_no":"510102199901010345"
"psn_name":"测试人"
"certno":"510102199901010345"
"psn_cert_type":"01"
"mdtrt_cert_type":"03"
"mdtrt_cert_no":"A510320222"
"card_sn":"6748757265145284237351523"
"insuplc_admdvs":"519900"
"card_token":"SDKSFJSGNICKSJDFKJGNIFNSIENDKFJ"
}
}
yh_CHS_print
原型定义：
yh_CHS_print（
string input
ref string output)
input、output参数均按照交易说明里参数组合，顺序无关.
input
表格 1
output
表格 1
安全控件调用说明
药店、门诊传入的交易号，一次就医行为调用安全控件可以只调用一次（包括身份识别1101），传入的交易号为当次医疗行为最后一个交易号；
例：门诊业务时传入（2207或2207A）门诊结算调用安全控件，获取到的校验介质，可以在2201至2206或1101业务场景使用.若使用2201交易号获取校验介质，只能在2201业务场景使用；
住院行为需要每次调用安全控件获取校验介质；
预结算类交易不校验介质，可以为空.但就诊凭证类型及就诊凭证编号必须准确；
调用流程图
扩展交易内容
基础信息获取
其他信息
【S1101】获取中心通知消息
交易说明
通过此交易获取中心通知消息.
重点说明
交易对象
交易发送方：医疗机构.
交易接收方：地方医保局.
输入
输出
【S1102】获取险种封顶线
交易说明
通过此交易获取险种封顶线.
重点说明
交易输入为单行数据，交易输出为多行输出
交易对象
交易发送方：医疗机构.
交易接收方：地方医保局.
输入
表 1 输入（节点标识：data）
输出
表 204 输出（节点标识：result）
医保结算
共济账户结算
【S2101】共济账户下账
交易说明
通过此交易共济账户下账.
重点说明
交易输入为单行数据，输出为单行数据
可进行冲正
医疗机构需确认双方关系属实
接口流程图
交易对象
交易发送方：医疗机构.
交易接收方：地方医保局.
输入
表 1 输入-基础信息（节点标识：data）
表 2 输入-字段扩展（节点标识：expContent）
输出
表 1 输出（节点标识：result）
表 2 输出-结算基金分项信息（节点标识：setldetail）
【S2102】共济账户下账撤销
交易说明
通过此交易撤销共济账户下账.
重点说明
交易输入为单行数据，输出为单行数据
交易对象
交易发送方：医疗机构.
交易接收方：地方医保局.
接口流程图
输入
表 1 输入-基础信息（节点标识：data）
输出
表 2 输出（节点标识：result）
表 3 输出-结算基金分项信息（节点标识：setldetail）
医药机构服务
特药经办管理
特药经办流程图
结算说明：
调用基线版2101A进行特药预结算，医疗类别传入特药结算(1801 单行 1802 高值)
调用基线版2102A进行特药结算.
调用基线版2103进行特药结算撤销.
rxno传入特药处方号.
治疗机构
供药机构
【S3111】特药病种认定信息上传
交易说明
通过此交易上传特药病种认定信息.
重点说明
交易输入病种信息为单行数据，建议治疗方案为多行数据.
交易输出为单行数据.
交易对象
交易发送方：医疗机构.
交易接收方：地方医保局.
输入
表 1 输入-病种信息（

投稿会员：匿名用户