定点医疗机构API开发手册实用.doc

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

定点医疗机构API开发手册

软件有限公司

版权声明

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

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

第74 页 共74 页

文档修改历史
版本
修改记录
修改日期
修改人
0.5
增加开发险种范围、安全机制、将HIS流程说明放到前面，常用API接口函数介绍
2010-7-15
薛亚玲
0.6
增加和修改文档中的部分说明
2010-7-21
陈晓明
0.61
Comminterface医疗类型入参增加医疗类别。调整API常见流程介绍
2010-7-23
薛亚玲
0.62
接口表KC22主键去掉AAE040
2010-7-26
薛亚玲
0.63
预结算、结算去掉支付方式、经办人、账户支付金额；读人员审批信息去掉审批类别
2010-8-10
薛亚玲
0.64
将读卡、读取封锁、读取审批合并；将读药品、读诊疗对照信息合并；去掉疾病和批量读取收费项目对照信息。
2010-8-12
薛亚玲
0.65
接口表KC22，增加每次用量单位AKA076,KC21增加患者联系电话PHONE
2010-8-17
薛亚玲
0.66
读卡身份验证，增加两个返回值：结算年月，定点医疗机构编号。
2010-8-20
武刚
0.67
修改xml字符串格式为小写
2010-8-26
陈晓明
0.68
修改门诊预结算和住院预结算出参
2010-9-6
陈晓明
0.69
修改kc22表结构，去掉aae040,zka101,aae073,ckc048,ckc125
2010-9-13
武刚
0.70
修改xml字符串示例，使之与kc22表结构一致
2010-9-13
武刚
0.71
调整kc21表结构
2010-9-13
武刚
0.81
读卡身份验证增加疾病编码
2010-9-21
薛亚玲
0.82
去掉入院登记回退业务
2010-11-09
薛亚玲
0.83
支持环境增加大医院模式使用oracle 10g版本
2010-11-10
薛亚玲
0.84
修改入院登记传入参数
2010-11-17
陈晓明
0.85
修改xml字符串示例
2010-11-18
陈晓明
0.86
医疗类别去掉中途结算与年终结算，住院结算参数增加结算方式（1-普通住院结算，2-中途结算，3-年终结算）
2010-11-19
薛亚玲
0.87
增加医保结算成功his失败后，如何处理的问题
2010-12-01
薛亚玲
0.9
定版0.9.0.9遗留问题：HIS传输费用明细后，如果费用等级发生变化，再次传入负记录也不能解决问题，需提供专门退费的函数来处理。接口函数增加参数中不能含有”#”;增加示例三
2010-12-08
薛亚玲
0.91
增加错误信息列表、验收标准；住院结算函数增加入参费用总额；database.ini改名为neuqhd.ini;增加病历号
2010-12-09
薛亚玲
0.92
修改住院费用明细修改调用流程
2010-12-22
陈晓明
0.93
门诊预结算、住院预结算增加返回参数
2011-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 2000/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 = “ZY0100000000000001” //住院号
ls_yllx = “0|21|0707110925|XX” //职工医保|医疗类别（普通住院）|IC卡号
ls_yblongin_name = “manager” //通过HIS登录用户获取
ls_yb_password = “neusoft” //通过HIS登录用户获取
ls_licence = “1111111111” //由东软公司提供给HIS的职工医疗的授权码
ls_jzxx = “<rowdata><row><akc190>zy0100000000000001</akc190>
<aae073>0</aae073><aka130>21</aka130><akc192>2010-6-30</akc192><akc193></akc193>
<akc194>2010-6-30</akc194><akc195></akc195><akc196></akc196><aae011>test</aae011><aae036>2010-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”，“1234567890”，kc21_xml,kc22_xml ,返回结算信息)
2、此人参保为职工医保，做出院结算业务，没有读卡操作。
li_res = comminterface (“CC311003”, “门诊住院号| 医疗类别|单据号”，“0|21|医保IC卡号|XX”,“manager”，“password”,“11111111111”，kc21_xml,kc22_xml,返回结算信息)
3、此人为工伤患者，做出院结算业务，没有读卡操作。
li_res = comminterface (“CC311003”, “门诊住院号| 医疗类别|单据号”，“2|21|社保编号|XX” ,“manager”，“password” ，“2222222222”，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
2010-12-07 8:00:00
阿莫西林
123456
20.00
10
200.00
现想退数量6，那么HIS应保存数量为4的数据到KC22，将新的费用明细生成XML。
住院号
处方号
处方日期
项目名称
项目编码
单价
数量
金额
123456
123456
2010-12-07 8:10:01
阿莫西林
123456
20.00
4
80.00

调用接口函数，传入“住院费用明细修改(BC311004)”协议码，将费用信息传到社会保障系统数据库中，并返回计算结果。
ls_ywxym = “BC311004”//业务协议码 住院退费预结算
ls_ywrc = “1302012516300|ZY0100000000000001|21|123456|20101207150000|123456” //住院号|医疗类别|处方号|处方日期|医院收费编码
ls_yllx =