财政部关于印发《节能环保产品政府采购清单数据规范》的通知

节能环保产品政府采购清单数据规范

1.目录.......1

2.适用范围......2

3.术语和定义、符号、缩略语......2

4.概述........2

5.接口规范........2

5.1政府采购节能环保清单定义说明.....3

5.1.1头信息........3

5.1.2节能环保清单标识信息.......3

5.1.3节能环保清单产品信息......3

5.2约束...........4

6.接口详情.............4

6.1接口方式......................4

6.2数据接口参数示例......5

6.2.1示例..............5

6.3接口返回...........7

7.附录...............7

7.1数据字典...........7 

7.2常见问题...........7

7.2.1接口账号........7

7.2.2品目与基础数据字典品目不一致时，如何填写品目数据？..........8

7.2.3调试说明.......8

　2.适用范围

本文档由财政部国库司、信息网络中心以及节能产品政府采购清单和环境标志产品政府采购清单（以下统称节能环保清单）相关认证机构共同编写。节能环保清单生成、发布、接收应当执行本文档规定的数据规范。

3.术语和定义、符号、缩略语

1、清单：如无特殊说明，清单在本文档中均指节能环保清单。

2、发布单位：如无特殊说明，发布单位均指节能环保清单发布单位。

3、空字符串：如接口字段不允许为空，即该字段必须有值，不可从技术上对字段不赋值或者赋值为 null，请根据字段说明按要求填写合适的值。

4、日期格式：约定统一的日期格式。统一的格式为 YYYY-MM-DD。如 2016-06-28。

4.概述

本规范将规定节能环保清单标准化文本应包含的信息内容及其规范性。节能环保清单相关认证机构定期发布的清单标准化文本，依据本文档规定的技术指标及相关说明生成。各相关信息系统通过系统接口方式获取清单标准化文本的，需严格遵循本规范。

节能环保清单标准化文本将按本规范约定以xml文件方式提供，用户可以通过以下两种方式中任意一种获取该xml文件：

1、通过中国政府采购网首页指定位置下载xml格式的数据包；

2、用户按此规范说明自行开发客户端工具，连接中国政府采购网的服务端程序以接收节能环保清单标准化文本。用户的客户端工具可用任何编程语言开发，也可与现有系统集成，实现在自有系统或网站上进行节能环保清单的发布与查询。

该文档主要描述节能环保清单标准化文本的内容及接口方式的获取方法，包含三部分内容：

1、接口可接收的字段说明，即各清单的字段类型及程序检查规则；

2、接口说明，即节能环保清单数据接口技术描述；

3、基础数据说明，即节能环保清单包含代码的字段，应按照基础数据字典中的代码字段填写。

5.接口规范

节能环保清单数据接口规范中包括各类型清单的字段，节能环保清单数据接口将按照下边的表格进行数据接收和验证，并按“接口检查规则”检验数据后存入各交易系统数据库。

5.1政府采购节能环保清单定义说明

　　5.1.1头信息

　　5.1.1.1 头信息要求说明

推送数据所需的必要全局信息，字段及描述详见本节定义。

5.1.1.2 字段要求列表

5.1.2节能环保清单标识信息

　　5.1.2.1 标识信息要求说明

清单标识信息记录清单的属性信息，字段及描述详见本节定义。

5.1.2.2 字段要求列表

　5.1.3节能环保清单产品信息

　　5.1.3.1 产品信息要求说明

产品信息记录节能环保清单品目相关信息，字段及描述详见本节定义。

　5.1.3.2 字段要求列表

5.2约束

约束条件已经在清单相关表中列出，请按照约束说明来设定字段值。

6.接口详情

以中国政府采购网接收节能环保清单标准化文本为例进行接口说明。省级财政部门政府采购管理交易系统可参照设计相关系统接口。

　6.1接口方式

中国政府采购网提供 xml 结构节能环保清单数据，各省级系统在获取授权后，通过请求接口的形式，获取清单数据。各省级系统应根据本规范说明进行接口客户端开发，开发完成后向中国政府采购网申请开通接口权限，以供调试和日后正式数据的获取，接口地址如下：

http://data.ccgp.gov.cn/ccgpexchange/JnhbService？dirType=1&dirCode=201618

6.2数据接口参数示例

　　6.2.1示例

以下以环保清单数据为示例：

/**

*@param dirType

*清单类型，清单类型列表见5.1.2节能环保清单标识信息。

*@param dirCode

*六位数字格式的清单编号，例如：201618代表2016年第18期。

*

*@return

*Xml结构的清单信息，xml结构请参见接口规范。

*/

Xml 结构：

Xml 中，jnhbINFO 结点下的各结点名称与接口规范中的字段参数名一一对应。由于品目数据及类型较多，下述代码仅为示例，请依据文档字段的定义及描述来指定参数。

【注意】以下 xml 结构只作为参数格式描述，请根据实际发送的清单类型选择和修改 XML 中应包含的字段，不可以不做任何修改直接复制到代码中。如 xml 结构与字段描述表格有出入，请以字段描述表格为准。其中 REMARK 结点不是必填项。

由于一份清单对应多个品目，属于一对多的情况此处采用组合的形式，采用子标签结构设置规范，示例以2个品目来举例：

　　6.3接口返回

@return 以字符串形式的返回信息，返回值的格式为：

1. <result>

2. <code>-1</code>

3. <reason>数据重复，请检查文档中有关重复数据的约束条件。</reason>

4. </result>

其中code表示的是数据推送状态，reason表示数据推送失败的原因，详细描述了您的数据参数中有哪些不符合的内容，可以根据返回值调试数据。下面是code可能包含的值及状态描述；

当接口接收数据时将按照接口规范及约束对传入的数据项目进行规范性、完整性检查。

如果传入的数据不满足规范要求将不接收数据，并向调用方返回检查后的结果状态值。

7.附录

7.1数据字典

请参见《基础数据字典.xlsx》文档，文档中包含品目字典、品牌字典。数据均来自于财政部或其他相关部门的规范。

7.2常见问题

　　7.2.1接口账号

接口系统的验证账号采用政府采购交易管理系统中的用户名和密码，请确保已经登记开通相关账号权限。

　7.2.2品目与基础数据字典品目不一致时，如何填写品目数据？

《基础数据字典.xlsx》中的品目为财政部国库司 2013 年发布的版本（财库[2013]189 号），如品目出现差异，可选择上一级品目，但应以财政部正式下发的品目为准。

　7.2.3调试说明

调试完成的单位可以直接联系中国政府采购网确认启用正式接口时间。

调试期间各单位请用中国政府采购网指定的调试账号进行数据的传输调试，调试数据每天晚上清空一次，请各位调试人员知悉。

正式接口地址与调试地址一致。接口调试简要流程为：用户联系中国政府采购网申请接口调试；中国政府采购网相关技术文档；用户根据资料中的说明使用测试账号进行接口调试（如遇到问题可以联系技术人员进行联调解决）；用户测试联调获得正确的数据；用户联系中国政府采购网开通正式接口；接收正式数据并应用在自建业务系统中。