医保接口编码规范说明文档修订版Word文档格式.docx

1、后台实现类3.医保接口定义及开发说明3.1主要业务接口调用流程出院收费3.2 医保常用公共对象参数说明医保相关的公共数据对象 ybbhxx : null, /病人基本信息ybcfxx : null, /门诊处方信息ybyzxx : null, /住院医嘱明细信息ybfyxx : null, /医保费用信息 YBTCZF: 医保统筹支付（对应HIS的QTYS） YBZHZF:医保帐户支付 YBZJJE: 医保总计金额 YBZFJE: 自负金额 / HISZJJE:业务总计金额 HISZFJE:业务自费金额 HISXJJE: 业务现金金额 HBWC: 货币误差ybkxx : null, /医保读卡

2、信息ybfpxx : null, /传回给主业务模块，需要打印发票的地方调用些对象打印医保相关的内容3.3 医保相关表结构定义项目对照表，大部分医保都需要在本地库实现医院的代码表与医保的三大目录对照的功能，费用明细上传的时候一般都会要求上传医院的代码和医保中心的编码。YB_DMB_?医保参数代码表，以后每个地区医保要实现自己的对照表，比如韶关命名方式为:YB_DMB_SGYB字段名类型说明SBXHNumber（18）识别序号LXNumber（2）按照医保的要求定义字典的类型BMVarchar（20）编码DH代号MCVarchar（30）名称后面根据需要自己扩展YB_XMDZB_?医保项目对照表

3、，以后每个地区医保要实现自己的对照表，比如韶关命名方式为:YB_XMDZB_SGYBJGID机构ID类型:1药品 2医疗服务项目字典 3材料 4服务设施HISBM内部编码HISMCVarchar（100）内部名称HISGG内部规格HISDWYBBM医保编码YBMC医保名称YB_YBML_?医保中心提供的目录表，以后每个地区医保要实现自己的目录表，比如韶关命名方式为:YB_YBML_SGYB字典类型:1药品 2医疗服务项目 3材料 4服务设施PYM拼音码GG规格DW单位JX剂型FYFL费用分类ZFBLNumber（18,4）自负比例DJ单价YB_YBKXX医保卡信息，用于保存医保读卡返回的信息B

4、RID病人IDBRXM姓名BRXB性别CSRQ出生日期BRNLVarchar（10）年龄SFZH身份证号ICKHIC卡号SBKH社保卡号GRBH个人编号MZ民族DQBM医保地区编码：内部为每个医保编号DWBMVarchar（19）单位编码DWMCVarchar（50）单位名称YLLB医疗类别CBLB参保类别CBZT参保状态YB_GHJS医保挂号结算表，用于记录每次医保挂号结算相关的信息GHGL挂号序号YBDJH医保登记号YBLSH医保流水号ZFPBNumber（1）作废标志：0正常 1作废YBTCZFNumber（18,2）医保统筹支付YBZHZF医保帐户支付YBZJJE医保总计金额YBZFJ

5、E医保自负金额HISZJJE业务总计金额HISZFJE业务自费金额HISXJJE业务现金金额HBWC货币误差YB_MZJS医保门诊结算表，用于记录每次医保收费结算相关的信息MZXH门诊收费序号FPHM发票号ZDBM医保诊断编码ZDMC医保诊断名称YB_ZYJS医保住院结算表，用于记录每次医保住院结算相关的信息ZYH住院ID号3.4 医保接口函数定义医保接口详细定义请查看phis.application.yb.script.MedicareCommonMethod.js文件，此文件定义了医保接口需要实现的基本流程接口函数，以后新开发一个医保接口都要按照具体的功能点在相应的接口函数里实现。/* *

6、 使用说明：MedicareCommonMethod.JS是整个医保接口函数声明的模块，要开始做一个医保接口的时候，需要实现doYbjddk后面 * 的所有接口函数，实现后需要在本文件的initYBServer配置好要调用的模块，业务模块每次调用医保接口的时候会调用initYBServer方法 * 动态装载要调用相应的医保的JS实现模块，具体参考MedicareCommonMethod4SGYB.JS的实现。 * -write by candy 2016.8.3 */phis.application.yb.script.MedicareCommonMethod = * 初始化医保服务方法,每增

