接口函数使用说明

admin管理员组

文章数量:1537319

2023年12月24日发(作者：)

接口函数使用说明

1、

2、

编写目的：为满足佳木斯市中心医院信息管理和医疗保险的需求，特编写此接口。

用户对象使用说明

Uo_calc_ic:读卡验证参保患者类型用户对象；

Uo_calc_base:城镇居民各类封装函数用户对象；

Uo_calc_base_zg城镇职工各类封装函数用户对象；

1、定义窗口实例变量或全局实例变量；

2、在调用窗口的Open 事件中创建实例,在close 事件中释放实例变量；

例如：实例变量：uo_calc_ic calc_ic

uo_calc_base calc_base

Uo_calc_base_zg calc_base_zg

Integer Ils_type //此变量用于存放Uo_calc_ic对象的GetType()返回值，如果是1代表城镇职工卡，2代表城镇居民卡；

在Open事件中：calc_ic=create uo_calc_ic

_ calc_base_=create uo_calc_base

calc_base_zg=create uo_calc_base_zg

在Close事件中: destroy calc_ic;

destroy calc_base

destroy calc_base_zg

3、用户对象Uo_calc_ic封装函数

1、获取参保病人参保对象函数Int GetType()

功能说明：验证患者是城镇居民或城镇职工，根据返回值调用城镇职工或城镇职工相对应的用户对象的函数；

参数说明：无；

返回值：如果2代表城镇居民，1代表城镇职工；

调用说明：ils_type = Gettype()

4、用户对象Uo_calc_base和Uo_calc_base_zg函数功能说明

1、 初始化读卡函数Int Init(String Ls_type)

功能说明：完成初始化读卡功能；

参数说明：Ls_type：凭单类型，在门诊调用传入字符’1’;在住院调用传入字符’2’;

返回值：如果返回值为1成功，否则失败；

调用说明：在结算前身份确认时调用；

2、 信息导出函数Void ExportVarValue(Ref String Ls_Name,

Ref String Ls_Sex,

Ref String Ls_Sort,

Ref String Ls_EachCode,

Ref String Ls_UnitCode,

Ref String Ls_AreaCode,

Ref Decimal Ld_AccountAddUp,

Ref Decimal Ld_PlanAsWhole,

Ref Integer Ld_InHospTime,

Ref String Ls_WorkTime

Ref Decimal Ld_BaseAsWhole

Ref Decimal Ld_BigAswhole

Ref Decimal ld_deylflj

Ref Decimal ld_ylfljzj );

功能说明：完成读卡后,信息返回功能；

参数说明1)Ls_name：返回参保人员姓名；

2)Ls_Sex：返回参保人员性别；

3) Ls_Sort：返回参保人员类别；

4)Ls_EachCode：返回参保人员代码；

5)Ls_UnitCode：返回参保人员单位代码；

6)Ls_AreaCode：返回参保人员地区代码；

7)Ld_AccountAddUp：本年内账户累计支出

8)Ld_PlanAsWhole：本年内住院统筹累计

9)Ld_InHospTime：返回住院次数；

10）Ls_WorkTime：工作日期(YYYYMMDD)

11)Ref Decimal Ld_BaseAsWhole 基本统筹累计

12)Ref Decimal Ld_BigAswhole 大额统筹累积

13)Ref Decimal ld_deylflj 大额医疗费累计

14)Ref Decimal ld_ylfljzj 医疗费累计总计

返回值：无；

调用说明：在调用Init函数后进行调用，用于获取患者基本情况；

3、

入院信息传入 int Setinhosp_ex(Datastore Da_inhosp_ex)

功能说明：把住院病人基本信息传入医疗保险接口中；

参数说明：input001 住院号：保证不同住院患者的唯一性，7位字符型；

input002 住院序号：住院序号(HIS提供),住院患者在本医院住院次数，数值型；

input003 姓名：字符型；

input004 性别：字符型 1、男；2、女；

input005 出生日期：日期型；

input006 社会保障号；字符型20

input007 单位编号：字符型10

input008 医院编号：字符型7位；

