丽水市社会保障“一卡通”就医接入技术规范

丽水市社会保障“一卡通”

就医接入技术规范

(V2.4)

丽水市医疗保障局

二o二o年九月

版本调整说明

当前版

V2.4发布时间2020-09-10

本号

起草

丽水市医保局

单位

起草人徐津杰

V2.0

杜战、何卿、胡森飞、林初春、雷炳阳、马晟杰、王玲玲、吴书君

审稿人

V2.1

何卿、吴登峰、吴书君、陈芬芳、马晟杰

审稿人

V2.2

审稿人

V2.3

何卿、吴登峰、吴书君、陈芬芳、李濠辰、李妍

审稿人

V2.4

何卿、吴登峰、吴书君、陈芬芳

审稿人

概述

接口概述

丽水市社会保障“一卡通”接口采用全实时交易模式,持卡人员信息都将实

时从数据中心通过交易提交的方式申请获取，同时就诊信息也将通过交易上传至

数据中心进行结算和存储。数据中心将配置前置机服务器，用于交易的申请、处

理和结果返回。医药机构系统必须与数据中心前置机网络畅通。

接口系统采用TUXEDO交易中间件对外提供接入服务，采用XML字符串作为

参数传递方式。接口开发商通过DLL提供的接口函数来完成相应交易的申请和执

行。本次接口只支持V2.0及以上的动态库版本。

名词解释

交易周期号:

操作人员签入系统后，接口会分配一个具有时效性的唯一号码，该号码会关

联该操作员在这一周期内做的所有结算交易。用于操作员对帐。

规则：时间（YYYYMMDDHHMMSS）（14位）+6位流水号

交易流水号：

交易流水号是指医药机构发起某些交易时需要向数据中心申请交易流水号，

该流水号标识为一笔唯一的交易。

规则：时间（YYYYMMDDHHMMSS）（14位）+6位流水号。

操作员签入：

对医药机构发起交易的操作员进行登记，数据中心分配该操作员有时效性的

交易周期号（24小时），在该交易周期号时效内，该操作员才可以发起其他医保

业务交易。

操作员对帐：

为了保证一个交易周期内医药机构结算数据与数据中心结算数据的一致性，

在交易周期到期后，该操作员将不能继续做其它交易，只能发起对帐交易，在对

账交易成功后再做签出交易，然后重新做签入来获取新的交易周期号。

操作员签出：

签出标志着一个交易周期结束，签出必须在做好对帐交易的前提下才能发

起。操作员必须签出才可以重新签入。

自费：

在实际发生的医疗费用中，按照有关规定不属于城镇职工或城乡居民基本医

疗保险支付范围的费用。包括：

1、基本医疗保险药品目录之外的药品费用；

2、《基本医疗保险医疗服务项目目录》之外的医疗服务项目、医用材料费用；

3、目录内药品、医用材料或诊疗项目超医保支付限额之外需个人支付的费

用；

4、因药品或医疗服务项目限定支付不符的需个人支付的费用。

自理：

指列入基本医疗保险支付范围，但按照规定应由个人先支付的费用。包括:

（1）目录内乙类药品或医疗服务项目由个人承担的费用；

（2）基本医疗保险统筹基金起付线标准费用；

（3）转市外就医时需个人承担的费用，或未按照转诊规定就医产生的需个

人先行承担费用。

自负：

指在实际发生的住院医疗费用中，属基本医疗保险支付范围（总费用-自费-

自理），并按照政策规定应由个人按比例分担的费用。

自付：

自付费用包括自费、自理和自负（包含个人账户支付部分）。

总体流程

接口总体流程

交易处理交易返回

后台业0

务处理

交易验证和执行

操作员签入：操作员进行签入，数据中心分配交易周期号。

接口初始化：医药机构下载三大目录，做医药机构药品库及诊疗库与数据中

心目录的对照，以及接口数据字典下载。

