# 工伤接口开发文档 ## 4.3.2.5 处方明细上报(2204) ### 4.3.2.5.1 交易说明 1. 允许同时上传多条处方明细。 2. 协议机构门诊随时上传处方,住院可以在摆药时上传,也可以每天晚上批量上传。 3. 按处方时间顺序上传,同一药品、项目、材料正数在前,负数在后。 4. 同一个包内应只包含同一次住院的费用明细,不同住院的明细分别打包上传。 5. 第九位入参总金额为单条处方数据的费用总额,等于第七位入参单价乘以第八位入参数量后四舍五入到小数点后两位。 6. 第十二位入参是否按最小计量单位,如果为是表示该处方按最小计量单位收费。中心进行限价控制时会使用整装的限价除以包装数量后的最小计量限价进行计算。 7. 单次交易最多允许上传50条处方。 8. 输入为多行数据,输出与输入行数一一对应。 ### 4.3.2.5.2 输入 **表 14 输入-费用明细列表(节点标识:feedetail)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否必填 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | ipt_otp_no | 门诊/住院流水号 | 字符型 | 20 | | Y | 同登记时的门诊/住院流水号 | | 2 | list_type | 三大目录类别 | 字符型 | 3 | Y | Y | | | 3 | rxno | 处方号 | 字符型 | 20 | | Y | | | 4 | feedetl_sn | 处方流水号 | 字符型 | 30 | | Y | 单次就诊内唯一 | | 5 | fee_ocur_time | 处方日期 | 字符型 | | | Y | 按照日期格式 YYYYMMDDHH24MISS | | 6 | med_list_codg | 收费项目中心编码 | 字符型 | 50 | | Y | | | 7 | pric | 单价 | 数值型 | 16,4 | | Y | | | 8 | cnt | 数量 | 数值型 | 16,4 | | Y | | | 9 | umamt | 总金额 | 数值型 | 16,2 | | Y | 单条处方的总金额等于单价*数量后四舍五入两位 | | 10 | bilg_dr_codg | 医生编码 | 字符型 | 50 | | Y | | | 11 | bilg_dept_codg | 科室编码 | 字符型 | 50 | | Y | | | 12 | min_unit | 是否最小计量单位 | 字符型 | 3 | Y | | 空默认为否 | | 13 | allSelfFlag | 全额自费标志 | 字符型 | 3 | Y | | 空默认为否 | ### 4.3.2.5.3 输出 **表 15 输出(节点标识:output)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否非空 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | rxno | 处方号 | 字符型 | 20 | | Y | | | 2 | feedetl_sn | 处方流水号 | 字符型 | 30 | | | 单次就诊内唯一 | | 3 | fee_ocur_time | 处方日期 | 字符型 | | | Y | 按照日期格式 YYYYMMDDHH24MISS | | 4 | med_list_codg | 收费项目中心编码 | 字符型 | 20 | | Y | | | 5 | umamt | 总金额 | 数值型 | 16,2 | | Y | | | 6 | ownpay_amt | 自费金额 | 数值型 | 16,2 | | Y | 丙类费用 | | 7 | alwpay_amt | 超限价金额 | 数值型 | 16,2 | | | 超上限部分 | | 8 | pric_uplmt_amt | 支付上限 | 数值型 | 16,2 | | | | | 9 | chrgitm_lv | 收费项目等级 | 字符型 | 3 | Y | | | | 10 | memo | 说明信息 | 字符型 | 1000 | | | | ### 4.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. 如果传入门诊/住院流水号、处方号和处方流水号,则撤销该门诊/住院流水号下该处方号对应的处方流水号的未结算处方。 4. 不允许传入处方号为空且处方流水号非空。 5. 输入为单行数据,无输出。 ### 4.3.2.6.2 输入 **表 16 输入(节点标识:input)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否必填 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | ipt_otp_no | 门诊/住院流水号 | 字符型 | 20 | | Y | 同登记时的门诊/住院流水号 | | 2 | rxno | 处方号 | 字符型 | 20 | | | | | 3 | feedetl_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 输入(节点标识:input)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否必填 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | ipt_otp_no | 门诊/住院流水号 | 字符型 | 20 | | Y | 同登记时的门诊/住院流水号 | | 2 | mdtrt_id | 单据号 | 字符型 | 20 | | Y | 预结算传空,结算时必传且不能为0 | | 3 | med_type | 医疗类别 | 字符型 | 3 | Y | Y | | | 4 | setl_time | 结算日期 | 字符型 | | | Y | 按照日期格式 YYYYMMDDHH24MISS | | 5 | dscg_time | 出院日期 | 字符型 | | | Y | 按照日期格式 YYYYMMDDHH24MISS | | 6 | dscg_trt_rslt | 出院原因 | 字符型 | 3 | Y | Y | | | 7 | diag_code | 出院诊断疾病主编码 | 字符型 | 50 | | Y | ICD10编码 | | 8 | psn_no | 个人唯一识别码 | 数值型 | 16 | | Y | | | 9 | adm_dept_codg | 科室编码 | 字符型 | 50 | | Y | | | 10 | atddr_no | 医生编码 | 字符型 | 50 | | Y | | | 11 | diag_dscr | 出院诊断 | 字符型 | 500 | | | 最多可上传三个ICD10病种编码,以"\|"分隔 | | 12 | occupationalType | 职业病类型 | 字符型 | 3 | Y | | 未执行重症职业病政策城市不要传入 | ### 4.3.2.7.3 输出 **表 18 输出(节点标识:output)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否非空 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | ipt_otp_no | 门诊/住院流水号 | 字符型 | 20 | | Y | | | 2 | mdtrt_id | 单据号 | 字符型 | 20 | | Y | | | 3 | medfee_sumamt | 本次医疗费总额 | 数值型 | 16,2 | | Y | | | 4 | hifp_pay | 本次统筹支付金额 | 数值型 | 16,2 | | | | | 5 | psn_cash_pay | 本次现金支付总额 | 数值型 | 16,2 | | Y | | | 6 | med_list_codg | 说明信息 | 字符型 | 200 | | | | | 7 | umamt | 备注 | 字符型 | 16,4 | | | | | 8 | drug_fee | 药费合计 | 数值型 | 16,2 | | | | | 9 | dati_fee | 诊疗项目费合计 | 数值型 | 16,2 | | | | | 10 | ms_fee | 材料费合计 | 数值型 | 16,2 | | | | ### 4.3.2.7.4 本交易对应二级代码 | 序号 | 类别名称 | 代码值 | 代码名称 | 备注 | |------|----------|--------|----------|------| | 1 | 医疗类别 | 11 | 门诊肢体残 | | | 2 | 医疗类别 | 12 | 门诊职业病 | | | 3 | 医疗类别 | 13 | 门诊康复 | | | 4 | 医疗类别 | 21 | 住院肢体残 | | | 5 | 医疗类别 | 22 | 住院职业病 | | | 6 | 医疗类别 | 23 | 住院康复 | | | 7 | 出院原因 | 01 | 治愈 | | | 8 | 出院原因 | 02 | 死亡 | | | 9 | 出院原因 | 03 | 转院 | | | 10 | 出院原因 | 04 | 其它 | | | 11 | 出院原因 | 05 | 好转 | | | 12 | 职业病类型 | 01 | 普通住院 | | | 13 | 职业病类型 | 02 | 职业病伴并发症 | | | 14 | 职业病类型 | 03 | 重症职业病 | | | 15 | 职业病类型 | 04 | 急救抢救 | | --- ## 4.3.2.8 费用结算(2207) ### 输入参数 同费用预结算2206,参数2单据号不能为空,传入实际的单据号。 ### 输出参数 同费用预结算2206 --- ## 4.3.2.9 费用结算撤销(2208) ### 4.3.2.9.1 交易说明 1. 要撤销的门诊/住院号通过第四位出参"是否保留处方标志"控制是否保留处方,保留的处方可以继续进行处方撤销、费用结算。 2. 如果结算交易和撤销结算交易跨月结算结算期,则结算交易数据在上一结算期进行月结算撤销结算数据在下一结算期进行月结算。 3. 输入为单行数据,无输出。 ### 4.3.2.9.2 输入 **表 19 输入(节点标识:input)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否必填 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | ipt_otp_no | 门诊/住院流水号 | 字符型 | 20 | | Y | 同登记时的门诊/住院流水号 | | 2 | mdtrt_id | 单据号 | 字符型 | 20 | | Y | 同结算时的单据号 | | 3 | setl_time | 结算撤销日期 | 字符型 | | | Y | 按照日期格式 YYYYMMDDHH24MISS | | 4 | keep_tp_type | 是否保留处方标志 | 字符型 | 3 | Y | Y | | ### 4.3.2.9.3 输出 无 ### 4.3.2.9.4 本交易对应二级代码 | 序号 | 类别名称 | 代码值 | 代码名称 | |------|----------|--------|----------| | 1 | 是否保留处方标志 | 0 | 不保留 | | 2 | 是否保留处方标志 | 1 | 保留 | --- ## 4.3.2.10 冲正交易(2209) ### 4.3.2.10.1 交易说明 1. 供HIS处理冲正交易时调用,建议只有协议机构数据和中心端数据出现单边账时调用。正常情况建议通过费用结算撤销交易2208撤销费用。月结算后不允许进行冲正,注意每月及时对帐;月结算后数据以中心端为准。 2. 允许冲正交易编号:2201、2207、2208 3. 输入为单行数据,输出为单行数据。 ### 4.3.2.10.2 输入 **表 20 输入(节点标识:input)** | 序号 | 数据元标识 | 数据元名称 | 类型 | 长度 | 代码标识 | 是否必填 | 备注 | |------|------------|------------|------|------|----------|----------|------| | 1 | infno | 冲正交易编号 | 字符型 | 4 | | Y | 可冲正交易编号:2201、2207、2208 | | 2 | msgid | 发送方报文ID | 字符型 | 30 | | Y | 协议机构发送交易时上传的报文ID | ### 4.3.2.10.3 输出 **表 21 输出(节点标识:output)** | 序号 | 参数代码 | 参数名称 | 参数类型 | 参数长度 | 代码标识 | 是否非空 | 说明 | |------|----------|----------|----------|----------|----------|----------|------| | 1 | rec_state | 冲正状态 | 字符型 | 3 | Y | Y | | | 2 | medfee_sumamt | 冲正医疗费总额 | 数值型 | 16,2 | | | | ### 4.3.2.10.4 本交易对应二级代码 | 序号 | 类别名称 | 代码值 | 代码名称 | 备注 | |------|----------|--------|----------|------| | 1 | 冲正状态 | 1 | 有正单据 | 发起的冲正交易流水号找到并冲正成功 | | 2 | 冲正状态 | 0 | 无正单据 | 发起的冲正交易流水号未找到 | --- ## 接口调用示例 ### 2204 处方明细上报请求示例 ```json { "action": "transaction", "transactionName": "2204", "businessParams": [ { "ipt_otp_no": "ZY20240115001", "list_type": "1", "rxno": "RX001", "feedetl_sn": "1001", "fee_ocur_time": "20240115103000", "med_list_codg": "YP001", "pric": 100.00, "cnt": 1, "umamt": 100.00, "bilg_dr_codg": "DR001", "bilg_dept_codg": "DEPT001", "min_unit": "0", "allSelfFlag": "0" } ] } ``` ### 2205 处方明细撤销请求示例 ```json { "action": "transaction", "transactionName": "2205", "businessParams": { "ipt_otp_no": "ZY20240115001", "rxno": "RX001", "feedetl_sn": "1001" } } ``` ### 2206 费用预结算请求示例 ```json { "action": "transaction", "transactionName": "2206", "businessParams": { "ipt_otp_no": "ZY20240115001", "mdtrt_id": "", "med_type": "21", "setl_time": "20240115103000", "dscg_time": "20240115103000", "dscg_trt_rslt": "01", "diag_code": "J18.9", "psn_no": "123456789", "adm_dept_codg": "DEPT001", "atddr_no": "DR001", "diag_dscr": "肺炎", "occupationalType": "01" } } ```