input009 人员类别：字符型2位

input010 入院日期：日期型；

input011 科别：字符型4位 需要对照编码

input012 病房：字符型4位 需要对照编码

返回值：，返回1成功，返回-1失败。

调用说明：在入院信息登记时调用。

4、

住院费用传入Int SetItemInfo_ex(string ls_status,string ls_rylb,DataStore

Da_SetItem_ex,ref datastore da_setitem_ex_ref)

功能说明：把住院费用明细传入到医疗保险接口中，为结算带来数据来源

参数说明：ls_status 人员状态,通过geteachinfo获得

Ls_rylb 人员类别，入院登记记载，每次录遗嘱时取出传入

Da_SetItem_ex、Da_SetItem_ex_ref 说明

Input001：住院号(HIS提供)，保证不同住院患者的唯一性，7位字符型；

input002：住院序号(HIS提供),住院患者在本医院住院次数，数值型；

input003：单据号(HIS提供),费用明细的流水号，保证唯一性，10位字符型

input004：操作码(HIS提供),药品或诊疗项目编码（医疗保险标准库提供的编码），如果是自费项目，提供HIS中的编码，16位字符型

input005：序号(HIS提供),若流水号保证唯一，此号可以不提供，数值型；

input006：时间(HIS提供)，项目发生日期和时间，日期型；

input007：项目名称(HIS提供),药品和诊疗项目的名称，80位字符型；

input008：规格，30位字符型；

input009：剂型，4位字符型

input010：单位 ，10位字符型

input011：数量，数值型；

input012：单价，数值型；

input013：金额，数值型；

input014: 药品类别his不传入 1位字符

input015: 审批(对于适应症项目需要审批，医院大夫掌握)1位字符，值为0未审批 1审批

input016：金额，数值型；

input017: 目录范围标识his不用传入

input018: 人员状态his不用传入

返回值：返回1成功，返回-1失败。

调用说明：在His录入处方后调用该函数。

5、 住院结算获取费用明细信息int GetItemInfo(String Ls_InHospNo,Long

Li_InHospSeq);

功能说明：从接口中获取住院费用明细信息以此作为住院结算费用明细；

参数说明：Ls_InHospNo：住院号字符型7位；

InHospSeq: 住院序号整型

返回值：返回1成功，-1失败；

调用说明：在调用住院结算函数CalcPlan()前调用；

6、

门诊信息传入函数Int SetItemInfo(DataStore Da_Item,ref DataStore da_item_ref)

功能说明：把His项目信息传入到医疗保险项目中，为结算带来数据来源。

参数说明：Da_Item数据存储，内容如下：

Id：His生成的Sequence，保证不同处方的唯一性，字符型第一位不能为零。

Xh：His生成的Sequence，保证同一处方的唯一性，数值型。

Xmbm：药品或诊疗项目编码,采用医保中心编码，字符性。

Mc：药品或诊疗项目名称，字符性。

Gg：规格，字符性，要求汉字表述，比如：1mg * 10

Jx：剂型，字符性，汉字表述

Dw：单位，字符性，汉字表述

Dj：单价，数值型（4位小数点）

Sl：数量，数值型（4位小数点）

Je：金额，数值型（4位小数点）

Zhzf：账户支付金额(4位小数点)

Grfd：个人自付金额(4位小数点)

Rq：发生日期，日期型

返回值：如果为1成功，否则失败；

调用说明：在His录入完处方后调用该函数。

7、 门诊结算函数Int CalcAccount(Ref DataStore Da_Itemt)

功能说明：完成门诊持卡病人结算功能；

参数说明：Da_Item数据存储，返回结算后信息；

同6中的Da_item

返回值：为1成功，否则失败；

调用说明：门诊结算时调用；

8、 存盘函数Int Save()

功能说明：完成门诊和住院持卡病人结算后回写卡和存盘功能；

参数说明：无；

返回值：为1成功，否则失败；

调用说明：His存盘时调用，保证His数据和医保数据的完整性；

9、

住院结算函数CalcPlan(String Ls_fdjsbz)