交易周期内交易申请：根据操作员签入的类型，医药机构在该交易周期内可

以调用相关业务的服务。

交易周期内交易结果对帐：操作员签出前必须对已经发生的交易结果与数据

中心进行对账。

操作员签出：标志着该操作员该交易周期结束。对帐不成功不能签出。

金额小数位

文档里传入传出参数中类型是数值型的字段，如果没有值则默认传0。

费用的总额以医药机构上传的总额为准，均采用以下算法:

单价保留4位小数，每个药品诊疗明细总额四舍五入保留2位小数，如：

费用1：0.0038X10=0.038,四舍五入后结果为0.04；

费用2：0.0026X10=0.026,四舍五入后结果为0.03；

总费用：0.04+0.03=0.07

His接口DLL说明

接口DLL是一套DLL程序文件，主文件名为“”，提供给医药机构系统开发

商在系统中进行调用。该接口DLL公布了以下接口函数：

LbsiHisBusiness

用途：

医药机构系统通过调用LbsiHisBusiness接口函数实现各种医保交易。调用

本交易时必须根据每个具体交易的要求填写输入参数。

函数定义：LbsiHisBusiness函数的接口定义如下：

intLbsiHisBusiness(char*cmdHeadXml,

char*cmdDataXml,

char*outDataXml);

函数返回值说明：

返回值为0：表示交易调用成功，此时可以在输出参数outDataXml中读取

交易返回数据

返回值为1：主要用在下载类交易，表示交易调用成功，但交易数据量太大,

必须分包交易。此时，医药机构在处理完本次的交易包以后，即刻循环重复调用

交易(循环调用交易时，交易流水号保持不变)，直到交易返回参数为0为止；

返回值大于1：未被定义，备用。

返回值小于0：表示交易调用失败，此时可以在输出参数outDataXml中读

取交易失败的详细错误信息。

参数说明:

cmdHeadXml：交易头信息，输入参数。每个交易必须根据具体要求传入交易

头信息，交易头信息为XML格式。交易头的具体格式和内容可参见各交易的详

细说明。

cmdDataXml：交易输入数据，输入参数。每个交易应根据各自的要求传

入交易数据。交易数据信息为XML格式。交易输入数据的具体格式和内容可参

见各交易的详细说明。

outDataXml：交易返回数据或交易返回错误信息，输出参数。当交易调用成

功时（返回值为0）,outDataXml中存储的是XML格式的交易返回数据，交易输

出数据的具体格式和内容可参见各交易的详细说明。当交易失败时（返回值为非

0）,outDataXml中存储的是交易错误的详细信息，如错误原因等，交易错误为

普通字符串。

注意事项：

调用LbsiHisBusiness接口函数时必须注意以下事项：

cmdHeadXml必须按要求传入正确格式和内容，不能为空。cmdHeadXml最大

长度限制为16Mb。

如果某交易需要输入交易数据，cmdDataXml必须按照要求传入正确格式和

内容，不能为空，。如果某交易不需要输入交易的具体数据，可传入空字符串””，

但不能传入空指针NULLocmdDataXml最大长度限制为16Mb。

接口程序在调用LbsiHisBusiness函数前必须预先为返回参数outDataXml

分配存储空间，当空间不足或未分配空间时会造成程序调用失败或出现异常情

况。OutDataXml最大返回数据量限制在16Mb。

LbsiSplitXml

用途：

为了方便医药机构系统开发商而提供的XML分拆函数，本函数用于对多个

XML返回时使用。

函数定义：

LbsiSplitXml函数的接口定义如下：

intLbsiSplitXml(char*XmlString,

intXmlNo,

char*OutDataXml,

char*ErrMsg)

函数返回值说明：

返回值大于或等于0：表示调用成功。

返回值小于0：表示调用失败，此时可以在输出参数ErrMsg中读取交易失

败的详细错误信息。

参数说明：

XmlString需分拆的多个XML串

