定点医疗机构API开发基础手册.doc

文档编号：DX12L002
分册名称：定点医疗机构API开发手册 第2.0 版

定点医疗机构API开发手册

河北东软软件有限公司

1月1日

版权声明

《定点医疗机构API开发手册》版权归河北东软软件有限公司所有。未经河北东软软件有限公司书面准许，不得将本规范任何内容以任何形式、任何手段（电子或机械，涉及照相复制或录制）、或为任何目，进行复制或扩散。

版权所有，翻制必究。
Copyright@ 河北东软软件有限公司。

文档修改历史
版本
修改记录
修改日期
修改人
0.5
增长开发险种范畴、安全机制、将HIS流程阐明放到前面，惯用API接口函数简介
-7-15
薛亚玲
0.6
增长和修改文档中某些阐明
-7-21
陈晓明
0.61
Comminterface医疗类型入参增长医疗类别。调节API常用流程简介
-7-23
薛亚玲
0.62
接口表KC22主键去掉AAE040
-7-26
薛亚玲
0.63
预结算、结算去掉支付方式、经办人、账户支付金额；读人员审批信息去掉审批类别
-8-10
薛亚玲
0.64
将读卡、读取封锁、读取审批合并；将读药物、读诊断对照信息合并；去掉疾病和批量读取收费项目对照信息。
-8-12
薛亚玲
0.65
接口表KC22，增长每次用量单位AKA076,KC21增长患者联系电话PHONE
-8-17
薛亚玲
0.66
读卡身份验证，增长两个返回值：结算年月，定点医疗机构编号。
-8-20
武刚
0.67
修改xml字符串格式为小写
-8-26
陈晓明
0.68
修改门诊预结算和住院预结算出参
-9-6
陈晓明
0.69
修改kc22表构造，去掉aae040,zka101,aae073,ckc048,ckc125
-9-13
武刚
0.70
修改xml字符串示例，使之与kc22表构造一致
-9-13
武刚
0.71
调节kc21表构造
-9-13
武刚
0.81
读卡身份验证增长疾病编码
-9-21
薛亚玲
0.82
去掉入院登记回退业务
-11-09
薛亚玲
0.83
支持环境增长大医院模式使用oracle 10g版本
-11-10
薛亚玲
0.84
修改入院登记传入参数
-11-17
陈晓明
0.85
修改xml字符串示例
-11-18
陈晓明
0.86
医疗类别去掉半途结算与年终结算，住院结算参数增长结算方式（1-普通住院结算，2-半途结算，3-年终结算）
-11-19
薛亚玲
0.87
增长医保结算成功his失败后，如何解决问题
-12-01
薛亚玲
0.9
定版0.9.0.9遗留问题：HIS传播费用明细后，如果费用级别发生变化，再次传入负记录也不能解决问题，需提供专门退费函数来解决。接口函数增长参数中不能具有”#”;增长示例三
-12-08
薛亚玲
0.91
增长错误信息列表、验收原则；住院结算函数增长入参费用总额；database.ini改名为neuqhd.ini;增长病历号
-12-09
薛亚玲
0.92
修改住院费用明细修改调用流程
-12-22
陈晓明
0.93
门诊预结算、住院预结算增长返回参数
-01-14
陈晓明
目 录
第一章 概述 7
§1.1 背景 7
§1.2 API接口开发险种范畴 7
§1.3 API接口开发安全机制 7
§1.4 API接口数据流图 8
§1.5 支持环境规定 9
§1.6 术语 9
第二章 迅速上手 10
§2.1 结识API接口构成 10
§2.2 创立接口表 11
§2.3 定点结算系统登录顾客信息对照 12
§2.4 ODBC配备 14
§2.5 三目编码对照 14
§2.5.1 药物对照 15
§2.5.2 诊断对照 16
§2.5.3 疾病编码对照维护 16
§2.6 示例一：入院登记解决 17
第三章 API接口函数阐明 18
§3.1 API函数参数阐明 18
第四章 HIS调用API接口函数流程阐明 20
§4.1 门诊某些 20
§4.1.1 门诊结算 20
§4.1.2 门诊结算回退 21
§4.2 住院某些 22
§4.2.1 入院登记 22
§4.2.2 住院登记信息修改 22
§4.2.3 住院费用录入（或执行医嘱） 23
§4.2.4 住院费用明细修改 24
§4.2.5 住院结算 26
§4.2.6 住院结算回退 27
§4.3 单据格式 27
§4.3.1 门诊结算单 27
§4.3.2 住院结算单 29
第五章 惯用业务合同码 31
§5.1 读卡身份验证 31
§5.2 读取收费项目对照信息 35
§5.3 门诊预结算 35
§5.4 门诊结算 36
§5.5 门诊结算回退 37
§5.6 门诊结算单打印 38
§5.7 入院登记 39
§5.8 住院录费预结算 40
§5.9 住院费用明细修改 41
§5.10 住院结算 42
§5.11 住院结算回退 43
§5.12 住院结算单打印 44
§5.13 无费出院 45
第六章 定点结算系统功能简介 46
第七章 常用问题 47
§7.1 在交易过程中，先提交哪一种系统数据库事务？ 47
§7.2 住院寻常费用录入如何解决？ 47
§7.3 如何才干查询到API接口事务与否成功或作进一步解决？ 47
§7.4 如果在进行his结算时，调用接口函数成功，但是his数据库突然断开，导致医保中存在结算数据，his中无结算数据，该如何解决？ 47
§7.5 住院录入费用过程中有无什么限制？在正常住院录入费用过程中，与否是每一笔处方都调一次动态库，还是录入完毕之后再调一次？有无限制或者规定性内容？ 48
§7.6 调用API接口函数（住院录费预结算）时，提示“发送祈求失败” 48
§7.7 如未正常维护三目对照，会有什么影响或者问题浮现？ 48
§7.8 项目未对照已收费，且已传播到劳动保障系统前置机中，此时将项目进行对照，但已传播过项目收费项目级别不能修改，仍显示为丙类，该如何解决？ 48
§7.9 能否医院各种药物相应医保某个药物？ 49
§7.10 读卡输入密码窗口需要HIS开发吗？ 49
§7.11 发生DLL调用错误怎么办？ 49
§7.12 进行API接口开发与否威胁到HIS系统数据安全？ 49
§7.13 能否由HIS系统提供接口，由定点结算系统来调用？ 50
§7.14 如果在住院录费预结算时费用明细传播错误，该怎么解决？ 50
§7.15 在住院期间住院患者变更单位，原单位存在封锁，而新单位没有封锁，或者卡挂失，卡号发生变化，在HIS中该如何解决？ 50
§7.16 当医保/工伤等项目发生变化之后，HIS系统如何解决? 50
§7.17 如何获取HIS中所有药物或所有诊断对照医保项目信息？ 50
§7.18 在进行费用录入时如何显示项目收费项目级别？ 51
§7.19 在住院费用录入时录入明细不不大于5条后，调用API接口住院录费预结算函数时，提示存储过程失效错误。 51
§7.20 读卡身份验证都验证哪些内容？ 51
§7.21 如何进行API接口函数声明引用？ 51
第八章 附录 52
§8.1 病人就诊信息表kc21构造 52
§8.2 费用明细信息表kc22构造 53
§8.3 接口表指标代码表 54
§8.4 病人就诊信息表kc21建表语句 57
§8.5 费用明细信息表kc22建表语句 59
§8.6 XML字符串示例 60
§8.7 错误信息列表 61
§8.8 验收原则 65

