辽宁省工伤保险联网结算协议机构接口开发手册

辽宁省工伤保险联网结算协议

机构接口开发手册

版本号更改条款及内容修改曰期修改人

VO.1建立文档2022.8.11马金龙

VO.2修改文档2022.9.5梁泽峰

VO.3修改读卡出参2022.9.19梁泽峰

修改读卡出参，新增交易

VO.42022.9.30梁泽峰

1102.1103.1104.1105.1106.1107.2501.2502.2403.2504

修改下载对照表格得数据格式。修改部分备案得描述，使

VO.52022.10.12梁泽峰

其更易解读,病历上传入参增加,并修改部分入参不必填。

VO.6接受方系统代码修改为“LNYTH”,2301交易增加出参2022.10.19梁泽峰

目录

目录3

1引言5

1.1文档编制目的5

1.2背景5

1.3词汇表5

参考资料6

2总体设计6

系统架构6

3系统接口设计8

3.1接口列表8

3.2用户接口函数9

32.1整体说明9

3.2.2接口输入、输出报文格式定义9

3.2.3交易状态码说明9

4接口交易详细设计14

4.1工伤联网对账14

4.L1交易功能描述14

4.1.2交易设计14

4.1.2.1总额对帐(1320)14

4.1.2.2明细对帐(1321)15

4.2认证类16

4.2.1交易功能描述16

4.2.2交易设计16

4.2.2.1签到(9001)16

4.2.2.2签退(9002)17

4.3业务类18

4.3.1交易功能描述18

4.3.2交易设计18

4.3.2.1读卡(1101)18

4.3.2.2门诊/住院登记(2201)22

4.3.2.3登记(挂号)撤销(2202)23

4.3.2.4登记信息修改(2203)24

4.3.2.5处方明细上报(2204)25

4.3.2.6处方明细撤销(2205)28

4.3.2.7费用预结算(2206)28

4.3.2.8费用结算(2207)31

4.3.2.9费用结算撤销(2208)31

4.3.2.10冲正交易(2209)32

4.3.2.11审批信息上传(2301)33

4.4下载类41

4.4.1交易功能描述41

4.4.2交易设计42

4.4.2.1批量数据下载(1301)42

4.4.2.2费用明细详细信息下载(9103)45

4.4.2.3处方明细下载(9104)61

5接口开发流程说明64

5.1认证类整体流程图64

5.2医院门诊/住院登记开发流程65

5.3医院费用结算流程图67

5.4医院处方明细上传流程图67

5.5医院费用结算撤消、登记(挂号)撤消流程图70

5.6体检协议机构体检流程图

1引言

1.1文档编制目的

辽宁省工伤保险联网结算协议机构接口开发手册主要表述了辽宁省工伤保险联网结算接

口设计方案和对协议机构的交易描述。

本报告的阅读对象主要包括辽宁省工伤保险信息系统用户方相关人员、协议机构软件开

发人员及相关的其他人员等。

1.2背景

系统框架设计为工伤联网部署，工伤联网结算业务相对独立运行，各协议机构需要与中

心端系统进行对接。

根据工伤保险业务的发展趋势，需要完成对工伤联网结算系统的改造，使之满足工伤联

网精细化、科学化管理的业务要求。

本次系统建设过程将严格依循系统建设规范标准，建成后的系统功能符合相关部门的需

求，并进行流程、效率方面的优化，确保系统可靠、稳定、高效运行。

按照部版标准“核心平台四版”为基准建设；

实现全省数据大集中，应用一卡通；

1.3词汇表

词汇名称词汇含义备注

交易工伤联网接口客户端向接口发出的一种请求消

息，接口需要作出应答

工伤联网接口人社部门向协议机构公开的服务，是人社部门

和协议机构之间的一个接口系统，完成两者之

间的信息传递，使协议机构具备工伤联网患者

业务实时处理功能

参考资料

编号参考资料备注

1《核心平台4.0工伤联网接口设计报告》

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)

功能描述：

检查整个运行环境：包括网络环境、运行所需文件、参数等的检查

返回值：成功：返叵0；失败：返回T

