省系统接口说明

附件附件 1 1： 市级系统接口参考页面市级系统接口参考页面 1 说明说明 本文档是关于，要求。已达到目的。 2 参考页面参考页面 第一步第一步 客户端首先要设置 web service 的连接地址、用户名和密码三项。远程地 址固定为：1/services/DataService。用户名和密码为省 总队分配。 参考界面如下： 帐号：3702-00-01 密码: 123456 2 第二步第二步 企业填报自己月报数据然后提交。 第三步第三步 市级用户审核企业提交的月报数据。 第四步第四步 市级进入提交审核页面。审核通过的企业将在“企业列表”中显示。将企 业选择进“已选企业” 。然后点击“上传至省平台”按钮。操作完成。 参考界面如下： 3 附件附件 2 2： 山东省节能信息系统数据导入接口山东省节能信息系统数据导入接口协议协议 1 简介简介 本协议用于山东省节能信息系统与通过 API 接入山东省节能信息系统的客 户端的数据传输通讯。两者的数据传输通讯采用 TCP 协议、短连接方式，山东 省节能信息系统为服务器方。 缩略语清单： client ：所有通过 Web Service 接口接入山东省节能信息系统的客户端 2 Web Service 接口说明接口说明 2.1 山东省节能信息系统山东省节能信息系统 Web Service 地址地址 WSDL：1/services/DataService?wsdl 4 地址：1/services/DataService 2.2 接口说明接口说明 2.2.1importYearReportData 方法方法 public String importYearReportData( String loginName, String loginPwd, String cityCode, int year, String reportData) 方法说明： 从各地市系统上传本市已经审核确认的企业年报数据到省系统，如果省系统中企业当 年年报数据还未上传过，则添加年报数据，如果年报数据已经上传过，则更新已上传年报 数据。 参数说明： 参数参数描述描述 loginName市级系统在省系统访问用户名 loginPwd市级系统在省系统访问口令 cityCode要上传年报的地市编码，具体编码见附录 4.2 year要上传年报的年份 reportData要上传的年报数据，具体数据格式见附录 4.1。 要求上传的年报数据必须包括以下表数据（见附录 4.3、4.4）： 返回值定义：第一行为错误代码，其他行为调用失败时的详细错误信息 ok：数据导入成功 invalidate-city：错误的地市编码 invalidate-date：错误的年份 invalidate-user：访问用户不可用 not-allow-op：用户没有操作权限 illegal-report-data：不合法的报表数据格式 error-report-style：错误的报表样式 error-verify-relations：错误的校验关系 2.2.2importMonthReportData 方法方法 public String importMonthReportData( 5 String loginName, String loginPwd, String cityCode, int year, int month, String reportData) 方法说明： 从各地市系统上传本市已经审核确认的企业月报数据到省系统，如果省系统中企业当 月月报数据还未上传过，则添加月报数据，如果月报数据已经上传过，则更新已上传月报 数据。 参数说明： 参数参数描述描述 loginName市级系统在省系统访问用户名 loginPwd市级系统在省系统访问口令 cityCode要上传月报的地市编码，具体编码见附录 4.2 year要上传月报的年份 month要上传月报的月份 reportData要上传的月报数据，具体数据格式见附录 4.1。 要求上传的月报数据必须包括以下表数据（见附录 4.3、4.5）： 1. 企业注册信息表（nyqyzcxxb） 2. 表 1 主表部分（nygjxfkcb） 3. 表 1 补充资料部分（nygjxfkcb_zyzb） 4. 表 2 数据部分（nygjxfkcfb） 5. 表 3 数据部分（dwcpzhnhzbqkb） 对于表 1 主表部分、表 2 数据部分，上传的数据可以只包括企 业填报过数的能源种类记录，没有填报过数的能源种类记录可 以不上传。 返回值定义：第一行为错误代码，其他行为当调用失败时的详细错误信息 ok：数据导入成功 invalidate-city：错误的地市编码 invalidate-date：错误的年份或月份 invalidate-user：访问用户不可用 not-allow-op：用户没有操作权限 illegal-report-data：不合法的报表数据格式 error-report-style：错误的报表样式 error-verify-relations：错误的校验关系 6 2.2.3exportDictionary public String exportDictionary(String catalog) 方法说明： 导出省级系统定义的各类字典编码数据，企业注册信息、月报数据、年报数据中相关 字段所使用的编码将从系统定义的字典编码中选取。 参数说明： 参数参数描述描述 catalog要显示的字典目录名 可选的字典目录名包括： 1.nyzl：能源种类 nymap 2.jldw：计量单位 3.cpzb：产品指标 zbmap 4.qylx：企业类型 5.hyfl：行业分类 6.hybm：行业编码 7.cybm：产业编码 8.sjbm：省级编码 9.dsbm：地市编码 10. qxbm：区县编码 返回值定义：返回的各种字典编码数据，每行为一条编码，每个编码包含 code 和 name， 中间用“$”分隔。 返回值示例： 1.能源种类 01$原煤 02$洗精煤 2.计量单位 0103$毫克 0106$微克 3.产品指标 0001$万元产值综合能耗（当量值） 000101$万元产值综合能耗（等量值） 4.企业类型 001$国家千家重点用能单位 002$省千户重点用能单位 003$市属重点用能单位 7 5.行业分类 06$煤炭 17$纺织 6.行业编码 06$煤炭开采和洗选业 08$黑色金属采选业 7.产业编码 1$第一产业 2$第二产业 3$第三产业 4$其他产业 8.省级编码 370000$山东 9.地市编码 370100$济南 370200$青岛 10. 区县编码 370101$市辖区 370102$历下区 370103$市中区 3 错误码使用说明错误码使用说明 对于方法调用的返回值，ok 代表数据导入成功，其他表示失败，具体错误码见下表。 如果调用失败，其他行将显示失败的详细信息。 错误码错误码描述和处理描述和处理 invalidate-city地市编码不可用，请检查地市的编码是否属于附录 4.2 定义的地 市编码。 invalidate-date错误的年份和月份，请检查年份和月份是否输入正确 invalidate-user市级系统需要在省级系统有访问帐号，给定的用户未在省级系 统中注册，联系省级系统管理员提供注册用户。 not-allow-op市级系统给定的用户没有对月报或年报有上传权限，联系省级 系统管理员，提供上传权限。 illegal-report-data给定的报表数据格式错误，报表数据格式请参考附录 4.1 的格式 定义。 error-report-style给定的报表数据不符合报表编码指定的报表样式，请检查报表 数据是否按照附录 4.3、4.4、4.5 中定义的报表样式定义数据字 8 段，并且报表数据的字段中指定的字典编码在系统字典中存在。 error-verify-relations给定的报表数据有错误的数据校验关系，请检查数据是否有填 写错误，因而不符合数据校验关系。 4 附录附录 4.1 报表数据格式定义报表数据格式定义 1. 年报和月报数据格式包含多个表数据（表定义见附录 4.3、4.4、4.5） ，每个表包含 1 到多个用能单位的上报数据，即：表 1 的上报数据，表 2 的上报数据，,表 n 的上报数 据。 2. 每个表数据第一行是表名标识行，以“”开头，后跟表数据所对应的表的编码， 第二行是表字段定义行，定义了该表所使用的字段名称，各个字段名之间用“$”分隔。 剩下行是表数据行，存放各个企业对该表的上报数据，要求数据行的各个字段值必须和字 段定义行的各个字段相一致，各个数据值之间用“$”分隔。各行之间用回车换行 （rn）分隔。 3. 填报的数据，对于字符型和日期型，要求在数据两边加单引号。 4. 报表数据各行的各个字段要求必须有值，如果企业数据没有填写，那么使用初始数 据填充，数值型数据初始值为 0，字符型和日期型数据初始值为空字符串（不是 null） 。 5. 要求导入的数据要遵循对应报表的数据校验关系，系统会根据数据校验关系对数据 进行校验，校验不通过时不能被导入，并返回错误码。 6. 导入数据可以传入指定报表的某个年月的多家企业的报表数据。导入时如果该企业 该年月有数据则采用覆盖的方式处理，否则数据为添加的方式。 7. 每次调用接口上报年报或月报的企业数量不要超过 50 家，如果需要上报企业超过 50 家，建议分为多次调用上报。 月报报表数据格式示例： nyqyzcxxb qy_code$qy_name$qy_qyfl_code$qy_address$qy_hy_code$qy_province$qy_city$qy_coun ty$qy_sscy$des 12345678-0$山东 XXXX 有限公司$06$山东省 xx 市 xx 路 xx 号 $001$370000$370100$370101$1$ nygjxfkcb qy_code$nyzl_code$qkcl$gjl_swl$gjl_je$xfl_gyscxf$xfl_gyscxf_yyycl$xfl_fgyscxf$ $xfl_ysgjxf$qmkcl$cyzbxs$dwfzr$tjfzr$tbr$dh$tbrq nygjxfkcb_zyzb qy_code$bq_zhnyxfl$sq_zhnyxfl$bq_gyzcz_dnj$bq_gyzcz_snj$sq_gyzcz_dnj$sq_fgyscxf$ $sq_dlxfhj$sq_gyscdlxf$sq_dlcc$sq_hlfdtr 9 nygjxfkcfb qy_code$nyzl_code$hlfd$gr$ymrx$lj$ly$zq$trqyh$jgmzp$nyjgzhcc$hsly$dw fzr$tjfzr$tbr$dh$tbrq dwcpzhnhzbqkb qy_code$cpzb_code$bnd_zxz$bnd_mxz$snd_mxz$snd_zxz$dwfzr$tjfzr$tbr$dh$tbr q 4.2 地市编码表地市编码表 编码编码地市名称地市名称 3701济南 3702青岛 3703 淄博 3704 枣庄 3705东营 3706烟台 3707潍坊 3708 济宁 3709 泰安 3710 威海 3711 日照 3712 莱芜 3713 临沂 3714 德州 3715 聊城 3716 滨州 3717 菏泽 4.3 企业注册信息表定义企业注册信息表定义 对象编码对象编码nyqyzcxxb 对象名称对象名称企业注册信息表企业注册信息表 字段字段名称名称类型类型说明说明 qy_code 企业组织机构代码证号码 字符型格式为：xxxxxxxx-x,不允 许为空，现在有系统里的法 人代码 qy_name 企业名称字符型不允许为空 qy_qyfl_code 企业分类编码 字符型对应企业类型字典表编码,不 允许为空 qy_address 企业地址字符型不允许为空 10 qy_hy_code 企业行业编码 字符型对应行业编码字典表编码,不 允许为空 qy_province 企业所属省份编码 字符型对应省级编码字典表编码,不 允许为空 qy_city 企业所属地市编码 字符型对应地市编码字典表编码,不 允许为空 qy_county 企业所属县（市）区编码 字符型对应区县编码字典表编码,不 允许为空 qy_sscy 企业所属产业编码 字符型对应产业编码字典表编码,不 允许为空（没有） des 备注信息 字符型（没有） 数据要求：数据要求： 本表每家企业每月只有一条数据。qy_code 为企业组织机构代码证号，例如：12345678-0。该字 段是唯一字段，多次导入该字段相同的企业时，会视作更新原有数据。 4.4 需要导入年报报表定义需要导入年报报表定义 暂无 4.5 需要导入月报报表定义需要导入月报报表定义 对象编码对象编码nygjxfkcb 对象名称对象名称表表 1 主表部分主表部分 字段字段名称名称类型类型说明说明 qy_code 企业组织机构代码证号码字符型格式为：xxxxxxxx-x,不允许为空 nyzl_code 能源编码 字符型对应能源种类字典表编码，为标准能源 +电力的等价值+当量值和等价值的合计， 不允许为空 qkcl 期初库存量 数值型两位有效小数位数，不允许为空 gjl_swl 购进量实物量 数值型两位有效小数位数，不允许为空 gjl_je 购进量金额数值型两位有效小数位数，不允许为空 xfl_gyscxf 消费量工业生产消费 数值型两位有效小数位数，不允许为空 xfl_gyscxf_yyycl 消费量工业生产消费量用 于原材料 数值型两位有效小数位数，不允许为空 xfl_fgyscxf 消费量非工业生产消费量 数值型两位有效小数位数，不允许为空 xfl_ysgjxf 消费量运输工具消费 数值型两位有效小数位数，不允许为空 qmkcl 期末库存量 数值型两位有效小数位数，不允许为空 cyzbxs 采用折标系数 数值型四位有效小数位数，不允许为空 dwfzr 单位负责人字符型表 1 下方的单位负责人,不允许为空 11 tjfzr 统计负责人 字符型表 1 下方的统计负责人,不允许为空 tbr 填报人 字符型表 1 下方的填表人,不允许为空 dh 电话字符型表 1 下方的电话,不允许为空 tbrq 填报日期 日期型表 1 下方的填表填报日期,不允许为空 数据要求：数据要求： 本表根据每家企业用能不同，数据条数并不相同，可以根据表 1 样式构造出所有数据，也可以只构 造企业用到的能源的数据。 校验关系：校验关系： 1、工业生产消费用于原材料。 2、子能源之和不能大于父能源。 如：2006-2010 年表中存在，煤制品型煤+水煤浆+煤粉。其他燃料煤矸石+生物质能+工业废料+城 市固体垃圾。2011 年之后的表存在原煤无烟煤+炼焦烟煤+一般烟煤+褐煤。 对象编码对象编码nygjxfkcb_zyzbnygjxfkcb_zyzb 对象名称对象名称表表 1 补充资料部分补充资料部分 字段字段名称名称类型类型说明说明 qy_code企业组织机构代码证号码字符型格式为：xxxxxxxx-x,不允许为空 bq_zhnyxfl本期-综合能源消费量(吨标准煤)数值型两位有效小数位数，不允许为空 sq_zhnyxfl上期-综合能源消费量(吨标准煤)数值型两位有效小数位数，不允许为空 bq_gyzcz_dnj本期-工业总产值(当年价)(千元)数值型两位有效小数位数，不允许为空 bq_gyzcz_snj本期-工业总产值(上年价) (千元)数值型两位有效小数位数，不允许为空 sq_gyzcz_dnj上期-工业总产值(当年价) (千元)数值型两位有效小数位数，不允许为空 sq_fgyscxf上期-非工业生产消费(吨标准煤) 数值型两位有效小数位数，不允许为空 sq_dlxfhj上期-电力消费合计（万千瓦时）数值型两位有效小数位数，不允许为空 sq_gyscdlxf 上期-工业生产电力消费（万千瓦时）数值型两位有效小数位数，不允许为空 sq_dlcc上期-电力产出（万千瓦时）数值型两位有效小数位数，不允许为空 sq_hlfdtr上期-火力发电投入(吨标准煤) 数值型两位有效小数位数，不允许为空 数据要求：数据要求： 本表每家企业每月只有一条数据。 对象编码对象编码nygjxfkcfbnygjxfkcfb 对象名称对象名称表表 2 数据部分数据部分 字段字段名称名称类型类型说明说明 qy_code企业组织机构代码证号码 字符型格式为：xxxxxxxx-x,不允许为空 nyzl_code能源种类编码 字符型对应能源种类字典表编码，为标准能源 +电力的等价值+当量值和等价值的合计， 不允许为空 12 hlfd火力发电 数值型两位有效小数位数，不允许为空 gr供热 数值型两位有效小数位数，不允许为空 ymrx原煤入洗 数值型两位有效小数位数，不允许为空 lj炼焦 数值型两位有效小数位数，不允许为空 ly炼油 数值型两位有效小数位数，不允许为空 zq制气 数值型两位有效小数位数，不允许为空 trqyh天然气液化 数值型两位有效小数位数，不允许为空 jgmzp加工煤制品 数值型两位有效小数位数，不允许为空 nyjgzhcc能源加工转换产出 数值型两位有效小数位数，不允许为空 hsly回收利用 数值型两位有效小数位数，不允许为空 dwfzr单位负责人 字符型不允许为空 tjfzr统计负责人 字符型不允许为空 tbr填表人 字符型不允许为空 dh电话 字符型不允许为空 tbrq填报日期 日期型不允许为空 数据要求：数据要求： 本表根据每家企业用能不同，数据条数并不相同，可以根据表 2 样式构造出所有数据，也可以只构造 企业用到的能源的数据。 校验关系：校验关系： 1、子能源之和不能大于父能源。 如：2006-2010 年表中存在，煤制品型煤+水煤浆+煤粉。其他燃料煤矸石+生物质能+工业废料+城 市固体垃圾。2011 年之后的表存在原煤无烟煤+炼焦烟煤+一般烟煤+褐煤。 2、总的加工转换投入合计总的能源加工转换产出。(仅限乘折标系数后的合计才有这样的关系，具体 每种能源没有这种关系) 3、总的工业生产消费量总的能源加工转换产出折标量。(仅限乘折标系数后的合计才有这样的关系， 具体每种能源没有这种关系) 4、总的工业生产消费量总的回收利用值。(仅限乘折标系数后的合计才有这样的关系，具体每种能源 没有这种关系) 5、总的工业生产消费量总的加工转换投入合计。(仅限乘折标系数后的合计才有这样的关系，具体每 种能源没有这种关系) 对象编码对象编码dwcpzhnhzbqkbdwcpzhnhzbqkb 对象名称对象名称表表 3 数据部分数据部分 字段字段名称名称类型类型说明说明 qy_code企业组织机构代码证号码字符型格式为：xxxxxxxx-x,不允许为空 cpzb_code产品指标编码字符型对应产品指标字典表编码 bnd_zxz本年度-子项值数值型两位有效小数位数，不允许为空 13 bnd_mxz本年度-母项值 数值型两位有效小数位数，不允许为空 snd_zxz上年度-子项值 数值型两位有效小数位数，不允许为空 snd_mxz上年度-母项值数值型