辽宁省工伤保险联网结算协议机构接口开发手册.docx
辽宁省工伤保险联网结算协议机构接口开发手册版本号更改条款及内容修改日期修改人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文档编制目的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.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)454.4.2.3处方明细下载(9104)615接口开发流程说明645.1 认证类整体流程图645.2 医院门诊/住院登记开发流程655.3 医院费用结算流程图675.4 医院处方明细上传流程图675.5 医院费用结算撤消、登记(挂号)撤消流程图705.6 体检协议机构体检流程图错误!未定义书签。1引言1. 1文档编制目的辽宁省工伤保险联网结算协议机构接口开发手册主要表述了辽宁省工伤保险联网结算接口设计方案和对协议机构的交易描述。本报告的阅读对象主要包括辽宁省工伤保险信息系统用户方相关人员、协议机构软件开发人员及相关的其他人员等。L2背景系统框架设计为工伤联网部署，工伤联网结算业务相对独立运行，各协议机构需要与中心端系统进行对接。根据工伤保险业务的发展趋势，需要完成对工伤联网结算系统的改造，使之满足工伤联网精细化、科学化管理的业务要求。本次系统建设过程将严格依循系统建设规范标准，建成后的系统功能符合相关部门的需求，并进行流程、效率方面的优化，确保系统可靠、稳定、高效运行。按照部版标准“核心平台四版”为基准建设；实现全省数据大集中，应用一卡通；1.3词汇表词汇名称词汇含义备注交易工伤联网接口客户端向接口发出的一种请求消息，接口需要作出应答工伤联网接口人社部门向协议机构公开的服务，是人社部门和协议机构之间的一个接口系统，完成两者之间的信息传递，使协议机构具备工伤联网患者业务实时处理功能参考资料编号参考资料备注1核心平台4.O工伤联网接口设计报告2总体设计系统架构系统建设过程中将对已有的部分业务进行优化，涉及工伤联网的全部业务在协议机构自身系统进行操作，全部通过接口方式实现，无用户界面，输入输出均通过动态库方式完成。网络环境：协议机构通过专线与工伤联网接口应用连接。从安全可靠方面建议可采用不同运营商的双线路。机器要求：大型协议机构配置集群服务器，建议做成双机备份。小型协议机构建议采取集中托管模式。3系统接口设计3. 1接口列表按照服务内容不同，接口共分成4个大类、20个交易，接口编号为4位阿拉伯数字。接口分类框架和接口列表参见表表1接口列表分类交易编号交易名称描述对账类1320总额对账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工伤住院超支备案下载类9103费用明细详细信息下载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输入、输出参数采用JSON格式的字符串，区分大小写。没有入参的交易也要上传“交易输入"inputo处方明细上传需要用“费用明细列表"feedetail数据元标识代替“交易输入“input,格式为feedetail,。3.2.2接口输入、输出报文格式定义入参格式：inputdata表2交易输入参数定义序号数据元标识数据元名称类型长度代码标识是否必填备注1infno交易编号字符理4Y交易编号详见接口列表2msgid发送方报文ID字符型30Y协议机构编号(6)+时间(14)+顺序号时间格式：yyyyMMddHHmmss不可重复3recer_sys_code接收方系统代码字符型10Y用于多套系统接入，区分不同系统使用。一期建设默认传入“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识别方式字符型3YY1-实体社保卡：2-电子凭证暂时只支持实体社保卡，后续会扩展14input交易输入字符型40000Y处方明细上报2204交易，用feedetail数据元标识代替input上传体检明细8105交易，用tJfeedetail数据元标识代替input交易格式定义如下:If1JfWlIRmsg：Il,wrecer_sys_coden："JSYTII",winfver"'V1.0","opter_typeM：m1m,wopterw0,n.HMlnopter_name:张二，"inf_time"："39","fixmedins_code"："H00001","fixmedins_name"："第一人民医院"，sign-no,79faf82271944fe38c4fld99be71bc9c",IfYQJIlIt«tlId-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接收方返回，接收方系统区划代码（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"：",41","respondtime"
