医保接口方案(提供第三方)

1、新农医接口方案（提供第三方）中软国际2003年8月一前言2二方案使用对象2三参照资料3四第三方软件实现接口的前提3五嵌入式接口软件简要说明3六农医办要求3七版权声明4一新农医病人4二、医疗项目4三、新农医药典4四、新农医大类4五、黑名单4一数据流程5二业务流程6一数据结构说明7二数据表中缺省值列的简写含义7三数据表中解释列的简写含义7一说明7二医院初始化定义相关的表7三数据更新方式8四进行关联9一门诊收费业务新农医数据保存9二住院登记业务新农医数据保存11三住院记账业务新农医数据保存11四住院结算部分新农医数据保存12一功能说明13二DLL函数说明13一退票问题18二特殊参保人群的报销方法说明

2、18引言一 前言新农医接口方案是中软国际和萧山区农医办根据萧山区新农医管理信息系统软件的数据流程的要求共同编写而成，用于辅助第三方医院或卫生院软件提供商修改现有软件，顺利实现与萧山区新农医管理信息系统软件进行联网运行。此方案交农医办确认后实施。二 方案使用对象1) 农医办相关科室及其他相关领导。2) 第三方软件开发商及其技术人员。3) 与新农医接口开发实施的相关技术人员。三 参照资料4) 新农医医疗发票格式.xls（暂无）5) 医疗项目目录.xls（暂无，参照萧山医保）6) 剂型定义.doc（暂无，参照萧山医保）7) 新农医费用大类定义.doc（暂无，参照萧山医保）8) 新农医接口部分软件安装

3、调试说明四 第三方软件实现接口的前提9) 第三方软件必须提供真实有效的数据信息。10) 第三方软件经过修改后必须能够提供所有接口数据库需要的数据。（见数据保存）11) 拥有足够的技术实力，采用直接方式或间接方式正常调用DELPHI所编译的动态链接库DLL。12) 对于不使用前置机的医院和卫生院，要求第三方软件开发商可以开发连接到农医办sockect服务程序的前端接口。五 嵌入式接口软件简要说明1. 运行环境l 操作系统：WIN98以上版本ll 服务器：PIII800以上2. 功能及构成简要说明接口软件分为两部分：接口DLL程序、新农医数据管理程序。13) 接口DLL程序：接口DLL程序，其中包

4、含读取二维条玛卡信息，各种卡状态的判断，并对由第三方提供的就医信息进行新农医费用计算，调用函数后返回状态值。14) 新农医数据管理程序新农医数据管理程序主要用于管理新农医相关数据，形成上传数据，保证与农医办的数据交换。程序包括：数据交换（上传下载），数据查询（包括：农医办药典查询，剂型查询，新农医大类查询，黑名单查询，有效期查询），打印新农医对帐单（包括：住院对帐汇总表、住院对帐明细表）。六 农医办要求15) 要求医院提供独立的新农医服务器16) 新农医服务器数据库权限由农医办掌握，数据库由农医办维护。17) 如有方案有变更，由农医办负责解释。七 版权声明新农医接口方案及提供的样例程序（包括所

5、有卡操作的动态连接库），由萧山区卫生局委托中软国际为萧山区农医办开发，版权由委托方和开发方拥有。新农医接口方案及提供的样例程序（包括所有条码卡操作的动态连接库）仅限于第三方软件开发商内部参考使用，任何情况下都不能以任何方式公开、告知其他任何个人或组织。第一部分 相关名词解释一 新农医病人这里新农医病人的概念，是从定点医疗机构的角度来讲的，它是指是且只是使用二维条码卡在定点医疗机构进行消费的病人。二、医疗项目医疗项目指病人在定点医疗机构消费的所有费用实体。三、新农医药典新农医药典或称医疗项目目录，是由农医办统一制定并下发的医疗项目目录（ItemCenter表），包括药品和诊疗。四、新农医大类新农

