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