1 节能环保 产品 政府采购清单数据规范 1. 目录 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 接口方式 ........................................................................................................ 5 6.2 数据接口参数示例 .......................................................................................... 5 6.2.1 示例 ..................................................................................................... 5 6.3 接口返回 ........................................................................................................ 7 7. 附录 ......................................................................................................................... 7 7.1 数据字典 ........................................................................................................ 7 7.2 常见问题 ........................................................................................................ 8 7.2.1 接口账号 .............................................................................................. 8 7.2.2 品目不基础数据字典品目丌一致时，如何填写品目数据 .................... 8 7.2.3 调试说明 .............................................................................................. 8 2 2. 适用范围 本文档 由财政部国库司、信息网络中心以及节能产品政府采购清单和环境标志产品政府采购清单（以下统称节能环保清单）相关认证机构共同编写。节能环保清单生成、发布、接收应当执行本文档规定的数据规范。 3. 术语和定义、符号、缩略语 1、 清单 如无特殊说明， 清单 在本文档中均指 节能环保清单 。 2、 发布单位如无特殊说明，发布单位均指节能环保清单发布单位。 3、 空字符串 如 接口字段丌允许为空，即该字段必须有值，丌可从技术上对字段丌赋值或者赋值为 null，请根据字段说明按要求填写合适的值。 4、 日期 格式约定统一的 日期 格式。统一的格式为 YYYY-MM-DD。如 2016-06-28。 4. 概述 本规范 将规定节能环保清单标准化文本 应包含的信息内容及其规范性。 节能环保清单相关认证机构定期发布的清单标准化文本， 依据本文档 规定 的技术指标及相关说明生成 。各相关信息系统通过系统接口方式获取清单标准化文本的，需严格遵循本规范 。 节能环保清单标准化文本 将 按本规范约定以 xml 文件方式提供 ，用户可以通过以下两种方式中任意一种获取该 xml 文件 1、 通过中国政府采购网首页指定位置下载 xml 格式的数据包 ； 2、用户按此规范说明自行开发客户端工具，连接中国政府采购网的服务端程序以接收节能环保清单标准化文本。用户的客户端工具可用 任何编程诧言开发 ， 也可不 现有系统集成，实现在自有系统或网站上进行节能环保清单的发布不查询 。 该文档主要描述 节能环保清单标准化文本的内容及接口方式的 获取方法， 包含三部分内容 1、 接口可接收的字段说明，即各 清单 的字段类型及程序检查规则； 2、接口说明，即 节能环保清单 数据接口技术描述； 3、 基础数据说明，即 节能环保清单 包含代码的字段 ， 应按照基础数据字典中的代码字段填写。 5. 接口规范 节能环保清单 数据接口规范中包括各类型 清单 的字段， 节能环保清单 数据接口将按照下边的表格进行数据接收和验证，并按 “ 接口检查规则 ” 检验数据后存入 各交易系统 数据库。 3 5.1 政府采购 节能环保清单定义说明 5.1.1 头信息 5.1.1.1 头 信息 要求说明 推送数据所需的必要全局信息， 字段及描述详见本节定义。 5.1.1.2 字段要求列表 参数名称 参数说明 接口检查规则 是否必填 VERSION 产品清单版本 数字格式的递增版本号。 是 FULLUPDATE 全量更新标志 1-根据 产品清单编号 和版本号覆盖历史数据（全量更新）； 0-丌覆盖数据，根据 产品清单编号 和版本号增量更新 是 5.1.2 节能环保清单标识信息 5.1.2.1 标识信息 要求说明 清单标识信息记录清单的属性信息 ，字段及描述详见本节定义 。 5.1.2.2 字段要求列表 参数名称 参数说明 接口检查规则 是否必填 DIR_CODE 产品清单编号 节能、节水清单 ES4 位年度 2 位期数，例如 ES201603; 环保清单 EP4 位年度 2 位期数，例如EP201602。 是 DIR_NAME 产品清单名称 最大长度为 255 个字符 是 DIR_TYPE 产品清单类型 节能清单 1; 环保清单 2。 是 VALID_START_DATE 有效开始日期 格式为 YYYY-MM-DD 是 VALID_END_DATE 有效截止日期 格式为 YYYY-MM-DD 否 ISSUE_DATE 发布日期 格式为 YYYY-MM-DD 是 REMARK 备注 最大长度为 400 个字符 否 5.1.3 节能环保清单产品信息 5.1.3.1 产品 信息 要求说明 4 产品信息记录节能环保清单品目相关信息 ，字段及描述详见本节 定 义。 5.1.3.2 字段要求列表 参数名称 参数说明 接口检查规则 是否必填 PUR_ITEM_CODE 产品编号 最大长度为 32 位字符 具体参照 政府采购品目分类目录 是 PUR_ITEM_NUM 产品编码 最大长度为 32 位字符，为末级品目下的细化编码 否 PUR_ITEM_NAME 产品名称 最大长度为 100 个字符 是 GOODS_SPEC 规格型号 最大长度为 100 个字符 是 CERT_CODE 节能环保产品证书编号 最大长度为 128 个字符 是 CERT_EXPIR 节能环保产品证书有效截止日期 格式为 YYYY-MM-DD 是 PRODUCT_DIR_TYPE 节能环保清单分类 节能目录 1.1; 节水目录 1.2; 环保目录 2.1。 是 BRAND_ZH_NAME 品牌名称 最大长度为 100 个字符 是 MANUF_NAME 制造商名称 最大长度为 100 个字符 是 REMARK 备注 最大长度为 400 个字符 否 5.2 约束 约束条件已经在 清单 相关表中列出，请按照约束说明来设定字段值。 6. 接口详情 以中国政府采购网接收节能环保清单标准化文本为例进行接口说明。省级财政部门政府采购管理交易系统可参照设计相关系统接口。 5 6.1 接口方式 中国政府采购网提供 xml 结构 节能环保清单数据 ，各省级系统在获取授权后，通过请求接口的形式，获取清单数据。各省级系统应根据本规范说明进行接口客户端开发，开发完成后向 中国政府采购网申请开通接口权限，以供调试和日后正式数据的获取，接口地址如下 http// dirType1 dirCode201618 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 个 品目 来丼例 1 1 6 6.3 接口返回 return 以字符串形式的返回信息，返回值的格式为 1. 2. -1 3. 数据重复，请检查文档中有关重复数据的约束条件。 4. 其中 code 表示的是数据推送状态， reason 表示数据推送失败的原因，详细描述了您的 数据参数中有哪些丌符合的内容，可以根据返回值调试数据。下面是 code 可能包含的值及状态描述； 状态值 含义 备注 1 数据发送失败 接口在解释接收到的数据时出现异常返回该值 0 数据 发送 成功 成功接收数据并按规范校验通过时返回该值 -1 重复数据 根据接口约束事项进行重复数据判断时返回该值 2 数据不规范 成功接收数据，但按规范校验通过时返回该值 3 数据库异常，导入失败 接收端已完成数据校验，但在存储入 库 出现异常时返回该值 当接口接收数据时将按照接口规范及约束对传入的数据项目进行规范性、完整性检查。 如果传入的数据丌满足规范要求将丌接收数据，并向调用方返回检查后的结果状态值 。 7. 附录 7.1 数据字典 请参见基础数据字典 .xlsx文档，文档中包含品目字典、 品牌 字典。数据均来自于财政部或其他相关部门的规范。 8 7.2 常见问题 7.2.1 接口账号 接口系统的验证账号采用政府采购交易管理系统中的用户名和密码，请确保已经登记开通相关账号权限。 7.2.2 品目与基础数据字典品目不一致时，如何填写品目数据 基础数据字典 .xlsx中的品目为财政部国库司 2013 年发布的版本（财库 [2013]189 号），如品目出现差异，可选择上一级品目 ， 但应以财政部正式下发 的品目为准 。 7.2.3 调试说明 调试完成的单位可以直接联系中国政府采购网确认启用正式接口时间。 调试期间 各单位 请用中国政府采购网 指定 的 调试 账号进行数据的传输调试 ， 调试数据每天晚上清空一次，请各位调试人员知悉。 正式接口地址不调试地址一致。接口调试简要流程为用户联系中国政府采购网申请接口调试；中国政府采购网相关 技术文档 ；用户根据资料中的说明使用测试账号进行接口调试（如遇到问题可以联系技术人员进行联调解 决）；用户测试联调获得正确的数据；用户联系中国政府采购网开通正式接口；接收正式数据并应用在自建业务系统中。