交易函数：

intSi_Busi(char*inputdata,

char*outputdata)

输入参数：inputdata

输出参数：outputdatachar*

返回值：成功=0失败＜0

输入、输出参数采用JS0N格式的字符串，区分大小写。没有入参的交易也要上传“交易

输入“input。。处方明细上传需要用“费用明细列表"feedetail数据元标识代替“交易输

入"input,格式为feedetail[{},{}]。

3.2.2接口输入、输出报文格式定义

入参格式：inputdata

表2交易输入参数定义

序代码是否必

数据元标识数据元名称类型长度备注

O标识境

1infno交易编号字符型4Y交易编号详见接口列表

协议机构编号(6)+时间(14)+顺序

号⑷

2msgid发送方报文ID字符型30Y

时间格式：yyyyMMddHHmmss

不可重复

用于多套系统接入，区分不同系统

3recer_sys_code接收方系统代码字符型10Y

使用。一期建设默认传入“LNYTH”

例如：“VL0”,版本号由社保下

6infver接口版本号字符型6Y

发接口开发手册版本号为准。

1-经办人；2-自助终端；3-移动终

7opter_type经办人类别字符型3YY

瑞

8opter经办人字符型30Y按要求传入经办人/终端编号

按要求传入经办人姓名/终端名称

9optcr_nanie经办人姓名字符型50Y

R期时

10inf_time交易时间20¥时间格式:yyyyMMddHHmmss

间型

11fixmcdins_code协议机构编号字符型12Y

通过签到【9001】交易获取，除签

12sign_no签到流水号字符型30Y

到交易外不可为空。

1-实体社保卡；2-电子凭证

13idfi_mode识别方式字符型3YY

暂时只支持实体社保卡，后续会扩展

处方明细上报2204交易，用

feedetai1数据元标识代替input

14input交易输入字符型40000Y

上传体检明细8105交易，用

tjfeedetail数据元标识代替input

交易格式定义如下:

"infno"：T101",

"msgid"：*11",

"rcccr_sys_codc"："JSYTH",

"infver"："V1.0\

II..•If1tl

opter_type：1,

"opter"："01',

"opter_name"："张三"，

"inf_tifnc"："39\

"fixmedins_code"："H00001",

"fixmedins_name"："第一人民医院".

"sign_no'："79faf82271944fe38c4fld99be71bc9c",

Idfi_mode"："1",

"input"：{

"data_l'：{

•string-：nr,

"number"：23,

),

"data_2'：[

(

key：valuel

),

(

"key"："valuc2"

)

]

)

J

注：节点data」(节点标识符(data_l)在各交易中声明)为单行数据示例，节点data_2(节点标设符(data_2)在

各交易中声明)为多行数据示例。

出参格式：outputdatachar*

表3交易输出参数定义

序代码是否

数据元标识数据元名称类型长度备注

号标识非空

1infcode交易状态码数值型4Y详见下节

接收方返回，接收方系统区划代码

2inf_refmsgid接收方报文ID字符型30Y（6）+时间（14）+流水号（10）时间格

式：yyyyMMddHIImmss

3rcfmsg_timc接收报文时间字符型17Y格式：yyyyMMddHHmmssSSS

4respond」ime响应报文时间字符型17Y格式:yyyyMMddHHmmssSSS

交易失败状态下，业务返回的错误信

7errmsg错误信息字符型200

息

交易成功状态下，业务返回的提示信

warn_msg提示信息字符型200

息

8output交易输出字符型40000

交易格式定义如下:

"infcode"："0w,

winf_refmsgid"：

"rcccr_sys_codc"："MBSLOCAL*,

"refmsg_time"："41",

"respond一time"："39",

”IIIIIf

errmsg：,

”wuin_nibKW:IIw,

•sign_no"：',79faf82271944fe38c4fld99be71bc9c",

