第1章接口报文格式.docx
《第1章接口报文格式.docx》由会员分享,可在线阅读,更多相关《第1章接口报文格式.docx(36页珍藏版)》请在课桌文档上搜索。
1、第1章接口报文格式1.1接口输入报文格式定义报文采用JSoN格式,交易参数定义如下:表1交易输入参数定义序号数据元标识数据元名称类型长度代码标识是否必填备注1infno交易编号字符型4Y交易编号详见接口列表2msgid发送方报文ID字符型30Y定点医药机构编号(12)+时间(14)+顺序号(4)时间格式:YyyyMMddHHnunss3mdtrtarea_admvs就医地医保区划字符型6Y4insuplc_admdvs参保地医保区划字符型6如果交易输入中含有人员编号,此项必填,可通过1101人员信息获取交易取得5recer_sys_code接收方系统代码字符型10Y用于多套系统接入,区分不同系
2、统使用6devno设备编号字符型1007dev_safe_info设备安全信息字符型20008cainfo数字签名信息字符型10249signtype签名类型字符型10建议使用SM2、SM310infver接口版本号字符型6Y例如:“VI.0”,版本号由医保下发通知。11opter_type经办人类别3YY1-经办人;2-自助终端:3-移动终端12opter经办人字符型30Y按地方要求传入经办人/终端编号13optername经办人姓名字符型50Y按地方要求传入经办人姓名/终端名称14inf_time交易时间日期时间型19Y15fixmedins_code定点医药机构编号字符型12Y16fix
3、medins_name定点医药机构名称字符型20Y17sign-no交易签到流水号字符型30通过签到【9001】交易获取18input交易输入字符型40000Y1.2接口输出报文格式定义报文采用JSON格式,交易参数定义如下:表2交易输出参数定义序号数据元标识数据元名称类型长度代码标识是否非空备注1infcode交易状态码数值型4Y详见下节2infJefmsgid接收方报文ID字符型30Y接收方返回,接收方医保区划代码(6)+时间(M)+流水号(10)时间格式:yyyyMMddHHmmss3refmsg_time接收报文时间字符型17格式:yyyyMMddHHmmssSSS4respondji
4、m。响应报文时间字符型17格式:yyyyMMddHHmmssSSS5err_msg错误信息字符型200交易失败状态下,业务返回的错误信息6output交易输出字符型400001. 3交易状态码说明交易状态码(infcode)规格如下:表3报文状态说明序号STATUS值值说明备注10成功2-1失败1.4重点说明 调用交易时INPUT、OUTPUT节点应按照接口安全相关要求进行签名。 时间格式代码说明:yyyy(年,4位)、MM(月,2位)、dd(日,2位)、HH(24小时制,2位)、Inm(分钟,2位)、SS(秒,2位)、SSS(毫秒,3位)。 日期时间型的数据元(例如开始时间)格式为:yyyy
5、-MM-ddHH:mm:ss;日期型的数据元(例如开始日期)格式为:yyyy-MM-ddo 查询中输入开始结束时间,格式为yyyy-MM-dd,时间范围默认开始于00:00:00,结束于23:59:59o例如时间2020-01-01-2020-01-02则匹配时间2020-01-0100:00:00-2020-01-0223:59:59的数据。 报文中的输入/输出项的字符型串中的根节点和各个子节点一律小写。 类型为数值的参数,如果为空,必须传“0”,其他为空串(“),TXT文件中空值使用“mill”o TXT文件使用字符集为UTF-8o 接口说明中声明的输入为输入报文中INPUT属性内容,输出
6、为输出报文中OUTPUT属性内容。 接口输入、输出数据元代码标识为“Y”的,字典内容参照文章中字典表部分内容。 报文中INPUT/OUTPUT(输入信息/输出信息)要符合JSON格式的约定。 如果信息中出现的下列字符,需要进行转义处理:1、转义为;2、“”转义为“。1.5接口说明1.5.1.114101】医疗保障基金结算清单信息上传1.5.1.1.1交易说明通过此交易上传医疗保障基金结算清单信息。1. 5.1.1.2重点说明1、交易输入结算清单信息为单行数据,输入其他信息均为多行数据;2、输入项信息按照医疗保障基金结算清单填写规范中的规范要求填写;3、每次接口调用只上传一位患者的信息。4、bl
7、dcat,bld,amt,bldunt如果传多条可通过逗号分隔,(或可以通过血费bldinfo节点传这3个);5、出参异地没有返回流水号,异地返回null1.5.1.1.3交易对象交易发送方:医药机构。交易接收方:地方医保局。1.5.1.1.4输入表4结算清单信息(节点标识SeIlinfo)序号参数代码参数名称参数类型参数长度代码标识是否必填说明1mdtrtid就诊ID字符型30Y2SetLid结算ID字符型30Y3fixmedins_name定点医药机构名称字符型200Y序号参数代码参数名称参数类型参数长度代码标识是否必康说明4fixmed1nscode定点医药机构编号字符型12Y5hi_s
8、etlV医保结算等级字符型3Y6hi_no医保编号字符型30参保人在医保系统中的唯一身份代码7raedcasno病案号字符型40Y8deIajime申报时间日期时间型结算清单上报时间9psnname人员姓名字符型50Y10gend性别字符型6YY11brdy出生日期日期型Y12age年龄数值型4,1大于1岁(含1岁)时必填,单位岁13ntly国籍字符型6YY14nwb_age(年龄不足1周岁)年龄数值型3小于1岁时必填,单位天年龄小于28天,新生儿入院类型必填15naty民族字符型3YY16patncerttyPe患者证件类别字符型3YY17certno证件号码字符型50Y患者证件号码18pr
9、fs职业字符型6YY19curr_addr现住址字符型20020emp_name单位名称字符型20021empaddr单位地址字符型20022emptel单位电话字符型5023poscode邮编字符型624coner_name联系人姓名字符型50Y25patn-rlts与患者关系字符型6YY26COneJaddr联系人地址字符型200Y27conertel联系人电话字符型50Y28hitype医保类型字符型3YY29insuplc参保地字符型6Y30sp_psn_type特殊人员类型字符型6Y31nwbadmtype新生儿入院类型字符型3Y32nwb_bir_wt新生儿出生体重数值型6,2精确
10、到10克(g)33nwbadmwt新生儿入院体重数值型6,2精确到10克(g)34opspdragcat:门诊慢特病诊断科别字符型50参照字典caty35opsp_mdtrt_date门诊慢特病就诊日期日期型序号参数代码参数名称参数类型参数长度代码标识是否必康说明36iptmedtype住院医疗类型字符型3YY37adm_way入院途径字符型3Y38trt_type治疗类别字符型3Y39adm_time入院时间日期时间型40adm_caty入院科别字符型6YY参照字典caty41refldeptdept转科科别字符型6Y参照字典caty,如果超过一次以上的转科,用“f”转接表示42dscg_t
11、ime出院时间日期时间型43dscg_caty出院科别字符型6YY参照字典caty44act_ipt_days实际住院天数数值型345otp_wm_dise门(急)诊西医诊断字符型20046wm_dise_code西医诊断疾病代码字符型2047Otptcmdise门(急)诊中医诊断字符型20048tcm_dise_code中医诊断代码字符型2049diag_code_cnt诊断代码计数数值型350maindiag_flag主诊断标志字符型3YY入参没有该字段51oprn_oprt_code_cnt手术操作代码计数数值型352vent_used_dura呼吸机使用时长字符型10格式:天数/小时数
12、/分钟数例:1/13/2453pwcrybfadmcomadura颅脑损伤患者入院前昏迷时长字符型10格式:天数/小时数/分钟数例:1/13/2454pwcry_afadm_comadura颅脑损伤患者入院后昏迷时长字符型10格式:天数/小时数/分钟数例:1/13/2455bld_cat输血品种字符型3Y参照字典bld_cat_code56bld_amt输血量字符型657bld_unt输血计量单位字符型358spga_nurscare_days特级护理天数数值型3序号参数代码参数名称参数类型参数长度代码标识是否必康说明59Ivlnurscaredays一级护理天数数值型360scd_nursc
13、are_days二级护理天数数值型361lv3_nurscare_days三级护理天数数值型362dscg_way离院方式字符型3Y63acp_medins_name拟接收机构名称字符型100当离院方式为“2”时,如果接收患者的医疗机构明确,需要填写转入医疗机构的名称;当离院方式为“3”时,如果接收患者的社区卫生服务机构明确,需要填写社区卫生服务机构/乡镇卫生院名称64acpoptinscode拟接收机构代码字符型30当离院方式为“2”或“3”时,如果接收患者的医疗机构或社区卫生服务机构明确,需要填写机构对应的医保定点医疗机构代码65billcode票据代码字符型50Y66bill_no票据号
14、码字符型30Y67biz_sn业务流水号字符型50Y业务流水号68days_rinp_flag_31出院31天内再住院计划标志字符型3Y69days_rinp_pup_31出院31天内再住院目的字符型20070chfpdrname主诊医师姓名字符型5071chfpdrcode主诊医师代码字符型30主诊医师在医保医师代码中的代码,在就医地未完成标准化前,可传医师在就医地系统中的唯一编号72setl_begn_date结算开始日期日期型Y73setl_end_date结算结束日期日期型Y74psn_seIfpay个人自付数值型16,2Y75psn_ownpay个人自费数值型16,2Y76acctp
15、ay个人账户支出数值型16,2Y序号参数代码参数名称参数类型参数长度代码标识是否必康说明77psncashpay个人现金支付数值型16,2Y78hi_paymtd医保支付方式字符型3YY79hsorg医保机构字符型100Y80hsorg_opter医保机构经办人字符型50Y81medins_fill_dept医疗机构填报部门字符型100Y82medins_fill_PSn医疗机构填报人字符型50Y表5基金支付信息(节点标识:payinfo)序号参数代码参数名称参数类型参数长度代码标识是否必填说明1fund_pay_type基金支付类型字符型6YY2fund_payamt基金支付金额数值型16,
16、2Y表6门诊慢特病诊断信息(节点标识:Opspdiseinfo)序号参数代码参数名称参数类型参数长度代码标识是否必填备注1diagname诊断名称字符型100Y2diag_code诊断代码字符型20Y3oprn_oprt_name手术操作名称字符型500Y4oprn_oprt_code手术操作代码字符型30Y表7住院诊断信息(节点标识:diseinfo)序号参数代码参数名称参数类型参数长度代码标识是否必填说明1diagtype诊断类别字符型3YY2diag_code诊断代码字符型20Y3diag_name诊断名称字符型100Y4adm_cond_type入院病情类型字符型3Y表8收费项目信息(
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 接口 报文 格式

链接地址:https://www.desk33.com/p-529512.html