第一章 概述
§1.1 背景
随着国家对劳动保障信息化工作大力投入，劳动保障部门需要与定点医疗机构建立更快密信息互联与互换，这就需要把定点医疗机构本来信息管理系统（下称HIS系统）与劳动保障部门业务系统互联。
当前，劳动保障部门延伸到定点医疗机构业务系统有：职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统，下面统称这三个定点结算系统为定点结算系统。
HIS系统与劳动保障部门业务系统互联，将有助于减轻定点医疗机构寻常管理和业务经办工作量，提高工作效率。同步，也有助于劳动保障部门对基金监督管理，有助于参保人员合法权益保护。
§1.2 API接口开发险种范畴

序号
险种
与否有卡
患者辨认方式
1
职工医疗
无
IC卡号
2
城乡居民
有卡
CPU卡
3
工伤保险
无
社会保障号
§1.3 API接口开发安全机制

序号
机制
阐明
1
授权码
API接口开发授权码，每个险种相应一种授权码，由东软公司提供。
2
登录顾客和口令
定点结算系统中登录顾客和口令；
用来拟定是哪个顾客/业务员传上来数据，作为API接口登录顾客。
3
MAC地址
通过MAC地址来限制各定点使用终端接入和信息跟踪。

§1.4 API接口数据流图
定点结算系统提供API接口函数供定点医疗机构HIS系统调用，以完毕相应险种数据传播与结算解决，其基本数据流图如下：
阐明：
1、 HIS系统进行业务数据录入，将就诊信息和费用明细写入HIS接口表中，依照接口表数据，生成XML格式数据。
2、 HIS系统提供相应API接口函数入参，其中要提供定点结算系统中登录名和密码，并提供险种授权码，调用定点结算系统API接口函数。
3、 API接口函数在接受到HIS系统调用祈求后，进行授权码验证和顾客合法性校验，然后把传入就诊信息XML数据和费用明细XML数据传播到劳动保障系统前置机业务系统中。
4、 API接口函数依照就诊信息和费用明细，按照政策规定进行相应运算。
5、 API接口函数返回执行成果，HIS系统依照返回成果进行相应判断解决，以完毕相应业务解决。至此整个调用过程结束。
§1.5 支持环境规定
计算机至少要1G 内存，磁盘剩余空间至少1G。
该API接口只支持WINDOWS /XP系统平台下所开发应用系统，各应用系统必要能正常调用接口函数，传入Windows原则API函数（例如用PB、Delphi、VB、VC、CB等开发软件都可以支持）。不支持其她操作系统。

