第1章接口报文格式.docx

第1章接口报文格式1.1接口输入报文格式定义报文采用JSoN格式，交易参数定义如下：表1交易输入参数定义序号数据元标识数据元名称类型长度代码标识是否必填备注1infno交易编号字符型4Y交易编号详见接口列表2msgid发送方报文ID字符型30Y定点医药机构编号（12）+时间（14）+顺序号（4）时间格式：YyyyMMddHHnunss3mdtrtarea_admvs就医地医保区划字符型6Y4insuplc_admdvs参保地医保区划字符型6如果交易输入中含有人员编号，此项必填，可通过1101人员信息获取交易取得5recer_sys_code接收方系统代码字符型10Y用于多套系统接入，区分不同系统使用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定点医药机构编号字符型12Y16fixmedins_name定点医药机构名称字符型20Y17sign-no交易签到流水号字符型30通过签到【9001】交易获取18input交易输入字符型40000Y1.2接口输出报文格式定义报文采用JSON格式，交易参数定义如下:表2交易输出参数定义序号数据元标识数据元名称类型长度代码标识是否非空备注1infcode交易状态码数值型4Y详见下节2infJefmsgid接收方报文ID字符型30Y接收方返回，接收方医保区划代码（6）+时间（M）+流水号（10）时间格式：yyyyMMddHHmmss3refmsg_time接收报文时间字符型17格式：yyyyMMddHHmmssSSS4respondjim。响应报文时间字符型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-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属性内容，输出为输出报文中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、bldcat,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_setlV医保结算等级字符型3Y6hi_no医保编号字符型30参保人在医保系统中的唯一身份代码7raedcasno病案号字符型40Y8deIajime申报时间日期时间型结算清单上报时间9psnname人员姓名字符型50Y10gend性别字符型6YY11brdy出生日期日期型Y12age年龄数值型4,1大于1岁(含1岁)时必填，单位岁13ntly国籍字符型6YY14nwb_age(年龄不足1周岁)年龄数值型3小于1岁时必填,单位天年龄小于28天,新生儿入院类型必填15naty民族字符型3YY16patncerttyPe患者证件类别字符型3YY17certno证件号码字符型50Y患者证件号码18prfs职业字符型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克(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_time出院时间日期时间型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输血量字符型657bld_unt输血计量单位字符型358spga_nurscare_days特级护理天数数值型3序号参数代码参数名称参数类型参数长度代码标识是否必康说明59Ivlnurscaredays一级护理天数数值型360scd_nurscare_days二级护理天数数值型361lv3_nurscare_days三级护理天数数值型362dscg_way离院方式字符型3Y63acp_medins_name拟接收机构名称字符型100当离院方式为“2”时，如果接收患者的医疗机构明确,需要填写转入医疗机构的名称；当离院方式为“3”时,如果接收患者的社区卫生服务机构明确,需要填写社区卫生服务机构/乡镇卫生院名称64acpoptinscode拟接收机构代码字符型30当离院方式为“2”或“3”时，如果接收患者的医疗机构或社区卫生服务机构明确,需要填写机构对应的医保定点医疗机构代码65billcode票据代码字符型50Y66bill_no票据号码字符型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,2Y76acctpay个人账户支出数值型16,2Y序号参数代码参数名称参数类型参数长度代码标识是否必康说明77psncashpay个人现金支付数值型16,2Y78hi_paymtd医保支付方式字符型3YY79hsorg医保机构字符型100Y80hsorg_opter医保机构经办人字符型50Y81medins_fill_dept医疗机构填报部门字符型100Y82medins_fill_PSn医疗机构填报人字符型50Y表5基金支付信息（节点标识：payinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1fund_pay_type基金支付类型字符型6YY2fund_payamt基金支付金额数值型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收费项目信息（节点标识：iIeminfo）序号参数代码参数名称参数类型参数长度代码标识是否必馍备注1medchrgitm医疗收费项目字符型6YY参照医疗收费项目类别medchrgitmty2amt金额数值型16,2Y3claa_sumfee甲类费用合计数值型16,2Y4clab_amt乙类金额数值型16,2Y5fulamt_ownpay_amt全自费金额数值型16,2Y6othamt其他金额数值型16,2Y表9手术操作信息（节点标识：OPrninf。）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1oprn_oprt_type手术操作类别字符型3YY2oprn_oprt_name手术操作名称字符型500Y3oprn_oprt_code手术操作代码字符型30Y序号参数代码参数名称参数类型参数长度代码标识是否必填说明4oprnoprtdate手术操作日期日期型Y5anst_way麻醉方式字符型6Y参照麻醉一方法代码anstmtd_code6oper_dr_name术者医师姓名字符型50Y7OPejdJCode术者医师代码字符型20Y8anst_dr_name麻醉医师姓名字符型509anstdrcode麻醉医师代码字符型20表10重症监护信息（节点标识：icuinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填备注1scs_cutd_ward_type重症监护病房类型字符型6YY参照字典icu_type2scs_cutd_inpool_tirae重症监护进入时间日期时间型Y3scs_cutd_exit_time重症监护退出时间日期时间型Y4Scscutdsumdura重症监护合计时长字符型10Y格式：天数/小时数/分钟数例：1/13/24输血信息（节点示识：bldinfo)序号参数代码参数名称参数类型参数长度代码标识是否必填备注1bld_cat输血品种字符型3Y参照字典bld_cat_code2bld_amt输血量字符型63bld_unt输血计量单位字符型31.5.1.1.5输出表11输出（节点标识：data）序号参数代码参数名称参数类型参数长度代码标识是否非空说明1setl_list_id清单流水号字符型9Y34exp_content字段扩展字符型400035ttp_pay_prop第三方自付比例数值型5,4表12输入-入院诊断信息（节点标识：diseinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1mdtrtid就诊ID字符型30Y2psn_no人员编号字符型30Y3diag_type诊断类别字符型3YY序号参数代码参数名称参数类型参数长度代码标识是否必填说明4maindiagflag主诊断标志字符型3YY5diag_srt_no诊断排序号数值型2Y6diag_code诊断代码字符型30Y7diag_name诊断名称字符型100Y8adm_cond入院病情字符型5009diagdept诊断科室字符型50Y10disedorno诊断医生编码字符型30Y11dise_dor_name诊断医生姓名字符型50Y12diag_time诊断时间H期时间型Yyyyy-MM-ddHH:nun:ss1.5.1.1.6输出无。1. 5.1.214101A医疗保障基金结算清单信息上传（新）2. 5.L2.1交易说明通过此交易上传医疗保障基金结算清单信息。注：新用户使用该交易之后，就不使用【4101】交易。3. 5.L2.2重点说明1、交易输入结算清单信息为单行数据，输入其他信息均为多行数据；2、输入项信息按照医疗保障基金结算清单填写规范中的规范要求填写;3、每次接口调用只上传一位患者的信息；1.5.L2.3交易对象交易发送方：医药机构。交易接收方：地方医保局。1.5.1.2.4输入表13结算清单信息（节点标识SeUinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1psnno人员编号字符型30Y医保系统内人员编号2mdtrt_id就诊ID字符型30Y3setlid结算ID字符型30Y4hino医保编号字符型30参保人在医保系统中的唯一身份代码5medcasno病案号字符型306dcla_time申报时间日期时间型结算清单上报时间，接收时自动填充7ntly国籍字符型6Y8prfs职业字符型6YY9curraddr现住址字符型20010empname单位名称字符型20011emp_addr单位地址字符型20012emp_tel单位电话字符型5013poscode邮编字符型614coner_name联系人姓名字符型5015patn-rlts与患者关系字符型6YY当Conername非空时必填16coner_addr联系人地址字符型200Y当Conername非空时必填17coner_tel联系人电话字符型50Y当Conejname非空时必填18nwb_adm_type新生儿入院类型字符型50Y填写多胞胎入院类型时以半角逗号隔开序号参数代码参数名称参数类型参数长度代码标识是否必填说明19nwbbirwt新生儿出生体重数值型6,2精确到10克（g）20nwb_adm_wt新生儿入院体重数值型6,2精确到10克（g）21mul_nwb_bir_wt多新生儿出生体重字符型50多胞胎体重，用英文逗号隔开22mul_nwb_adm_wt多新生儿入院体重字符型50多胞胎体重，用英文逗号隔开23opsp_diag_caty门诊慢特病诊断科别字符型5024opspmdtrt-date门诊慢特病就诊日期日期型25adm_way入院途径字符型30Y26trt_type治疗类别字符型3Y27adm_time入院时间日期时间型28adm_dept_code入院科室编码字符型3029adm_dept_name入院科室名称字符型10030traf_dept_flat转科室标志字符型631refldept_dept转科科别字符型50Y参照科室代码（dept）»如果超过一次以上的转科，用“一”转接表示32dscg_time出院时间日期时间型33dscgdeptcode出院科室编码字符型3034dscgdeptname出院科室名称字符型100序号参数代码参数名称参数类型参数长度代码标识是否必填说明35dscgcaty出院科别字符型6YY参照科室代码（dept）36otp_w_dise门（急）诊诊断（西医诊断）字符型20037wmdisecode西医疾病代码字符型3038otp_tcm_dise门（急）诊诊断（中医诊断）字符型20039tcm_dise_code中医疾病代码字符型3040vent_used_dura呼吸机使用时长字符型10格式：天数/小时数/分钟数例：1/13/2441Pwcrybfadmcoma_dura颅脑损伤患者入院前昏迷时长字符型10格式：天数/小时数/分钟数例：1/13/2442pwcry_afadm_coma_dura颅脑损伤患者入院后昏迷时长字符型10格式：天数/小时数/分钟数例：1/13/2443Spganurscaredays特级护理天数数值型4,1441V1nurscaredayS一级护理天数数值型4,145scd_nurscare_dayS二级护理天数数值型4,1461v3_nurscare_dayS三级护理天数数值型4,147dscg_way离院方式字符型3Y序号参数代码参数名称参数类型参数长度代码标识是否必填说明说明当离院方式为“2”时，如果接收患者的医疗机构明确，需要填写转入医疗机构的名称：拟接收机构名48acp_medins_name称字符型100当离院方式为“3”时，如果接收患者的社区卫生服务机构明确，需要填写社区卫生服务机构/乡镇卫生院名称当离院方式为“2”或“3”时，如果接收患者的医疗拟接收机构代机构或社区卫生49acp_optins_code码字符型30服务机构明确，需要填写机构对应的医保定点医疗机构代码定点医疗机构按照财政部门票据管理相关规定出50bill_code票据代码字符型50Y具的医疗收费电子票据上的票据代码序号参数代码参数名称参数类型参数长度代码标识是否必填说明51billno票据号码字符型30Y定点医疗机构按照财政部门票据管理相关规定出具的医疗收费电子票据上的票据流水号52biz_sn业务流水号字符型50Y53daysrinpflag31出院31天内再住院计划标志字符型3Y54days_rinp_pup_31出院31天内再住院计划目的字符型20055ChfPdJCOde主诊医师代码字符型30主诊医师在医保医加代码中的代码，在就医地未完成标准化前，可传医肺在就医地系统中的唯编号56setl_bcgn_date结算开始日期日期型Y57setl_end_date结算结束日期日期型Y58medins_fill_dept医疗机构填报部门字符型100Y59medins_fill_psn医疗机构填报人字符型50Y60resp_nurs_code责任护士代码字符型5061stas_type状态分类字符型10Y序号参数代码参数名称参数类型参数长度代码标识是否必填说明62hipaymtd医保支付方式字符型3Y医保经办机构与定点医疗机构根据不同医疗服务的性质和特征，将医疗服务划分为不同的付费单元并确定付费标准的措施衣14门诊慢特病诊断信息（节点标识：OPSPdiSeinfO）序号参数代码参数名称参数类型参数长度代码标识是否必填备注1oprn_oprt_name手术操作名称字符型5002oprn_oprt_code手术操作代码字符型30表15住院诊断信息（节点标识：diseinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1diag_type诊断类别字符型3YY2diag_code诊断代码字符型30Y3diag_name诊断名称字符型100Y4adm_cond_type入院病情类型字符型3YY5maindiagflag主诊断标志字符型3YY表16手术操作信息（节点标识：OPrninfO）序号参数代码参数名称参数类型参数长度代码标识是否必填说明1oprn_oprt_typc手术操作类别字符型3YY1主要手术及操作2其他手术及操作2oprn_oprt_name手术操作名称字符型500Y3oprn_oprt_code手术操作代码字符型30Y4anstway麻醉方式字符型6Y参照麻醉-方法代码5operdrcode术者医师代码字符型20Y6anst_dr_code麻醉医师代码字符型207oprn_oprt_begn手术操作开始日期时间序号参数代码参数名称参数类型参数长度代码标识是否必填说明time时间型8oprn_oprt_endtime手术操作结束时间日期时间型9anst_begntime麻醉开始时间日期时间型10anst_endtime麻醉结束时间日期时间型表17重症监护信息（节点标识：icuinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填备注1scs_cutd_ward_type重症监护病房类型字符型6YY使用字典IClLTYPE2scs_cutd_inpool_time重症监护进入时间日期时间型Y3scs_cutd_exit_time重症监护退出时间日期时间型Y4scs_cutd_sum_dura重症监护合计时长字符型10Y格式:天数/小时数/分钟数例：1/13/24表18输血信息（节点标识：bldinfo）序号参数代码参数名称参数类型参数长度代码标识是否必填备注1bld_cat输血品种字符型3Y2bld_amt输血量数值型8,23bld_unt输血计量单位字符型151.5.1.2.5输出表19输出（节点标识：data）序号参数代码参数名称参数类型参数长度代码标很是否非空说明1setl_list_id清单流水号字符型9Y1.5.1.314102医疗保障基金结算清单信息状态修改1.5.1.3.1交易说明通过此交易修改医疗保障基金结算清单信息。1.5.1.3.2重点说明0：未提交1：已提交2：审核通过