省系统接口说明范文

附件1：

市级系统接口参考页面

1 说明

本文档是关于……，要求……。已达到……目的。

2 参考页面

第一步

客户端首先要设置web service的连接地址、用户名和密码三项。远程地址固定为：http://124.133.54.21/services/DataService。用户名和密码为省总队分配。

参考界面如下：

帐号：3702-00-01

密码:

第二步

企业填报自己月报数据然后提交。

第三步

市级用户审核企业提交的月报数据。

第四步

市级进入提交审核页面。审核通过的企业将在“企业列表”中显示。将企业选择进“已选企业”。然后点击“上传至省平台”按钮。操作完成。

参考界面如下：

附件2：

山东省节能信息系统数据导入接口协议

1 简介

本协议用于山东省节能信息系统与通过API接入山东省节能信息系统的客户端的数据传输通讯。两者的数据传输通讯采用TCP协议、短连接方式，山东省节能信息系统为服务器方。

缩略语清单：

client ：所有通过Web Service接口接入山东省节能信息系统的客户端2 Web Service接口说明

2.1 山东省节能信息系统Web Service地址

WSDL：http://124.133.54.21/services/DataService?wsdl

地址：http://124.133.54.21/services/DataService

2.2 接口说明

2.2.1 i mportYearReportData方法

public String importYearReportData(

String loginName,

String loginPwd,

String cityCode,

int year,

String reportData)

方法说明：

从各地市系统上传本市已经审核确认的企业年报数据到省系统，如果省系统中企业当年年报数据还未上传过，则添加年报数据，如果年报数据已经上传过，则更新已上传年报数据。

返回值定义：第一行为错误代码，其他行为调用失败时的详细错误信息

ok：数据导入成功

invalidate-city：错误的地市编码

invalidate-date：错误的年份

invalidate-user：访问用户不可用

not-allow-op：用户没有操作权限

illegal-report-data：不合法的报表数据格式

error-report-style：错误的报表样式

error-verify-relations：错误的校验关系

2.2.2 i mportMonthReportData方法

public String importMonthReportData(

String loginName,

String loginPwd,

String cityCode,

int year,

int month,

String reportData)

方法说明：

从各地市系统上传本市已经审核确认的企业月报数据到省系统，如果省系统中企业当月月报数据还未上传过，则添加月报数据，如果月报数据已经上传过，则更新已上传月报数据。

返回值定义：第一行为错误代码，其他行为当调用失败时的详细错误信息

ok：数据导入成功

invalidate-city：错误的地市编码

invalidate-date：错误的年份或月份

invalidate-user：访问用户不可用

not-allow-op：用户没有操作权限

illegal-report-data：不合法的报表数据格式

error-report-style：错误的报表样式

error-verify-relations：错误的校验关系

2.2.3 e xportDictionary

public String exportDictionary(String catalog)

方法说明：

导出省级系统定义的各类字典编码数据，企业注册信息、月报数据、年报数据中相关字段所使用的编码将从系统定义的字典编码中选取。

参数说明：

返回值定义：返回的各种字典编码数据，每行为一条编码，每个编码包含code和name，中间用“$@$”分隔。

返回值示例：

1.能源种类

01$@$原煤

02$@$洗精煤

…

2.计量单位

0103$@$毫克

0106$@$微克

…

3.产品指标

0001$@$万元产值综合能耗（当量值）

$@$万元产值综合能耗（等量值）

…

4.企业类型

001$@$国家千家重点用能单位

002$@$省千户重点用能单位

003$@$市属重点用能单位

5.行业分类

06$@$煤炭

17$@$纺织

…

6.行业编码

06$@$煤炭开采和洗选业

08$@$黑色金属采选业

…

7.产业编码

1$@$第一产业

2$@$第二产业

3$@$第三产业

4$@$其他产业

8.省级编码

$@$山东

…

9.地市编码

$@$济南

$@$青岛

…

10.区县编码

$@$市辖区

$@$历下区

$@$市中区

…

3 错误码使用说明

对于方法调用的返回值，ok代表数据导入成功，其他表示失败，具体错误码见下表。