如果为大医院模式，本地ORACLE数据库服务器端和各业务员客户端需要安装oracle 10g（10.2.0.1以上）版本。

§1.6 术语
序号
术语
含义
1
劳动保障系统前置机
定点结算系统数据库所在服务器
2
预结算
将未上传费用明细传播到劳动保障系统前置机，对费用信息计算预览
3
定点结算系统
职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统，统称这三个定点结算系统为定点结算系统。软件版权归东软公司。
4
HIS系统
指各定点医疗机构使用医院信息管理系统。
5
大医院模式
在我市定点结算系统中，有10多家大型医院安装了本地数据库，某些没有安装本地数据库。安装了本地数据库医院叫大医院模式，没有安装本地数据库医院称为托管模式。大医院模式对不同定点结算系统也许不同，如某医院也许职工定点结算系统是大医院模式，而城居和工伤定点结算系统就也许不是大医院模式，这一点要注意。

第二章 迅速上手
本章将对API接口构成和开发前准备工作做一下简朴简介，并用例子让开发者初步结识调用API接口函数普通过程与办法。
API授权码
创立接口表
定点结算系统登录顾客信息对照
三目编码对照
HIS调用API接口程序开发
API接口业务调试
HIS系统
定点结算系统
API接口文献

§2.1 结识API接口构成
请从东软公司获取API接口文献。该API接口文献涉及如下内容：
序号
文献名
阐明
1
hiscomminterface.dll
医保API接口
2
hiscomminterface.h
供c开发his系统开发使用
3
hiscomminterface.lib
供c开发his系统开发使用
4
Dcic32.dll
卡有关动态库
5
HSMApi.dll
卡有关动态库
6
LSCard.dll
卡有关动态库
7
TYICAPI.dll
卡有关动态库
8
TYICRD.dll
卡有关动态库
9
TYReader.dll
卡有关动态库
10
eapagent.dll
医保有关动态库
11
Hdcrw.dll
卡有关动态库
12
Mwic_32.dll
卡有关动态库
13
SSSE32.dll
卡有关动态库
14
ICCARD.dll
卡有关动态库
15
neuqhd.ini
配备文献
16
eapagent.ini
配备文献（医院不能修改）

