农村电子商务和社区商业信息系统数据采集规范-商务部

附件1

农村电子商务和社区商业信息系统

数据采集规范

（试行）

本规范规定了农村电子商务和社区商业信息系统（以下简称信息系统）功能结构、数据接口、传输指标、数据格式、安全和维护等方面的技术要求。

适用于全国农村电子商务示范县县级电商企业平台。 一、术语与定义

下列术语和定义适用于本规范。 （一）农村电子商务示范工程

电子商务进农村是商务部和财政部2014年联合启动的完善农村市场体系建设项目。按照工业化、城镇化、信息化、农业现代化总体要求，以农村流通现代化为目标，通过电子商务示范县建设，着力解决电子商务进农村过程中的突出矛盾和问题，创造良好的发展环境，推广典型经验，形成示范效应，引领电子商务在农村更大范围推广和应用，促进农村现代市场体系进一步完善。目前，已在全国256个县开展示范建设工作。

（二）农村电子商务和社区商业信息系统

农村电子商务和社区商业信息系统是指由商务部负责建设

和管理、县级电子商务示范企业负责定期上传数据的，用于对商务部开展的电子商务进农村示范工程进行综合管理、对农村电子商务发展现状进行统计、对各地农村电子商务人才培训情况等进行动态掌握的管理信息系统。

针对商务部“农村电子商务和社区商业信息系统”中的相关规定，由农村电子商务和社区商业信息系统的技术支持单位中国国际电子商务中心负责对接总体安排，试点地区承担农村电子商务示范工程的项目建设技术单位负责数据接口开发，共同完成数据对接工作。本文档规定了数据采集指标、数据对接接口设计规范及数据传输格式要求，供相关技术人员查阅。

二、数据采集指标

农村电子商务和社区商业信息系统数据采集指标包括日报指标和季报指标。

（一）日报数据采集指标。

日报数据主要包括站点交易数据和配送中心配送数据，具体指标包括：站点代买商品类别、代买总金额、代买总订单数、销售商品类别、销售总金额、销售总订单数，配送中心日收件数量、日发件数量。（数据表格见表一） （二）季报采集指标。

季报数据主要包括基本情况、县级服务中心建设情况、乡镇级区域服务站建设情况、村级服务站点建设情况、配送中心建设情况、人员培训情况、电商发展情况等七大项（数据表格见表二）。

其中：

基本情况包括乡镇数量、行政村数量、社区数量、常住人口、农业户口人数、非农业户口人数等6个指标；

县级服务中心建设情况包括县级服务中心名称、主要职能、提供服务、负责人、座机、手机、联系人、座机、手机等9个指标；

乡镇级区域服务站建设情况主要包括主要职能、提供服务、服务站点名称、服务站ID（必填指标）、负责人、手机、设施配置等7个指标；

村级服务站点建设情况主要包括主要职能、提供服务、服务站点名称、服务站ID（必填指标）、负责人、手机、设施配置等7个指标；

配送中心建设情况主要包括配送中心名称、配送中心ID（必填指标）、主要职能、提供服务、负责人、座机、手机、联系人、座机、手机等10个指标；

人员培训情况主要包括培训人数总计、培训总时长、培训场次、政府培训人数、培训时长、培训内容、企业培训人数、培训时长、培训内容、合作社培训人数、培训时长、培训内容、农村青年及返乡大学生培训人数、培训时长、培训内容、退伍军人培训人数、培训时长、培训内容、其他人员培训人数、培训时长、培训内容、培训实习单位、负责人、手机等24个指标；

电商发展情况主要包括企业网商总数、新孵化数、合作社网

商总数、新孵化数、个人网商总数、新孵化数等6个指标。

（三）数据采集频率。

日报数据由各示范县综合示范工作承办企业通过数据传输接口，自动传输至商务部农村电子商务和社区商业信息系统。

季报数据由各示范县每季度末登录商务部农村电子商务和社区商业信息系统填报本季度相关数据。

三、数据接口设计规范与假定约束 规定数据接口设计规范与假定约束条件。 （一）数据接口设计规范。

协议规范：访问和数据返回都采用WebService协议的方式；

格式规范：数据的传输参数和返回的结果数据串都以XML的形式表达；

安全控制：本接口需要农村电子商务和社区商业信息系统中各省级商委的用户名和密码来进行身份验证。用户名和密码都需要加密后进行密文传输。

详见：加密技术附件。 性能控制参数：

1.每页记录数：定义每页记录数的上下限，用于多页返回； 2.服务时间段：控制访问的服务时间段；目前为0-24点 3.两次访问的时间间隔：避免用户频繁访问；访问间隔不能小于3秒钟。

（二）假定约束。

1.请求方和响应方均以对接接口数据传输格式为契约标准； 2.用户传输过程中提供的节点编码ID与用户在XXX网站中备案的节点编码ID一致；

3.接口用户应遵循本接口设计规范，并以友善的方式使用服务接口，作为安全控制和系统性能的补充。

4.接口传输数据的字符串编码格式为UTF-8。 5.接口传输数据的字符串中日期格式为“yyyy-MM-dd”。 四、数据接口总体设计要求 （一）数据接口总体结构。