6、医大类是由农医办根据首先自付比率的不同定义的大类，根据新农医大类统计新农医病人费用信息供农医办查询统计，也用于住院结算时的发票打印。五、黑名单黑名单记录了作废卡、挂失卡、冒用卡等卡非法信息，所有进入黑名单的卡不能被使用。第二部分 嵌入式接口软件流程一 数据流程1、流程图2、流程说明18) 数据监视：数据监视程序运行以后，不断的检查农医办的数据与医院前置机数据的差别，一旦医院业务操作将数据保存到了农医办医院前置机，程序自动在下一个上传任务中将数据上报到农医办。19) 保存新农医数据：第三方软件首先按照接口数据结构要求保存数据到接口数据库。（数据结构见第五部分 新农医数据保存）20) 调用DLL：

7、调用新农医接口DLL，实现条码卡信息的获取，实现参保人员的身份验证、实现新农医费用计算，返回操作结果。（调用方法见第六部分 DLL调用说明）21) 返回结果信息：第三方软件通过DLL的返回结果获取条码卡信息或结算后的信息。（返回的结构体文件内容及说明见第七章返回信息结构说明）22) 保存医院数据：根据调用DLL返回的结果进行相关处理，包括打印发票进行收费等。0二 业务流程第三部分 新农医数据表结构的几点说明一 数据结构说明下面所提供的表结构（见第四部分和第五部分）并非完整表结构，只是提供需要由第三方软件提供的信息字段，第三方软件对相关表只有查询或者插入权限，没有修改权限。二 数据表中缺省值列的

8、简写含义PK:表示主键FK:表示外键NN:表示非空字段U:表示唯一性IDX:表示创建索引三 数据表中解释列的简写含义条码：表示可以从条码卡中取得的信息。DB：表示可以从接口数据库中取得的信息。IN：表示需要由医院系统提供的信息。第四部分 初始信息关联定义一 说明第三方软件实现新农医接口需要进行相关初始信息的关联，以提供需要的新农医数据。下面的表中只需关联把农医办药典表（ItemCenter）中的农医办序号（ItemNo）与医院本地系统中的药品和项目定义的编码进行关联即可。而剂型表（Conformation）、新农医大类表（MediKind）与农医办药典表（ItemCenter）进行关联的。用于

9、提供与农医办药典表（ItemCenter）关联时的剂型信息和新农医大类信息。二 医院初始化定义相关的表1. 农医办药典表23) 表名称：ItemCenter24) 表结构：序号字段名数据类型缺省值约束解释1ItemNoVarchar2(10)NN,IDX农医办序号2NumNoNumber (10)NN,IDX数字编码3SpellNoVarchar2(15)NN,IDX拼音编码4ItemNameVarchar2(100)NN药典名称5UnitVarchar2(100)NN单位（治疗项目的单位）6CON_IDChar(2)FK剂型编码7MK_IDChar(2)FK新农医大类编码8IsMedicin

10、eChar(1)NN是否是药9IsMedicareChar(2)NN是否新农医项目，自费5010SelfPayRatioNumber（4,3）NN首先自付比例11ConnotationVarchar2(300)项目内涵12ExclusionVarchar2(300)除外内容13MaxPriceNumber(8,2)0NN最大价格限制14HighLimitCityNumber(8,2)0NN市级医院最大价格限制15HighLimitTown Number(8,2)0NN县（区）级最大价格限制HighLimitVillage Number(8,2)0NN乡级最大价格限制25) 表作用：记录农医办药

11、典信息（医疗项目目录）。26) 关联表：CON_ID关联Conformation表，MK_ID关联MediKind表27) 说明：28) IsMedare字段的值的确定，如果ISMEDICARE的值大于医院的等级，那么此项目（药品）对此医院限制使用。如果为50，那么此项目（药品）为全自付。 2. 剂型表1) 表名称：Conformation2) 表结构：序号字段名数据类型缺省值约束解释1CON_IDChar(2)PK剂型编码2CON_NAMEVarchar2(15)NN剂型名称3) 表作用：记录剂型信息。4) 关联表：通过CON_ID关联ItemCenter表3. 新农医大类表1) 表名称：M