7、加一个医保需要在此方法内声明要调用的接口文件 * param BRXZ */ initYBServer : function（brxz）/通用医保读卡，给建档界面调用 doYbjddk:function（） , /清除医保缓存信息 clearYbxx : function（） this.ybbhxx = null; this.ybcfxx = null; this.ybyzxx =null; this.ybfyxx = null; this.ybkxx = null; /医保挂号读卡 doYbghdk: /读卡界面点击确认后回调方法 onQr_mzghdk : function（ybxx） t

8、his.ybkxx = ybxx; /医保挂号预结算 doYbghyjs : function（） var ret = ; retresult = true;msg = 成功; return ret; /医保挂号确认结算 doYbghjs : / 医保退号 doYbghth : /退号界面确定后的回调函数 onQr_Ghth : /-门诊收费部分开始- /医保门诊收费读卡 doYbmzsfdk: / 读卡返回 自动调用病人结算信息 onQr_mzsfdk : / 医保门诊收费预结算 doYbmzyjs : /医保门诊收费确认结算 doYbmzjs: /门诊收费保存数据过程中发生异常，调用医保费

9、用冲销功能 doYbmzsfcx: function（） /门诊收费退款读卡 doYbmztkdk: , / 门诊收费发票作废读卡成功 onQr_mzfpzf : .3.5 开发一个新医保接口的步骤1、在phis.application.yb包下面按照首拼码新建相应的包，如韶关医保为sgyb,然后在其下再建存放JS代码的script和实现后台Java服务的source包。2、新建MedicareCommonMethod4xxYB.js的接口实现文件，接口必须要实现phis.application.yb.script.MedicareCommonMethod对象里定义的医保业务接口。3、打开ph

10、is.application.yb.script.MedicareCommonMethod.js文件，在initYBServer方法里面必须要定义好实现具体医保业务逻辑的接口文件，在switch块里增加一个case选项声明实现的接口文件，如下所示：4、在相关的医保实现文件里实现具体的医保业务逻辑，医保开发人员不需要关心主业务的代码，主业务已经按医保结算的流程定好了哪个步骤会调用哪个医保的接口函数。以下为在MedicareCommonMethod.js文件定义的公共Json对象，开发人员需要访问业务的病人基本信息时，只需要通过ybbhxx对象就可以访问了，同时需要将医保读卡返回的信息保存到ybk

11、xx对象，可能通过ybcfxx对象取得门诊收费的处方明细信息，通过ybyzxx对象取得住院的医嘱明细，医保预结算和结算返回结果后，需要将相关的费用信息保存到ybfyxx对象，以便业务模块能够访问该对象的数据，如需打印一些医保相关的信息，需要将打印的内容保存到ybfpxx对象里，业务模块会自动打印该对象里的内容。 / HISZJJE:3.6 医保数据保存方法 MedicareService是医保后台数据处理对外开放的服务类，具体实现由MedicareModel来完成。医保接口的业务数据保存已经规范化，每个医保的实现都要继续MedicareModel类，在相应的接口方法里覆盖父类的方法，实现自己的

12、数据保存处理过程。主要对门诊挂号、退号、门诊处方结算、门诊发票作废、住院登记、取消登记、住院结算、取消住院结算的数据保存提供的接口。每个医保需要在自己确认接口里调用数据保存前，将需要保存的数据对象封装到YBXX对象里，并且需要指定是属于哪个医保的，如韶关医保需设置YBXX“yblx”=sgyb,具体实现代码参考doSaveYbghxx。每增加一个医保接口需要更新YbModelType类里定义的医保类型，/以下为医保业务数据保存接口，具体每个医保的实现需要在每个地区的MedicareModal去实现， /在调用接口时需要传入yblx参数值，接口根据YBLX决定调哪个接口实现类 /* * 医保门诊

13、挂号数据保存 * param req * param res * param dao * param ctx * throws ServiceException public void doSaveYbghxx（Map req, Map res, BaseDAO dao, Context ctx） throws ServiceException* 医保门诊退号数据保存 public void dosaveYbGhth（Map BaseDAO dao, Context ctx） throws ServiceException* 医保门诊结算数据保存 * param req * param res * param dao * param ctx * throws ServiceException */ public void dosaveYbMzjs（Map* 医保门诊发票作废 public void dosaveYbmzFpzf（Map* 医保入院登记数据保存 public void dosaveYbZydj（Map* 医保住院取消登记数据保存 *