功能说明:完成持卡病人的住院结算。

参数说明:Ls_fdjsbz传入0。

返回值：为1成功，否则失败。

调用说明:住院结算时调用；

离休或意外结算函数CalcPlan1(String Ls_fdjsbz)

功能说明:完成持卡病人的住院结算。

参数说明:Ls_fdjsbz传入0。

返回值：为1成功，否则失败。

调用说明:住院结算时调用；

10、

备注：如果是职工医疗此函数用于离休人员结算，如果是居民用于住院意外伤害结算

11、

门诊慢性病结算函数CalcPlan2(String Ls_fdjsbz)

功能说明:完成持卡病人的门诊慢性病结算。

参数说明:Ls_fdjsbz传入0。

返回值：为1成功，否则失败。

调用说明:门诊结算时调用

门诊统筹结算函数CalcPlan3(String Ls_fdjsbz)

功能说明:完成持卡病人的住院结算。

参数说明:Ls_fdjsbz传入0。

返回值：为1成功，否则失败。

调用说明:门诊结算时调用

13、 门诊红冲函数Int BlankOutVoucher(String Ls_no)

功能说明:完成门诊处方红冲功能。

参数说明:Ls_no处方号，即3中的Id.

返回值:：1成功，否则失败。

14、

调用说明:整张处方或费用明细全部作废时调用；

住院红冲函数Int BlankOutVoucher_zy(String Ls_no,string ls_zyh,li_zyxh)

功能说明:完成住院处方红冲功能。

参数说明::ls_no结算号，ls_zyh住院号，ls_zyxh住院序号.

返回值:：1成功，否则失败。

调用说明:整张处方或费用明细全部作废时调用；

15、 诊断传入函数Int SetDiagInfo(String zyh,Long zyxh,String zdmc,string

zdbm,datetime sj,String zdlb)

功能说明：把His诊断信息传入到医疗保险诊断库中，为结算带来数据来源（如果中心不要诊断信息可以不调用该函数）。

参数说明：zyh 住院号

Zyxh 住院序号

Zdmc 诊断名称

Zdbm 诊断编码

Sj 诊断时间

Zdlb 诊断类别，02入院诊断 06 出院诊断

返回值：如果为1成功，-1失败；

调用说明：在调用入院信息函数后调用；

备注：在病人入院调用一次，诊断类别传入02，在病人出院调用一次，诊断类别传入06。

16、 结果返回函数 GetResultInfo(…..):

功能说明:计算结果返回函数

参数说明: Ref_zhzf：本年账户支付

Ref_cdzf：上年账户支付

Ref_tcbx[]：统筹支付金额

12、

Ref_tczf[]：统筹自负金额

Ref_zffy1：自费药品金额

Ref_zffy ：自负总额

Ref_qfx ：起付线金额

Ref_Lineup：封顶线以上

Ref_tjzf：特检先负担金额

Ref_tzzf：特治先负担金额

Ref_gyzf：贵药先负担金额

Ref_jbtcbx：基本统筹报销

Ref_jbtczf：基本统筹自负

Ref_detcbx：大额统筹报销

Ref_detczf：大额统筹自负

Ref_jbtcbxlj：年度内基本统筹报销累计

Ref_detcbxlj ：年度内大额统筹报销累计

Ref_jbylf：本次基本医疗费

Ref_deylf：本次大额医疗费

Ref_begin[]：分段开始

Ref_end[] = 分段截至

Ref_jbylflj：基本医疗费累计

Ref_deylflj：大额医疗费累计

Ref_ylfljzj：医疗费累计总计

Ref_bccltcbx_jb：本次基本材料报销（包含在基本统筹报销内）

Ref_bccltcbx_de：本次大额材料报销（包含在大额统筹报销内）

Ref_wyzf：外地就诊个人先负担

Ref_xmfl[]：项目分类数组

Ref_xmfl[1]：西药

Ref_xmfl[2]：中药

Ref_xmfl[3]：诊疗

Ref_xmfl[4]：化验

Ref_xmfl[5]：检查