12、ediKind2) 表结构：序号字段名数据类型缺省值约束解释1MK_IDChar(2)PK新农医大类编码2MK_NAMEVarchar2(16)NN新农医大类名称3SelfPayRatioNumber(4,3)NN首先自付比率3) 表作用：记录新农医大类定义信息。4) 关联表：通过MK_ID关联ItemCenter表三 数据更新方式由新农医数据管理程序（数据监视）自动完成更新。医院系统应该能够自动根据新农医数据库的变动进行相应的对应修改（ItemNo不会改变，但会增加）。四 进行关联农医办药典表（ItemCenter）关联着剂型表（Conformation）和新农医大类表（MediKind），

13、第三方软件所定义的医疗项目需要与农医办药典（ItemCenter）表进行关联，以保证能够提供相关的新农医数据。第五部分 新农医数据保存一 门诊收费业务新农医数据保存数据表结构与保存说明如下：1. 门诊预算收费主表1) 表名称：PreClinicBill2) 表结构：序号字段名数据类型缺省值约束解释1ClinicBillNoVarchar2(20)PK序号IN2PatientIDVarchar2(20)NN病人此次看病标识IN3) 表作用：门诊预算收费主表信息4) 关联表：通过ClinicBillNo关联PreClinicBillDetail表5) 说明：A、 ClinicBillNo必须是唯一

14、的主键字段B、 PatientID：病人此次看病的标识。病人一次看病可能对应多张发票，但只有唯一的PatientID。即一个病人一次消费应该对应一个唯一的PatientID。C、 进行门诊预算调用前需要首先填写门诊预算收费主表和门诊预算费用明细表。2. 门诊预算费用明细表1) 表名称：PreClinicBillDetail2) 表结构：序号字段名数据类型缺省值约束解释1ClinicBillNoVarchar2(20)FK序号IN2ItemNoVarchar2(8)NN农医办药典序号DB3HosItemNameVarchar2(40)NN医院药典名称IN4PriceNumber(10,5)0NN

15、单价IN5QuantityNumber(10,5)0NN数量IN6AmountNumber(10,5)0NN金额IN7SpecVarchar2(40)规格IN3) 作用：门诊收费药品项目消费明细4) 关联表：通过ClinicBillNo关联PreClinicBill表5) 说明：A、 提供ItemNo是进行新农医费用计算的必要条件。 B、 如果是中药，则明细中存储的是实际的用量。如：中药5付，每付10克，则明细中存储50克的数量和金额。C、 ItemNo可通过在初始信息关联定义中进行的关联来获得。3. 门诊收费主表6) 表名称：ClinicBill7) 表结构：序号字段名数据类型缺省值约束解释

16、1ClinicBillNoVarchar2(20)PK序号IN2InvoiceNoVarchar2(20)NN,U发票号IN3PatientIDVarchar2(20)NN病人此次看病标识IN4DepartmentNameVarchar2(20)NN部门名称IN5DoctorNameVarchar2(8)NN医生名称IN6OccurDateDateNN票据日期IN7RedBillFlagNumber(1,0)1NN冲票标志（1：正票；-1：红票）IN8) 表作用：门诊收费主表信息9) 关联表：通过ClinicBillNo关联ClinicBillDetail表10) 说明：A、 ClinicBi

17、llNo必须是唯一的主键字段B、 PatientID：病人此次看病的标识。病人一次看病可能对应多张发票，但只有唯一的PatientID。即一个病人一次消费应该对应一个唯一的PatientID。C、 OccurDate:打印票据时的日期，ORACLE可以同时保存日期和时间。D、 冲票操作：产生一条新的红票数据，冲票标志（RedBillFlag）为-1，被冲票据号（StrikedBillNo）为被冲的票据的序号（InHosBalanceNo）。其他数据插入方法与正票插入方法相同。E、 门诊冲票以后，再次进行结算时，门诊主表和门诊明细表中的数据必须重新填写。4. 门诊费用明细表6) 表名称：Clin

18、icBillDetail7) 表结构：序号字段名数据类型缺省值约束解释1ClinicBillNoVarchar2(20)FK序号IN2ItemNoVarchar2(8)NN农医办药典序号DB3HosItemNameVarchar2(40)NN医院药典名称IN4PriceNumber(10,5)0NN单价IN5QuantityNumber(10,5)0NN数量IN6AmountNumber(10,5)0NN金额IN7SpecVarchar2(40)规格IN8) 作用：门诊收费药品项目消费明细9) 关联表：通过ClinicBillNo关联ClinicBill表10) 说明：D、 提供ItemNo是

