成都市医保支付接口规范V50.docx

成都市医保支付接口规范V50.docx

《成都市医保支付接口规范V50.docx》由会员分享，可在线阅读，更多相关《成都市医保支付接口规范V50.docx（172页珍藏版）》请在冰豆网上搜索。

成都市医保支付接口规范V50

成都市基本医疗保险

支付接口应用编程规范

Version

2015年06月

1、变更说明

2009-3-9文字错误更正

日常修正：

门诊结算11交易的controlXML漏写接口版本标志

身份识别03交易的输出XML在个人帐户余额一段多写了，去掉。

14A和14B交易的节点数据类型注释中yke170应为yae170

2009-3-16调整输入输出节点

日常修正：

20交易增加返回节点，不影响业务

17交易增加返回节点，不影响业务

14A、14B、16交易删除【yka105记账流水号】节点

03、11交易controlXML节点改名，【version】改为【edition】（因version之前已使用）

2009-3-19调整输入输出节点

日常修正：

16交易返回节点【YKE141】，应为【YKC141】

2009-3-27交易41、52调整

明细冲负及打印预结算单调整：

41交易数量可以传入负数。

HIS可以通过传入负数的数量或43交易两种方式来退明细

52交易：

住院结算。

控制xml中增加一个节点是否打印预结算单。

预结算单不能作为报销凭据，仅提供给参保人查看。

如果该节点为1，则表示是打印预结算单。

其他值或者无此节点，表示住院结算。

注意：

（1）打印出预结算单可能和正式结算有差异，因为在预结算和正式结算之间，个人的信息可能改变，费用明细可能改变等原因。

（2）当打印预结算单时，交易标志aint_appcode返回的值总是小于零的。

2010-6-28门诊统筹相关交易变更说明：

门诊统筹项目：

100交易：

医院医保信息新增申请

说明：

新增交易

101交易：

医院医保信息停用申请

说明：

新增交易

102交易：

医院医保信息查询

说明：

新增交易

103交易：

药品新增申请

说明:

新增交易

104交易：

医院药品对码

说明:

新增交易

105交易：

医院药品停用申请

说明：

新增交易

106交易：

医院医保药品目录查询

说明：

新增交易

107交易：

药品基本信息查询

说明：

新增交易

108交易：

挂号费项目查询

说明：

新增交易

110交易：

门诊挂号

说明：

新增交易

111交易：

门诊明细上传

说明：

新增交易，本交易在医院医生工作站进行实时传输中医电子处方信息、西医电子处方信息、医嘱信息、门诊病例信息、检查信息、手术信息、中医四诊、挂号信息、服务对象信息

11交易：

门诊结算

说明：

门诊明细上传后，可根据记帐流水号选择需要结算的明细费用

12交易：

门诊结算回退

说明：

增加支持挂号结算回退

30交易：

查询住院和门诊统筹支付限额和不支付原因

说明：

支持门诊统筹查询

43交易：

住院和门诊费用明细退单

说明：

支持门诊统筹费用退单

55交易：

医保基金详单打印

说明：

支持门诊统筹汇总单据、门诊统筹明细单据打印

71交易：

清算申请

说明：

支持城职门诊统筹、城乡门诊统筹清算

2010-8-27交易16，25变更说明：

门特信息扩展完善：

16交易：

交易增加人员所申请过的门诊特殊病病种查询

25交易：

交易输入xml串增加病人联系电话、诊疗过程描述节点

2011-4-15交易52变更，118新增说明：

单病种项目：

52交易：

增加病种编码，病种名称及医院负担部分节点

118交易：

查询单病种编码，ICD码和手术信息查询

2013-07-31变更120，121，122新增说明

新门特项目：

14a交易增加病种编码节点

14b交易增加病种编码节点

16交易增加病种编码节点

20交易增加新门特医院结算节点

20a交易增加新门特医院结算节点

41交易增加病种编码节点

120交易病种认定交易（新增交易）

121交易一般诊疗费置标（新增交易）（一般诊疗费置标）

122交易病种认定查询交易

2013-10-24新增123，124说明

工伤康复项目：

123交易工伤康复住院上传治疗方案

124交易工伤康复住院撤消治疗方案

20交易交易输入添加节点疾病诊断序号

03交易添加工伤诊断输出节点多row

14A添加传入节点门特结束时间（针对工伤联网部分）

2014-9-1修改说明

接口部分：

以下涉及到修改的交易编号（11、111、21、23、25等，除28a、28b类查询交易），在control节点都需要传入edition节点，固定值为

25交易在ykd018dataset节点下增加中西医诊断信息节点。