请将以上从东软公司获取API接口文献保存到HIS系统前端程序安装目录下，配备文献neuqhd.ini修改项阐明见配备文献中阐明。
§2.2 创立接口表
所谓接口表，是在进行API接口开发之前，需要在HIS系统中创立两个实体表，特指病人就诊信息表kc21和费用明细信息表kc22两张表，这两张表用于生成XML数据。详细表构造和字段含义，请参照附录病人就诊信息表kc21和费用明细信息表kc22中描述。
这里，对创立接口表作如下规定：
1、接口表建在HIS系统数据库中，建在HIS系统同一数据库顾客下。
2、如果HIS系统所使用数据库不是ORACLE，创立接口表时，把接口表表名和字段名设立为大写。
3、接口表作为HIS系统数据库一某些，用于HIS自身事务解决。
阐明：建立接口表目是为了在调用API接口函数时，生成接口函数所需要XML数据， 至于哪些函数需要XML数据，请参照惯用业务合同码简介。
§2.3 定点结算系统登录顾客信息对照
HIS系统在调用API接口函数时需要提供合法登录顾客和口令，如果登录顾客和口令与定点结算系统中登录顾客匹配，那么可以正常调用API接口函数，否则提示顾客不合法。
因而，HIS系统中要提供定点结算系统中登录顾客信息与HIS系统中登录顾客信息对照功能。在初次启动动态库时，操作员要使用此功能模块将定点结算系统中登录顾客和口令信息保存到HIS系统中，在寻常使用过程中，如果定点结算系统中顾客信息发生变化，操作员还需要应用此模块重新进行对照，否则不能正常做医保业务。
当前，定点医疗机构业务系统有：职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统，在HIS系统中需要对三套定点结算系统进行登录顾客对照。
下方为HIS系统社会保障系统登录顾客对照功能示例，HIS可参照，也可自己开发，只要实现此功能即可。
假设HIS系统中顾客信息表为T_USER。
1. 表构造
字段
类型长度
与否可空
主键
备注
LOGIN_NAME
VARCHAR2(20)
否
是
HIS系统中顾客登录名
PASSWORD
VARCHAR2(20)
否

HIS系统中登录密码
NAME
VARCHAR2(20)
否

操作员姓名
ZGYL_LOGIN_NAME
VARCHAR2(20)
否

职工定点结算系统中登录名
ZGYL_PASSWORD
VARCHAR2(20)
否

职工定点结算系统中密码
CZJM_LOGIN_NAME
VARCHAR2(20)
否

城乡居民定点结算系统中登录名
CZJM_PASSWORD
VARCHAR2(20)
否

城乡居民定点结算系统中密码
GS_LOGIN_NAME
VARCHAR2(20)
否

工伤保险定点结算系统中登录名
GS_PASSWORD
VARCHAR2(20)
否

工伤保险定点结算系统中密码
…………

黄色某些为原系统中不存在列，需要针对动态库新增
2. HIS系统中原顾客信息：
LOGIN_NAME
PASSWORD
NAME
ZGYL_LOGIN_NAME
ZGYL_PASSWORD
CZJM_LOGIN_NAME
CZJM_PASSWORD
……
张三
123456
张三

李四
780215
李四

…………

3. 动态库启动后，操作员通过顾客信息对照功能模块，录入定点结算系统中登录名与密码。
打开定点结算系统登录顾客信息对照窗口，定点结算系统中登录顾客信息某些会自动显示已维护过信息，如果为空，证明尚未进行维护。灰色字体不可录，蓝色字体为必录项。操作员填写登录顾客与密码，保存即可。HIS系统存入密码为明码值。
定点结算系统登录顾客信息对照 —□×

HIS系统顾客信息
登录顾客
张三

