《辽宁省工伤保险联网结算协议机构接口开发手册.docx》由会员分享，可在线阅读，更多相关《辽宁省工伤保险联网结算协议机构接口开发手册.docx（74页珍藏版）》请在课桌文档上搜索。
1、辽宁省工伤保险联网结算协议机构接口开发手册版本号更改条款及内容修改日期修改人VO.1建立文档2022.8.11马金龙VO.2修改文档2022.9.5梁泽峰VO.3修改读卡出参2022.9.19梁泽峰VO.4修改读卡出参，新增交易1102.1103.1104.1105.1106.1107.2501.2502.2403.25042022.9.30梁泽峰VO.5修改下载对照表格得数据格式。修改部分备案得描述，使其更易解读,病历上传入参增加,并修改部分入参不必填。2022.10.12梁泽峰VO.6接受方系统代码修改为“LNYTH”，2301交易增加出参2022.10.19梁泽峰目录目录31引言5Ll文
2、档编制目的5L2背景51.3词汇表5参考资料62总体设计6系统架构63系统接口设计83.1 接口列表83.2 用户接口函数93. 2.1整体说明.94. 2.2接口输入、输出报文格式定义95. 2.3交易状态码说明94接口交易详细设计144.1 工伤联网对账144. L1交易功能描述144. 1.2交易设计144. 1.2.1总额对帐(1320)144. 1.2.2明细对帐(1321)154.2认证类164. 2.1交易功能描述166. 2.2交易设计164.2.2.1签到(90OD164.2.2.2签退(9002)174.3业务类184.3.1交易功能描述184.3.2交易设计184.3.2
3、.1读卡(IIoI)184.3.2.2门诊/住院登记(2201)224.3.2.3登记(挂号)撤销(2202)234.3.2.4登记信息修改(2203)244.3.2.5处方明细上报(2204)254.3.2.6处方明细撤销(2205)284.3.2.7费用预结算(2206)284.3.2.8费用结算(2207)314.3.2.9费用结算撤销(2208)314.3.2.10冲正交易(2209)324.3.2.11审批信息上传(2301)334.4下载类414.4.1交易功能描述414.4.2交易设计424.4.2.1批量数据下载(1301)424.4.2.2费用明细详细信息下载(9103)45
4、4.4.2.3处方明细下载(9104)615接口开发流程说明645.1 认证类整体流程图645.2 医院门诊/住院登记开发流程655.3 医院费用结算流程图675.4 医院处方明细上传流程图675.5 医院费用结算撤消、登记(挂号)撤消流程图705.6 体检协议机构体检流程图错误!未定义书签。1引言1. 1文档编制目的辽宁省工伤保险联网结算协议机构接口开发手册主要表述了辽宁省工伤保险联网结算接口设计方案和对协议机构的交易描述。本报告的阅读对象主要包括辽宁省工伤保险信息系统用户方相关人员、协议机构软件开发人员及相关的其他人员等。L2背景系统框架设计为工伤联网部署，工伤联网结算业务相对独立运行，各
5、协议机构需要与中心端系统进行对接。根据工伤保险业务的发展趋势，需要完成对工伤联网结算系统的改造，使之满足工伤联网精细化、科学化管理的业务要求。本次系统建设过程将严格依循系统建设规范标准，建成后的系统功能符合相关部门的需求，并进行流程、效率方面的优化，确保系统可靠、稳定、高效运行。按照部版标准“核心平台四版”为基准建设；实现全省数据大集中，应用一卡通；1.3词汇表词汇名称词汇含义备注交易工伤联网接口客户端向接口发出的一种请求消息，接口需要作出应答工伤联网接口人社部门向协议机构公开的服务，是人社部门和协议机构之间的一个接口系统，完成两者之间的信息传递，使协议机构具备工伤联网患者业务实时处理功能参考
6、资料编号参考资料备注1核心平台4.O工伤联网接口设计报告2总体设计系统架构系统建设过程中将对已有的部分业务进行优化，涉及工伤联网的全部业务在协议机构自身系统进行操作，全部通过接口方式实现，无用户界面，输入输出均通过动态库方式完成。网络环境：协议机构通过专线与工伤联网接口应用连接。从安全可靠方面建议可采用不同运营商的双线路。机器要求：大型协议机构配置集群服务器，建议做成双机备份。小型协议机构建议采取集中托管模式。3系统接口设计3. 1接口列表按照服务内容不同，接口共分成4个大类、20个交易，接口编号为4位阿拉伯数字。接口分类框架和接口列表参见表表1接口列表分类交易编号交易名称描述对账类1320总
7、额对账1321明细对账认证类9001签到9002签退业务类1101读卡获取人员基础信息2201门诊/住院登记2202登记（挂号）撤销2203登记信息修改2204处方明细上报2205处方明细撤销2206费用预结算2207费用结算2208费用结算撤销2209冲正交易2301审批信息上传2302审批信息查询2303上传审批信息撤销1102工伤门诊住院就医备案1103工伤门诊住院就医核准备案1104工伤康复核准备案1105工伤康复延期核准备案1106工伤门诊病历上传1107工伤住院病历上传2501工伤同时就医核准备案2502工伤就医变更核准备案2503工伤门诊超支备案2504工伤住院超支备案下载类91
8、03费用明细详细信息下载9104处方明细下载1301批量数据下载3.2用户接口函数3.2.1整体说明本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过DLL完成。程序文件名：LNSiInterface.dll对外提供的接口函数：初始化函数：intSi_INIT(char*pErrMsg)功能描述：检查整个运行环境：包括网络环境、运行所需文件、参数等的检查返回值：成功：返回O；失败：返回T交易函数：intSi_Busi(char*inputdata,char*outputdata)输入参数：inputdata输出参数：outputdatachar*返回值：成功二0失败0输入、输出参数
9、采用JSON格式的字符串，区分大小写。没有入参的交易也要上传“交易输入inputo处方明细上传需要用“费用明细列表feedetail数据元标识代替“交易输入“input,格式为feedetail,。3.2.2接口输入、输出报文格式定义入参格式：inputdata表2交易输入参数定义序号数据元标识数据元名称类型长度代码标识是否必填备注1infno交易编号字符理4Y交易编号详见接口列表2msgid发送方报文ID字符型30Y协议机构编号(6)+时间(14)+顺序号时间格式：yyyyMMddHHmmss不可重复3recer_sys_code接收方系统代码字符型10Y用于多套系统接入，区分不同系统使用。
10、一期建设默认传入“LNYTH”6infver接口版本号字符型6Y例如：“V1.0”，版本号由社保下发接口开发手册版本号为准。7opter_type经办人类别字符型3YY1-经办人：2-自助终端；3-移动终端8opter经办人字符型30Y按要求传入经办人/终端编号9opter_name经办人姓名字符型50Y按要求传入经办人姓名/终端名称10inf-time交易时间日期时间型20Y时间格式：yyyyMMddHHmmss11fixmedins_code协议机构编号字符型12Y12sign_no基到流水号字符型30Y通过签到【9001】交易获取，除签到交易外不可为空。13idfi_mode识别方式字符
11、型3YY1-实体社保卡：2-电子凭证暂时只支持实体社保卡，后续会扩展14input交易输入字符型40000Y处方明细上报2204交易，用feedetail数据元标识代替input上传体检明细8105交易，用tJfeedetail数据元标识代替input交易格式定义如下:If1JfWlIRmsg：Il,wrecer_sys_coden：JSYTII,winfverV1.0,opter_typeM：m1m,wopterw0,n.HMlnopter_name:张二，inf_time：39,fixmedins_code：H00001,fixmedins_name：第一人民医院，sign-no,79fa
12、f82271944fe38c4fld99be71bc9c,IfYQJIlIttlId-mode：1,input：data：string：11,number:23,).data_2：(key：valuel),(“keyw：”VaIUe2”)2注：节点data(节点标识符(data_l)在各交易中声明)为单行数据示例，节点data_2(节点标识符(data-2)在各交易中声明)为多行数据示例。出参格式：outputdatachar*表3交易输出参数定义序号数据元标识数据元名称类型长度代码标识是否非空备注1infcode交易状态码数值型4Y详见下节2inf_refmsgid接收方报文ID字符型30Y
13、接收方返回，接收方系统区划代码（6）+时间（14）+流水号（10）时间格式：yyyyMMddHHmmss3refmsg_time接收报文时间字符型17Y格式：yyyyVMddHHmmssSSS4respond_time响应报文时间字符型17Y格式：YyyyMMddHHnimssSSS7err_msg错误信息字符型200交易失败状态下，业务返回的错误信息WarnJnSg提示信息字符型200交易成功状态下，业务返回的提示信息8output交易输出字符型40000交易格式定义如下:infcode：0,*inf_refmsgid：,receJSyS_code：MBSLOCAL,refmsg_time：
14、,41,respondtime：39,itIrIrWerr_msg：,warn_msg：,r.sign_no：79faf82271944fe38c4f1d99be71bc9c,output：data：string：11,number：23,.data_2M：(key：VaIUe1”.(key：VaIlle2”)2注：节点data(节点标识符(data,l)在各交易中声明)为单行数据示例，节点data_2(节点标识符(data.2)在各交易中声明)为多行数据示例。3. 2.3交易状态码说明交易状态码(infcOde)为2位编码，表示本次请求省工伤保险信息系统是否正常接收成功。具体规格如下表：表4
15、报文状态说明序号STATUS值值说明备注1O成功2-1失败4接口交易详细设计此部分主要对工伤联网接口交易的各具体业务作详细说明。4. 1工伤联网对账4. 1.1交易功能描述该交易目前主要完成对帐业务。确保协议机构数据与省工伤保险信息系统数据一致性。4. 1.2交易设计4. 1.2.1总额对帐（1320）4. 1.2.1.1交易说明1 ：HIS系统发起对帐请求，中心返回费用信息。2 ：如果各项费用中某一项与HlS方费用不一致，需要进行费用明细下载后逐条比对。3 ：可以通过参数”是否包含退费记录”控制是否统计退费记录（一正一负两条）。4 ：输入参数的对账结束时间与对账开始时间之间的差不能超过31天
16、。5 ：可以传入对帐开始时间和对帐结束时间，也可以单独传入签到流水号，时间段与签到流水号不应同时传入。6：输入为单行数据，输出为单行数据。4.1.2.1.2输入表5输入（节点标识：input）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1Stmtj)egindate对帐开始时间字符型8Y2stmt_enddate对帐结束时间字符型8Y3sign_no签到流水号字符型304refd_setl_flag是否包含退费记录字符型3Y默认是5opter医院经办人字符型304.1.2.1.3输出表6输出（节点标识：OUtPUt）序号参数代码参数名称参数类型参数长度代码标识是否非空说明1medf
17、ee_sumamt医疗费总额数值型16,2Y2hifp_pay统筹支付金额数值型16,2Y3psn_cash_pay现金支付总额数值型16,2Y4.1.2.1.4本交易对应二级代码序号类别名称代码值代码名称备注1是否包含退费记录1是2是否包含退费记录0否4.1.2.2明细对帐（1321）4.1.2.2.1交易说明1 ：HIS系统发起明细对帐请求，中心返回指定查询条件的处方明细的合计信息。2 ：如果各项费用中某一项与HIS方费用不一致，需要进行处方明细下载后逐条比对。3 ：中心系统只统计有效的处方明细信息，有效处方明细指正常参与结算的处方。4：输入为单行数据，输出为单行数据。4 .1.2.2.2
18、输入表7输入（节点标识：input）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1ipt_otp_no门诊/住院流水号字符型20Y2medrcdno单据号字符型203opter医院经办人字符型304. 1.2.2.3输出表8输出（节点标识：OUtPUt）序参数代码参数名称参数类型参数长度代码标识是否非空说明号1ipt_otp_no门诊/住院流水号字符型20Y2medrcdno单据号字符型20Y3medfee_sumamt医疗费总额数值型16,2Y4hifp_pay统筹支付金额数值型16,2Y5psn_cash_pay现金支付总额数值型16,2Y4.2 认证类4.3 .1交易功能描述
19、说明：认证交易开发商直接调用，不需要传入入参。4.2.2交易设计4.2.2.1签到(9001)4.2.2.Ll交易说明1 .进行业务类交易操作前必须进行签到，只有传入有效的业务周期号才能进行业务类操作。2 .同一个操作员可在不同的设备签到。3 .不同操作员可在同一个设备签到。4 .重复签到或在不同设备签到时返回原业务周期号。5 .无输入，输出为单行数据。4.2.2.L2输入无输入参数举例：infno：9001,B1W”11Wmsgd：Il,recer_sys_code：nJSYTH,infverZV1.0,irOptejtypeCopter：01w,W.tlHLf9OPteJname:张二，i
20、nf_time：39,fixmedins_code：HOOOOl,fixmedins_name：第一人民医院,ntvftUsign_no：,input：4.2.2.L2输出表9输出(节点标识：OUtPUt)序号参数代码参数名称参数类型参数长度代码标识是否非空说明1Sign_time签到时间日期时间型YYyyyMMddHHmmss2sign_no签到流水号字符型30Y中心根据操作员和中心时间，生成4.2.2.2签退(9002)4.2.2.2.1交易说明可以在任何机器签退，签退时撤销该操作员所有设备的签到。4.2.2.2.2输入无4.2.2.2.3输出无43业务类4.3. 1交易功能描述该类交易主
21、要完成参保患者挂号登记、处方上报、预结算、结算及撤销结算等各项业务处理。在事务提交方面，由工伤联网接口自动控制事务。如果客户端需要取消事务，可以发起撤销交易请求。4.3.2交易设计4.3.2.1读卡(Ilol)4.3.2.Ll交易说明1、通过此交易获取人员信息。2、无输入，输出为单行数据。3、“工伤诊断结论”在协议机构发起门诊/住院登记交易时需要根据实际情况选择一个工伤医疗费资格审核信息ID作为第十二位入参。就诊类型为中文，显示该人员可以开展肢体伤残、职业病、康复中那类就诊。重点用于工伤患者多次发生工伤时使用。4.3.2.L2输入无4.3.2.L3输出表10输出-基本信息(节点标识：outpu
22、t)序号参数代码参数名称参数类型参数长代码标是否非空说明度识1psn_no个人唯一识别码数值型20Y2emp_no单位唯一识别码数值型16Y3erap-name单位名称字符型200Y4certno证件号码字符型50Y5psn_name姓名字符型50Y6gend性别字符型6YY7age年龄数值型4,1Y8inhosp_stas在院状态字符型3YY9certificate_type证件类型字符型3Y10birthday出生日期数值型8yyyyMMdd表1输出-工伤诊断结论（节点标识diagnosis）多条参数序号参数代码参数名称参数类型参数长度代码标识是否非空说明1qualification_id
23、工伤医疗费资格审核信息ID数值型162psn_type工伤人员类别字符型3Y3trt_chk_rslt待遇不享受原因字符型5004Injured_part认定诊断结论字符型5005Visit_type就诊类型字符型500Y6insu_admdvs统筹区号字符型16Y7injureAffirmID认定信息ID数值型16Y4.3.2.2.4本交易对应二级代码序号类别名称代码值代码名称备注1性别1男2性别2女3性别9未说明性别4工伤人员类别01新工伤5工伤人员类别02老工伤6工伤人员类别03工程项目参保7工伤人员类别04退休职业病8工伤人员类别05机关事业老工伤纳入9工伤人员类别06机关事业老工伤确
24、认10工伤人员类别08非全日制和多单位就业11工伤人员类别098023人员12工伤人员类别10包干老工伤13工伤人员类别11超龄就业人员14工伤人员类别12实习生15工伤人员类别13离职职业病16工伤人员类别14见习生17工伤人员类别15新业态人员18工伤人员类别16快递业从业人员19工伤人员类别17伤残军人旧伤复发20工伤人员类别18公务员工伤21在院状态0未在院22在院状态1工伤在院23证件类型01居民身份证（户口簿）24证件类型02中国人民解放军军官证25证件类型03中国人民武装警察警官证26证件类型04香港特区护照/港澳居民来往内地通行证27证件类型05澳门特区护照/港澳居民来往内地通
25、行证28证件类型06台湾居民来往大陆通行证29证件类型07外国人永久居留证30证件类型08外国人护照31证件类型09残疾人证32证件类型10军烈属证明33证件类型11外国人就业证34证件类型12外国专家证35证件类型13外国人常驻记者证36证件类型14台港澳人员就业证37证件类型15回国（来华）定居专家证38证件类型16港澳台居民居住证39证件类型17护照40证件类型18中国护照41证件类型90社会保障卡42证件类型99其他身份证件43统筹区号210100沈阳市44统筹区号210200大连市45统筹区号210300鞍山市46统筹区号210400抚顺市47统筹区号210500本溪市48统筹区号2
26、10600丹东市49统筹区号210700锦州市50统筹区号210800营口市51统筹区号210900阜新市52统筹区号211000辽阳市53统筹区号211100盘锦市54统筹区号211200铁岭市55统筹区号211300朝阳市56统筹区号211400葫芦岛市57统筹区号219900省直4.3.2.2门诊/住院登记(2201)4.3.2.2.1交易说明1、门诊/住院流水号应保持院内唯一，不得重复，包括不能与老系统历史数据重复。取消挂号或无费退院后重新办理的，应更换门诊/住院流水号。冲正处理后，再次挂号或住院登记可使用原门诊/住院流水号。2、中心校验就诊类别、人员身份的对应关系。3、输入为单行数据
27、，无输出。4.3.2.2.2输入表11输入(节点标识：input)序号参数代码参数名称参数类型参数长度代码标识是否必填说明1ipt_otp_no门诊/住院流水号字符型20Y唯一2InediyPe就诊类别字符型3YY3adm_time门诊/住院入院时间数值型Y按照日期格式YYYYMMDDHH24MISS4adm_diag_dscr诊断疾病编码字符型20YICDlO病种库，入院只能上传一个病种编码5wardarea_name病区名称字符型506adm_deptcodg科室编码字符型20Y7adm_bed床位号字符型20院内真实床位号8atddr_no医生编码字符型20Y9tel病人联系电话字符型2
28、0Y如果无法获取，可以默认传“0”10psn_no个人唯一识别码数值型20Y11ipt_no住院号字符型50住院类交易住院号不能为空12qualification_id工伤医疗费资格审核信息ID数值型16Y通过读卡交易出参“工伤诊断结论”中获取4.3.2.2.3输出无4.3.2.2.4本交易对应二级代码序号类别名称代码值代码名称备注1就诊类别11门诊肢体残2就诊类别13门诊职业病3就诊类别14门诊康复4就诊类别21住院肢体残5就诊类别23住院职业病6就诊类别24住院康复4.3.2.3登记(挂号)撤销(2202)4.3.2.3.1交易说明1、要撤销的门诊/住院号没有发生费用可以进行登记撤销。如果
29、已发生费用且没有费用结算的，自动将已上传处方作废处理并撤销登记（挂号）。如果已发生费用且已费用结算，则不允许撤销登记（挂号），需要先进行费用结算撤销。2、输入为单行数据，无输出。4. 3.2.3.2输入表12输入（节点标识：input）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1ipt_otp_no门诊/住院流水号字符型20Y同登记时的门诊/住院流水号4.3. 2.3.3输出4.4. 2.4登记信息修改（2203）4.5. 2.4.1交易说明：1、用于在院期间修改就诊类别、疾病、病区、科室等信息。2、输入为单行数据，无输出。3、前三位入参不可以修改。第四位后的入参只针对非空信息修
30、改中心就诊登记数据。4. 3.2.4.2输入表13输入（节点标识：input）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1ipt_otp_no门诊/住院流水号字符型20Y同登记时的门诊/住院流水号2adm_time门诊/住院入院时间字符型Y按照日期格式YYYYMMDDHH24MISS3psn_no个人唯一识别码数值型20Y4mcd_type就诊类别字符型3Y5adm_diag_dscr诊断疾病编码字符型20ICDlO病种库6wardarea_name病区名称字符型507admdept_codg科室编码字符型208adm_bed床位号字符型20院内唯一流水9atddr_no医生编码
31、字符型520IOtel病人联系电话字符型2011ipt_no住院号字符型50住院类交易住院号不能为空4.3. 2.4.3输出无4.3.2.4.4本交易对应二级代码序号类别名称代码值代码名称备注1就诊类别11门诊肢体残2就诊类别13门诊职业病3就诊类别14门诊康复4就诊类别21住院肢体残5就诊类别23住院职业病6就诊类别24住院康复4.3.2.5处方明细上报上204)4.3.2.5.1交易说明1、允许同时上传多条处方明细。2、协议机构门诊随时上传处方，住院可以在摆药时上传，也可以每天晚上批量上传。3、按处方时间顺序上传，同一药品、项目、材料正数在前，负数在后。4、同一个包内应只包含同一次住院的费
32、用明细，不同住院的明细分别打包上传。5、第九位入参总金额为单条处方数据的费用总额，等于第七位入参单价乘以第八位入参数量后四舍五入到小数点后两位。6、第十二位入参是否按最小计量单位，如果为是表示该处方按最小计量单位收费。中心进行限价控制时会使用整装的限价除以包装数量后的最小计量限价进行计算。7、单次交易最多允许上传50条处方。8、输入为多行数据，输出与输入行数一一对应。4.3.2.5.2输入表14输入-费用明细列表（节点标识：feedetail）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1ipt_otp_no门诊/住院流水号字符型20Y同登记时的门诊/住院流水号2list_type
33、三大目录类别字符型3YY3rxno处方号字符型20Y4feedetl_sn处方流水号字符型30Y单次就诊内唯一5fee_ocur_time处方日期数值型Y按照日期格式YYYYMMDDHH24M1SS6med_list_codg收费项目中心编码字符型50Y7pric单价数值型16,4Y8ent数量数值型16,4Y9umamt总金额数值型16,2Y单条处方的总金额等于单价*数量后四舍五入两位。10bilg_dr_codg医生编码字符型20Y11bilg_dept_codg科室编码字符型20Y12min_unit是否最小计量单位字符型3Y空默认为否13alISelfFlag全额自费标志字符型3Y空歌
34、认为否4.3.2.5.3输出表15输出（节点标识：OUtPUt）序号参数代码参数名称参数类型参数长度代码标识是否非空说明1rxno处方号字符型20Y2feedetl_sn处方流水号字符型30单次就诊内唯一fee_ocur_time处方日期数值型Y按照日期格式YYYYMMDDHH24M1SS3med_list_codg收费项目中心编码字符型20Yyyyy-MMddHH：mm：ss4umamt总金额数值型16,2Y5ownpay_amt自费金额数值型16,2Y丙类费用6alwpay_amt超限价金额数值型16,2超上限部分7pric_uplmt_amt支付上限数值型16,28chrgitm_lv收
35、费项目等级字符型3Y9memo说明信息字符型10004.3.2.5.4本交易对应二级代码序号类别名称代码值代码名称备注1三大目录类别1药品2三大目录类别2诊疗项目3三大目录类别3材料4是否最小计量单位0否5是否最小计量单位1是6收费项目等级1甲类7收费项目等级2乙类8收费项目等级3丙类9全额自费标志0否10全额自费标志1是4.3.2.6处方明细撤销(2205)4.3.2.6.1交易说明1、如果只传入门诊/住院流水号，处方号和处方流水号为空，则撤销该门诊/住院流水号下所有未结算处方。2、如果传入门诊/住院流水号和处方号，处方流水号为空，则撤销该门诊/住院流水号下该处方号的所有未结算处方。3、如果
36、传入门诊/住院流水号、处方号和处方流水号，则撤销该门诊/住院流水号下该处方号对应的处方流水号的未结算处方。4、不允许传入处方号为空且处方流水号非空。5、输入为单行数据，无输出。4.3.2.6.2输入表16输入(节点标识：input)序号参数代码参数名称参数类型参数长度代码标识是否必填说明1ipt_otp_no门诊/住院流水号字符型20Y同登记时的门诊/住院流水号2rxno处方号字符型203feedetl_sn处方流水号字符型30单次就诊内唯一4.3.2.6.3输出无4.3.2.7费用预结算(2206)4.3.2.7.1交易说明1、预结算只计算待遇享受信息，不对数据进行保存及提交，可多次进行预结算。2、出参平衡关系说明：本次医疗费总额二本次统筹支付金额+现金。3、门诊类允许一次就诊登记多次进行结算“住院类一次就诊登记只能进行一次结算。4、输入为单行数据，输出为单行数据。4.3.2.7.2输入表17输入（