19、进行新农医费用计算的必要条件。 E、 如果是中药，则明细中存储的是实际的用量。如：中药5付，每付10克，则明细中存储50克的数量和金额。F、 ItemNo可通过在初始信息关联定义中进行的关联来获得。二 住院登记业务新农医数据保存5. 入院登记表1) 表名称：InHosRegister2) 表结构：序号字段名数据类型缺省值约束解释1InHosRegisterNoVarchar2(20)PK入院登记序号IN2InHosNoVarchar2(20)住院号IN3DepartmentNameVarchar2(20)NN部门名称IN4DoctorNameVarchar2(8)NN医生名称IN5InHosS

20、ickNameVarchar2(30)入院病种名称IN6InHosDateDateNN入院日期IN3) 表作用：住院登记信息 4) 关联表： 5) 说明：A、 InHosRegisterNo：必须是唯一的标识。即每一个病人的每一次看病对应该有唯一的InHosRegisterNo，此号不同于病案号。三 住院记账业务新农医数据保存1. 住院记账主表1) 表名称：InHosBill2) 表结构：序号字段名数据类型缺省值约束解释1InHosBillNoVarchar2(20)PK记账主表序号IN2InHosRegisterNoVarchar2(20)FK入院登记序号IN3DepartmentNameV

21、archar2(20)科室名称IN4DoctorNameVarchar2(8)医生名称IN5SickNameVarchar2(30)治疗病种名称IN6AmountNumber(10,2)0NN费用金额IN7RedBillFlagNumber(1,0)1NN退费标志（1：收费；-1：退费）IN8OccurDateDateNN发生日期IN3) 表作用：住院记账信息主表4) 关联表： 通过InHosRegisterNo关联InHosRegister表。通过InHosBillNo与InHosBillDetail表关联。5) 说明：A、 退费处理：产生一条新的红票数据，冲票标志（RedBillFlag）

22、为-1，明细中存入需要退的项目信息，金额、数量和价格都是正数。B、 InHosBillNo必须是唯一序号。2. 住院记账明细表1) 表名称：InHosBillDetail2) 表结构：序号字段名数据类型缺省值约束解释1InHosBillNoVarchar2(20)FK记账主表序号IN2ItemNoVarchar2(8)NN农医办药典序号DB3HosItemNameVarchar2(40)NN医院药典名称IN4PriceNumber(10,5)0NN单价IN5QuantityNumber(10,5)0NN数量IN6AmountNumber(10,5)0NN金额IN7SpecVarchar2(40

23、)NN规格IN3) 表作用：住院记账药品和项目费用信息明细表4) 关联表：通过InHosBillNo与InHosBill表关联。四 住院结算部分新农医数据保存3. 住院结算表1) 表名称：InHosBalance2) 表结构：序号字段名数据类型缺省值约束解释1InHosBalanceNoVarchar2(20)PK结算序号IN2InvoiceNoVarchar2(20)NN,U发票号IN3InHosRegisterNoVarchar2(20)NN入院登记序号IN4DepartmentNameVarchar2(20)NN出院科室名称IN5DoctorNameVarchar2(8)NN医师名称IN

24、6OutHosCureCodeChar(1)NN出院治疗情况(0-治愈1-好转2-未愈3-死亡4-转院) IN7OutHosDateDateNN出院日期IN8InHosDaysNumber(3,0)NN在院天数IN9OccurDateDateNN票据发生日期IN3) 表作用：出院费用结账信息表4) 关联表：通过InHosRegisterNo关联InHosRegister表。5) 说明：A、 InHosBalanceNo：是唯一标识。B、 冲票操作：产生一条新的红票数据，冲票标志（RedBillFlag）为-1，被冲票据号（StrikedBillNo）为被冲的票据的序号（InHosBalance