定点结算系统中登录顾客信息
职工医疗登录顾客
1001zhangsan
职工医疗密码
******
城乡居民登录顾客
1001zhangsan
城乡居民密码
******
工伤保险登录顾客
1001zhangsan
工伤保险密码
******

保 存
关 闭

就绪
定点结算系统登录顾客信息对照
4. 操作员维护后顾客信息

LOGIN_NAME
PASSWORD
NAME
ZGYL_LOGIN_NAME
ZGYL_PASSWORD
CZJM_LOGIN_NAME
CZJM_PASSWORD
……
张三
123456
张三
1001zhangsan
888888
1001zhangsan
888888

李四
780215
李四
lisi
000000
lisi
000000

…………

5. 调用API接口函数时，HIS系统在验证其HIS系统登录安全后，再从该对照表T_USER中获取相应险种登录名和密码（如zhangsan、888888）传给API函数，由API函数传到定点结算系统中进行医保相应安全验证。
6. 如果操作员在定点结算系统中变更密码，那么须在此窗口重新维护。如果未在HIS系统中修改定点结算系统登录密码，那么在调用API接口函数时会提示顾客不合法。
§2.4 ODBC配备
定点结算系统存在本地数据库医院需要进行ODBC配备，否则不用配备ODBC。
ODBC数据源中只需录入数据源名称及TNS Service Name即可，其中TNS Service Name为客户端连接本地数据库服务名。配备时按如下表中名称配备：
险种
ODBC数据源名称
TNS Service Name
备注
职工
connection_zg
zgyl
数据源名称需要与neuqhd.ini中相应险种【#医保前置机连接】下ServerName名称一致。
城居
connection_cj
cjyl
工伤
connection_gs
gsyl
例：客户端连接职工医疗数据库服务名为zgyl。

§2.5 三目编码对照
医保患者在医院就诊且发生费用时，就应当按照医保中心有关政策对该患者在就诊期间所发生各项费用进行结算。而各种药物、诊断项目、病种、服务设施有关信息在结算过程中扮演着重要角色，因而医院对医保患者进行费用结算时就必要明确告诉医保中心，自己所用目录中各个项目分别相应于医保中心目录中哪一条。
然而，各个医院均有自己独立HIS系统，也有自己独立药物、诊断、病种，并且这些目录均有也许不同于医保中心相应目录。因此，为了将医院目录中各个项目与医保中心有关目录关联起来（而又不需要对医院已有目录进行改动），就需要将医院目录中信息和医保中心有关信息进行对照。
目录通过对照后，在医院每一种药物、诊断、病种就都可以在医保中心找到一条记录与之相相应，也就使得医院与医保中心记录统一起来。这样，医院就能在通过医保接口与医保中心进行对照时，以提供对照码方式来告诉医保中心医院所用项目相应于中心哪条记录。
§2.5.1 药物对照
点击定点结算系统中【医疗信息维护】下【药物对照】会打开下图所示窗口：