Ref_xmfl[6]：B超

Ref_xmfl[7]：X光

Ref_xmfl[8]：CT

Ref_xmfl[9]：核磁

Ref_xmfl[10]：治疗

Ref_xmfl[11]：手术

Ref_xmfl[12]：床位

Ref_xmfl[13]：输血

Ref_xmfl[14]：输氧

Ref_xmfl[15]：理疗

Ref_xmfl[16]：蒙药

Ref_xmfl[17]：其他

Ref_gwybx[] 公务员补贴

Ref_gwybx_jb 基本医疗公务员补贴

Ref_gwybx_de大额医疗公务员补贴

Ref_gwybx_fdxys 封顶线以上公务员补贴

Ref_gwytclj 封顶线以上公务员报销累计

Ref_total 医疗费合计

Ref_dbztc 单病种统筹

ref_dbzjsfy 单病种结算费用，即目录内医疗费

ref_dbzyytc 单病种参照项目统筹差额

返回值：无

调用说明：结算完成后调用，用于获取相关结算信息；

17、 卡信息返回函数ExportVar(Ref CardStruct Structvar)

参数说明: 结构Structvar

卡号：string cardno;

账户编码:string zhbm;

姓名:string xm;

性别:string xb;

出生日期:string csny;

账户指标:decimal zhzb

账户累计支出:decimal ljxf

医疗类别:string yllb

人员类别:string rytz

状态:string grzhzt

单位编码:string dwbm

年度:string nd

住院类计消费:decimal ljxf_zy

功能说明：完成读卡后,信息返回功能；

账户支出备份:decimal ljxf_bak

住院类计消费:decimal ljxf_zy_bak

住院次数:decimal zycs

账户余额:decimal zhye

有效标志:string yxbz

医院编号:string yybh

起付线:decimal qfx

起付线余额:qfxye

备用:string bzw

参加工作时间:string cjgzsj

刷卡标志:string skbz

基本统筹报销累计:decimal jbtcbxlj

大额统筹报销累计:decimal detcbxlj

大额医疗费累计:decimal deylflj

医疗费累计总计:decimal ylfljzj

本次住院先付:decimal bczyxf

床位报销累计:decimal cwbxlj

社会保障号:string shbzh

所在区县:string szqx

灵活就业标志:string lhbz

沉淀账户:decimal cdybf

疾残标志:string jcbz

缴费年限:decimal stjfnx

年龄:decimal nl

标志：boolean lb_return

慢性病统筹支付累计:decimal slowtc

慢性病起付线累计:decimal slowline

备注：以上信息用于显示参保职工信息情况；His用户可以做一外部数据窗进行显示；

返回值：无；

18、 住院类型参数传入函数Int SetVarValue(String Ls_jtbc,string Ls_jylb,decimal

ld_zyts,string ls_mess,string ls_ywsh,string ls_lx,string ls_ryrq)

参数说明：Ls_jtbc 如果传入1为门诊慢性病，否则为正常住院；

Ls_jylb如果为2表示正常住院，如果是门诊慢性病传入1

Ld_zyts传入住院病人从入院到出院之间的天数；

Ils_mess传入0

ls_ywsh意外伤害标识1、是意外伤害，0正常住院；适用居民；职工传入0

ls_lx

病种结算方式1、单纯病种2、复合病种

ls_ryrq入院日期字符型yyyy-mm-dd

调用说明：His在结算init读卡后、结算Calcplan之前调用

调用说明：调用Init函数后调用；用于获取相关IC卡信息；

19、 操作员参数传入函数SetUserId(String Ls_userId)

功能说明：用于向接口中传入用户ID;

参数说明：Ls_userid 编号不能超过5个字符

返回值：无

调用说明：在SetVarValue之后调用

例如：String Ls_userid=’002’

rid(ls_userid)

病种、发票号、慢性病标志传入函数

Int Calc_cherno(String Ls_fph,string ls_jbbm,string ls_flag)

功能说明：用于向接口中传入发票号、疾病编码、慢性病标志;

参数说明：ls_fph 不超过11个全数字字符

