节能环保清单数据接口规范说明 (2).docxVIP

节能环保产品政府采购清单数据规范目录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品目与基础数据字典品目不一致时，如何填写品目数据？87.2.3调试说明8适用范围本文档由财政部国库司、信息网络中心以及节能产品政府采购清单和环境标志产品政府采购清单（以下统称节能环保清单）相关认证机构共同编写。节能环保清单生成、发布、接收应当执行本文档规定的数据规范。术语和定义、符号、缩略语清单：如无特殊说明，清单在本文档中均指节能环保清单。发布单位：如无特殊说明，发布单位均指节能环保清单发布单位。空字符串：如接口字段不允许为空，即该字段必须有值，不可从技术上对字段不赋值或者赋值为 null，请根据字段说明按要求填写合适的值。日期格式：约定统一的日期格式。统一的格式为 YYYY-MM-DD。如 2016-06-28。概述本规范将规定节能环保清单标准化文本应包含的信息内容及其规范性。节能环保清单相关认证机构定期发布的清单标准化文本，依据本文档规定的技术指标及相关说明生成。各相关信息系统通过系统接口方式获取清单标准化文本的，需严格遵循本规范。节能环保清单标准化文本将按本规范约定以xml文件方式提供，用户可以通过以下两种方式中任意一种获取该xml文件：1、通过中国政府采购网首页指定位置下载xml格式的数据包；2、用户按此规范说明自行开发客户端工具，连接中国政府采购网的服务端程序以接收节能环保清单标准化文本。用户的客户端工具可用任何编程语言开发，也可与现有系统集成，实现在自有系统或网站上进行节能环保清单的发布与查询。该文档主要描述节能环保清单标准化文本的内容及接口方式的获取方法，包含三部分内容： 1、接口可接收的字段说明，即各清单的字段类型及程序检查规则； 2、接口说明，即节能环保清单数据接口技术描述； 3、基础数据说明，即节能环保清单包含代码的字段，应按照基础数据字典中的代码字段填写。 接口规范节能环保清单数据接口规范中包括各类型清单的字段，节能环保清单数据接口将按照下边的表格进行数据接收和验证，并按“接口检查规则”检验数据后存入各交易系统数据库。政府采购节能环保清单定义说明头信息 头信息要求说明推送数据所需的必要全局信息，字段及描述详见本节定义。 字段要求列表参数名称参数说明接口检查规则是否必填VERSION产品清单版本数字格式的递增版本号。是FULLUPDATE全量更新标志1-根据产品清单编号和版本号覆盖历史数据（全量更新）；0-不覆盖数据，根据产品清单编号和版本号增量更新是节能环保清单标识信息 标识信息要求说明清单标识信息记录清单的属性信息，字段及描述详见本节定义。 字段要求列表参数名称参数说明接口检查规则是否必填DIR_CODE产品清单编号节能、节水清单:ES+4位年度+2位期数，例如ES201603;环保清单:EP+4位年度+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个字符否节能环保清单产品信息 产品信息要求说明产品信息记录节能环保清单品目相关信息，字段及描述详见本节定义。 字段要求列表参数名称参数说明接口检查规则是否必填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个字符否约束约束条件已经在清单相关表中列出，请按照约束说明来设定字段值。接口详情以中国政府采购网接收节能环保清单标准化文本为例进