图5-1
图5-2
【操作流程】
1. 选取批量方式对照时需要把his药物库导入到医保库中，然后再his药物信息中选取需要对照药物，选种该药物同步在医保药物信息中也查出相应药物，然后再医保药物信息中选取对的药物后点击【对照】按钮就可以把医院和医保药物对照起来了。
2. 选取单个对照方式时录入拼音码或名称后点击【检索】按钮在医保药物信息中找到该药物后同步再对照信息中插入一条该药物信息，把his编码录入到该记录中后点击【保存】按钮，把刚才录入信息进行保存。
§2.5.2 诊断对照
同【药物对照】。
§2.5.3 疾病编码对照维护
同【药物对照】。
§2.6 示例一：入院登记解决
通过该示例，你将学习到如何调用API接口函数，完毕信息在HIS系统与定点结算系统之间交互与解决全过程。掌握了该示例，其她业务解决基本都相似，请认真体会。
一方面录入住院就诊信息，然后选取录入医疗类型及医保IC卡号或社会保障号进行入院登记业务解决。以职工医保为例。
ls_ywxym = “CC311001”//业务合同码 入院登记
ls_ywrc = “ZY0001” //住院号
ls_yllx = “0|21||XX” //职工医保|医疗类别（普通住院）|IC卡号
ls_yblongin_name = “manager” //通过HIS登录顾客获取
ls_yb_password = “neusoft” //通过HIS登录顾客获取
ls_licence = “” //由东软公司提供应HIS职工医疗授权码
ls_jzxx = “<rowdata><row><akc190>zy0001</akc190>
<aae073>0</aae073><aka130>21</aka130><akc192>-6-30</akc192><akc193></akc193>
<akc194>-6-30</akc194><akc195></akc195><akc196></akc196><aae011>test</aae011><aae036>-6-30</aae036><aka121></aka121><ckc126>1</ckc126><zkc271></zkc271><zkc272>test</zkc272><zkc274></zkc274><zkc275></zkc275><zkc276></zkc276><zkc277></zkc277><zkc278></zkc278>
<zkc279></zkc279><zkc280></zkc280><zkc281></zkc281><zkc282></zkc282><cka040></cka040><cka041></cka041><zhuzhi></zhuzhi><zhiye></zhiye><phone></phone><blh>123456</blh></row></rowdata>” //就诊信息xml
ls_fymx = “0” //费用明细为’0’
//调用API函数
li_res=comminterface(ls_ywxym,ls_ywrc,ls_yllx,ls_yblongin_name,ls_yb_password,ls_licence,ls_jzxx,ls_fymx,ref ls_ywcc)
ls_ywcc = “” //业务出参为空
//后续解决
HIS有关业务
第三章 API接口函数阐明
§3.1 API函数参数阐明
本接口API函数只提供了一种comminterface函数，通过给该函数传入不同业务合同码，来实现不同业务功能。因而，对于调用者，需要详细学习该函数构成，以便灵活调用。
comminterface (in业务合同码，in业务入参，in医疗类型，in 登录名,in 密码，in 授权码，in 就诊信息，in 费用明细，out业务出参)
参数描述：参数内不能带有@和#标记符号
列
方向
阐明
业务合同码
in
请参照业务合同码表中业务合同码
业务入参
in
请参照业务合同码表中业务入参；
医疗类型
in
(险种|医疗类别|患者辨认信息|XX)
HIS系统需要提供选取职工医保、城居医保、工伤功能， 同步要提供录入IC卡号\社会保障号功能。
险种：0--职工医保，1--城居医保，2--工伤；
医疗类别：见接口代码表；
患者辨认信息：定点机构需用读卡器读取卡上信息此参数置为0，职工医疗不用读卡器读取卡上信息此参数需置上参保人医保IC卡号，对于工伤险种此参数置为工伤人员社保编号；
XX:两个大写X属于固定格式，必要放在最后；
险种、医疗类别、患者辨认信息、XX之间要用“|”分隔。
如果使用社保卡，dll将自动区别是职工还是居民，并且在读卡身份验证业务中返回是职工还是居民，第20个参数，其她业务依照此参数判断险种为0还是1

登录名
in
定点结算系统中登录名
口令
in
定点结算系统中密码（密码须为明码）
授权码
in
授权码(东软公司提供)
就诊信息
in
依照kc21表构造生成XML字符串。
费用明细
in
依照kc22表构造生成XML字符串。
业务出参
out
请参照业务合同码表中出参格式；
备注：
调用预结算、结算、住院登记合同时，就诊信息、费用明细需要传入XML字符串，其她状况可传入”0”。
XML格式规定见【XML字符串示例】
返回值：返回值类型：int。
1. 0 表达到功，业务出参为相应各业务合同码业务出参。
2. 当此函数返回值不等于0时，操作失败，业务出参内具有错误信息。
用例：
1、此人参保为城居医保，做出院结算业务，城居为有卡模式。
li_res = comminterface (“CC311003”，“门诊住院号| 医疗类别|单据号”，“1|21|0|XX”,“manager”，“password”，“”，kc21_xml,kc22_xml ,返回结算信息)
2、此人参保为职工医保，做出院结算业务，没有读卡操作。
li_res = comminterface (“CC311003”，“门诊住院号| 医疗类别|单据号”，“0|21|医保IC卡号|XX”,“manager”，“password”,“”，kc21_xml,kc22_xml,返回结算信息)
3、此人为工伤患者，做出院结算业务，没有读卡操作。
li_res = comminterface (“CC311003”，“门诊住院号| 医疗类别|单据号”，“2|21|社保编号|XX” ,“manager”，“password” ，“”，kc21_xml,kc22_xml ，返回结算信息)

