赣州市医保接口标准规范.doc

资源描述

1、接口更新内容：本次医保接口动态库ZRHosJK.dll基于原接口规范不变基本上增长一项业务：【收费发票打印】(涉及门诊和住院收费发票打印)，详细调用办法详见本文档21页。 -于09月01日网点接口规范一概述为了保证医疗保险管理系统和网点管理信息系统完整性和独立性以及数据同步和一致性，需要提供一种原则数据输入输出接口，建立一种公用数据互换原则。因而，开发出一套通用适合于各种类型医疗管理机构、能嵌入各种管理软件接口系统是保证医保顺利实行核心。为此，提出如下中心系统与网点系统接口规范。二医疗机构接入准备1. 硬件规定引用接口系统嵌入模块终端机器至少要64M 内存，并有足够空间安装支持软件。网络

2、上规定必要能访问中心应用服务器。2. 软件规定接口系统当前支持Windows95/98/NT系统平台下所开发应用系统，各应用系统必要能正常调用Windows原则API函数（例如用PB、Delphi、VB、VC、C+Builder等开发软件都可以支持）。依照电脑技术发展形式，嵌入模块不支持DOS系统下开发应用软件。三数据规定接口系统需要从医疗机构获得必要数据，为统一编码，录入数据尽量采用医保中心提供编码规则，医疗机构需要依照需要将自身系统编码做对照，医疗机构需要对照内容涉及：1）药物目录详见药物目录表、诊断目录表2）病种编码目录详见病种编码目录表3）收费类别目录详见收费类别目录表4）科

3、室目录医院自身设立科室名称。5）项目级别详见项目级别目录表6）医疗类别详见医疗类别表7）关于日期时间数据包中关于日期时间数据，日期格式为4位年份+2位月份+2位日，时间格式为2位时+2位分。例如，“-9-4”则需填写“”，“14：08”则填写“1408”8）其他如果数据为空值，则用“NULL”代替传入。对于返回数据同样，如果数据为空，则返回相应“NULL”。医院接口涉及文献： 1). ZRHosJK.dll 接口动态库。2). Mwic_32.dll，ZrkjDll.dll 读卡器动态库。3). PRINTFP_NEW.fr3 门诊收费发票和住院结算发票打印模板。于8月31日增长四医

4、疗机构端嵌入模块医疗机构端嵌入模块（如下简称嵌入模块）是整个接口系统唯一和顾客交互模块。对于医疗机构，仅调用此模块中提供顾客交易功能即可完毕医保病人业务解决。嵌入模块包括若干种顾客交易，对医疗机构来说，顾客交易为其唯一可视交易。1. 嵌入模块内容嵌入模块主文献为ZRHosJK.DLL，ZRHosJK提供外部调用函数重要涉及交易申请函数f_UserBargaingApply、交易初始化函数f_UserBargaingInit和交易关闭函数f_UserBargaingClose。2. 交易初始化和关闭函数医疗机构软件每次启动时，需要调用接口系统中顾客交易初始化函数，初始化接口并获得交易参数，即可

5、连接到中心系统数据库中。同样，应用软件退出时调用顾客交易关闭函数释放系统资源。函数原型：function f_UserBargaingInit(UserID,PassWD:PCHAR;retMsg:PCHAR):Integer;功能：系统应用前初始化数据准备，连接到中心系统应用服务器。参数阐明：传入参数：UserID -由中心系统管理员分派给医疗机构端顾客 PassWD -由UserID相应密码 retMsg -返回错误信息返回值： 0-成功，没有任何警告 0-失败，错误信息在retMsg中备注：返回值登陆顾客名错误-5 -顾客密码错误-6 -顾客名密码验证失败调用之前，retMsg

6、必要分派空间。PowerBuilder中函数定义：Function int f_UserBargaingInit(string UserID,string PassWD,ref string retMsg ) 函数原型 function f_UserBargaingClose(retMsg:PCHAR):Integer; 功能：退出系统前释放资源，关闭连接以及退出IC卡驱动。返回值：0-退出成功 0 表达交易成功 0 表达交易失败，并返回交易失败因素在retMsg中PowerBuilder中函数定义：function int f_UserBargaingApply(string Ywlx,s

7、tring InData,ref string OutData,ref string retMsg ) 函数原型function f_GetGRID00(sGRID00:PChar):Integer;stdcall;export;功能：可以不用读卡，直接得到个人编号。如：住院医疗保险人员，在办理其她业务之前，调用该函数，就可以得到个人编号。函数原型function f_GetUserLoginMsg(OutData:PChar):Integer;stdcall;export;功能：直接返回顾客登陆信息。返回数据包(OutData)格式为：“顾客ID|顾客姓名|顾客类别|服务机构编号|服务机构