11交易中yke112医嘱记录序号字段为必传项，其对应的医嘱信息使用31号交易上传。

考虑到时效性，医嘱信息允许事后上传。

其中医嘱记录序号允许对应多条费用信息。

增加31A、31B、31C、31D交易

34交易增加医嘱信息的输出

111交易中对医嘱节点增加结构化数据

25交易中增加yke659医疗付款方式、yke663出院科室编码、yke664实际住院天数、yke665离院方式

21交易增加yke660入院途径、yke380婚姻状况类别代码、aae004联系人姓名、yke661联系人关系、aae005联系电话、yke662入院科室编码

23交易增加yke660入院途径、yke380婚姻状况类别代码、aae004联系人姓名、yke661联系人关系、aae005联系电话、yke662入院科室编码

28a,28b增加对输入字段的输出

增加127、128、129号交易

增加130、131号交易

增加42A、42B、42C号交易

11/41/111交易增加ake005,yka059节点

1、判断kb01kae

如果存在医院编码对应的数据

2、解析明细中的ake005,yka059节点

3、调用（akb020,ake005,yka059

）过程记录

增加132号交易诊疗使用设备编码上传

2014-10-26修正说明

接口部分：

需注意以下交易11,31,34,111

由原<医院对码编码>节点信息,修正为以下节点信息:

医院对码编码

2015-06-05修正说明

络氨酸激酶抑制剂部分：

1、新增135交易：

络氨酸激酶抑制剂认定申请

2、新增136交易：

络氨酸激酶抑制剂认定复核结果查询

3、新增137交易：

酪氨酸激酶抑制剂方案申请

4、新增137A交易：

酪氨酸激酶抑制剂方案申请回退

5、新增137B交易：

酪氨酸激酶抑制剂就诊登记

6、新增137E交易：

酪氨酸激酶抑制剂就诊登记回退

7、新增138交易：

酪氨酸激酶抑制剂结算

8、新增139交易：

酪氨酸激酶抑制剂结算回退

9、新增140交易：

酪氨酸激酶抑制剂方案变更申请

2016-05-18修正说明

异地门特部分：

1、03交易新增返回参数，人员特慢病病种编码（ICD10）

2、新增yd11交易：

异地门诊结算

3、新增yd12交易：

异地结算回退

2、概述

《成都市基本医疗保险支付接口应用编程规范（Version）》（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。

规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。

规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。

术语及参考资料

COM：

CommonObjectModel

HIS：

HospitalInformationSystem

MIS：

ManagementInformationSystem

应用模式

银海医保支付组件库是一组运行在WINDOWS32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。

环境要求

硬件环境

指标

指标值

CPU

≧

Memory

≧256MB

HardDisk

≧100M（free）

NetCard

≧10MB

网络环境

指标

指标值

协议

TCP/IP、HTTP/HTTPS

广域网带宽

≧56k

网络连接

客户端直接访问医保中心网络

系统软件

指标

指标值

操作系统

WIN98SE或WIN2000及以上WIN系列操作系统

辅助软件

接口描述

总体描述

组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；

接口交易组件库提供了六个公共方法（yh_interface_init初始化，yh_interface_destroy资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询），交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。

新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。

接口COM说明

组件库提供交易的COM组件属性如下：

属性

值

AppID

{5767E3DB-64CF-46B0-8997-04CC6506CA37}

TypeLibraryID

{A6C75A98-FC7F-456A-9E2D-4141CC758C63}

ProgramID

ClassName

CoClass_n_yh_interface

COMClassID

{1FB2A005-1AAF-42BD-A95E-AED025ABD75B}

InterfaceType

DualInterface

InterfaceName

In_yh_interface

InterfaceID

{BC708B00-5ED0-4DC7-8345-14FA94D5F840}

交易接口函数描述

yh_interface_init

原型定义：

yh_interface_init（

reflongaint_appcode,

refstringastr_appmsg）

yh_interface_init2

yh_interface_init2（stringastr_parmxml,

reflongaint_appcode,

refstringastr_appmsg）

astr_parmxml：

11:

表示异步执行确认或取消0：

表示同步执行

astr_parmxml:

函数说明：

初始化函数，HIS应用启动时调用，进行医保交易处理初始化，本交易调用成功后才能进行其他交易处理。

yh_interface_destroy

原型定义：

yh_interface_destroy（）

函数说明：

资源释放函数，在HIS应用退出时调用。

yh_interface_call

原型定义：

yh_interface_call（

stringastr_jybh,

stringastr_jykz_xml,

stringastr_jysr_xml,

refstringastr_pcbh,

refstringastr_jylsh,