XmLNo需要获取的第几个XML串。

OutDataXml：Xml字符串，返回参数。

ErrMsg：当返回错误信息，输出参数。交易输入数据，输入参数。

ErrMsg最大2000字节,HIS程序在调用LbsiGetRowCount前必须为ErrMsg分

配足够的空间。

调用成功时ErrMsg为空字符串。

例如：

LbsiSplitXml(•,,,1,OutDataXml,ErrMsg)

返回0时，则表示取第1个XML串，放入OutDataXml里。

LbsiGetRowCount

用途:

为了方便医药机构系统开发商而提供的XML解析函数，本函数返回一个

XML串中包含的总的记录数(名字为“ROW”的结点的数目)。

函数定义：

LbsiGetRowCount函数的接口定义如下：

intLbsiGetRowCount(char*XmlString,

char*ErrMsg)

函数返回值说明：

返回值大于或等于0：表示调用成功，返回值为输入XML串XmlString中

“ROW”结点的记录数。

返回值小于0：表示调用失败，此时可以在输出参数ErrMsg中读取交

易失败的详细错误信息。

参数说明：

XmlString：Xml字符串，输入参数。

ErrMsg：当返回错误信息，输出参数。交易输入数据，输入参数。ErrMsg

最大2000字节，HIS程序在调用LbsiGetRowCount前必须为ErrMsg分配足够

的空间。

调用成功时ErrMsg为空字符传。

例如：

LbsiGetRowCount(“<R0WSETXR0Wnum="1"><a>data1</aX/R0WXR0W

num="2"><a>data2</a></R0W></R0WSET>>,,ErrMsg)

将返回2,表示该XML串中有2行记录。如果传入的是无效的XML串将返

回T;

LbsiGetXmlData

用途：

为了方便医药机构系统开发商而提供的XML解析函数，本函数返回一个

XML串中第Num行结点名为ColumnName的内容。调用成功时返回值以字符串

的形式存储在ColumnValue中，HIS程序必须根据实际情况将ColumnValue

进行数据类型转换。

函数定义：

LbSiGetXmlData函数的接口定义如下：

intLbSiGetXmlData(char*XmlString,

char*ColumnName,

intRowNum,

char*ColumnValue,

char*ErrMsg);

函数返回值说明：

返回值为0：表示调用成功。此时可以在ColumnValue返回参数中读取返回

值。此时ErrMsg中为空串。

返回值为非0：表示调用失败，此时可以在输出参数ErrMsg中读取交易失

败的详细错误信息。

参数说明：

XmlString：Xml字符串，输入参数。

ColumnName要取值的结点名称，输入参数。

RowNum记录行号。

ColumnValue结点内容，返回值。

ErrMsg：当返回错误信息，输出参数。交易输入数据，输入参数。ErrMsg

最大2000字节，HIS程序在调用LbsiGetRowCount前必须为ErrMsg分配足够

的空间。调用成功时ErrMsg为空字符传。

例如：