9、C卡有效性等。MZGH门诊挂号MZSF门诊收费MZGHCX门诊挂号冲销MZSFCX门诊收费冲销MZSFYJS门诊收费预结算YDSF药店收费YDSFCX药店收费冲销ZYDJ住院登记ZYSF住院收费不采用CYDJ出院登记ZYDJCX住院登记冲销ZYSFCX住院收费冲销可以不刷卡CYDJCX出院登记撤销ZYYJ住院预缴收费可以不刷卡ZYYJCX住院预缴冲销ZYSFDJ住院收费登记可以不刷卡ZYSFTF住院收费退费ZYSFYJS住院收费预结算ZYSFJS住院收费结算ZYDJBG住院登记变更SFFPDY收费发票打印于-8-31新增业务可以不刷卡注意：在交易过程中，每个数据均以“|”符符号隔开，如果数据为

10、空值，则用NULL代替。每个数据包分隔符为“;”（半角）。每个数据必要空格符号，如果交易失败，其错误因素可从retMsg参数获得。异常出错解决，最后需要调用函数f_UserBargaingClose来关闭数据链接,并释放资源。传入参数InData可以是各种数据包构成，传出参数OutData也可以是各种数据包构成六业务阐明 1. 交易前刷卡办理各个业务时，必要先刷卡，刷卡前，必要保证IC卡在读卡器内，刷卡成功后，返回参保人员基本信息，这样才干进行业务交易。交易成功后，返回数据包(OutData)格式为：“保险号|姓名|卡号|出生日期|年龄|参保日期|单位编号|单位名称|性别|医疗人员类别|所属

11、地区|卡状态|账户余额”。例如：“00|李四|000048|39|NULL|00010012|某某单位|男|在职|某某市|正常|999.99” 某些交易类型刷卡返回数据，此外解决如下：返回门诊收费刷卡信息或药店收费刷卡信息，(OutData)格式为：“保险号|姓名|卡号|出生日期|年龄|参保日期|单位编号|单位名称|性别|医疗人员类别|所属地区|卡状态|账户余额|门诊流水号|挂号科室名称”。返回住院收费刷卡信息、出院登记刷卡信息或住院预缴刷卡信息，(OutData)格式为：“保险号|姓名|卡号|出生日期|年龄|参保日期|单位编号|单位名称|性别|医疗人员类别|所属地区|卡状态|账户余额|住院流

12、水号|住院科室|本次看病次数”。其中“NULL”表达该字段为空值。如果交易失败，返回错误信息在RetMsg中。返回个人参保信息为明文数据，顾客可以分解后使用。办理其她业务前，都必要刷卡时，否则，无法获得IC卡相应信息。参数YWLX相应值上述表格代码相相应。例如，办理“门诊挂号”，先调用f_UserBargaingApply函数，获得参保人员基本信息，其中，参数YWLX为MZGHSK,参数InData为空，参数OutData需要分派足够大空间，参数retMsg也分派足够大空间。然后，可以从刷卡后返回数据包中，获得关于信息。2. 门诊挂号业务类型代码：“MZGH”。传入数据包(InData)格式为

13、：“卡号|保险号|姓名|单位名称|科室|医疗类别|挂号费|挂号日期|挂号时间|经办人”。例如：“000048|00|李四|市委老干部局|外科|普通门诊|6.50|1608|admin”阐明：【医疗类别】为中心系统规定类别中文名称一致（详见医疗类别目录表）。否则将取不到对的数据。挂号日期，例如“9月4日”，需填写“”.同理，挂号时间同样，例如：“下午4点8分”，需填写“1608”.数据交易成功，返回数据包(OutData)格式为：A. 主表数据包格式为：“门诊号|个人编号|姓名|单位编号|单位名称|挂号科室|医疗类别|挂号费|挂号日期|挂号时间|冲销单据号|卡号|出生日期|年龄|参保日期|性别|

