第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格式:天数/小时数/分钟数例：1/13/2453pwcrybfadmcomadura颅脑损伤患者入院前昏迷时长字符型10格式:天数/小时数/分钟数例：1/13/2454pwcry_afadm_comadura颅脑损伤患者入院后昏迷时长字符型10格式:天数/小时数/分钟数例：1/13/2455bld_cat输血品种字符型3Y参照字典bld_cat_code56bld_amt输