医保接口说明v2.doc

医保接口说明一、接口模式概述2二、调用方法概述2（1）调用函数2（2）输入参数3（3）输出参数4（4）webservice函数列表4（5）DLL函数列表5(6)调用示例5三、门诊接口71、业务流程:72、相关函数：7（1）读卡DLL函数：ReadCardOH 7（2）获取个人信息OHGetPersInfo ： （非必需）11（3）处方结算OHPresBillPay ：11（4）退处方：（非必需）14四、住院接口14(1)查询关联住院登记IHGetRegInfo15(2)设置住院号关联 IHSetRegNoRel16(3) 导入住院费用 IHImportCost17(4) 验证住院费用IHVerifyCost17（5）获取验证费用信息 IHGetVerifyCost17(6)上传住院费用到医保 IHCostUp20(7)医保住院费用作废 IHCancelCostSI20(8) 获取出院登记信息IHGetRegInfoPay20(9)、IHRegInHospInfo入院登记20(10)、IHRegInHospCancel入院登记取消21(11)、IHRegOutHosp 出院登记21(12)、IHRegOutHospCancel出院登记取消21(13)、IHOutHospBudget出院预结算21(14)、IHOutHospPay出院结算21(15)、IHOutHospPayCancel 出院结算召回22（16）BasSetSIUserRel设置用户关联22五、数据视图22六、业务数据视图24修改记录：日期修改内容修订版本号2012-05-18陈钢v1.002012-08-18增加出入院相关函数陈钢V1.20一、接口模式概述本接口采用数据库视图+DLL+WebService技术与HIS系统进行对接，实现医保业务的各项功能。包括读卡、门诊结算、住院费用导入等。医院方需要一台服务器作为中间数据库服务器，并运行接口的WebService服务，各个HIS和接口客户端统一调用该服务器的WebService服务或DLL函数，而读卡功能由接口的DLL函数完成。HIS和接口之间的调用关系有两种模式:（1）、视图模式（外挂式）：接口程序为主动调用方，HIS提供视图（包括门诊费用视图、住院费用视图等），接口提供一个独立的可执行文件的客户端程序，由接口程序读取HIS的费用信息结算并上传。（2）、DLL + WebService模式（嵌入式）：HIS为主动调用方，接口提供读卡DLL和业务WebService服务，由HIS系统调用WebService服务或DLL函数，接口在HIS调用相关函数功能时完成验证、上传、结算、返回结果的功能。本接口两种方式都支持。二、调用方法概述（1） 调用函数WebService服务函数 C# 原型:WebMethodpublic XmlDocument WebSimCall(string as_InParApp, string as_InParam, string as_InData, string as_InDebug)或WebMethodpublic string WebSimCallStr(string as_InParApp, string as_InParam, string as_InData, string as_InDebug)两个函数的区别仅返回数据类型不一样，功能和调用方式相同。接口统一通过WebSimCall函数调用，提供不同功能代码调用不同的功能，通过as_InParApp提供医保账户等每个功能的通用参数，通过as_InParam提供不同功能不同的业务参数，通过as_InData提供不同功能可能需要提供的数据集参数。 返回的结果为XML，也包含类似通用返回信息、业务返回信息、返回数据集等节点的返回结果。（2） 输入参数输入参数一般为四个输入字符串（对应xml的节点），每个字符串是一个以值的参数集。内容如下：参数字符串一：通常为每个功能都需要提供的固定参数。主要包含以下参数内容接口版本（必需）值=V1.00功能编号或功能名称（必需）医保操作员代码（必需）医保操作员名称（可为空）医保操作员密码（必需）HIS操作员代码（可为空）HIS操作员名称（可为空）医院代码（可为空）数据编码格式。（可为空）仅为特殊情况使用,比如数据集用到压缩和特殊编码处理模式（可为空）；字符串型枚举值，不同功能函数值不同，通常情况下可忽略该参数，主要用于特殊数据编码和处理方式的情况。参数字符串二：为业务参数字符串，每个功能不一样。读卡事务号：由读卡函数返回，对于一些需要读卡的功能函数需要提供，以便标识一次读卡。（考虑多处方批处理的情况，这导致HIS每处理一张处方需要调用读卡函数一次，而需考虑重复输入密码的问题。）参数字符串三：为大数据参数。如数据集、二进制数据。 参数字符串四调试模式信息。为调试用，通常情况忽略该参数。参数指定使用业务对象序号。读卡DLL模式:OnlyIC,（3）输出参数输出参数一般为包含XML节点的字符串，通常包含以下共同的节点内容：返回参数字符串一：公共参数返回结果标志 成功 true 失败 false 返回结果值 字符串类型表示的整数， 一般大于等于0表示成功小于0表示失败 返回结果信息（一般不用该参数而用下述的，为了兼容而保存）处理模式；字符串型枚举值，不同功能函数值不同，通常情况下可忽略该参数，主要用于特殊数据编码和处理方式的情况。数据编码格式。（可为空）仅为特殊情况使用,比如数据集用到压缩和特殊编码返回参数字符串二：返回结果信息返回参数字符串三：业务参数返回返回参数字符串四： 返回结果数据集。返回参数字符串五：调试模式信息。为调试用，通常情况忽略该参数。（4）webservice函数列表函数代码功能版本新增OHGetPersInfo获取个人信息V1.00OHPresBillPay门诊处方结算V1.00OHCancelPres门诊处方作废V1.00IHGetRegInfo获取住院登记信息V1.00IHSetRegNoRel设置住院号关联V1.00IHImportCost导入住院费用V1.00IHVerifyCost验证住院费用V1.00IHGetVerifyCost获取验证费用信息V1.00IHCostUp住院费用上传V1.00IHCancelCostSI住院费用作废V1.00IHGetRegInfoPay获取出院登记信息V1.00BasSetSIUserRel设置用户关联V1.20IHRegInHospInfo入院登记V1.20IHRegInHospCancel入院登记取消V1.20IHRegOutHosp出院登记V1.20IHRegOutHospCancel出院登记取消V1.20IHOutHospBudget出院预结算V1.20IHGetPayBill获取出院结算单V1.20IHOutHospPay出院结算V1.20IHOutHospPayCancel出院结算召回V1.20（5）DLL函数列表函数代码功能ReadCardOH门诊读卡V1.00ReadCardIH住院读卡ReadCard读卡信息(6)调用示例Delphi调用示例：（采用网页方式）procedure TForm1.Button5Click(Sender: TObject);var strMsg:string; sParams: TStringStream; IdHTTP1:TIdHTTP;begin sParams := TStringStream.create(); IdHTTP1:=TIdHTTP.Create(Nil); IdHTTP1.Request.ContentType := application/x-www-form-urlencoded; try sParams.WriteString(as_InParam=aaa&as_InData=bb); strMsg:=IdHTTP1.post( http:/localhost:1680/wsim/Service1.asmx/WebFootPresInit,sParams) ; memo1.Text:=UTF8Decode(strmsg); finally sParams.Free; IdHTTP1.Free; end;end;PowerBuilder调用示例：string lsxmlstring ls_inComm,ls_inTran,ls_indata,ls_indebug, ls_outcomm ,ls_outmsg, ls_outtran , ls_outdata , ls_outdebug soapconnection lcsiimservice1soap lolc = create soapconnectionlc.createinstance( lo,siimservice1soap )ls_inComm = v1.20IHGetVerifyCostrmyy008123456ls_inTran =103616000005521842000lsxml = lo.websimcallStr(ls_inComm,ls_inTran,ls_indata,ls_indebug )mle_msg.text = lsxmlmessagebox(ok,)三、门诊接口1、 业务流程:（1） 读卡：HIS系统调用接口DLL的读卡函数，接口DLL读卡并判断该参保人是否可以刷卡，如果可以刷卡，返回个人编号、姓名、卡类型等个人信息，如果不能刷卡，返回错误信息。（2） 录入处方：HIS获取参保人个人信息后由操作员进行处方录入。（3） 结算：HIS完成处方明细录入后调用接口的WebService服务，将处方明细传给接口，接口上传并结算该处方，返回结算结果信息：总金额、医保金额、自费金额等。（4） 打印发票：HIS根据接口返回结果自行处理发票打印、出错处理等功能。（5） 退处方：如果需要退费，HIS调用接口退费DLL函数执行退费。2、 相关函数：（1） 读卡DLL函数：ReadCardOH （C+）int ReadCardOH (const char * as_InParComm, const char * as_InParTran, const char * as_InParData, const char * as_DebugMsgIn, char * as_OutParComm, char * as_OutMsg, char * as_OutParTran, char * as_RetData, char * as_DebugMsgOut)说明：该函数9个字符串参数仅用到4个字符串参数，其他为兼容性和扩展性保留统一格式。输入参数：as_InParComm：参考 参数字符串一 说明。读卡函数包含从IC卡读卡并从服务器获取个人信息的功能。所以需要包含医保操作员账号好密码等信息。as_InParTran：PersNo：个人编号PersType：人员类型CardNo：卡号PersName：姓名RICDllMode：读卡模式：NotDB，OnlyIC，PersICKey:避免重复读卡需要的参数首次读卡as_InParTran参数可以为空，二次读卡提供个人编号(PersNo)姓名(PersName)卡号(CardNo)可以避免输入密码。输出参数：返回值：大于等于零表示成功，负数表示失败as_OutMsg：返回提示信息as_OutParTran,：包含个人信息的XML字符串。卡类型(PersType)个人编号(PersNo)姓名(PersName)性别(PSex)年龄(PAge)参保待遇(PTrea)参保状态(PState)个人余额(PMoney)统筹使用金额(PPMoneyUse)门诊类型(OHType)慢性病病种代码列表(OHIllnCode)慢性病病种代码名称列表(OHIllnName)单位名称(CompName)参保区域名称(AreaCode)参保机构名称(InsuCode)业务事务标识号(SimCardTranNo) IC卡标识PersICKey调用参数示例：输入参数：as_InParComm= v1.20 OHGetPersInfo usercode 123456 088066 操作员姓名返回：as_OutParTran= #078crDmEw 000001000826 N06406167 01 韦剑阳 在职待遇 暂停参保 284.9 0 1 男 27 450700 00000017 钦州市社会保险经办机构 钦州市职工基本医疗保险所 Delphi调用示例：函数定义function ReadCardOH(as_InParComm:pchar;as_InParam:pchar;as_InData:pchar;as_InDebugMsg:pchar;as_OutParComm:pchar;as_OutParam:pchar;as_OutData:pchar;as_OutDebugMsg:pchar;as_OutMsg:pchar):integer;stdcall; External SimCard.dll;procedure TForm1.Button1Click(Sender: TObject);Var lzInParComm:string; lzInParTran:string; lzInData:string; lzInDebugMsg:string; lzOutParComm:Pchar; lzOutParTran:Pchar; lzOutData:Pchar; lzOutDebugMsg:Pchar; lzOutMsg:Pchar;begin lzInParComm:=v1.20OHGetPersInformyymm123456000114u003张三/SimHisOperName; lzInParTran:=; lzInData:=; lzInDebugMsg:=;/ lzInDebugMsg:=OnlyIC; getmem(lzOutParComm, 2048); getmem(lzOutParTran, 2048); /getmem(lzOutData, 2048);/ getmem(lzOutDebugMsg, 2048); getmem(lzOutMsg, 2048); ReadCardOH( pchar(lzInParComm), pchar(lzInParTran), pchar(lzInData), pchar(lzInDebugMsg), lzOutParComm, lzOutParTran , lzOutData , lzOutDebugMsg, lzOutMsg); Memo1.Text := strcat(lzOutParComm , lzOutParTran);end;PowerBuilder调用示例：函数定义：Function long iReadCardOH (string as_inComm,string as_inTran,string as_indata,string as_indebug, ref string as_outcomm,ref string as_outmsg,ref string as_outtran,ref string as_outdata,ref string as_outdebug ) LIBRARY SimCard.dll ALIAS FOR ReadCardOH;Ansi调用：long liret string ls_inComm,ls_inTran,ls_indata,ls_indebug, ls_outcomm ,ls_outmsg, ls_outtran , ls_outdata , ls_outdebug ls_outcomm = space(2048)ls_outmsg = space(2048)ls_outtran = space(2048)/ls_outdata = space(2048)ls_outdebug = space(2048) ls_inComm=v1.20OHGetPersInformyy313123456000114u003张三 /ls_inTran=OnlyIC liret = iReadCardOH( ls_inComm,ls_inTran,ls_indata,ls_indebug, ls_outcomm ,ls_outmsg, ls_outtran , ls_outdata , ls_outdebug )mle_1.text = ls_outcomm + +ls_outtran + +ls_outmsg （2） 获取个人信息OHGetPersInfo ： （非必需）说明：提供卡号从医保服务器获取个人信息输入参数：as_InParam： CardNo：卡号 PersType：人员类型PersNo:个人编号GetTranNoFlag：获取事务号标识。接口内部使用，HIS调用者可忽略。返回参数：与读卡DLL函数相同（3） 处方结算OHPresBillPay ： 输入参数字符串说明：功能代码OHPresBillPayas_InParam：请求处理标志(ReqMode)医院处方号(OHBillNo)参保人个人编号(PersNo)参保人姓名(PersName) 人员类型(PersType)医院操作员代码(HospOperCode)医院操作员名称(HospOperName)处方数据格式(InDataMode)读卡事务号（SimCardTranNo）是否替换(IsRepOwn)1可以重复结算该处方号数据代码格式参数含义：请求处理标志：“FOOT”表示结算处方指令。“BUDGET”表示预结算指令。“ADD”表示仅仅新增处方明细而不进行结算。处方数据格式：“SQL”“VIEW”“XML”“EXIST”。指定参数as_InData的内容格式。数据代码格式（CodeForm）: “CodeAnsi”“ CodeHex”示例：Foot226287韦剑阳1292吴海英XML#281CBa9as_InParData：如果as_InParam中的参数“处方数据格式”值为“VIEW”，则该参数为空，HIS应提供处方明细的视图，由接口根据处方号取数据。如果as_InParam中的参数“处方数据格式”值为“SQL”，则该参数为处方明细的SQL语法，HIS应把一张处方明细转换成一条SELECT语法，其字段内容见“处方主表”“处方明细表”视图。处方数据集XML参数例子： 1 220043 000001000826 226287 226287_1 226287 陈忠鑫 1 急诊医学科 126 黄仁裕 87.50 70.00 n220301001a 彩色多普勒超声常规检查(胸部) 彩色多普勒超声常规检查(胸部) 次 70.0000 1.0000 70.0000 0 30602 220301001A 邓承琳 吴海英 2012-04-18T10:53:01 1 220043 000001000826 226287 226287_1 226287 陈忠鑫 1 急诊医学科 126 黄仁裕 87.50 70.00 n220301001a 阿莫西林颗粒 阿莫西林颗粒 次 17.5000 1.0000 17.5000 0 30626 220301002 邓承琳 吴海英 2012-04-18T10:53:01处方数据集SQL参数例子：字段内容:Cfid（处方号）,ylzh（医疗证号） , xm（姓名）, ks（科室）, ys（医生）, dm（代码）, dj（单价）, sl（数量）, je（金额） , bzw（退费标志）, lb（收费类别）, mxybje（明细医保金额）, zje（处方总金额）, ybje（处方医保金额）, yblb（医保类别）,ssje（实收金额） , sfid（收费项目ID） , ksid（科室ID）, fph（发票号）, czy（操作员）, sj（时间）, id（费用ID）语句：select L0991569 As Cfid, As ylzh ,钱泉 As xm,急诊科 As ks,陈文强 As ys, As dm,.9 As dj,1 As sl,.9 As je ,0 As bzw, As lb,.9 As mxybje,0 As zje,0 As ybje,甲类诊疗 As yblb,.9 As ssje ,6640 As sfid ,223 As ksid,5273062 As fph,刘平 As czy,2011-12-10 06:52:43 As sj, 46186988 As id Union All select L0991569 As Cfid, As ylzh ,钱泉 As xm,急诊科 As ks,陈文强 As ys, As dm,3.6 As dj,1 As sl,3.6 As je ,0 As bzw, As lb,3.6 As mxybje,0 As zje,0 As ybje,甲类诊疗 As yblb,3.6 As ssje ,6650 As sfid ,223 As ksid,5273062 As fph,刘平 As czy,2011-12-10 06:52:43 As sj, 46186989 As id Union All select L0991569 As Cfid, As ylzh ,钱泉 As xm,急诊科 As ks,陈文强 As ys, As dm,2 As dj,2 As sl,4 As je ,0 As bzw, As lb,4 As mxybje,0 As zje,0 As ybje,甲类诊疗 As yblb,4 As ssje ,6656 As sfid ,223 As ksid,5273062 As fph,刘平 As czy,2011-12-10 06:52:43 As sj, 46186990 As id返回参数字符串：返回值(PayRetVal)错误等级(PayRetLev)预算医保金额(BudMoney)预算总金额(BudMoneySum)医院处方号(PayOHBillNo)结算医保金额(PayMoney)结算医保统筹金额(PubPayMoney)结算医保处方总金额(PayMoneySum)结算医保处方号(PayInsuBillNo) 结算前个人余额(PMoneyBef)结算后个人余额(PMoneyAft)结算前个人统筹金额(PPMoneyBef)结算后个人统筹金额(PPMoneyAfr)错误信息（4） 、退处方：（非必需）功能代码：OHCancelPresas_InParam：医院处方号（OHBillNo）医保就诊号(OHBillNoInsu) 读卡事务号（SimCardTranNo）返回参数字符串：四、住院接口住院接口因为不像门诊一样要求实时性高，所以采用视图模式对于HIS来说比较方便实现。接口提供一个独立的客户端程序，由该程序读取HIS的住院登记、住院费用视图，与指定的医保住院登记关联，将参保人住院费用上传到该医保住院登记中。医保住院接口只提供费用上传的功能，入院登记、出院登记、出院结算操作由独立的医保程序完成。住院接口涉及的视图表包括：住院登记、住院医嘱（非必须）、住院费用，表名和字段内容见业务视图定义说明。流程：1、住院登记：操作员先在HIS读卡或手工输入姓名登记住院，然后在医保系统做住院登记，并录入在HIS的住院号(可选)。2、住院号关联：操作员选择医院住院登记信息，HIS调用接口IHGetRegInfo 函数返回与姓名或医院住院号对应的医保住院登记信息表，显示给操作员看，由操作员点击确认，HIS调用接口IHSetRegNoRel函数确定该医院住院号和医保住院号的对应关系。3、HIS调用IHImportCost 导入费用。4、HIS调用接口IHVerifyCost函数验证医保费用，调用IHGetVerifyCost返回验证结果数据集（如果有错误记录或提醒记录的话）5、HIS 调用IHCostUp上传费用到医保6、操作员在医保系统进行出院登记和结算操作。7、如果费用有误或者有修改，修改或删除十一新增记录或负记录的形式，可以直接导入上传新增部分费用。否则可以调用IHCancelCostSI 作废医保系统的费用再全部重新导入上传。(1)查询关联住院登记IHGetRegInfo输入参数：as_InParam：医院住院号（IHRegNo）医保住院号（IHRegNoSI）个人编号(PersNo)姓名(PersName)入院时间(InHospTime)说明：医保住院号（IHRegNoSI）个人编号(PersNo)可以为空，该功能函数主要用于查询与医院住院登记对应的医保住院登记。入院时间(InHospTime)可以限定查询时间范围返回参数：返回值代表查询到的记录个数返回医保住院登记信息数据集字段名数据类型中文名说明areacodeVarchar(20)区域代码hospcodeVarchar(20)医院代码ihregnoVarchar(20)医保住院号attypeVarchar(5)保险类型代码persnoVarchar(20)个人编号、证号persnameVarchar(20)姓名intimedatetime入院时间treatflagVarchar(5)待遇代码outtimedatetime出院时间inhospfalgnVarchar(20)住院状态payflagnVarchar(20)结算状态perstypenVarchar(20)人员类别operinVarchar(20)入院操作员operoutVarchar(20)出院操作员indiagVarchar(255)入院诊断MoneySumnumeric(18,4)总金额MoneyPubnumeric(18,4)统筹金额MoneyAccnumeric(18,4)个人账户MoneyCashnumeric(18,4)个人现金MoneySerinumeric(18,4)大病救助MoneyOffinumeric(18,4)公务员补助返回示例：- 450722 000114 000005626745 2 000001073238 张永友 2012-05-20 00:00:00 21 2012-05-20 00:00:00 1 0 1 入院登记 未结算 职工医保 rmyy591 高血压 (2)设置住院号关联 IHSetRegNoRel输入参数：医院住院号(IHRegNo)医保住院号IHRegNoSI说明：设置医院住院号与医保住院号的对应关系。(3) 导入住院费用 IHImportCost输入参数：IHRegNo：医院住院号IHRegNoSI：医保住院号 （可为空）ReImport：是否重新导入；0 仅导入新增费用。1 重新导入所以费用IsPayCost：是否导入费用已结算； 0 导入未结算部分 1 导入已结算部分RepTime：是否替换时间为当日；0 不替换 1 替换 (4) 验证住院费用IHVerifyCost功能说明：用于执行医院费用与医保费用匹配、划分医保费用和自费费用输入参数：IHRegNo：医院住院号IHRegNoSI：医保住院号（可为空）返回：返回值总金额自费金额记录数出错记录数费用类别不一致记录数（5）获取验证费用信息 IHGetVerifyCost输入参数：IHRegNo：医院住院号IHRegNoSI：医保住院号（可为空）VerifyFlag：NotNull:表示只返回有错误或警告的记录开始行号 (可为空，表示返回所有记录)结束行号 (可为空，表示返回所有记录)返回参数：记录数返回费用记录集字段数据类型字段中文名说明rowidint行序号rcountint记录数hidvarchar(20)医院费用idyydmvarchar(20)医院代码yyzyhvarchar(20)医院住院号sfdmvarchar(20)收费项目代码sfmcvarchar(255)收费名称jxmcvarchar(50)剂型名称ggvarchar(50)规格dwvarchar(20)单位bzdmvarchar(20)医保标准代码bzmcvarchar(255)医保标准名称ybsfdmvarchar(50)医保收费代码djnumeric(18, 4)单价slnumeric(18, 4)数量jenumeric(18, 4)金额yzdmvarchar(20)对应医嘱代码sjdatetime时间zxcsint执行次数ybczztvarchar(5)医保操作状态ybczxxvarchar(255)医保操作信息scsjdatetime上传时间yyksdmvarchar(20)医院科室代码yyksmcvarchar(20)医院科室名称ybksdmvarchar(20)医保科室代码ybksmcvarchar(20)医保科室名称yyysdmvarchar(20)医院医生代码y