工伤接口开发文档

4.3.2.5 处方明细上报(2204)

4.3.2.5.1 交易说明

允许同时上传多条处方明细。
协议机构门诊随时上传处方，住院可以在摆药时上传，也可以每天晚上批量上传。
按处方时间顺序上传，同一药品、项目、材料正数在前，负数在后。
同一个包内应只包含同一次住院的费用明细，不同住院的明细分别打包上传。
第九位入参总金额为单条处方数据的费用总额，等于第七位入参单价乘以第八位入参数量后四舍五入到小数点后两位。
第十二位入参是否按最小计量单位，如果为是表示该处方按最小计量单位收费。中心进行限价控制时会使用整装的限价除以包装数量后的最小计量限价进行计算。
单次交易最多允许上传50条处方。
输入为多行数据，输出与输入行数一一对应。

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 交易说明

如果只传入门诊/住院流水号，处方号和处方流水号为空，则撤销该门诊/住院流水号下所有未结算处方。
如果传入门诊/住院流水号和处方号，处方流水号为空，则撤销该门诊/住院流水号下该处方号的所有未结算处方。
如果传入门诊/住院流水号、处方号和处方流水号，则撤销该门诊/住院流水号下该处方号对应的处方流水号的未结算处方。
不允许传入处方号为空且处方流水号非空。
输入为单行数据，无输出。

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 交易说明

预结算只计算待遇享受信息，不对数据进行保存及提交，可多次进行预结算。
出参平衡关系说明：本次医疗费总额=本次统筹支付金额+ 现金。
门诊类允许一次就诊登记多次进行结算。住院类一次就诊登记只能进行一次结算。
输入为单行数据，输出为单行数据。

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 交易说明

要撤销的门诊/住院号通过第四位出参"是否保留处方标志"控制是否保留处方，保留的处方可以继续进行处方撤销、费用结算。
如果结算交易和撤销结算交易跨月结算结算期，则结算交易数据在上一结算期进行月结算撤销结算数据在下一结算期进行月结算。
输入为单行数据，无输出。

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 交易说明

供HIS处理冲正交易时调用，建议只有协议机构数据和中心端数据出现单边账时调用。正常情况建议通过费用结算撤销交易2208撤销费用。月结算后不允许进行冲正，注意每月及时对帐；月结算后数据以中心端为准。
允许冲正交易编号：2201、2207、2208
输入为单行数据，输出为单行数据。

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 处方明细上报请求示例

{
  "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 处方明细撤销请求示例

{
  "action": "transaction",
  "transactionName": "2205",
  "businessParams": {
    "ipt_otp_no": "ZY20240115001",
    "rxno": "RX001",
    "feedetl_sn": "1001"
  }
}

2206 费用预结算请求示例

{
  "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"
  }
}

工伤接口文档.md 12 KB 고유링크 히스토리 Raw