LbSiGetXmlData(rt<R0WSETXR0Wnum="1"Xa>datal</aX/ROW>

<R0Wnum="2"Xa>data2</a></R0W>

</R0WSET>"，"a"2,ColumnName,ErrMsg);

调用成功后将在ColumnValue中将返回data2。

Xml组合说明

样例：

<ROWSET>

<ROWnum=^^1”>

<BM>YP001</BM>

<DJ>1000.00</DJ>

<RQ>2007-01-18</RQ>

</ROW>

<ROWnum="n”>

<BM>YP001</BM>

<DJ>1000.00</DJ>

<RQ>2007-01-18</RQ>

</ROW>

</ROWSET>

<>

<ROWSET>

<ROWnum="1">

<BKE047>l</BKE047>

</ROW>

</ROWSET>

说明：整个XML以<ROWSET>开始，</ROWSET>结束。<ROWnum="1"></ROW>

表示一个行域。里面的1表示是第一行，如果多行时，可以2,3,4如此递增，

仅一行时也必需有该信息。〈BM>YP001</BM>这是一个行中的字段域BM是该字段

的编码，YP001是该字段的值，可根据具体要求进行替换。需要注意的是行与行

之间的字段域的数量和顺序必须是一致的。字符串不需要特意加上引号例如：

<akb001>>000r</akb001>,但是前面说的rownum="1"的引号是需要的。可

以不保留回车符即：

<ROWSETXROWnum="1"Xakb001〉0001〈/akb001>…也可以。接口规定的字

段域不能缺少且不能改变字段域的编码。

多个XML串组合则使用“◊”进行分隔，门诊预结算及门诊结算交易时需要

使用该符号分隔多XML串。

接口文件下载地址

医药机构环境配置

硬件环境

最低客户机配置为：CPU为PIV以上、内存为512M以上、硬盘可用空间1G

以上。

软件环境

安装Windows平台操作系统（win2000操作系统以上），必须安装到每个客

户机上。接口动态库程序环境支持文件和，安装在每个客户机上.

网络环境

接口采用实时模式，需要医药机构PC机与数据中心应用服务器网络畅通。

接口程序配置文件

接口动态库会从配置文件文件中读取下列信息：

SvrAddress数据中心应用服务器地址，此信息由数据中心随接口DLL一

同发布，不能随意修改。

LogFileDir交易日志保存目录。如果文件中无LogFileDir参数，或

者LogFileDir参数所指定的目录不存在，则接口程序会自动在当前工作目录

中尝试建立Ibsilog子目录，并在其中记录交易日志，如果Ibsilog目录创建

不成功，则在当前工作目录中保存交易日志文件。交易日志文件的文件名为，

yyyymmd为客户机当前时间（年、月、日）。

LogFlag定义日志文件输出级别：允许设置的日志输出级别有：

DEBUG,INFO,WARNING,ERROR

DEBUG：输出最详细的日志，供查找程序错误使用

INFO：输出正常日志信息（交易信息、警告信息和错误信息）

WARNING:输出警告和错误信息

ERROR：仅输出错误信息

<?xmlversion="1.0"encoding="gb2312"?>

<Configuration>

<SvrAddress>:8080/hisweb/</SvrAddress>

<SvrAddress>:8081/hisweb/</SvrAddress>

<LogFileDir>d:\jdsi\log</LogFileDir>

<LogFlag>DEBUG</LogFlag>

</Configuration>

接口交易一览表

交易代码功能简介备注

100操作员注册新增

101操作员注销新增

110操作员签入

120操作员签出

130操作员对帐

131医药机构月结算对帐

150申请交易流水号

160数据中心交易状态查询

170交易周期状态查询

230口诊预结复

240门诊结算

250门诊退费结篁

251门诊退费申请停用

252门诊退费申请状态查询停用

260交易作废（冲正）修改

210住院登记

211住院信息变更

220取消住院登记

310住院费用明细上传

交易代码功能简介备注

410住院预结篁

420住院结复

430住院退费结算

440住院结算冲正停用

510特检、治、药审批停用

530药品目录备案停用

531诊疗目录备案停用

540审核扣款明细确认（预留）预留

541审核扣款明细复审结果查询（预留）预留

610商卜

620查询人员基本信息停用

630查询费用结算信息

631在院明细信息查询

632删除未结算明细费用

633查询第三方支付状态

640查询特殊药品审批信息停用

641特检特治特药年度累计用量查询

650本院信息查询

651门诊结算电子票据数据上传

652住院结算电子票据数据上使

653结算电子票据作废

654发票信息查询

660查询药品诊疗自负比例停用

672个人检查报告上传合并至671

680代管人员审核结果查询

710下载交易周期内的结算信息

720药品口录下载

730诊疗目录下载

731诊疗目录限价信息下载

740疾病目录下载（ICD10）

750接口数据字典下载

760审核扣款明细下载

770医师备案新增

780个人检查报告上传新增

781住院医嘱上住新增

782手术记录上传新增

783住院病案首页上传新增

784死亡人员信息上佞新增

785住院病案首页作废

790秒始库存信息上侵新增

791产品入库（进货）单上传新增

792出库信息上传新增

交易代码功能简介备注

793盘存信息上传新增

132体检结算操作员对账

340体检结篁

350体检退费结算

621体检人员信息查询

671个人体检信息上传新增

801省平台日结算对账停用

802省平台结算信息下载交易停用

803省平台交易结果查询交易停用

804结算单据下载交易停用

805操作员注册交易停用

806操作员注销交易停用

901查询近期就诊情况新增

910门诊单据提醒新增

911住院医嘱提醒新增

接口交易说明

交易头输入项(cmdHeadXml)

指标编码指标名称数据类型是否必填备注

AAB299就医地行政区划Varchar2(8)医药机构所属统筹区代码

代码

AKB001医药机构编码Varchar2(16)是统一重新编号

BKE046操作员统一账号Varchar2(20)是注册后的平台统一账号

TRADEID交易代码Varchar2(3)是

BKC004交易周期号Varchar2(30)操作员签入交易后数据中心分配

的交易周期号

除签入交易外都必须传入；

CKC009交易流水号Varchar2(30)通过150交易获取;未明确规定

需要交易流水号的可以为空

DKE010交易类型Varchar2(3)代码见C060

BKZ022身份验证方式Varchar2(3)代码见C053

DAC002身份验证关键字Varchar2(256)当验证方式为电子社保卡时，需

传入二维码信息；

当验证方式为医保电子凭证时，

需传入身份凭证信息，格式：姓

名1证件类型1证件号码1令牌

签入'签出及对帐类交易

100操作员注册

交易描述

医药机构操作员在进行接口交易前，必须先在平台注册，如果该人员已经注

册过，则直接返回该人员平台操作员账号；否则系统记录该操作员信息并为其产

生唯一的操作员账号，并返回给医药机构，医药机构进行人员编号和平台操作员

账号的对应。

同一个操作员可以有多个角色，医药机构可以同一个社会保障号，用不同的

内部工号注册多个角色，解决一人多角色的问题。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号空

TRADEID交易代码100

BKC004交易周期号空

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

指标编码指标名称数据类型是否必填备注

AAC002社会保障号Varchar2(18)是如果是自助机传

COMPUTER

AAC003姓名Varchar2(50)是如果是自助机传

COMPUTER

BKE043内部员工工号Varchar2(20)是

BKE044联系电话Varchar2(50)

DKEU4用户角色Varchar2(3)是代码见C063

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

BKE043内部员工工号Varchar2(20)是

BKE046平台统一账号Varchar2(20)是结算平台操作员统一账号

101操作员注销

交易描述

医药机构操作员由于辞职、岗位变动等因素不再从事接口交易操作的，调用

该交易对账号进行注销。只有系统管理员能调用该交易。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码101

BKC004交易周期号必填项一当前该操作员处于签入状态的交易周期号

CKC009交易流水号必填项一先通过150交易获取

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

指标编码指标名称数据类型是否必填备注

AAC002社会保障号Varchar2(20)是

AAC003姓名Varchar2(50)是

BKE043内部员工工号Varchar2(20)是

BKE046平台统一账号Varchar2(20)是

BKE058注销原因Varchar2(200)注销原因的文字描述

交易输出数据(outDataXml)

无

110操作员签入

交易描述

该交易作为交易周期的开始,规定所有医药机构操作员必须先签入,方可做

后续交易调用该交易后数据中心会分配一个交易周期号,每次调用其它交易时

必须指定该交易周期号.在未签出的情况下,在交易周期内(24小时)该操作员交

易周期号是不变动的,该交易周期号作为操作员对帐的依据，签入分门诊及住院,

签入的门诊只能做门诊相关交易，签入住院只能做住院相关交易操作员可以同

时签入门诊及住院,签入时间为24小时,24小时后必须进行对帐并相应签出。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码110

BKC004交易周期号空

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

指标编码指标名称数据类型是否必填备注

BKE047签入类别Varchar2(l)是代码见C045

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

BKC004交易周期号Varchar2(30)是必须保存到医药机构系统中，以便

对帐,及后续交易

120操作员签出

交易描述

签出交易是对帐交易的后续交易，即必须在交易周期内，数据中心结算信息

与医药机构操作员对帐成功情况下方可签出，签出标志着该交易周期结束,24小

时必须签出.时间超长后接口会提示交易周期号过期,其它交易则不能正常调用,

此时医药机构操作员必须马上对帐后立即签出，重新申请新的交易周期号.

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码120

BKC004交易周期号必填项一当前该操作员处于签入状态的交易周期号

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

指标编码指标名称数据类型是否必填备注

BKE047签入类别Varchar2(l)是代码见C045

交易输出数据(outDataXml)

无

130操作员对帐

交易描述

为保证数据中心结算信息与医药机构结算信息一致，在规定时间周期内必须

进行对帐。即每隔24小时，只能进行对帐、签出交易，且对帐成功的情况下才可

以进行签出，进行新的周期。调用该交易时先汇总医药机构医保病人数据中相关

需要传入的值,数据中心根据传入的交易周期号及相关金额,与数据中心该交易

周期号内的金额比较，返回数据中心交易周期内的金额及对帐信息。

对帐结果：

平：医药机构与数据中心都平的情况下则表明数据一致,可签出重新进行新

交易周期.

不平：调用下载交易周期内结算信息交易，下载数据中心该交易周期内的所

有结算信息。医药机构比对数据中心的结算信息，可发起门诊、住院结算作废交

易，冲销该笔数据中心结算信息。如果是医药机构多，则内部自行处理。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码130

BKC004交易周期号必填项一当前该操作员处于签入状态的交易周期号

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

对账主信息

指标编码指标名称数据类型是否必填备注

BKZ010结算笔数Number(10)是退费交易也算一次结算；作

废交易及被作废的结算不

计算在内。

AKC046医疗费总额Number(12,2)是作废交易及被作废的结算

不计算在内。医疗费总额必

须等于对账明细支付金额

合计。

对账明细信息

指标编码指标名称数据类型是否必填备注

BKE038支付渠道VARCHAR2(3)代码见C043

BKE039资金类别代码VARCHAR2(3)代码见C044

BKE041支付金额Number(12,2)

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

BKZ012对帐结果Varchar2(l)是代码见C052

AAE013备注Varchar2(200)对帐结果描述

131医药机构月结算对帐

交易描述

每月1号系统自动按中心的结算时间为条件汇总医药机构上月的医疗费用

并生成医药机构预清算数据。每月io号之前，医药机构必须完成月度结算数据

对帐，过期仍未对帐通过的，系统将限制该医药机构的所有操作员签入系统直到

月结算数据对帐完成。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码131

BKC004交易周期号空

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

对账主信息

指标编码指标名称数据类型是否必填备注

AAE002结算年月Char(6)是YYYYMM

BKZ010结算笔数Number(10)是退费交易也算一次结算；作废交

易及被作废的结算不计算在内。

AKC046医疗费总额Number(12,2)是作废交易及被作废的结算不计

算在内。医疗费总额必须等于对

账明细支付金额合计。

对账明细信息

指标编码指标名称数据类型是否必填备注

BKE038支付渠道VARCHAR2(3)代码见C043

BKE039资金类别代码VARCHAR2(3)代码见C044

BKE041支付金额Number(12,2)

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

BKZ012对帐结果Varchar2(l)是代码见C052

AAE013备注Varchar2(200)对帐结果描述

150申请交易流水号

交易描述

针对门诊及住院类交易在调用时必须申请交易流水号。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码150

BKC004交易周期号必填项一当前该操作员处于签入状态的交易周期号

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

空字符串(“”)

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

CKC009交易流水号Varchar2(30)是

160数据中心交易状态查询

交易描述

查询指定交易号交易是否成功执行

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码160

BKC004交易周期号必填项一当前该操作员处于签入状态的交易周期号

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

指标编码指标名称数据类型是否必填备注

CKC009交易流水号Varchar2(30)是所查询的交易流水号

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

BKZ016交易状态Varchar2(l)是代码见C051

170交易周期状态查询

交易描述

针对查询该交易是否成功执行

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码170

BKC004交易周期号空

CKC009交易流水号空

DKE010交易类型空

BKZ022身份验证方式空

DAC002身份验证关键字空

交易输入数据(cmdDataXml)

指标编码指标名称数据类型是否必填备注

BKC004交易周期号Varchar2(30)是所查询医保交易周期号

交易输出数据(outDataXml)

指标编码指标名称数据类型是否必填备注

CKE042交易周期状态Varchar2(3)是代码见C059

BKE047签入类别VARCHAR2(3)是代码见C045

门诊类

230门诊预结算

交易描述

在费用结算前必须调用预结算交易查看结算结果。

当交易类型是诊间交易时，自费和自负费用还是在现金金额中返回，只有在

正式结算时才能去调用第三方支付。

交易头数据项说明

指标编码指标名称备注

AAB299就医地行政区划代码必填项一医药机构所在统筹区代码

AKB001医药机构编码必填项

BKE046操作员统一账号必填项-注册后的平台统一账号

TRADEID交易代码230

BKC004交易周期号必填项一当前该操作员处于签入状态的交易周期号

CKC009交易流水号空

DKE010交易类型必填项

BKZ022身份验证方式必填项

DAC002身份验证关键字当验证方式为电子社保卡时，需传入二维码信息：

当验证方式为医保电子凭证时，需传入身份凭证信息；

交易输入数据(cmdDataXml)

门诊基本信息:

指标编码指标名称数据类型是否必填备注

AAB301参保地行政区划代码Varchar2(8)是

AAC001个人编号Varchar2(20)是

AKC041门诊时间Date是Yyyy-mm-ddhh24:min:ss

BKZ006就诊类别Varchar2(3)是代码见C050

AKC038门诊号Varchar2(20)是医药机构内部门诊号

AKF001科室代码Varchar2(6)是代码见C029；药店传

“0000”

AKA120疾病编码Varchar2(20)主要诊断的疾病ICD10码

AKE046疾病名称Varchar2(100)

AKC078主要病情诊断Varchar2(600)病情描述

AKC039审批编号Varchar2(18)备用

AKA130医疗类别Varchar2(3)是代码见C018

CKC016医生身份证号码VARCHAR2(20)非空时必须是备案过的医

生身份证号码

CKE013医生姓名VARCHAR2(20)

BKA030特殊结算类别Varchar2(3)代码见C074

AKA024特慢病病种标识Varchar2(3)是代码见C075

AKA023特慢病病种编码Varchar2(10)否代码见C006

如果是特病、慢病必填

AKC068外配处方审批编号Varchar2(20)否药店外配处方时使用上

传，其他两定单位默认传

空”

诊断疾病列表

指标编码指标名称数据类型是否必填备注

AKA120疾病编码Varchar2(20)疾病ICD10码

门诊费用信息

指标编码指标名称数据类型是否必填备注

AKC038门诊/住院号VARCHAR2(20)是

CKC017费用明细序号VARCHAR2(20)是

AKE003药品诊疗类别VARCHAR2(3)是代码见C024

AKE015中心项目编码VARCHAR2(20)是

AKC051医药机构收费项目编VARCHAR2(20)是

码

AKC052医药机构收费项目名VARCHAR2(60)是

称

AKC225