14、人员类别|所属地区|卡状态|账户余额|经办人”。B. 个人慢性病审批数据包格式为：“病种编码|病种名称;病种编码|病种名称”。阐明：门诊挂号，此时冲销单据号为空值，返回是NULL ;医疗类别选取“门诊慢性病（一类）或门诊慢性病（二类）”时，才返回该参保人审批慢性病信息。3. 门诊收费业务类型代码：“MZSF”。传入数据包(InData)由两某些构成：主表数据包和消费明细数据包A. 主表数据包格式为：“与否打印门诊收费发票|卡号|门诊号|保险号|姓名|账户余额|病种编号|病种名称|单位编号|单位名称|开方医生”。例如：“TRUE|000048|00000105|00|李四|0|NULL|NULL

15、|00010012|市委老干部局|李医生”阐明：病种编号和病种名称必要是中心系统规定病种（详见病种目录表）。如果没有病种信息,则用NULL代替。【与否打印门诊收费发票】：当传入参数为TURE则接口直接打印出门诊收费发票，当传入参数为FALSE则不调用接口门诊收费发票打印功能。B消费明细数据包格式为：“项目编号|项目名称|单价|数量|金额|收费类别|项目级别|与否药物和非药物|与否医保|处方日期”。例如：“00003|苯唑西林|12.5|2.00|25.00|西药费|甲类|1|1|;00005|青霉素|12.00|2.00|24.00|西药费|甲类|1|1|”阐明：【收费类别】必要是中心系统规定

16、类别(详见收费类别目录表)，只需传中文名称，但保证中文名称与收费目录表目录一致，否则，接口无法获得相应代码。如“西药费”，“中药费”等收费中文名称。【项目级别】必要是中心系统规定项目级别（详见项目级别目录表），传入项目级别名称必要与项目级别目录表中中文名称一致。例如：“甲类”，“乙类”等。【药物编号和名称】必要是中心系统规定药物（详见药物目录表）。【与否药物和非药物】：“1”代表“是”，“0”代表“否”。【与否医保】：“1”代表“是”，“0”代表“否”。消费明细数据包可以由各种构成，之间以分号隔开。交易成功后，返回数据包(OutData)格式为：“单据流水号|门诊号|个人编号|姓名|性别|出

19、”。传入数据包(InData)由两某些构成：主表数据包和消费明细数据包B. 主表数据包格式为：“与否打印门诊收费发票|卡号|门诊号|保险号|姓名|账户余额|病种编号|病种名称|单位编号|单位名称|开方医生”。例如：“TRUE|000048|00000105|00|李四|0|NULL|NULL|00010012|市委老干部局|李医生”阐明：病种编号和病种名称必要是中心系统规定病种（详见病种目录表）。如果没有病种信息,则用NULL代替。【与否打印门诊收费发票】：当传入参数为TURE则接口直接打印出门诊收费发票，当传入参数为FALSE则不调用接口门诊收费发票打印功能。B消费明细数据包格式为：“项目编

20、号|项目名称|单价|数量|金额|收费类别|项目级别|与否药物和非药物|与否医保|处方日期”。例如：“00003|苯唑西林|12.5|2.00|25.00|西药费|甲类|1|1|;00005|青霉素|12.00|2.00|24.00|西药费|甲类|1|1|”阐明：【收费类别】必要是中心系统规定类别(详见收费类别目录表)，只需传中文名称，但保证中文名称与收费目录表目录一致，否则，接口无法获得相应代码。如“西药费”，“中药费”等收费中文名称。【项目级别】必要是中心系统规定项目级别（详见项目级别目录表），传入项目级别名称必要与项目级别目录表中中文名称一致。例如：“甲类”，“乙类”等。【药物编号和名称】

26、系统规定病种（详见病种目录表）。如果没有病种信息,则用NULL代替.B 消费明细数据包格式为：“项目编号|项目名称|单价|数量|金额|收费类别|项目级别|与否药物和非药物|与否医保|处方日期”。例如：“00003|苯唑西林|12.5|2.00|25.00|西药费|甲类|1|1|;00005|青霉素|12.00|2.00|24.00|西药费|甲类|1|1|”阐明：【收费类别】必要是中心系统规定类别(详见收费类别目录表)，只需传中文名称，但保证中文名称与收费目录表目录一致，否则，接口无法获得相应代码。如“西药费”，“中药费”等收费中文名称。【项目级别】必要是中心系统规定项目级别（详见项目级别目录表