Ls_jbbm 不超过16个字符

Ls_flag 1个字符1代表是慢性病，否则不是

返回值：整型，1成功，否则失败

调用说明：在住院结算前调用一次，发票号传入代表此次调用只传

慢性病标志，用于结算走慢性病算法；在结算存盘之前调用一次，发票号传入真实发票号；

21、 Int GetEachInfo(string ls_icno)

功能：完成人员状态查询，返回人员状态值，1为正常看病状态，否则非正常

20、

参数说明：ls_icno 可以根据住院号，查住院登记信息中zhm获取

调用说明：Ls_status：= geteachinfo( ls_icno :)；

返回值说明：1为正常看病状态，否则非正常，发生药费全自费；

备注：每次上传住院费用明细之前调用此函数，把此返回值带入setiteminfo_ex中

22、 退院SetOutHosp(string ls_zyh,string ls_zyxh)

功能说明：完成退院功能;

参数说明：ls_zyh 住院号

Ls_zyxh 住院序号

返回值：整型，1成功，否则失败

23、

24、

备注：此接口全部封闭在一用户对象之中，His用户在使用时，必须在使用可视控件中定义一个实例变量，在可视控件的启动时创建一个该实例对象，以使用对象中的接口函数，在窗口关闭时，释放该实例变量。

5、关于字典表说明

1、基本医疗保险药品目录：sys_yw_ypwc

中文说明

操作码

操作码类别

国际码

国标码

地方码

中文通用名

通用名拼音码

项目编码

乙类标志

甲类标志

限价

目录标志

字段名称

Czm

Czmlb

Gjm

Gbm

Dfm

Zwtym

Tym_py

Xmbm

Gzyp

Gfbz

BXFW

Zzbz

主键

His开发商不用接口程序自动填写

编码对照使用

编码对照使用

编码对照使用

His开发商不用接口程序自动填写

1-乙类否则其他

1-甲类否则自费

材料费限价

1-目录标志否则菲医疗保险目录

说明：His开发商在对照药品代码时使用国际码(Gjm)做对照。

2、 医疗保险诊疗目录：sys_yw_jczlssbm

中文说明

操作码

操作码类别

国际码

国标码

地方码

中文通用名

通用名拼音码

字段名称

Czm

Czmlb

Gjm

Gbm

Dfm

Mc

Pym

主键

说明

His开发商不用接口程序自动填写

编码对照使用

编码对照使用

编码对照使用

项目编码

特检特治标志

诊疗项目限价

目录标志

Xmbm

tjtzbz

GLXE

Gfbz

His开发商不用接口程序自动填写

2-特检，3-特治，4-自费否则其他不应保险项目

1-诊疗目录否则自费

说明：His开发商在对照药品代码时使用操作码(czm)做对照

3、疾病目录

中文说明

操作码

ICD编码

疾病名称

拼音码

慢性病标志

4、科室及其病房编码对照表

字段名称

Czm

Gjm

JBMc

Pym

flag

主键

编码对照使用

说明

sys_yw_bm

中文说明

编码

名称

字段名称

bmbm

bmmc

说明

主键，编码对照使用

5、剂型

中文说明

编码

名称

6、剂量单位

字段名称

jxdm

jxmc

说明

主键，编码对照使用

中文说明

编码

名称

字段名称

dwdm

dw

说明

主键，编码对照使用

补充说明：对于住院结算单据要填写的信息可以通过函数Exportvar和GetResultInfo获取:下面对以下项说明:

出单日期：填写系统时间

凭单号：his生成的主键

结算起至时间:填写入院日期和出院日期

医疗类别：填写医保

人员类别：填写在职、退休或其他，在读完卡时通过函数exportvar得到。

账户号：在读完卡时通过函数exportvar得到。

入院科别:his开发商填写

入院病房:his开发商填写

姓名：在读完卡时通过函数exportvar得到

出院科别：his开发商填写

出院病房：his开发商填写

押金金额：his开发商填写

费用总额：本次发生的费用合计

累计报销：通过函数GetResultInfo获取,即Ref_jbtcbxlj+Ref_detcbxlj