"output"：{

"data_l"：{

"stringr："ll",

“number'：23,

),

"data_2"：[

(

"key"："valuel”

},

(

"key"："value2"

}

]

注：节点data」（节点标识符（data_l）在各交易中声明）为单行数据示例，节点data_2（节点标识符（data_2）在

各交易中声明）为多行数据示例。

3.2.3交易状态码说明

交易状态码（infcode）为2位编码，表不本次请求省工伤保险信息系统是否止常接收成

功。具体规格如下表：

表4报文状态说明

序号STATUS值值说明备注

10成功

2-1失败

4接口交易详细设计

此部分主要对工伤联网接口交易的各具体业务作详细说明。

4.1工伤联网对账

4.1.1交易功能描述

该交易目前主要完成对帐业务。确保协议机构数据与省工伤保险信息系统数据一致性。

4.1.2交易设计

4.1.2.1总额对帐（1320）

4.1.2.1.1交易说明

1：HTS系统发起对帐请求，中心返回费用信息。

2：如果各项费用中某一项与HIS方费用不一致，需要进行费用明细下载后逐条比对。

3：可以通过参数“是否包含退费记录”控制是否统计退费记录（一正一负两条）。

4：输入参数的对账结束时间与对账开始时间之间的差不能超过31天。

5：可以传入对帐开始时间和对帐结束时间，也可以单独传入签到流水号，时间段与签到流水

号不应同时传入。

6：输入为单行数据，输出为单行数据。

4.1.2.1.2输入

表5输入（节点标识：inpuI）

序号参数代码参数名称参数类型参数长度代码标识是否必填说明

1stmt_begindate对帐开始时间字符型8Y

2stmt_enddate对帐结束时间字符型8Y

3sign_no签到流水号字符型30

4refdsetl一flag是否包含退费记录字符型3Y默认是

5opter医院经办人字符型30

4.1.2.1.3输出

表6输出（节点标识：oulput）

序参数代码参数名称参数类型参数长度代码标识是否非空说明

号

1medfee_sumamt医疗费总额数值型16,2Y

2hifp_pay统筹支付金额数值型16,2Y

3psncashpay现金支付总额数值型16,2Y

4.1.2.1.4本交易对应二级代码

序号类别名称代码值代码名称备注

1是

是否包含退费记录

1

0否

是否包含退费记录

2

4.1.2.2明细对帐（1321）

4.1.2.2.1交易说明

1：HIS系统发起明细对帐请求，中心返回指定查询条件的处方明细的合计信息。

2：如果各项费用中某一项与HIS方费用不一致，需要进行处方明细下载后逐条比对。

3：中心系统只统计有效的处方明细信息，有效处方明细指正常参与结算的处方。

4：输入为单行数据，输出为单行数据。

4.1.2.2.2输入

表7输入（节点标识：input）

序号参数代码参数名称参数类型参数长度代码标识是否必填说明

1ipt_otp_no门诊/住院流水号字符型20Y

2medrcdno单据号字符型20

3opter医院经办人字符型30

4.1.2.2.3输出

表8输出（节点标识：output）

序参数代码参数名称参数类型参数长度代码标识是否非空说明

手

1ipt_otp_no门诊/住院流水号字符型20Y

2medrcdno单据号字符型20Y

3mcdfee_sumamt医疗费总额数值型16,2Y

4hifp_pay统筹支付金额数值型16,2Y

5psncashpay现金支付总额数值型16,2Y

4.2认证类

4.2.1交易功能描述

说明：认证交易开发商直接调用，不需要传入入参。

4.2.2交易设计

4.2.2.1签到（9001）

4.2.2.1.1交易说明

1.进行业务类交易操作前必须进行签到，只有传入有效的业务周期号才能进行业务类操作。

2.同一个操作员可在不同的设备签到。

3.不同操作员可在同一个设备签到。

4.重复签到或在不同设备签到时返回原业务周期号。

5.无输入，输出为单行数据。

4.2.2.1.2输入

无

输入参数举例

"infno"："900r'.

"rcccr_sys_codc"："JSYTH",

winfver"：wV1.0",

”..IfV1IT

opter_type：1,

wopterw："01",

"opier_naine":"张三"，

'inf_timcw："39",

"fixmedins_code"："HOOOO1",

"fixmedins_name"："第一人民医院”,

.sign_no"：

input：t

4.2.2.1.2输出

表9输出（节点标识：output）

序

参数代码参数名称参数类型参数长度代码标识是否非空说明

O

F）期时间

1sign_time签到时间YyyyyMMddHHmmss

型

2sign_no签到流水号字符型30Y中心根据操作员和中心时间，

生成

4.2.2.2签退(9002)

4.2.2.2.1交易说明

可以在任何机器签退，签退时撤销该操作员所有设备的签到。

4.2.2.2.2输入

无

4.2.2.2.3输出

无

4.3业务类

4.3.1交易功能描述

该类交易主要完成参保患者挂号登记、处方上报、预结算、结算及撤销结算等各项业务

处理。

在事务提交方面，由工伤联网接口自动控制事务。如果客户端需要取消事务，可以发起

撤销交易请求。

4.3.2交易设计

4.3.2.1读卡（1101）

4.3.2.1.1交易说明

1、通过此交易获取人员信息。

2、无输入，输出为单行数据。

3、“工伤诊断结论”在协议机构发起门诊/住院登记交易时需要根据实际情况选择一个工伤医

疗费资格审核信息ID作为第十二位入参。就诊类型为中文，显示该人员可以开展肢体伤残、

职业病、康复中那类就诊.重点用于T伤患者多次发生T伤时使用。

4.3.2.1.2输入

无

4.3.2.1.3输出

表10输出-基本信息（节点标识：oulpul）

序号参数代码叁数名称熬数类型叁数长代码标是否非空说明

度识

1psn_no个人唯一识别数值型20Y

码

2emp_no单位唯一识别数值型16Y

码

3cmp_namc单位名称字符型200Y

4certno证件号码字符型50Y

5psn_name姓名字符型50¥

6gend性别字符型6Y¥

7age年龄数值型4,1Y

8inhosp_stas在院状态字符型3YY

9certificate_typc证件类型字符型3Y

10birthday出生日期数值型8yyyyMMdd

表1检出-工伤诊断结论（节点标识diagnosis）多条参数

序号参数代码参数名称参数类型参数长代码标是否非空说明

度识

1qualification_id工伤医疗费资数值型16

格审核信息ID

2psn_type工伤人员类别字符型3Y

3trt_chk_rslt待遇不享受原因字符型500

4Injurcd_part认定诊断结论字符型500

5Visit_type就诊类型字符型500Y

6insu_admdvs统筹区号字符型16Y

7injurcAffirmlD认定信息ID数值型16Y

4.3.2.2.4本交易对应二级代码

序号类别名称代码值代码名称备注

1

性别男

1

2女

性别

2

9未说明性别

性别

3

01

工伤人员类别新工伤

1

02

，伤人员类别老J■伤

5

03

工伤人员类别工程项目参保

6

04

工伤人员类别退休职业病

7

05

工伤人员类别机关事业老工伤纳入

8

06

工伤人员类别机关事业老工伤确认

9

08

工伤人员类别非全日制和多单位就业

10

09

工伤人员类别8023人员

11

10

工伤人员类别包干老工伤

12

11

工伤人员类别超龄就业人员

13

12

工伤人员类别实习生

14

13

工伤人员类别离职职业病

15

14

工伤人员类别见习生

16

15

工伤人员类别新业态人员

17

18工伤人员类别16快递业从业人员

1917

工伤人员类别伤残军人旧伤复发

2018

工伤人员类别公务员工伤

210

在院状态未在院

221

在院状态工伤在院

2301

证件类型居民身份证（户口簿）

2402

证件类型中国人民解放军军官证

2503

证件类型中国人民武装警察警官证

2604

证件类型香港特区护照/港澳居民来

往内地通行证

2705

证件类型澳门特区护照/港澳居民来

往内地通行证

2806

证件类型台湾居民来往大陆通行证

2907

证件类型外国人永久居留证

3008

证件类型外国人护照

3109

证件类型残疾人证

3210

证件类型军烈属证明

3311

证件类型外国人就业证

3412

证件类型外国专家证

3513

证件类型外国人常驻记者证

3614

证件类型台港澳人员就业证

3715

证件类型回国（来华）定居专家证

3816

证件类型港澳台居民居住证

3917

证件类型护照

4018

证件类型中国护照

4190

证件类型社会保障卡

4299

证件类型其他身份证件

43210100

统筹区号沈阳市

44210200

统筹区号大连市

45210300

统筹区号鞍山市

46210400

统筹区号抚顺市

47210500

统筹区号本溪市

48210600

统筹区号丹东市

49210700

统筹区号锦州市

50210800

统筹区号营口市

51210900

统筹区号阜新市

52211000

统筹区号辽阳市

53211100

统筹区号盘锦市

54211200

统筹区号铁岭市

55211300

统筹区号朝阳市

56211400

统筹区号葫芦岛市

57219900

统筹区号省直

4.3.2.2门诊/住院登记(2201)

4.3.2.2.1交易说明

1、门诊/住院流水号应保持院内唯一，不得重复，包括不能与老系统历史数据重复。取消挂

号或无费退院后重新办理的，应更换门诊/住院流水号。冲正处理后，再次挂号或住院登记可

使用原门诊/住院流水号。

2、中心校验就诊类别、人员身份的对应关系。

3、输入为单行数据，无输出。

4.3.2.2.2输入

表11输入(节点标识：input)

序参数类参数代码是否

参数代码参数名称说明

号型长度标识必填

1ipt_olp_no门诊/住院流水号字符型20Y唯一

2med_type就诊类别字符型3YY

按照日期格式

门诊/住院入院时

3adm_time数值型Y

间YYYYMMDDHH24MISS

4adm_diag_dsci-诊断疾病编码字符型20YICD10病种库，入院只

能上传一个病种编码

5wardarea_name病区名称字符型50

6adm_dcpt_codg科室编码字符型20Y

7admbed床位号字符型20院内真实床位号

8atddr_no医生编码字符型20Y

9tel病人联系电话字符型20Y如果无法获取，可以默

认传“0”

10psn_no个人唯一识别码数值型20Y

11ipt_no住院号字符型50住院类交易住院号不

能为空

12qualificationiclJ■伤医疗费资格审数值型16Y通过读卡交易出参“工

核信息1D伤诊断结论”中获取

4.3.2.2.3输出

无

4.3.2.2.4本交易对应二级代码

序号类别名称代码值代码名称备注

11门诊肢体残

就诊类别

1

13门诊职业病

就诊类别

2

14门诊康复

就诊类别

3

21住院肢体残

就诊类别

4

23住院职业病

就诊类别

5

24住院康复

就诊类别

6

4.3.2.3登记(挂号)撤销(2202)

4.3.2.3.1交易说明

1、要撤销的门诊/住院号没有发生费用可以进行登记撤销。如果已发生费用且没有费用结算

的，自动将已上传处方作废处理并撤销登记（挂号）。如果已发生费用且已费用结算，则不

允许撤销登记（挂号），需要先进行费用结算撤销C

2、输入为单行数据，无输出。

4.3.2.3.2输入

表12输入（节点标识：input）

序参数类参数代码是否

参数代码参数名称说明

号型长度标识必填

1ipt_otp_no门诊/住院流水号字符型20Y同登记时的门诊/住

院流水号

4.3.2.3.3输出

无

4.3.2.4登记信息修改（2203）

4.3.2.4.1交易说明：

1、用十在院期间修改就诊类别、疾病、病区、科室等信息。

2、输入为单行数据，无输出。

3、前三位入参不可以修改。第四位后的入参只针对非空信息修改中心就诊登记数据。

4.3.2.4.2输入

表13输入（节点标识：input）

序参数类参数代码是否

参数代码参数名称说明

号型长度标识必填

1ipt_otp_no门诊/住院流水号字符型20Y同登记时的门诊/住

院流水号

按照日期格式

2adm_time门诊/住院入院时间字符型Y

YYYYMMDDHH24MISS

3psn_no个人唯一识别码数值型20Y

4med_type就诊类别字符型3Y

5adm_diag_dscr诊断疾病编码字符型201CD10病种库

6wardarea_name病区名称字符型50

7admdep