第四章 HIS调用API接口函数流程阐明
§4.1 门诊某些
§4.1.1 门诊结算
门诊特殊病与普通门诊业务流程同样，因此放在一起简介。
普通门诊合用险种
职工医疗、城乡居民、工伤
门诊特殊病合用险种
职工医疗、城乡居民
环节号
触发业务
分步详解
1
信息录入
录入就诊信息和处方明细信息。
2

选取险种类型和医疗类别（普通门诊或门诊特殊病），依照API接口开发险种范畴录入IC卡号、社会保障号或插入CPU卡。
3
预结算（可选）
1. 生成kc21、kc22相应XML字符串。调用接口函数，传入“门诊预结算(BC311002)”合同码。
a) 如果接口函数返回0即成功，HIS可继续完毕其她业务。可将返回计算成果显示到HIS前台系统，供操作员参照。
b) 如果接口函数返回值不为0即失败，错误信息见业务返回信息，但HIS可继续做其她业务（只影响计算成果显示）。
4
结算
1. 写入kc21、kc22，生成XML字符串。调用接口函数，传入“门诊结算(CC311002)”合同码。
a) 如果接口函数返回0即成功，HIS需更新接口表KC21、KC22中CKC126等于1，表达已将KC21、KC22中记录传到定点结算系统数据库中，接下来完毕其她HIS操作即可。
b) 如果接口函数返回值不为0即失败，错误信息见业务返回信息，HIS事务回滚，终结HIS操作。
注：如果HIS系统门诊结算失败而接口交易成功即接口函数返回0，HIS需要发起反交易祈求，冲掉医保成功交易，即调用接口函数，传入门诊结算回退(DC311002)合同码，做门诊结算回退。详细解决见门诊结算回退流程。
5
提交
提交HIS数据库。

§4.1.2 门诊结算回退
在查询结算信息时，可不用读卡，但是在结算回退时，针对有卡险种必要插卡，否则不能结算回退。
普通门诊合用险种
职工医疗、城乡居民、工伤
门诊特殊病合用险种
职工医疗、城乡居民
环节号
触发业务
分步详解
1
查询
查询待作废结算信息。
2

解决HIS门诊结算回退业务。
3
结算回退
调用接口函数，传入“门诊结算回退(DC311002)”合同码。
1. 如果接口函数返回0即成功,接下来完毕其她HIS操作即可。
2. 如果接口函数返回值不为0即失败，错误信息见业务返回信息，HIS事务回滚，终结HIS操作。
注：如果HIS系统门诊结算回退失败而接口交易成功，那么HIS需要将HIS中结算信息作废。
4
提交
提交HIS数据库。

§4.2 住院某些
§4.2.1 入院登记
非医保转医保业务可按入院登记环节来操作。
合用险种
职工医疗、城乡居民、工伤
环节号
触发业务
分步详解
1
信息录入
录入入院登记信息。
2

解决HIS入院登记业务。
3
住院登记
选取险种类型，选取医疗类别（普通住院），依照API接口开发险种范畴录入IC卡号、社会保障号或插入CPU卡。
将入院登记信息保存到接口表KC21中，生成就诊信息XML字符串。
4
住院登记
调用接口函数，传入“入院登记(CC311001)”合同码。
1. 如果接口函数返回0即成功，HIS可继续完毕其她业务。
2. 如果接口函数返回值不为0即失败，回滚HIS事务，终结HIS操作。
注：如果HIS系统入院登记失败，但接口交易成功，HIS系统需要重新办理医保住院登记，不用调用API接口函数（入院登记）即可。
5
提交
提交HIS数据库。