门诊累计消费:在读完卡后，通过函数exportvar得到账户支付累计(ljxf),结算完后通过函数getresultinfo得到本年帐户支付(Ref_zhzf)和上年账户支付(Ref_cdzf),三者加到一起即是门诊累计消费。

基本统筹报销累计：通过函数getresultinfo获取，即Ref_jbtcbxlj

医疗费累计：通过函数getresultinfo获取，即Ref_ylfljzj

基本累计消费：通过函数getresultinfo获取，即Ref_jbylflj

大额报销累计: 通过函数getresultinfo获取，即Ref_detcbxlj

大额累计：通过函数getresultinfo获取，即Ref_deylflj

基本统筹报销：通过函数getresultinfo获取，即Ref_jbtcbx

沉淀保费支付：通过函数getresultinfo获取，即Ref_cdzf

材料费统筹报销支付: 通过函数getresultinfo获取即基本医疗保险(Ref_bccltcbx_jb)和大额医疗保险(Ref_bccltcbx_de)

大额统筹报销：通过函数getresultinfo获取，即Ref_detcbx

个人账户支付：通过函数getresultinfo获取，即Ref_zhzf

自费费用：通过函数getresultinfo获取，即Ref_zffy1

起付线下自负：通过函数getresultinfo获取，即Ref_qfx

封顶线上自负：通过函数getresultinfo获取，即Ref_Lineup

统筹自负：即基本统筹自负通过函数getresultinfo获取，即Ref_jbtczf

大额自负：通过函数getresultinfo获取，即Ref_detczf

预先自负: Ref_tjzf：特检先负担金额,Ref_tzzf：特治先负担金额,Ref_gyzf：贵药先负担金额,三者之和

统筹段一：ref_begin[1]~Ref_end[1] 统筹费用：ref_tcbx[2]统筹自负：ref_tczf[2] 公务员补贴：ref_gwybx[2]

统筹段二：ref_begin[1]~Ref_end[2] 统筹费用：ref_tcbx[3]统筹自负：ref_tczf[3] 公务员补贴：ref_gwybx[3]

统筹段三：ref_begin[1]~Ref_end[3] 统筹费用：ref_tcbx[4]统筹自负：ref_tczf[4] 公务员补贴：ref_gwybx[4]

统筹段四：ref_begin[1]~Ref_end[4] 统筹费用：ref_tcbx[5]统筹自负：ref_tczf[5] 公务员补贴：ref_gwybx[5]

统筹段五：ref_begin[1]~Ref_end[5] 统筹费用：ref_tcbx[6]统筹自负：ref_tczf[6] 公务员补贴：ref_gwybx[6]

统筹段六：ref_begin[1]~Ref_end[6] 统筹费用：ref_tcbx[7]统筹自负：ref_tczf[7] 公务员补贴：ref_gwybx[7]

统筹报销合计：通过函数GetResultInfo获取,即Ref_jbtcbx+Ref_detcbx

统筹自负合计：通过函数GetResultInfo获取,即Ref_jbtczf+Ref_detczf

特检先负担金额：Ref_tjzf；

特治先负担金额：Ref_tzzf；

贵药先负担金额：Ref_gyzf；

备注：His开发商根据需要，可以调整接口函数被调用的位置。

住院接口思路： his开发商需要在入院登记加一下字段，用于记载入院登记时必须的一些信息

1、 转院标志：用于在本次住院前是否 从其他医院转入本医院；字符1

2、 起付线累计：用于记载再转入被医院起付线已经花费累计金额；数值

3、 意外伤害标志：用于记载病人本次住院是否是意外伤害病人；字符1

4、 人员类别：用于记载病人住院人员的特征属性；字符2

5、 医疗保险号：用于记载参保人员的医疗保险号码；字符20

6、 建议his开发创建一个医疗保险结算后接口返回值表，用于记载接口的返回值，数据结构有his开发商根据接口返回值根据需要创建。

门诊接口不要his改变现有数据结构。

本文标签： 函数说明调用住院结算