25、No）。其他数据插入方法与正票插入方法相同。C、 住院冲票操作以后，不需要重新上传住院记账主表的数据和记账明细的数据。4. 住院病种表：6) 表名称：inHosSick7) 表结构：序号字段名数据类型缺省值约束解释1HOSCODE Varchar2(20)NN医院代码IN2INHOSBALANCENOVarchar2(20)NN,U结算序号IN3SICKSERIALNOVarchar2(20)NN出院病种代码IN4SICKNAMEVarchar2(20)NN出院病种名称IN5SICKKINDCODEVarchar2(8)NN病种类型 IN6HOSSICKNAMEChar(1)NN出院病种医院方

26、名称IN8) 表作用：出院费用结账病种信息表9) 关联表：通过inhosBalanceNO关联出院结算表,通过SICKKINDCODE关联sickKind表。10) 说明：病种类型现在只需要普通病种。住院结算、预算计算时需要，插入住院病种信息第六部分 DLL调用说明一 功能说明新农医接口DLL名称为DataExchange.DLL，通过调用DLL，可以获得验证传入信息，可以完成新农医收费并通过返回的字符串读取相关信息（结构体说明见下）。二 DLL函数说明1. 说明1) 调用动态连接库函数返回相应的字符串返回值时，正确的返回结果值以开始符表示数据的起始，结束符表示数据的终止。开始符，结束符均用字

27、符*来表示，长度为一位。2. 获取个人基本信息1) 函数体function VerifyCardInfo() : pchar;2) 入参说明3) 函数返回null 异常失败，其他：查找成功 4) 返回处理如果成功，则返回值为指向一个字符串的地址指针。（具体信息见下）。如果异常失败，函数会返回一个错误号，医院管理软件应对此处理后，重新调用接口函数。如果返回成功，医院软件应根据返回的结构体中的数据，提示是否走自费，如果是则按自费处理，如果否，则终止业务。5) 返回值字符串结构说明startflag|成员编码|新农医编号|姓名|身份证号|性别|出生年月|住址|endflag注：卡状态和参保人状态应该

28、通过错误信息的返回报告给你们，而不应该和正确的返回放在一起。3. 从二维条码卡中读取照片信息1) 函数体function GetPhone() : pchar;2) 入参说明3) 函数返回null 异常失败，其他：查找成功 4) 返回处理如果成功，则返回值为指向一个照片数据的地址指针。如果异常失败，函数会返回一个空指针和一个错误号，医院管理软件应对此处理后，重新调用接口函数。如果返回成功，医院软件应根据返回的结构体中的数据，提示是否走自费，如果是则按自费处理，如果否，则终止业务。5) 说明调用此函数前必须先调用获取个人基本信息函数，否则得不到需要的照片。4. 门诊预算收费调用1) 函数体fun

29、ction PreClinicCharge(PatientID: Pchar): pchar; 2) 入参说明PatientID：Pchar类型，对应门诊预算收费主表（PreClinicBill）中的PatientID字段信息。3) 函数返回 null 异常失败，其他：收费计算成功4) 返回处理同获取个人基本信息5) 返回字符串结构说明开始符|成员编码|门诊总费用|个人现金支付|农医办支付|结束符6) 说明调用门诊预算收费函数前，必须填写门诊预算主表5. 门诊收费调用1) 函数体function ClinicCharge(PatientID: PChar):pchar; 2) 入参说明Pati

30、entID：Pchar类型，对应门诊收费主表（ClinicBill）中的PatientID字段信息。3) 函数返回 null 异常失败，其他：查找成功4) 返回处理同获取个人基本信息5) 返回字符串结构说明开始符|成员编码|门诊总费用|个人现金支付|农医办支付|结束符6. 门诊退票调用1) 函数体function UnClinicCharge(ClinicBillNo,UnClinicBillNo: PChar): Integer; 2) 入参说明ClinicBillNo,UnClinicBillNo：Pchar类型，Clinic BillNo是冲票单据号，UnClinicBillNo是被冲票