32、：主表数据包和消费明细数据包A. 主表数据包格式为：“卡号|住院号|保险号|姓名|账户余额|病种编号|病种名称|单位编号|单位名称”。例如：“000048|00000105|00|李四|0|NULL|NULL|00010012|市局”阐明：【病种编号和病种名称】必要是中心系统规定病种（详见病种目录表）。如果没有病种信息,则用NULL代替。B消费明细数据包格式为：“项目编号|项目名称|单价|数量|金额|收费类别|项目级别|与否药物和非药物|与否医保|处方日期”。例如：“00003|苯唑西林|12.5|2.00|25.00|西药费|甲类|1|1|;00005|青霉素|12.00|2.00|24.0

33、0|西药费|甲类|1|1|”阐明：【收费类别】必要是中心系统规定类别(详见收费类别目录表)，只需传中文名称，但保证中文名称与收费目录表目录一致，否则，接口无法获得相应代码。如“西药费”，“中药费”等收费中文名称。【项目级别】必要是中心系统规定项目级别（详见项目级别目录表），传入项目级别名称必要与项目级别目录表中中文名称一致。【药物编号和药物名称】必要是中心系统规定药物（详见药物目录表）【与否药物和非药物】：“1”代表“是”，“0”代表“否”。与否医保：“1”代表“是”，“0”代表“否”，主表数据包和消费明细数据包之间以分号隔开，消费明细数据包可以各种，之间也以分号隔开。交易成功后，返回数据包(

36、11. 出院登记业务类型代码：“CYDJ”传入数据包(Indata)格式为：“与否打印住院结算发票|卡号|保险号|姓名|住院号|出院因素(出院诊断)|出院日期|出院时间|性别”。其中，保险号，姓名，IC卡号，性别均可从刷卡后返回个人参保信息数据包获得。例如：“TRUE|000048|00|李四|00000123|康复|1713|男”阐明：【出院因素】必要是中心系统规定中文名称（详见出院因素目录表）【与否打印住院结算发票】：当传入参数为TURE则接口直接打印出住院结算发票，当传入参数为FALSE则不调用接口住院结算发票打印功能。交易成功后，返回数据包(OutData)格式为：“住院号|保险号|姓

41、|个人账户余额|所属地区|卡状态”。16. 住院预缴冲销业务类型代码：“ZYYJCX”。传入数据包(Indata)格式为：“卡号|保险号|姓名|预缴金流水号”。其中卡号、保险号、姓名均可从刷卡返回数据包中获得。例如：“000048|00|李四|”交易成功后，返回数据包(OutData)格式为：“预缴金流水号|住院号|预缴金额|金额来源|保险号|姓名|单位编号|冲销单据号”。17. 住院收费登记业务类型代码：“ZYSFDJ”。传入数据包(Indata)分为两个某些：主表数据包和消费明细数据包。A.主表数据包格式为：“卡号|住院号|保险号|姓名|病种编号|病种名称|单位编号|单位名称|开方医生”

42、。例如：“000048|00000105|00|李四|NULL|NULL|00010012|市委老干部局|李医生”阐明：【病种编号和病种名称】必要是中心系统规定病种（详见病种目录表）。如果没有病种信息,则用NULL代替。B消费明细数据包格式为：“项目编号|项目名称|单价|数量|金额|收费类别|项目级别|与否药物和非药物|与否医保|处方日期”。例如：“00003|苯唑西林|12.5|2.00|25.00|西药费|甲类|1|1|;00005|青霉素|12.00|2.00|24.00|西药费|甲类|1|1|”阐明：【收费类别】必要是中心系统规定类别(详见收费类别目录表)，只需传中文名称，但保证中文名

43、称与收费目录表目录一致，否则，接口无法获得相应代码。如“西药费”，“中药费”等收费中文名称。【项目级别】必要是中心系统规定项目级别（详见项目级别目录表），传入项目级别名称必要与项目级别目录表中中文名称一致。【药物编号和药物名称】必要是中心系统规定药物（详见药物目录表）【与否药物和非药物】：“1”代表“是”，“0”代表“否”。与否医保：“1”代表“是”，“0”代表“否”，主表数据包和消费明细数据包之间以分号隔开，消费明细数据包可以各种，之间也以分号隔开。交易成功后，返回数据包(OutData)格式为：“处方号|住院号|项目编号|项目名称|单价|数量|金额|收费类别|项目级别|与否药物和非药物|与

展开阅读全文