农村电子商务和社区商业信息系统与试点省（市）农村电子商务示范企业信息系统数据对接接口一共包含两类，分别是：站点交易接口、配送信息接口。

数据对接接口总体结构图如下所示：

农村电子商务和社区商业信息系统提供给地方平台的接口如下表格： 接口名称 站点交易接口 配送信息接口

访问方式 http://IP/services/syncStation?wsdl http://IP/services/syncDeliverCenter?wsdl (二)数据传输格式。

对接接口的数据传输格式主要包括基本信息、参数列表和数据列表三部分，总体结构图如下所示：

数据传输格式对应的XML文档结构为：

……

……

……

（三）基本信息。

基本信息节点为必选节点，及所有接口的输入参数和返回结果都包含基本信息节点，基本信息主要包括操作状态、指定当前页，总记录条数，当前页记录条数，及用于身份认证的用户名和密码等内容。

head节点的XML文档结构如下所示：

000 1

100 beijing ***

字段名 states page total pageSize 含义 操作状态 当前页 总记录条数 当前页数据量 Int Int Int 类型 String 父节点 head head head head

username password

用户名 密码 String String head head 其中states为操作状态，在返回结果中出现，用于返回本

次请求的执行结果状态，states有以下七种状态：

000：访问成功 001：没有数据

002：不在服务时间之内

003：用户过于频繁访问，请稍后再来 004：用户不合法，请核对校验密码 005：传入参数有误，请核对参数 006：数据库无法响应，请稍后访问

007：超出一批数据最大处理数量上限pageSize 008：ip地址错误 例：

001

1.参数列表。

参数列表节点为可选节点主要用于向查询接口输入查询条

件，在使用查询接口时，需要通过参数列表节点指定相应的查询参数，查询条件参数根据具体接口而定。

如在企业备案信息数据查询接口中params节点的XML文档结构如下所示：

01 ……

2.数据列表。

数据列表节点为可选节点，主要用于接口批量推送数据或者批量返回数据.如：在数据同步接口中用于推送数据，在数据查询接口由于返回查询结果。

由于存在服务站信息和配送中心信息两个数据接口，所以数据文件也应该分成两个xml文件分别存储。

（1）服务站信息数据文件items节点的XML文档结构如下所示：

2015-08-21

123

站点1

1 24 24 12

123

13

123

124 站点2

2 24 24

, 2村

22

123

23

123

2015-08-22 123 站点1

1 24 24 12

123

2村

, 13

123

124 站点2

2 24 24 22

123 23

123

2村

, 字段名 serviceStation rptDate serviceStationReport code name countyType serviceStationCommodity commId money buyOrder saleOrder

含义 服务站 报表日期 类型 String 父节点 items serviceStation serviceStation serviceStationReport serviceStationReport serviceStationReport serviceStationReport serviceStationCommodity serviceStationCommodity serviceStationReport serviceStationReport 各站点交易信 息 站点编码 站点名称 站点类型 String String String 代买或者销售 商品 代买商品类别 代买总金额 代买总订单数 销售总订单数 String NUMBER Int Int （2）配送中心信息数据文件items节点的XML文档结构如下所示：

2015-08-21

111

配送中心1

123 123

112

配送中心2

123 123

2015-08-22 111

配送中心1

123 123

112

配送中心2

123 123

字段名 deliverCenter rptDate 含义 配送中心 报表日期 类型 String 父节点 items deliverCenter deliverCenter deliverCenter deliverCenter deliverCenter deliverCenter 配送中心收发件信deliverCenterReport 息 code name receiveNum sendNum 配送中心ID 配送中心名称 String String 日收件数量（件） Int 日发件数量（件） Int

表一

站点交易、配送信息采集表（日报表）

序号 站点1 站点编码（ID) 站点名称 站点类型 代买商品类别 代买总金额 代买总订单数 商品类别见附表 配送中心名称 销售商品类别 销售总金额 销售总订单数 站点2 …… 配送中心1 ……

配送中心ID 商品类别见附表 日收件数量（件） 日发件数量（件） 说明：1、该报表内容通过数据接口直接传输至中央平台。

2、站点类型包括村级服务站点、乡镇级服务站点。 3、站点代买/销售商品类别见附表。

4、各站点交易信息、配送中心收发件信息要求按日报送。

5、站点编码（ID）是本地区所建站点在承担示范工作的电商平台中的对应ID编码。 6、配送中心(ID) 是本地区所建配送中心在承担示范工作的电商平台中的对应ID编码。

附表

站点代买/销售商品类别

商品大类 具体类别 1粮油类 代买编码（commId） 4 5 6 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 代卖编码（commId） 27 28 29 30 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 农产品 （3类） 2生鲜食品类 3干货类 1休闲食品类 2烟酒类 3服装、鞋帽、针纺织品类 4化妆品类 5金银珠宝类 工业消费品 （12类） 6日用品类 7家用电器和音像器材类 8中西药品类 9文化办公用品类 10家具类 11通讯器材类 12建筑及装潢材料类 1农用生产资料类 生产资料 （4类） 2化工产品类 3机电类 4木材类 注：1.可根据示范县项目实施企业商品经营情况，在现有商品类别基础上进行添加。

2.接口中商品编码严格按照此表中的商品编码填写。

本文来源：https://www.bwwdw.com/article/3hc5.html