31、据号。3) 函数返回 0: 操作成功，其他：操作失败4) 返回处理5) 说明7. 住院登记调用1) 函数体function InHosReg(InHosRegisterNo: PChar): Integer:2) 入参说明InHosRegisterNo: Pchar，对应入院登记表（InHosRegister）的InHosRegisterNo字段信息。3) 函数返回 0: 操作成功，其他：操作失败4) 返回处理同获取条码卡信息函数8. 退住院登记调用1) 函数体function UnInHosReg: Integer:2) 入参说明3) 函数返回 0: 操作成功，其他：操作失败4) 返回处理9

32、. 住院结算预算调用1) 函数体function PreInHosBalance(InHosRegisterNo: Pchar, OutSickcode:Integer,outsickkind : integer):pchar;2) 入参说明InHosRegisterNo: Pchar，对应入院登记表（InHosRegister）的InHosRegisterNo字段信息。OutsickCode: 对应农医办病种目录中的病种代码。Outsickkind；病种类型.（现在只有一种,1，普通病）3) 函数返回 null 异常失败，其他：查找成功4) 返回处理同获取条码卡信息函数5) 字符串结构开始符

33、|总费用|全自费金额|首先自付|进入统筹费用(包括起付线)|实际起付线金额|统筹支付|统筹自付|超限费用|个人账户支付|现金支付|结束符预算调用的正确结果用*开头，表示。后面跟数据体。10. 普通住院结算调用1) 函数体function InHosBalance(InHosBalanceNo: PChar):Integer;2) 入参说明InHosBalanceNo：Pchar类型，对应住院结算表(InHosBalance)中的InHosBalanceNo字段信息。3) 函数返回 null 异常失败，其他：查找成功4) 返回处理同获取条码卡信息函数5) 字符串结构结果标志|总费用|全自费金额|

34、首先自付|进入统筹费用(包括起付线)|执行起付线|实际起付线金额|统筹支付|统筹自付|超限费用|个人账户支付|现金支付|6) 说明：结果标志长度一位，值为 *，预算调用的正确结果用*开头，表示。后面跟数据体。11. 住院结算冲票调用1) 函数体function UnInHosBalance (InHosBalanceNo,UnInHosBalanceNo: PChar):Integer;2) 入参说明InHosBalanceNo：Pchar类型，对应住院结算表(InHosBalance)中冲票的InHosBalanceNo字段信息。UnInHosBalanceNo：Pchar类型，被冲票据的I

35、nHosBalanceNo字段信息。3) 函数返回 0: 操作成功1：操作失败4) 返回处理12. 开始事务1) 函数体function BeginTrans ():Integer;2) 入参说明3) 函数返回 0: 操作成功1：操作失败4) 说明新农医的事务控制全部由第三方软件开发商控制，第三方应该在开始自己的事物以后开启新农医的事物，在提交自己的事物之前提交新农医的事物。应该尽可能晚的开启新农医的事物，新农医事务的提交与医院事务的提交之间不应有其他的操作。13. 回滚事务1) 函数体Procedure RollBack ();2) 入参说明3) 函数返回无4) 说明14. 提交事务1) 函

36、数体function CommitTrans ():Integer;2) 入参说明3) 函数返回0: 操作成功1：操作失败4) 说明提交成功，第三方提交自己的事物。提交失败，则调用回滚函数，回滚新农医事务，然后回滚第三方自己的事物。15. 查询备案信息1) 函数体function VerifyMemo(ItemNO:Pchar，CureNo: Integer): Integer;2) 入参说明ItemNO :农医办药品(诊疗项目编码)CureNo: 备案号码3) 函数返回0， 农医办未备案、1， 农医办已备案其他值：错误。16. 返回错误代码所对应的中文信息1) 函数体function Get

37、ErrToStr(aInt: Integer): string;2) 入参说明aInt: Integer :以上函数返回的错误代码。3) 函数返回 错误代码对应的错误信息。17. 错误代码描述 101,201,402,502: tmpStr := '传入的病人标识没有对应的数据信息。' 102: tmpStr := '卡处于黑状态或深灰状态，停新农医支付。' 2,103,306,1101: tmpStr := '读卡失败！' 104,203,706,804,904: tmpStr := '此病人费用出现负数，请检查费用信息。' 301: tmpSt