refstringastr_jyyzm,

refstringastr_jysc_xml,

reflongaint_appcode,

refstringastr_appmsg）

参数名称

参数含义

参数类型

参数类别

参数说明

astr_jybh

交易编号

String

入口参数

具体的交易代码见〖交易列表〗

astr_jykz_xml

交易控制

String

入口参数

xml方式，组织方式见业务说明

astr_jysr_xml

交易输入

String

入口参数

xml方式，组织方式见业务说明

astr_pcbh

批次编号

String

出口参数

与签到交易中返回的值相同，用于标识签到与支付数据的相关性

astr_jylsh

交易流水号

String

出口参数

唯一标识一次交易，VARCHAR（20）

astr_jyyzm

交易验证码

String

出口参数

处理类交易返回，确认交易时传入

VARCHAR（15）

astr_jysc_xml

交易输出

String

出口参数

xml方式，组织方式见业务说明

aint_appcode

交易标志

long

出口参数

小于0均为失败。

此值数据类型是整数，范围为-48to+47

astr_appmsg

交易信息

String

出口参数

错误信息描述。

aint_appcode小于0时存放错误描述，其他aint_appcode不用关心该参数内容。

函数说明：

交易主函数，完成所有医疗业务的实际处理。

由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入HIS系统事务管理。

在交易接口函数定义中，传递的参数都是字符串。

但是在交易详细说明中，数据类型都是逻辑类型，常用类型有三种：

string,number,datetime，下面的表格描述了交易接口进行类型转换的限制和说明。

数据类型

空字符串

格式不合法

其它说明

string

视同空串

无

无特别说明标注的长度为最大长度

number

视同0

返回错误

无特别说明标注的长度为最大长度（小数尾数同）

datetime

视同空值

返回错误

足19位长，格式如下：

YYYY-MM-DDhh24:

mm:

ss

date

视同空值

返回错误

足19位长，格式如下：

YYYY-MM-DD00:

00:

00

astr_jykz_xml、astr_jysr_xml、astr_jysc_xml参数均按照交易详细说明里xml参数组合，顺序无关。

接口调用示例：

VB调用

DimyinhaiobjectAsObject'定义存放引用对象的变量。

Setyinhaiobject=CreateObject（""）

'检查连接是否建立

IfyinhaiobjectIsNothingThen

MsgBox"对象为空!

"

EndIf

DimBusinessIDAsString

DimCtrlxmlAsString

DimDataxmlAsString

DimPcbhAsString

DimBusinesssequenceAsString

DimBusinessvalidateAsString

DimOutputxmlAsString

DimAppcodeasLong

DimAppmsgAsString

BusinessID="01"

Ctrlxml=""'组织参数

Dataxml=""'组织参数

BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg

'判断返回信息

'HIS业务处理

Setyinhaiobject=Nothing'关闭对象

delphi调用

注意：

delphi调用时先要usesComObj;否则不能引用oleobject。

Var

yinhaiobject:

Variant;

1.

ml

交易输出：

代码

名称

约束

类型

说明

filename

文件名称

NOTNULL

VARCHAR（20）

文件名称只包含字母和数字，扩展名为.xml

文件内容：

就诊编码

结算编号

报销类型

社保经办机构

中心业务经办时间

支付类别

个人编码

费用总额

社保基金支付总额

【城镇职工社保基金支付】、【城乡居民社保基金支付】、【工伤保险基金支付】、【生育保险基金支付】等4项之和。

个人帐户支付总额

城镇职工的【个人帐户支付总额】或城乡居民的【门诊定额补助总额】

…

代码

名称

约束

类型

说明

akc190

就诊编码

NOTNULL

VARCHAR（20）

结算交易或入院交易返回标识一次就诊行为

yka103

结算编号

NOTNULL

VARCHAR（20）

结算交易返回，标识一次结算行为

ykd007

报销类型

NOTNULL

VARCHAR（4）

结算交易返回，标识正常结算和退单，详细信息参见代码表

yab003

社保经办机构编号

NOTNULL

VARCHAR（4）

结算时返回

aae036

中心业务经办时间

NOTNULL

DATETIME

结算中心记录写入时间

aka130

支付类别

NOTNULL

VARCHAR（4）

结算时返回

aac001

个人编码

NOTNULL

VARCHAR（20）

结算时返回

yka055

费用总额

NOTNULL

NUMBER（14,2）

ykh011

社保基金支付总额

NOTNULL

NUMBER（14,2）

医保基金支付部分，不含个人帐户支付，同结算时返回yka107金额

yka065

个人帐户支付总额

NOTNULL

NUMBER（14,2）