§4.2.2 住院登记信息修改
办理住院登记后，如果对科室、医生、疾病等信息进行修改，或者患者基本信息发生变化，HIS需提供修改住院登记信息功能，并实时传播到定点结算系统数据库中。
如果需要修改患者基本信息，可通过读卡功能获取患者最新信息，并更新到接口表KC21中。
合用险种
职工医疗、城乡居民、工伤
环节号
触发业务
分步详解
1
查询
查询住院登记信息
2
修改
住院登记信息修改，修改KC21。
3

解决HIS住院登记信息修改业务。
4

生成就诊信息XML字符串。不用生成费用明细字符串。
5
拟定
调用接口函数，传入“住院录费(BC311003)”合同码，做住院登记信息修改业务。
1. 如果接口函数返回0，即成功，HIS可继续完毕其她业务。
2. 如果接口函数返回不为0，即失败，HIS业务可继续操作，待费用录入时再将变更后住院登记信息传播到定点结算系统数据库中。
6
提交
提交HIS数据库。

§4.2.3 住院费用录入（或执行医嘱）

合用险种
职工医疗、城乡居民、工伤
环节号
触发业务
分步详解
1
费用录入
费用录入（正记录费用录入）
2

解决HIS费用录入业务。
3
保存
将划价收费明细写入KC22，单价和数量不能为负数，保存，生成费用明细XML字符串，同步生成就诊信息XML字符串。
4
保存
调用接口函数，传入“住院录费(BC311003)”合同码，将费用信息传到社会保障系统数据库中，并返回计算成果。
1) 如果接口函数返回0即成功，HIS需置接口表kc22.ckc126为1，可继续完毕HIS中其她业务操作。
2) 如果接口函数返回不为0，即失败，HIS数据库回滚。
5
提交
提交HIS 数据库

§4.2.4 住院费用明细修改

合用险种
职工医疗、城乡居民、工伤
环节号
触发业务
分步详解
1
费用退费
费用删除（录入费用存在错误，需要将原费用明细删除，再录入对的费用明细）
2

解决HIS费用退费业务。
3
保存
如果整条费用明细退费，那么直接删除KC22中数据，不用生成费用明细XMl；如果是某些退费，那么KC22中先删除本来费用明细，再生成正记录进行保存，将正记录生成费用明细XML字符串，同步生成就诊信息XML字符串。
例：原已传播过收费项目。红色代表主键
住院号
处方号
处方日期
项目名称
项目编码
单价
数量
金额
123456
123456
-12-07 8:00:00
阿莫西林
123456
20.00
10
200.00
现想退数量6，那么HIS应保存数量为4数据到KC22，将新费用明细生成XML。
住院号
处方号
处方日期
项目名称
项目编码
单价
数量
金额
123456
123456
-12-07 8:10:01
阿莫西林
123456
20.00
4
80.00

调用接口函数，传入“住院费用明细修改(BC311004)”合同码，将费用信息传到社会保障系统数据库中，并返回计算成果。
ls_ywxym = “BC311004”//业务合同码 住院退费预结算
ls_ywrc = “00|ZY0001|21|123456|00|123456” //住院号|医疗类别|处方号|处方日期|医院收费编码
ls_yllx = “0|21||XX” //职工医保|医疗类别（普通住院）|IC卡号
ls_yblongin_name = “manager” //通过HIS登录顾客获取
ls_yb_password = “neusoft” //通过HIS登录顾客获取
ls_licence = “” //由东软公司提供应HIS职工医疗授权码
ls_jzxx = “<rowdata><row><akc190>zy0001</akc190>
<aae073>0</aae073><aka130>21</aka130><akc192>-6-30</akc192><akc193></akc193><akc194>-6-30</akc194><akc195></akc195><akc196></akc196><aae011>test</aae011><aae036>-6-30</aae036><aka121></aka121><ckc126>1</ckc126><zkc271></zkc271><zkc272>test</zkc272