本规范确定了“互联网+第四方物流”供销集配科技支撑体系数据对接标准，是供销集配科技支撑体系信息化系统统一的基础、是各合作商对接供销集配体系的依据，是江西省供销电子商务有限公司（以下简称电商公司）对社会统一开放共享的前提。
本规范由江西省供销电子商务有限公司技术部提出并归口。
本规范由归口部门负责解释。
本规范起草单位：江西省电子商务有限公司
适用对象为江西省供销电子商务有限公司内部及合作方, 用于在业务开展、招标选型、工程建设、运行维护、设备开发等方面提供技术参考依据。
2、接口说明
本规范支持以下接口或协议：http/https和数据库接口，并可根据客户、合作方的具体需求提供相应的对接方式。
包含集配中心及集配中心设计到所有实体，例如车辆、司机、服务站、仓库、客户、供应商、产品等。以及集配中心开展业务经营情况信息，例如快递、快消品、生鲜、等业务数据
正式请求地址：具体官网公布为准
官网地址：https://www.jxcoop.com.cn/
对接方式：http接口
3.1集配企业主体信息上报
该接口用于上报集配企业基础信息
接口名称：uploadCompanyInformation
请求方式：post
接口示例：参见附件一
请求参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | Hdh#qqashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 车辆数 | car_num | 是 | int | 20 | 车辆总数 |
| 仓库面积 | area_num | 是 | float | 3525.3 | 仓库面积 |
| 网点数 | shop_num | 是 | int | 222 | 网点数量 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "car_num": "20", "area_num": "3525.3", "shop_num": "222", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", }
|
接口描述：该接口用于上报集配中心车辆信息
接口名称：uploadCarInformation
请求方式：post
请求参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | Hdh#qqashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 车牌号 | car_name | 是 | int | 20 | 车辆总数 |
| 车辆长度（米） | car_long | 是 | float | 12 | 仓库面积 |
| 车载重量（吨） | shop_num | 是 | int | 22 | 网点数量 |
| 购买时间 | buy_date | 是 | date | 2022-12-09 |
|
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
| { "code_id": "360102", "key": "Hdh#qqashdas", "car_num": "20", "car_long": "12", "shop_num": "20", "buy_date ": "2022-12-09", "create_time": "2022-12-09" }
|
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.3司机信息上报
接口描述：该接口用于上报集配中心司机信息
请求方式：post
请求参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | Hdh#qqashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 司机名字 | driver_name | 是 | int | 王小明 | 司机名字 |
| 司机性别 | driver_sex | 是 | float | 1 | 1.男2女 |
| 从业证件 | driver _certificate | 是 | int | 222 | 上传图片 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 数据上报时间 |
返回参数:
| 变量名 | 必填 | 类型 | 示例值 | 描述 | |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "driver_name": "王小明", "driver_sex": "1", "driver _certificate ": "图片", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.4服务站点上报
接口描述：该接口用于上报服务站点信息
接口名称：uploadPartnerInformation
请求方式：post
请求参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | Hdh#qqashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 站点名称 | partner_name | 是 | int | XXX超市 | 提货点、小卖铺、服务站点、合伙人 |
| 联系人名字 | link_name | 是 | float | 翟志刚 | 联系人名字 |
| 联系人电话 | link_phone | 否 | int | 18918882910 | 联系人电话 |
| 经度 | lot | 是 | float | 28.32 | 经度 |
| 纬度 | lat | 是 | float | 112.23 | 纬度 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数:
| 变量名 | 必填 | 类型 | 示例值 | 描述 | |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "partner_name": " XXX超市", "link_name": "翟志刚", "link_phone": "18918882910", "lot": "28.32", "lat": "112.23", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.5素材上传
接口描述：该接口用于上传素材信息、例如集配企业营业执照、车辆行驶证、驾照、重要文件、宣传资料等信息
接口名称：uploadFile
请求方式：post
请求参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | Hdh#qqashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 素材名称 | file_name | 是 | int | 测试图片 | 提货点、小卖铺、服务站点、合伙人 |
| 素材类型 | file_type | 是 | int | 1 | 1 图片 2 视频 3 文件 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
| { "code_id": "360102", "key": "Hdh#qqashdas", "file_name": "测试图片", "file_type": "1", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.6车辆实时坐标
接口描述：该接口用于实时上报车辆位置，设备开启后间隔30s传输一次。
接口名称：uploadCarPosition
请求方式：post
请求参数：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | Hdh#qqashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 车辆id | car_id | 是 | int | 20 | 车辆id |
| 车牌号 | car_name | 是 | string | 赣A23131 | 车牌号 |
| 经度 | lot | 是 | float | 28.31 | 经度 |
| 纬度 | lat | 是 | float | 116.23 | 纬度 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数:
| 变量名 | 必填 | 类型 | 示例值 | 描述 | |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "car_id": "20", "car_name": "赣A23131", "lot": "28.31", "lat": "116.23", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.7快递数据接口
集配中心每日快递数据上报接口（每日上报一次快递数据）
请求方式：post
请求参数:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | hdhashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 快递上行件 | up_num | 是 | int | 1344 | 快递上行件的数量 |
| 快递下行件 | down_num | 是 | int | 222 | 快递下行件的数量 |
| 日期 | data_time | 是 | date | 2022-12-09 | 快递数据日期一般为当天的日期 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数:
| 变量名 | 必填 | 类型 | 示例值 | 描述 | |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "up_num ": "2021", "down_num ": "3525", "date_time": "2022-12-09", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.8订单数据上报接口
集配中心订单数据上报接口（每个成功的订单上报一次数据）
地址：uploadOrder
请求方式：post
请求参数:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | hdhashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 订单类型 | type | 是 | int | 1 | 标识订单类型（1、新零售2、生鲜3、农资） |
| 订单总价 | price | 是 | decimal | 222.11 | 订单总金额 |
| 日期 | data_time | 是 | string | 202006100909 | 下单日期 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数:
| 变量名 | 必填 | 类型 | 示例值 | 描述 | |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "type ": "2", "price ": "3525.3", "data_time ": "2022-12-09", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
3.9订单商品数据上报接口
县级运营中心订单数据上报接口，该接口主要根据订单单品来上报，用于统计每个单品的销售情况
请求方式：post
请求参数:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 密钥 | key | 是 | string | hdhashdas | 密钥主要用于上报数据接口验证每个运营中心的密钥都是唯一的 |
| 订单类型 | type | 是 | int | 1 | 标识订单类型（1、新零售2、生鲜3、农资） |
| 订单金额 | price | 是 | decimal | 222.11 | 订单总金额 |
| 单品名称 | sku_name | 是 | string | 橘子 | 商品名称 |
| 单品id | sku_id | 是 | int | 00001 | 商品规格id |
| 日期 | data_time | 是 | date | 202006100909 | 下单日期 |
| ip | ip | 是 | string | 47.86.170.30 | 县级运营中心上报数据的ip地址 |
| 数据时间 | create_time | 是 | date | 2022-12-09 | 该字段是数据上报的时间 |
返回参数:
| 变量名 | 必填 | 类型 | 示例值 | 描述 | |
| 返回状态码 | code | 是 | int | 1 | 返回值为1时代表成功，为0时代表失败 |
| msg | msg | 是 | string | 成功 | 主要表述数据上报是否成功 |
| 返回信息 | body | 是 | string | null | 部分接口会有返回信息 |
请求参数示例：
| { "code_id": "360102", "key": "Hdh#qqashdas", "type ": "1", "price": "222.11", "sku_name ": "橘子", "sku_id ": "00001", "data_time ": "2022-12-09", "ip": "47.86.170.30", "create_time": "2022-12-09" } |
返回值示例：
| { "code": "1", "msg": "正常", "body ": "null", } |
4、数据库对接
通过http接口对接的数据会经过筛选和处理，容易导致数据失真，不利于后续数据的分析和利用。可以采取开放数据库权限，直接对接数据库的方式获取原始数据。
数据库方式通信所对应的数据库组网方式有以下两种：
一、由合作伙伴提供一个交互用的数据库服务器，要求数据库的结构满足本规范中定义要求。
二、电商公司提供一个符合规范定义的结构要求的标准数据库，供合作方数据交互。
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 360102 | 地区id标识的是县级运营中心所在的地区（详情请查看附件） |
| 公司名称 | name | 是 | string | XX公司 | 公司名称 |
| 订单类型 | type | 是 | int | 1 | 标识订单类型（1、新零售2、生鲜3、农资） |
| 注册资金 | registered_capital | 是 | decimal | 222万 | 公司注册资金 |
| 股权占比 | equity_ratio | 是 | float | 36.3% | 股权占比 |
| 经营类型 | business_type | 是 | int | 1 | 公司经营类型1快递,2新零售,3生鲜,4 |
| 员工数量 | staff_num | 否 | int | 20 | 员工数量 |
| 店铺数量 | shop_num | 否 | int | 47 | 公司名下店铺数量 |
| 总场地面积 | totle_area | 是 | float | 10000㎡ | 总场地面积 |
| 快递品牌 | express_brand | 是 | int | 1 | 快递品牌1.中通2圆通等等 |
| 配送单价 | express_price | 否 | decimal | 1.2 | 配送快递的价格 |
| 配送线路 | route_num | 否 | int | 2 | 配送线路 |
| 企业负责人 | real_name | 是 | string | 王小明 | 企业负责人 |
| 联系方式 | phone | 是 | string | 13154218546 | 企业负责人联系方式 |
| 省 | province | 是 | string | 江西 | 省 |
| 市 | city | 是 | string | 南昌 | 市 |
| 县 | area | 是 | string | 西湖区 | 县/区 |
| gps x坐标 | gps_x | 否 | float | 28.33 | 百度地图坐标 |
| gps y坐标 | gps_y | 否 | float | 115.212 | 百度地图坐标 |
| 注册时间 | create_time | 是 | datetime | 2020-02-03 | 注册时间 |
服务站点表
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 公司id | company_id | 是 | int | 12 | 公司id |
| 企业名称 | company_name | 是 | string | XX公司 | 所属公司名称 |
| 服务站点名称 | name | 是 | string | XXX超市 | 服务站点名称 |
| 联系人 | link_man | 是 | string | 1 | 联系人 |
| 联系电话 | link_phone | 是 | string | 13154218546 | 联系电话 |
| 经度 | longitude | 是 | float | 28.23 | 订单总金额 |
| 纬度 | latitude | 是 | float | 116.3 | 商品名称 |
| 创建时间 | create_time | 是 | datetime | 2020-03-03 | 商品规格id |
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 公司id | key_id | 是 | int | 12 | 公司id |
| 公司名称 | add_name | 是 | string | XX公司 | 所属公司名称 |
| 快递单号 | sn | 是 | string | XXX超市 | 快递单号 |
| 快递品牌 | logis_name | 是 | string | 圆通 | 快递品牌 |
| 操作人 | user_name | 是 | string | 小明 | 操作人 |
| 数据时间 | data_time | 是 | date | 2020-03-03 | 数据时间 |
| 地址 | address | 是 | string | 民安路99号 | 地址 |
| 手机号 | phone | 是 | string | 13154218546 | 手机号 |
| 数据传输时间 | create_time | 是 | datetime | 2020-03-03 | 数据传输时间 |
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 12 | 地区id |
| 公司id | company_id | 是 | string | 06 | 订单所属公司id |
| 商品名 | goods_name | 是 | string | 小白菜 | 商品名 |
| 商品数量 | goods_num | 是 | Int | 111 | 商品数量 |
| 订单数量 | order_num | 是 | Int | 111 | 订单数量 |
| 订单总价 | totle_price | 是 | decimal | 124214.2 | 订单总价 |
| 数据时间 | data_time | 是 | date | 2020-03-03 | 数据时间 |
| 数据传输时间 | create_time | 是 | datetime | 2020-03-03 | 数据传输时间 |
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 12 | 地区id |
| 公司id | company_id | 是 | int | 06 | 订单所属公司id |
| 快递名称 | express_name | 是 | string | 圆通快递 | 快递名称 |
| 快递上行数量 | up_num | 是 | int | 6465 | 快递上行数量 |
| 快递下行数量 | down_num | 是 | int | 3122 | 快递下行数量 |
| 数据时间 | data_time | 是 | date | 2020-03-03 | 数据时间 |
| 数据传输时间 | create_time | 是 | datetime | 2020-03-03 | 数据传输时间 |
新零售数据表
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 12 | 地区id |
| 公司id | company_id | 是 | string | 06 | 订单所属公司id |
| 商品名 | goods_name | 是 | string | 王老吉 | 商品名 |
| 商品数量 | goods_num | 是 | int | 111 | 商品数量 |
| 订单数量 | order_num | 是 | int | 111 | 订单数量 |
| 订单总价 | totle_price | 是 | decimal | 124214.2 | 订单总价 |
| 数据时间 | data_time | 是 | date | 2020-03-03 | 数据时间 |
| 数据传输时间 | create_time | 是 | datetime | 2020-03-03 | 数据传输时间 |
农资农具数据表
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 地区id | code_id | 是 | int | 12 | 地区id |
| 公司id | company_id | 是 | string | 06 | 订单所属公司id |
| 商品名 | goods_name | 是 | string | 化肥 | 商品名 |
| 商品数量 | goods_num | 是 | int | 111 | 商品数量 |
| 订单数量 | order_num | 是 | int | 111 | 订单数量 |
| 订单总价 | totle_price | 是 | decimal | 124214.2 | 订单总价 |
| 数据时间 | data_time | 是 | date | 2020-03-03 | 数据时间 |
| 数据传输时间 | create_time | 是 | datetime | 2020-03-03 | 数据传输时间 |
